n8n 2.45.6 → 2.46.1

package/dist/modules/instance-ai/instance-ai.service.d.ts

@@ -1,61 +1,46 @@
-import { type InstanceAiAttachment, type ComputerUseChannel, type InstanceAiBuildMode, type InstanceAiHandoffContext, type InstanceAiConfirmRequest, type InstanceAiCredits, type InstanceAiConfirmResponse, type InstanceAiThreadStatusResponse, type InstanceAiEvalThreadMemoryResponse, type InstanceAiThreadArtifactsContext } from '@n8n/api-types';
+import { type InstanceAiAttachment, type InstanceAiBuildMode, type InstanceAiHandoffContext, type InstanceAiConfirmRequest, type InstanceAiCredits, type InstanceAiConfirmResponse, type InstanceAiThreadStatusResponse, type InstanceAiEvalThreadMemoryResponse, type InstanceAiThreadArtifactsContext } from '@n8n/api-types';
 import { Logger } from '@n8n/backend-common';
-import { SsrfProtectionService } from '@n8n/backend-network';
-import { EventService, InstanceWriteAccessService, UrlService } from '@n8n/backend-services';
-import { GlobalConfig, SsrfProtectionConfig } from '@n8n/config';
+import { EventService } from '@n8n/backend-services';
+import { GlobalConfig } from '@n8n/config';
 import { UserRepository, type User } from '@n8n/db';
 import { type ModelConfig, type RunDebugRecord } from '@n8n/instance-ai';
 import { ErrorReporter, InstanceSettings } from 'n8n-core';
-import { UserError } from 'n8n-workflow';
-import { Push } from '../../push';
 import { Publisher } from '../../scaling/pubsub/publisher.service';
 import type { PubSubCommandMap } from '../../scaling/pubsub/pubsub.event-map';
-import { AiPreferenceService } from '../../services/ai-preference.service';
-import { AiUsageService } from '../../services/ai-usage.service';
 import { AiService } from '../../services/ai.service';
 import { Telemetry } from '../../telemetry';
-import { InstanceContextService } from './instance-context.service';
 import { InstanceAiBrowserSessionService } from './browser/instance-ai-browser-session.service';
 import { EvalThreadCredentialAllowlistService } from './eval/thread-credential-allowlist.service';
 import { DurableEventLog } from './event-bus/durable-event-log';
 import { InProcessEventBus } from './event-bus/in-process-event-bus';
 import { InterruptedRunSweeper } from './event-bus/interrupted-run-sweeper';
-import { InstanceAiConversationHistoryService } from './instance-ai-conversation-history.service';
 import { InstanceAiCreditService } from './instance-ai-credit.service';
 import { InstanceAiErrorReporterService } from './instance-ai-error-reporter.service';
-import { InstanceAiGatewayService } from './instance-ai-gateway.service';
 import { InstanceAiMemoryService } from './instance-ai-memory.service';
 import { InstanceAiModelService } from './instance-ai-model.service';
 import { InstanceAiRunProbe } from './instance-ai-run-probe';
 import { InstanceAiSettingsService } from './instance-ai-settings.service';
-import { InstanceAiSkillsService } from './instance-ai-skills.service';
 import { InstanceAiTemporaryWorkflowService } from './instance-ai-temporary-workflow.service';
 import { InstanceAiThreadTabsService } from './instance-ai-thread-tabs.service';
 import { InstanceAiAdapterService } from './instance-ai.adapter.service';
-import { InstanceAiMcpRegistryService } from './mcp';
 import { InstanceAiEventLogRepository } from './repositories/instance-ai-event-log.repository';
 import { InstanceAiObservationCursorRepository } from './repositories/instance-ai-observation-cursor.repository';
 import { InstanceAiObservationRepository } from './repositories/instance-ai-observation.repository';
 import { InstanceAiPendingConfirmationRepository } from './repositories/instance-ai-pending-confirmation.repository';
 import { InstanceAiThreadGrantRepository } from './repositories/instance-ai-thread-grant.repository';
-import { DbIterationLogStorage } from './storage/db-iteration-log-storage';
+import { SelfHealingAgentService, type SelfHealingRunInput, type SelfHealingRunLifecycle, type SelfHealingRunResult } from './self-healing/self-healing-agent.service';
 import { TypeORMAgentCheckpointStore } from './storage/typeorm-agent-checkpoint-store';
 import { TypeORMAgentMemory } from './storage/typeorm-agent-memory';
