n8n 2.31.5 → 2.32.1

package/dist/modules/instance-ai/instance-ai.service.js

@@ -1,49 +1,17 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
 var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
     var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
     if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InstanceAiService = exports.QUOTA_EXHAUSTED_USER_MESSAGE = void 0;
 exports.getUserFacingErrorMessage = getUserFacingErrorMessage;
+const agents_1 = require("@n8n/agents");
 const api_types_1 = require("@n8n/api-types");
 const backend_common_1 = require("@n8n/backend-common");
 const backend_network_1 = require("@n8n/backend-network");
@@ -52,23 +20,30 @@ const db_1 = require("@n8n/db");
 const decorators_1 = require("@n8n/decorators");
 const di_1 = require("@n8n/di");
 const instance_ai_1 = require("@n8n/instance-ai");
+const lazy_import_1 = require("@n8n/utils/lazy-import");
 const workflow_sdk_1 = require("@n8n/workflow-sdk");
 const n8n_core_1 = require("n8n-core");
 const n8n_workflow_1 = require("n8n-workflow");
 const nanoid_1 = require("nanoid");
 const constants_1 = require("../../constants");
+const forbidden_error_1 = require("../../errors/response-errors/forbidden.error");
 const event_service_1 = require("../../events/event.service");
+const instance_ai_builder_delegate_adapter_1 = require("../../modules/agents/instance-ai-builder-delegate.adapter");
+const check_access_1 = require("../../permissions.ee/check-access");
 const source_control_preferences_service_ee_1 = require("../../modules/source-control.ee/source-control-preferences.service.ee");
 const publisher_service_1 = require("../../scaling/pubsub/publisher.service");
 const ai_service_1 = require("../../services/ai.service");
 const proxy_token_manager_1 = require("../../services/proxy-token-manager");
 const url_service_1 = require("../../services/url.service");
 const telemetry_1 = require("../../telemetry");
+const agent_preview_handoff_1 = require("./agent-preview-handoff");
 const composite_local_mcp_server_1 = require("./browser/composite-local-mcp-server");
 const instance_ai_browser_session_service_1 = require("./browser/instance-ai-browser-session.service");
 const thread_credential_allowlist_service_1 = require("./eval/thread-credential-allowlist.service");
+const durable_event_log_1 = require("./event-bus/durable-event-log");
 const in_process_event_bus_1 = require("./event-bus/in-process-event-bus");
 const instance_ai_credit_service_1 = require("./instance-ai-credit.service");
+const instance_ai_error_reporter_service_1 = require("./instance-ai-error-reporter.service");
 const instance_ai_gateway_service_1 = require("./instance-ai-gateway.service");
 const instance_ai_memory_service_1 = require("./instance-ai-memory.service");
 const instance_ai_model_service_1 = require("./instance-ai-model.service");
@@ -80,7 +55,6 @@ const instance_ai_adapter_service_1 = require("./instance-ai.adapter.service");
 const internal_messages_1 = require("./internal-messages");
 const liveness_1 = require("./liveness");
 const mcp_1 = require("./mcp");
-const instance_ai_error_reporter_service_1 = require("./instance-ai-error-reporter.service");
 const observability_1 = require("./observability");
 const output_redaction_config_1 = require("./output-redaction-config");
 const planned_task_action_runner_1 = require("./planned-task-action-runner");