+import { AssistantAgentFactory } from './turn-setup/assistant-agent.factory';
+import { AssistantTurnEnvironmentFactory } from './turn-setup/assistant-turn-environment.factory';
+import { AssistantTurnInputBuilder } from './turn-setup/assistant-turn-input.builder';
+export { isAssistantCreditBalanceExhausted, QuotaExhaustedStreamError, } from './turn-setup/assistant-credits';
 export declare function isAttachmentRejectedByProviderError(error: unknown): boolean;
 export declare const QUOTA_EXHAUSTED_USER_MESSAGE = "You've run out of AI credits. Upgrade your plan to continue using the n8n Assistant.";
 export declare function getUserFacingErrorMessage(error: unknown, fallback?: string, opts?: {
     attachmentRemoved?: boolean;
 }): string;
 export declare function isMaskedStreamFailure(error: unknown): error is Error;
-export declare class QuotaExhaustedStreamError extends UserError {
-    readonly errorCode = "quota_exhausted";
-    constructor(maskedError: Error);
-}
-export declare function isAssistantCreditBalanceExhausted(credits: {
-    creditsQuota: number;
-    creditsClaimed: number;
-}): boolean;
-export declare function resolveOperatorPromptVersion(configured: string | undefined): string | undefined;
 export declare class InstanceAiService {
     private readonly instanceSettings;
     private readonly adapterService;
@@ -63,7 +48,6 @@ export declare class InstanceAiService {
     private readonly eventLog;
     private readonly interruptedRunSweeper;
     private readonly settingsService;
-    private readonly gatewayService;
     private readonly browserSessionService;
     private readonly memoryService;
     private readonly agentMemory;
@@ -73,12 +57,8 @@ export declare class InstanceAiService {
     private readonly pendingConfirmationRepo;
     private readonly observationRepo;
     private readonly observationCursorRepo;
-    private readonly urlService;
     private readonly eventLogRepository;
-    private readonly dbIterationLogStorage;
-    private readonly instanceWriteAccess;
     private readonly telemetry;
-    private readonly mcpRegistryService;
     private readonly userRepository;
     private readonly temporaryWorkflowService;
     private readonly errorReporter;
@@ -88,23 +68,15 @@ export declare class InstanceAiService {
     private readonly creditService;
     private readonly publisher;
     private readonly instanceAiErrorReporter;
-    private readonly push;
-    private readonly conversationHistoryService;
-    private readonly instanceContext;
-    private readonly aiPreferenceService;
-    private readonly aiUsageService;
     private readonly threadTabsService;
-    private readonly skillsService;
-    private _mcpClientManager?;
-    private readonly _ssrfProtectionConfig;
-    private readonly _ssrfProtectionService;
-    private get mcpClientManager();
+    private readonly selfHealingAgent;
+    private readonly turnEnvironment;
+    private readonly turnInput;
+    private readonly agentFactory;
     private readonly instanceAiConfig;
     private readonly aiConfig;
-    private readonly oauth2CallbackUrl;
-    private readonly webhookBaseUrl;
-    private readonly formBaseUrl;
     private readonly runState;
+    private readonly finalizingSelfHealingRuns;
     private readonly backgroundTasks;
     private readonly memoryTaskRegistry;
     private readonly tracing;
@@ -112,8 +84,6 @@ export declare class InstanceAiService {
     private readonly domainAccessTrackersByThread;
     private readonly threadPushRef;
     private readonly pendingBrowserCredentialSetups;
-    private readonly planRequestsByThread;
-    private readonly schedulerLocks;
     private readonly failedInternalFollowUpStreaks;
     private readonly terminalOutcome;
     private readonly liveness;
@@ -126,7 +96,7 @@ export declare class InstanceAiService {
     private readonly taskProjector;
     private readonly inFlightExecutions;
     private readonly preserveHitlOnShutdown;
-    constructor(logger: Logger, globalConfig: GlobalConfig, instanceSettings: InstanceSettings, adapterService: InstanceAiAdapterService, eventBus: InProcessEventBus, eventLog: DurableEventLog, interruptedRunSweeper: InterruptedRunSweeper, settingsService: InstanceAiSettingsService, gatewayService: InstanceAiGatewayService, browserSessionService: InstanceAiBrowserSessionService, memoryService: InstanceAiMemoryService, agentMemory: TypeORMAgentMemory, checkpointStore: TypeORMAgentCheckpointStore, aiService: AiService, threadGrantRepo: InstanceAiThreadGrantRepository, pendingConfirmationRepo: InstanceAiPendingConfirmationRepository, observationRepo: InstanceAiObservationRepository, observationCursorRepo: InstanceAiObservationCursorRepository, urlService: UrlService, eventLogRepository: InstanceAiEventLogRepository, dbIterationLogStorage: DbIterationLogStorage, instanceWriteAccess: InstanceWriteAccessService, telemetry: Telemetry, mcpRegistryService: InstanceAiMcpRegistryService, userRepository: UserRepository, temporaryWorkflowService: InstanceAiTemporaryWorkflowService, errorReporter: ErrorReporter, ssrfProtectionConfig: SsrfProtectionConfig, ssrfProtectionService: SsrfProtectionService, eventService: EventService, evalCredentialAllowlists: EvalThreadCredentialAllowlistService, runProbe: InstanceAiRunProbe, modelService: InstanceAiModelService, creditService: InstanceAiCreditService, publisher: Publisher, instanceAiErrorReporter: InstanceAiErrorReporterService, push: Push, conversationHistoryService: InstanceAiConversationHistoryService, instanceContext: InstanceContextService, aiPreferenceService: AiPreferenceService, aiUsageService: AiUsageService, threadTabsService: InstanceAiThreadTabsService, skillsService: InstanceAiSkillsService);
+    constructor(logger: Logger, globalConfig: GlobalConfig, instanceSettings: InstanceSettings, adapterService: InstanceAiAdapterService, eventBus: InProcessEventBus, eventLog: DurableEventLog, interruptedRunSweeper: InterruptedRunSweeper, settingsService: InstanceAiSettingsService, browserSessionService: InstanceAiBrowserSessionService, memoryService: InstanceAiMemoryService, agentMemory: TypeORMAgentMemory, checkpointStore: TypeORMAgentCheckpointStore, aiService: AiService, threadGrantRepo: InstanceAiThreadGrantRepository, pendingConfirmationRepo: InstanceAiPendingConfirmationRepository, observationRepo: InstanceAiObservationRepository, observationCursorRepo: InstanceAiObservationCursorRepository, eventLogRepository: InstanceAiEventLogRepository, telemetry: Telemetry, userRepository: UserRepository, temporaryWorkflowService: InstanceAiTemporaryWorkflowService, errorReporter: ErrorReporter, eventService: EventService, evalCredentialAllowlists: EvalThreadCredentialAllowlistService, runProbe: InstanceAiRunProbe, modelService: InstanceAiModelService, creditService: InstanceAiCreditService, publisher: Publisher, instanceAiErrorReporter: InstanceAiErrorReporterService, threadTabsService: InstanceAiThreadTabsService, selfHealingAgent: SelfHealingAgentService, turnEnvironment: AssistantTurnEnvironmentFactory, turnInput: AssistantTurnInputBuilder, agentFactory: AssistantAgentFactory);
     private createProxyRunConfig;
     resolveAgentModelConfig(user: User): Promise<ModelConfig>;
     private loadThreadSessionGrants;
@@ -143,7 +113,6 @@ export declare class InstanceAiService {
     isRunLive(threadId: string, runId: string): boolean;
     getThreadStatus(threadId: string): InstanceAiThreadStatusResponse;
     private memoryTaskObserverFor;
-    private subscribeToAgentErrors;
     isRunDebugEnabled(): boolean;
     private buildOrchestratorAgentStreamOptions;
     private buildOrchestratorResumeAgentOptions;
@@ -163,7 +132,8 @@ export declare class InstanceAiService {
         comment?: string;
     }): Promise<void>;
     private assertRunAdmissible;
-    startRun(user: User, threadId: string, message: string, attachments?: InstanceAiAttachment[], context?: InstanceAiHandoffContext, timeZone?: string, pushRef?: string, mode?: InstanceAiBuildMode, promptVersion?: string, computerUseChannels?: ComputerUseChannel[], threadArtifacts?: InstanceAiThreadArtifactsContext, observerThresholdTokens?: number): string;
+    startSelfHealingRun(input: SelfHealingRunInput, lifecycle: SelfHealingRunLifecycle): Promise<SelfHealingRunResult>;
+    startRun(user: User, threadId: string, message: string, attachments?: InstanceAiAttachment[], context?: InstanceAiHandoffContext, timeZone?: string, pushRef?: string, mode?: InstanceAiBuildMode, promptVersion?: string, browserUseAvailable?: boolean, threadArtifacts?: InstanceAiThreadArtifactsContext, observerThresholdTokens?: number): string;
     getMessageGroupId(threadId: string): string | undefined;
     getLiveMessageGroupId(threadId: string): string | undefined;
     getRunIdsForMessageGroup(messageGroupId: string): string[];
@@ -206,27 +176,11 @@ export declare class InstanceAiService {
     pruneExpiredData(now?: number, signal?: AbortSignal): Promise<void>;
     private hardDeleteExpiredCheckpoints;
     private pruneExpiredThreads;
-    private createAgentMemoryOptions;
-    private createWorkflowTaskServiceWithUiSync;
     private trackWorkflowVerificationObligation;
-    private buildPlannedTaskFollowUpMessage;
-    private buildWorkflowVerificationFollowUpMessage;
-    private createPlannedTaskState;
     replayUndeliveredTerminalOutcomes(threadId: string): Promise<void>;
-    private syncPlannedTasksToUi;
-    private cancelAwaitingApprovalPlan;
     areMcpConnectionsAvailable(): boolean;
     private createExecutionEnvironment;
-    private getAgentExecutionService;
-    private bindAgentContextReader;
-    private bindAgentPreviewSession;
-    private dispatchPlannedTask;
-    private collectWorkflowIds;
-    private getBuildTaskWorkflowName;
-    private checkpointRequiresRunApproval;
-    private getCheckpointRunPolicy;
-    private handlePlannedTaskSettlement;
-    private buildWorkflowSetupStateBlock;
+    private createTurnRuntime;
     private buildWorkflowSetupFollowUpMessage;
     private getWorkflowSetupSuspensionWorkflowId;
     private markWorkflowSetupHandled;
@@ -238,37 +192,15 @@ export declare class InstanceAiService {
     private releaseWorkItemSetupRoutingClaim;
     private updateInternalFollowUpFailureStreak;
     private startInternalFollowUpRun;
-    private schedulePlannedTasks;
-    private createPlannedTaskActionRunner;
-    private createPlannedTaskView;
-    private createPlannedTaskRunGate;
-    private createPlannedTaskDispatcher;
-    private createPlannedTaskFollowUps;
-    private createPlannedWorkflowVerificationGate;
-    private toWorkflowVerificationSourceTask;
-    private createPlannedWorkflowVerificationTracker;
-    private createPlannedTaskDispatchContext;
-    private doSchedulePlannedTasks;
     private persistInterruptedUserMessage;
     private resolveContextAttachments;
     private readThreadProvenance;
     private executeRun;
-    private finalizeCheckpointFollowUp;
-    private finalizePlannedBuildFollowUp;
     resolveConfirmation(requestingUserId: string, requestId: string, request: InstanceAiConfirmRequest): Promise<InstanceAiConfirmResponse | null>;
-    private buildMcpServers;
     private createAgentFromEnvironment;
     private buildFreshInstanceAgent;
     private rebuildSuspendedRunFromCheckpoint;
     private revalidateActiveUser;
-    private resolveBoundProject;
-    private resolveAiPreferencesTurn;
-    private findAiPreferencesHistory;
-    private resolveThreadArtifactsTurn;
-    private findLastThreadArtifactsBlock;
-    private getReplayedMessages;
-    private canAccessAgentPreviewHandoff;
-    private assertAgentPreviewHandoffScopes;
     private rebuildAgentForResume;
     private resumeSuspendedRun;
     private processResumedStream;
@@ -276,7 +208,6 @@ export declare class InstanceAiService {
     private emitTerminalRun;
     private bestEffort;
     private snapshotAttachedAgents;
-    private buildMessageWithRunningTasks;
     private trackConfirmationRequest;
     private finalizeCancelledSuspendedRun;
     private publishRunFinish;
@@ -287,12 +218,9 @@ export declare class InstanceAiService {
     private static readonly BLOCK_CHARS_PER_TOKEN;
     private persistSuspendedInstanceContext;
     private instanceContextTurnBinding;
-    private observeInstanceContextEvents;
+    private createRunEventBus;
     private emitInstanceContextTurn;
     private emitRunMetrics;
     private refineTitleIfNeeded;
-    private extractStoredMessageText;
     private readRunEvents;
-    private parseMcpServers;
-    private trackMcpToolCall;
 }