@@ -96,28 +70,36 @@ const suspended_thread_persistence_service_1 = require("./suspended-thread-persi
 const tracing_1 = require("./tracing");
 const workflow_verification_obligation_service_1 = require("./workflow-verification-obligation-service");
 const workflow_verification_task_projector_1 = require("./workflow-verification-task-projector");
+const agent_execution_service_1 = require("../agents/agent-execution.service");
+const format_preview_context_1 = require("../agents/builder/format-preview-context");
 function getErrorMessage(error) {
     return error instanceof Error ? error.message : String(error);
 }
-function buildContextResourcesBlock(workflowAttachments) {
-    if (workflowAttachments.length === 0)
+function buildContextResourcesBlock(contextAttachments) {
+    if (contextAttachments.length === 0)
         return '';
-    const lines = workflowAttachments.map((attachment) => {
+    const lines = contextAttachments.map((attachment) => {
         const name = attachment.name ? ` "${attachment.name}"` : '';
+        if (attachment.type === 'agent') {
+            return `- Agent${name} (id: \`${attachment.id}\`, in project \`${attachment.projectId}\`).`;
+        }
         const execution = attachment.executionId
             ? `, currently viewing its execution \`${attachment.executionId}\``
             : '';
         return `- Workflow${name} (id: \`${attachment.id}\`)${execution}.`;
     });
+    const header = contextAttachments.some((attachment) => attachment.type === 'agent')
+        ? 'The user opened this conversation from the agent editor, where they are looking at:'
+        : 'The user opened this conversation from the workflow editor, where they are looking at:';
     const prose = [
-        'The user opened this conversation from the workflow editor, where they are looking at:',
+        header,
         ...lines,
         "Treat this purely as context. Until the user tells you what they need, don't read, inspect, run, or otherwise call tools on these resources, and don't make claims about their contents — just briefly acknowledge what they're working on and ask how you can help.",
     ].join('\n');
-    return `${internal_messages_1.EDITOR_CONTEXT_OPEN_TAG}\n${JSON.stringify(workflowAttachments)}\n\n${prose}\n${internal_messages_1.EDITOR_CONTEXT_CLOSE_TAG}`;
+    return `${internal_messages_1.EDITOR_CONTEXT_OPEN_TAG}\n${JSON.stringify(contextAttachments)}\n\n${prose}\n${internal_messages_1.EDITOR_CONTEXT_CLOSE_TAG}`;
 }
 function buildHandoffContextBlock(context) {
-    if (!context)
+    if (!context || context.source !== 'credential-modal')
         return '';
     const { credential } = context;
     const lines = [
@@ -238,10 +220,11 @@ let InstanceAiService = class InstanceAiService {
         }
         return this._mcpClientManager;
     }
-    constructor(logger, globalConfig, instanceSettings, adapterService, eventBus, settingsService, gatewayService, browserSessionService, memoryService, agentMemory, checkpointStore, aiService, threadGrantRepo, pendingConfirmationRepo, urlService, dbSnapshotStorage, dbIterationLogStorage, sourceControlPreferencesService, telemetry, mcpRegistryService, userRepository, temporaryWorkflowService, errorReporter, ssrfProtectionConfig, ssrfProtectionService, eventService, evalCredentialAllowlists, runProbe, modelService, creditService, publisher, instanceAiErrorReporter) {
+    constructor(logger, globalConfig, instanceSettings, adapterService, eventBus, eventLog, settingsService, gatewayService, browserSessionService, memoryService, agentMemory, checkpointStore, aiService, threadGrantRepo, pendingConfirmationRepo, urlService, dbSnapshotStorage, dbIterationLogStorage, sourceControlPreferencesService, telemetry, mcpRegistryService, userRepository, temporaryWorkflowService, errorReporter, ssrfProtectionConfig, ssrfProtectionService, eventService, evalCredentialAllowlists, runProbe, modelService, creditService, publisher, instanceAiErrorReporter) {
         this.instanceSettings = instanceSettings;
         this.adapterService = adapterService;
         this.eventBus = eventBus;
+        this.eventLog = eventLog;
         this.settingsService = settingsService;
         this.gatewayService = gatewayService;
         this.browserSessionService = browserSessionService;
@@ -333,7 +316,16 @@ let InstanceAiService = class InstanceAiService {
             aiService: this.aiService,
         });
         this.terminalOutcome = new instance_ai_terminal_outcome_service_1.InstanceAiTerminalOutcomeService({
-            eventBus: this.eventBus,
+            durableLog: globalConfig.instanceAi.durableLog,
+            eventBus: {
+                publish: (threadId, event) => this.eventBus.publish(threadId, event),
+                getEventsForRun: async (threadId, runId) => this.instanceAiConfig.durableLog
+                    ? await this.readDurableEventsForRuns(threadId, [runId])
+                    : this.eventBus.getEventsForRun(threadId, runId),
+                getEventsForRuns: async (threadId, runIds) => this.instanceAiConfig.durableLog
+                    ? await this.readDurableEventsForRuns(threadId, runIds)
+                    : this.eventBus.getEventsForRuns(threadId, runIds),
+            },
             dbSnapshotStorage: this.dbSnapshotStorage,
             agentMemory: this.agentMemory,
             telemetry: this.telemetry,
@@ -438,13 +430,18 @@ let InstanceAiService = class InstanceAiService {
     hasActiveRun(threadId) {
         return this.runState.hasLiveRun(threadId);
     }
+    isRunLive(threadId, runId) {
+        return (this.runState.getActiveRunId(threadId) === runId ||
+            this.runState.getSuspendedRun(threadId)?.runId === runId);
+    }
     getThreadStatus(threadId) {
         const status = this.runState.getThreadStatus(threadId, this.backgroundTasks.getTaskSnapshots(threadId));
         const memoryTasks = this.memoryTaskRegistry.getTasks(threadId);
         return { ...status, memoryTasks };
     }
-    memoryTaskObserverFor(threadId) {
+    memoryTaskObserverFor(threadId, tracing) {
         return (event) => {
+            tracing?.onMemoryTaskEvent?.(event);
             this.memoryTaskRegistry.handleEvent(threadId, event);
             const pendingTasks = this.memoryTaskRegistry.getTasks(threadId);
             const logContext = {
@@ -490,6 +487,7 @@ let InstanceAiService = class InstanceAiService {
             persistence: {
                 resourceId: user.id,
                 threadId,
+                hostRunId: runId,
             },
             providerOptions: {
                 anthropic: { cacheControl: { type: 'ephemeral' } },
@@ -507,7 +505,7 @@ let InstanceAiService = class InstanceAiService {
             runId: agentRunId,
             toolCallId,
             recoverUsageOnAbort: true,
-            persistence: { resourceId: user.id, threadId },
+            persistence: { resourceId: user.id, threadId, hostRunId: runId },
             providerOptions: {
                 anthropic: { cacheControl: { type: 'ephemeral' } },
             },
@@ -850,11 +848,25 @@ let InstanceAiService = class InstanceAiService {
         this.planRequestsByThread.delete(threadId);
         this.memoryTaskRegistry.clearThread(threadId);
         this.tracing.deleteTraceContextsForThread(threadId);
+        await this.deleteAgentBuilderSessions(threadId);
         await this.sandboxService.destroySandbox(threadId);
         await this.temporaryWorkflowService.reapForThreadCleanup(threadId);
         await this.suspendedThreads.dropPendingConfirmationsForThread(threadId);
         this.eventBus.clearThread(threadId);
     }
+    async deleteAgentBuilderSessions(threadId) {
+        if (!di_1.Container.get(backend_common_1.ModuleRegistry).isActive('agents'))
+            return;
+        try {
+            await di_1.Container.get(instance_ai_builder_delegate_adapter_1.InstanceAiBuilderDelegateAdapterService).deleteBuilderSessions(threadId);
+        }
+        catch (error) {
+            this.logger.warn('Failed to clean up agent-builder sessions for thread', {
+                threadId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
     async shutdown() {
         this.stopCheckpointPruning();
         this.liveness.shutdown();
@@ -904,8 +916,10 @@ let InstanceAiService = class InstanceAiService {
         this.sandboxService.stopSandboxExpiryTimers();
         this.domainAccessTrackersByThread.clear();
         this.tracing.clear();
+        await this.eventLog.flushAll();
         this.eventBus.clear();
         await this._mcpClientManager?.disconnect();
+        await (0, instance_ai_1.shutdownProductTelemetryProviders)();
         this.logger.debug('Instance AI service shut down');
     }
     startCheckpointPruning() {
@@ -1018,11 +1032,27 @@ let InstanceAiService = class InstanceAiService {
             });
         }
     }
-    createAgentMemoryOptions() {
+    createAgentMemoryOptions(user, threadId, runId) {
         return {
             observationalMemory: {
                 observerThresholdTokens: this.instanceAiConfig.observerMessageTokens,
                 reflectorThresholdTokens: this.instanceAiConfig.reflectorObservationTokens,
+                onTaskUsage: async (report) => {
+                    try {
+                        const items = (0, instance_ai_1.tokenUsageToBuilderUsageItems)(report.model, report.usage);
+                        if (items.length === 0)
+                            return;
+                        await this.creditService.claimRunUsage(user, threadId, `${runId}:memory:${report.task}:${report.reportId}`, items, 'completed');
+                    }
+                    catch (error) {
+                        this.logger.warn('Failed to claim observational-memory usage', {
+                            threadId,
+                            runId,
+                            task: report.task,
+                            error: getErrorMessage(error),
+                        });
+                    }
+                },
             },
         };
     }
@@ -1192,12 +1222,14 @@ let InstanceAiService = class InstanceAiService {
         const localGatewayDisabledForUser = await this.settingsService.isLocalGatewayDisabledForUser(user.id);
         const userGateway = this.gatewayService.findGateway(user.id);
         const { searchProxyConfig, tracingProxyConfig, tokenManager, proxyBaseUrl } = proxyRunConfig ?? (await this.createProxyRunConfig(user));
+        const configEvalsEnabled = await this.adapterService.isConfigEvalsEnabled(user);
         const context = this.adapterService.createContext(user, {
             searchProxyConfig,
             pushRef,
             threadId,
             projectId: boundProjectId,
             credentialIdAllowlist: this.evalCredentialAllowlists.get(threadId),
+            configEvalsEnabled,
         });
         this.gatewayService.applyToolPolicy(user.id);
         const gatewayMcpServer = !localGatewayDisabledForUser && userGateway?.isConnected ? userGateway : undefined;
@@ -1277,7 +1309,10 @@ let InstanceAiService = class InstanceAiService {
         if (nodeDefDirs.length > 0) {
             (0, workflow_sdk_1.setSchemaBaseDirs)(nodeDefDirs);
         }
-        const allRuntimeSkills = (0, instance_ai_1.loadInstanceAiRuntimeSkillSource)();
+        const flagDisabledSkillIds = (0, instance_ai_1.disabledInstanceAiSkillIds)({ configEvalsEnabled });
+        const allRuntimeSkills = flagDisabledSkillIds.length > 0
+            ? (0, agents_1.filterRuntimeSkillSource)((0, instance_ai_1.loadInstanceAiRuntimeSkillSource)(), flagDisabledSkillIds)
+            : (0, instance_ai_1.loadInstanceAiRuntimeSkillSource)();
         let runtimeSkills = allRuntimeSkills;
         let runtimeWorkspace;
         let workspaceRoot;
@@ -1344,6 +1379,27 @@ let InstanceAiService = class InstanceAiService {
             trackTelemetry: (eventName, properties) => {
                 this.telemetry.track(eventName, properties);
             },
+            claimSubAgentUsage: async (dedupeId, usage, status) => {
+                try {
+                    await this.creditService.claimRunUsage(user, threadId, dedupeId, usage, status);
+                }
+                catch (error) {
+                    this.instanceAiErrorReporter.report(error, {
+                        component: 'instance-ai-agent-builder-usage',
+                        threadId,
+                        runId,
+                        userId: user.id,
+                        ...(boundProjectId ? { projectId: boundProjectId } : {}),
+                        ...(messageGroupId ? { messageGroupId } : {}),
+                    });
+                    this.logger.warn('Failed to claim agent-builder usage', {
+                        threadId,
+                        runId,
+                        dedupeId,
+                        error: getErrorMessage(error),
+                    });
+                }
+            },
             domainTools,
             abortSignal,
             taskStorage,
@@ -1404,6 +1460,42 @@ let InstanceAiService = class InstanceAiService {
             orchestrationContext,
         };
     }
+    getAgentExecutionService() {
+        if (!di_1.Container.get(backend_common_1.ModuleRegistry).isActive('agents'))
+            return null;
+        try {
+            return di_1.Container.get(agent_execution_service_1.AgentExecutionService);
+        }
+        catch {
+            return null;
+        }
+    }
+    async bindAgentPreviewSession(context, user) {
+        await (0, instance_ai_1.resolveAgentPreviewSession)(context);
+        const projectId = context.projectId;
+        if (!context.agentPreviewSession || !projectId)
+            return;
+        if (!(await this.canAccessAgentPreviewHandoff(user, projectId))) {
+            context.agentPreviewSession = undefined;
+            return;
+        }
+        context.resolvePreviewSession = async (ref) => {
+            const service = this.getAgentExecutionService();
+            if (!service)
+                return null;
+            const detail = await service.getThreadDetail(ref.threadId, projectId, ref.agentId);
+            if (!detail)
+                return null;
+            const transcript = (0, format_preview_context_1.formatPreviewSessionContext)(detail.thread, detail.executions, ref.executionId);
+            if (transcript === null)
+                return null;
+            return {
+                title: detail.thread.title?.trim() || `Session #${detail.thread.sessionNumber}`,
+                sessionNumber: detail.thread.sessionNumber,
+                transcript,
+            };
+        };
+    }
     async dispatchPlannedTask(task, context, _graph) {
         if (task.kind === 'build-workflow' || task.kind === 'checkpoint') {
             this.logger.warn('dispatchPlannedTask called for a runtime planned-task kind', {
@@ -1856,6 +1948,11 @@ let InstanceAiService = class InstanceAiService {
     async executeRun(user, threadId, runId, message, abortController, attachments, handoffContext, messageGroupId, timeZone, isReplanFollowUp = false, checkpoint, resumeReason, plannedBuild) {
         const fileAttachments = (attachments ?? []).filter((attachment) => attachment.type === 'file');
         const workflowAttachments = (attachments ?? []).filter((attachment) => attachment.type === 'workflow');
+        const agentAttachments = (attachments ?? []).filter((attachment) => attachment.type === 'agent');
+        const contextAttachments = [
+            ...workflowAttachments,
+            ...agentAttachments,
+        ];
         const signal = abortController.signal;
         let tracing;
         let messageTraceFinalization;
@@ -1925,7 +2022,7 @@ let InstanceAiService = class InstanceAiService {
             });
             if (signal.aborted) {
                 await this.persistInterruptedUserMessage(threadId, user.id, message, turnStartedAt);
-                this.terminalOutcome.evaluateTerminalResponse(threadId, runId, 'cancelled', {
+                await this.terminalOutcome.evaluateTerminalResponse(threadId, runId, 'cancelled', {
                     messageGroupId,
                     correlationId: messageId,
                 });
@@ -1991,7 +2088,7 @@ let InstanceAiService = class InstanceAiService {
                 context.currentUserAttachments = fileAttachments;
             }
             if (!tracing && process.env.E2E_TESTS === 'true') {
-                const { createTraceReplayOnlyContext } = await Promise.resolve().then(() => __importStar(require('@n8n/instance-ai')));
+                const { createTraceReplayOnlyContext } = await (0, lazy_import_1.lazyImport)(async () => await import('@n8n/instance-ai'));
                 tracing = createTraceReplayOnlyContext();
             }
             if (tracing) {
@@ -2002,9 +2099,43 @@ let InstanceAiService = class InstanceAiService {
                     this.tracing.storeTraceContext(runId, threadId, tracing, messageGroupId);
                 }
             }
+            const enrichedMessage = await this.buildMessageWithRunningTasks(threadId, message);
+            const contextResourcesBlock = buildContextResourcesBlock(contextAttachments);
+            let handoffContextBlock = '';
+            let agentPreviewTitleFallback;
+            if (handoffContext?.source === 'agent-preview') {
+                const projectId = context.projectId;
+                if (!projectId) {
+                    throw new n8n_workflow_1.UnexpectedError(`Instance AI thread "${threadId}" has no bound project; agent-preview handoff requires a project`);
+                }
+                await this.assertAgentPreviewHandoffScopes(user, projectId);
+                const agentExecutionService = this.getAgentExecutionService();
+                if (!agentExecutionService) {
+                    throw new n8n_workflow_1.UserError('Agent preview handoff is not available');
+                }
+                const resolved = await (0, agent_preview_handoff_1.resolveAgentPreviewHandoff)(handoffContext, {
+                    projectId,
+                    getThreadDetail: agentExecutionService.getThreadDetail.bind(agentExecutionService),
+                });
+                handoffContextBlock = resolved.block;
+                agentPreviewTitleFallback = resolved.titleFallback;
+                context.agentBuilderTarget = resolved.target;
+                context.agentPreviewSession = {
+                    agentId: handoffContext.agentId,
+                    threadId: handoffContext.threadId,
+                    ...(handoffContext.executionId ? { executionId: handoffContext.executionId } : {}),
+                };
+                await (0, instance_ai_1.saveAgentBuilderTarget)(context, resolved.target, {
+                    previewSession: context.agentPreviewSession,
+                });
+            }
+            else {
+                handoffContextBlock = buildHandoffContextBlock(handoffContext);
+            }
             const thread = await memory.getThread(threadId);
             if (thread && !thread.title) {
-                const handoffTitle = workflowAttachments.find((attachment) => attachment.name)?.name;
+                const handoffTitle = contextAttachments.find((attachment) => attachment.name)?.name ??
+                    agentPreviewTitleFallback;
                 await (0, instance_ai_1.patchThread)(memory, {
                     threadId,
                     update: ({ metadata }) => handoffTitle
@@ -2024,9 +2155,6 @@ let InstanceAiService = class InstanceAiService {
                     payload: { tasks: existingTasks },
                 });
             }
-            const enrichedMessage = await this.buildMessageWithRunningTasks(threadId, message);
-            const contextResourcesBlock = buildContextResourcesBlock(workflowAttachments);
-            const handoffContextBlock = buildHandoffContextBlock(handoffContext);
             let nonStructuredAttachments = [];
             let attachmentManifest = '';
             let hasParseableAttachment = false;
@@ -2195,7 +2323,7 @@ let InstanceAiService = class InstanceAiService {
                         is_intermediate: true,
                     });
                 }
-                const waitingDecision = this.terminalOutcome.evaluateWaitingResponse(threadId, runId, result.confirmationEvent, {
+                const waitingDecision = await this.terminalOutcome.evaluateWaitingResponse(threadId, runId, result.confirmationEvent, {
                     messageGroupId,
                     correlationId: messageId,
                 });
@@ -2272,7 +2400,7 @@ let InstanceAiService = class InstanceAiService {
             const userFacingErrorMessage = result.status === 'errored' ? getUserFacingErrorMessage(result.error) : undefined;
             const userFacingErrorCode = result.status === 'errored' ? getUserFacingErrorCode(result.error) : undefined;
             if (runControl.shouldEmitTerminalOutcome(result.stopReason)) {
-                this.terminalOutcome.evaluateTerminalResponse(threadId, runId, result.status, {
+                await this.terminalOutcome.evaluateTerminalResponse(threadId, runId, result.status, {
                     messageGroupId,
                     correlationId: messageId,
                     workSummary: result.workSummary,
@@ -2339,7 +2467,7 @@ let InstanceAiService = class InstanceAiService {
                 if (cancellationReason === liveness_1.INSTANCE_AI_RUN_TIMEOUT_REASON) {
                     this.liveness.publishRunTimeoutNotice(threadId, runId);
                 }
-                this.terminalOutcome.evaluateTerminalResponse(threadId, runId, 'cancelled', {
+                await this.terminalOutcome.evaluateTerminalResponse(threadId, runId, 'cancelled', {
                     messageGroupId,
                     correlationId: messageId,
                 });
@@ -2380,7 +2508,7 @@ let InstanceAiService = class InstanceAiService {
                 ...(0, observability_1.buildInstanceAiObservabilityContext)(errCtx),
             });
             this.instanceAiErrorReporter.report(error, { component: 'instance-ai-run', ...errCtx });
-            this.terminalOutcome.evaluateTerminalResponse(threadId, runId, 'errored', {
+            await this.terminalOutcome.evaluateTerminalResponse(threadId, runId, 'errored', {
                 messageGroupId,
                 correlationId: messageId,
                 errorMessage: userFacingErrorMessage,
@@ -2631,6 +2759,7 @@ let InstanceAiService = class InstanceAiService {
         if (tracing) {
             environment.orchestrationContext.tracing = tracing;
         }
+        await this.bindAgentPreviewSession(environment.context, user);
         const mcpServers = await this.buildMcpServers(user, threadId, runId, tracing, environment.orchestrationContext.messageGroupId);
         const agent = await (0, instance_ai_1.createInstanceAgent)({
             modelId: environment.modelId,
@@ -2638,10 +2767,10 @@ let InstanceAiService = class InstanceAiService {
             orchestrationContext: environment.orchestrationContext,
             mcpServers,
             mcpManager: this.mcpClientManager,
-            memoryConfig: this.createAgentMemoryOptions(),
+            memoryConfig: this.createAgentMemoryOptions(user, threadId, runId),
             memory: environment.memory,
             checkpointStore: this.checkpointStore,
-            onMemoryTaskEvent: this.memoryTaskObserverFor(threadId),
+            onMemoryTaskEvent: this.memoryTaskObserverFor(threadId, tracing),
             thinkingEnabled: this.instanceAiConfig.thinkingEnabled,
         });
         this.subscribeToAgentErrors(agent, threadId, runId);
@@ -2725,6 +2854,15 @@ let InstanceAiService = class InstanceAiService {
             return null;
         }
     }
+    async canAccessAgentPreviewHandoff(user, projectId) {
+        const requiredScopes = ['agent:read', 'agent:update'];
+        return await (0, check_access_1.userHasScopes)(user, requiredScopes, false, { projectId });
+    }
+    async assertAgentPreviewHandoffScopes(user, projectId) {
+        if (!(await this.canAccessAgentPreviewHandoff(user, projectId))) {
+            throw new forbidden_error_1.ForbiddenError('You do not have permission to load or edit agent previews in this project.');
+        }
+    }
     async rebuildAgentForAutoSetupResume(user, threadId, runId, abortController, tracing, runHandoff, messageGroupId) {
         try {
             const rebuilt = await this.buildFreshInstanceAgent(user, threadId, runId, abortController.signal, tracing, messageGroupId, this.threadPushRef.get(threadId));
@@ -2938,7 +3076,7 @@ let InstanceAiService = class InstanceAiService {
                     });
                 }
                 const messageGroupId = this.tracing.getMessageGroupId(opts.runId);
-                const waitingDecision = this.terminalOutcome.evaluateWaitingResponse(opts.threadId, opts.runId, result.confirmationEvent, { messageGroupId });
+                const waitingDecision = await this.terminalOutcome.evaluateWaitingResponse(opts.threadId, opts.runId, result.confirmationEvent, { messageGroupId });
                 if (waitingDecision?.reason === 'confirmation-invalid') {
                     messageTraceFinalization = await this.terminalOutcome.finishInvalidConfirmationRun({
                         threadId: opts.threadId,
@@ -3012,7 +3150,7 @@ let InstanceAiService = class InstanceAiService {
             const userFacingErrorMessage = result.status === 'errored' ? getUserFacingErrorMessage(result.error) : undefined;
             const userFacingErrorCode = result.status === 'errored' ? getUserFacingErrorCode(result.error) : undefined;
             if (runControl.shouldEmitTerminalOutcome(result.stopReason)) {
-                this.terminalOutcome.evaluateTerminalResponse(opts.threadId, opts.runId, result.status, {
+                await this.terminalOutcome.evaluateTerminalResponse(opts.threadId, opts.runId, result.status, {
                     messageGroupId,
                     workSummary: result.workSummary,
                     errorMessage: userFacingErrorMessage,
@@ -3077,7 +3215,7 @@ let InstanceAiService = class InstanceAiService {
                 if (cancellationReason === liveness_1.INSTANCE_AI_RUN_TIMEOUT_REASON) {
                     this.liveness.publishRunTimeoutNotice(opts.threadId, opts.runId);
                 }
-                this.terminalOutcome.evaluateTerminalResponse(opts.threadId, opts.runId, 'cancelled', {
+                await this.terminalOutcome.evaluateTerminalResponse(opts.threadId, opts.runId, 'cancelled', {
                     messageGroupId,
                 });
                 await this.tracing.finalizeRunTracing(opts.runId, opts.tracing, {
@@ -3115,7 +3253,7 @@ let InstanceAiService = class InstanceAiService {
                 ...(0, observability_1.buildInstanceAiObservabilityContext)(errCtx),
             });
             this.instanceAiErrorReporter.report(error, { component: 'instance-ai-run', ...errCtx });
-            this.terminalOutcome.evaluateTerminalResponse(opts.threadId, opts.runId, 'errored', {
+            await this.terminalOutcome.evaluateTerminalResponse(opts.threadId, opts.runId, 'errored', {
                 messageGroupId,
                 errorMessage: userFacingErrorMessage,
                 errorCode: userFacingErrorCode,
@@ -3583,6 +3721,10 @@ let InstanceAiService = class InstanceAiService {
         }
         return '';
     }
+    async readDurableEventsForRuns(threadId, runIds) {
+        await this.eventLog.flush(threadId);
+        return await this.eventLog.getEventsForRuns(threadId, runIds);
+    }
     async saveAgentTreeSnapshot(threadId, runId, snapshotStorage, isUpdate = false, overrideMessageGroupId) {
         try {
             const messageGroupId = overrideMessageGroupId ?? this.runState.getMessageGroupId(threadId);
@@ -3594,10 +3736,14 @@ let InstanceAiService = class InstanceAiService {
                     const snapshot = await snapshotStorage.getLatest(threadId, { messageGroupId, runId });
                     groupRunIds = snapshot?.runIds?.length ? snapshot.runIds : [runId];
                 }
-                events = this.eventBus.getEventsForRuns(threadId, groupRunIds);
+                events = this.instanceAiConfig.durableLog
+                    ? await this.readDurableEventsForRuns(threadId, groupRunIds)
+                    : this.eventBus.getEventsForRuns(threadId, groupRunIds);
             }
             else {
-                events = this.eventBus.getEventsForRun(threadId, runId);
+                events = this.instanceAiConfig.durableLog
+                    ? await this.readDurableEventsForRuns(threadId, [runId])
+                    : this.eventBus.getEventsForRun(threadId, runId);
             }
             if (isUpdate && events.length === 0) {
                 this.logger.warn('Skipped updating empty Instance AI agent tree snapshot', {
@@ -3674,37 +3820,6 @@ __decorate([
 ], InstanceAiService.prototype, "stopCheckpointPruning", null);
 exports.InstanceAiService = InstanceAiService = __decorate([
     (0, di_1.Service)(),
-    __metadata("design:paramtypes", [backend_common_1.Logger,
-        config_1.GlobalConfig,
-        n8n_core_1.InstanceSettings,
-        instance_ai_adapter_service_1.InstanceAiAdapterService,
-        in_process_event_bus_1.InProcessEventBus,
-        instance_ai_settings_service_1.InstanceAiSettingsService,
-        instance_ai_gateway_service_1.InstanceAiGatewayService,
-        instance_ai_browser_session_service_1.InstanceAiBrowserSessionService,
-        instance_ai_memory_service_1.InstanceAiMemoryService,
-        typeorm_agent_memory_1.TypeORMAgentMemory,
-        typeorm_agent_checkpoint_store_1.TypeORMAgentCheckpointStore,
-        ai_service_1.AiService,
-        instance_ai_thread_grant_repository_1.InstanceAiThreadGrantRepository,
-        instance_ai_pending_confirmation_repository_1.InstanceAiPendingConfirmationRepository,
-        url_service_1.UrlService,
-        db_snapshot_storage_1.DbSnapshotStorage,
-        db_iteration_log_storage_1.DbIterationLogStorage,
-        source_control_preferences_service_ee_1.SourceControlPreferencesService,
-        telemetry_1.Telemetry,
-        mcp_1.InstanceAiMcpRegistryService,
-        db_1.UserRepository,
-        instance_ai_temporary_workflow_service_1.InstanceAiTemporaryWorkflowService,
-        n8n_core_1.ErrorReporter,
-        config_1.SsrfProtectionConfig,
-        backend_network_1.SsrfProtectionService,
-        event_service_1.EventService,
-        thread_credential_allowlist_service_1.EvalThreadCredentialAllowlistService,
-        instance_ai_run_probe_1.InstanceAiRunProbe,
-        instance_ai_model_service_1.InstanceAiModelService,
-        instance_ai_credit_service_1.InstanceAiCreditService,
-        publisher_service_1.Publisher,
-        instance_ai_error_reporter_service_1.InstanceAiErrorReporterService])
+    __metadata("design:paramtypes", [backend_common_1.Logger, config_1.GlobalConfig, n8n_core_1.InstanceSettings, instance_ai_adapter_service_1.InstanceAiAdapterService, in_process_event_bus_1.InProcessEventBus, durable_event_log_1.DurableEventLog, instance_ai_settings_service_1.InstanceAiSettingsService, instance_ai_gateway_service_1.InstanceAiGatewayService, instance_ai_browser_session_service_1.InstanceAiBrowserSessionService, instance_ai_memory_service_1.InstanceAiMemoryService, typeorm_agent_memory_1.TypeORMAgentMemory, typeorm_agent_checkpoint_store_1.TypeORMAgentCheckpointStore, ai_service_1.AiService, instance_ai_thread_grant_repository_1.InstanceAiThreadGrantRepository, instance_ai_pending_confirmation_repository_1.InstanceAiPendingConfirmationRepository, url_service_1.UrlService, db_snapshot_storage_1.DbSnapshotStorage, db_iteration_log_storage_1.DbIterationLogStorage, source_control_preferences_service_ee_1.SourceControlPreferencesService, telemetry_1.Telemetry, mcp_1.InstanceAiMcpRegistryService, db_1.UserRepository, instance_ai_temporary_workflow_service_1.InstanceAiTemporaryWorkflowService, n8n_core_1.ErrorReporter, config_1.SsrfProtectionConfig, backend_network_1.SsrfProtectionService, event_service_1.EventService, thread_credential_allowlist_service_1.EvalThreadCredentialAllowlistService, instance_ai_run_probe_1.InstanceAiRunProbe, instance_ai_model_service_1.InstanceAiModelService, instance_ai_credit_service_1.InstanceAiCreditService, publisher_service_1.Publisher, instance_ai_error_reporter_service_1.InstanceAiErrorReporterService])
 ], InstanceAiService);
 //# sourceMappingURL=instance-ai.service.js.map