import { type JSONObject } from '@n8n/agents'; import { type AssistantTracePayload, type InstanceAiEvent, type InstanceAiResourceAttachment, type InstanceAiThreadArtifactsContext } from '@n8n/api-types'; import { Logger } from '@n8n/backend-common'; import { type InstanceAiTraceContext, type ModelConfig, type ServiceProxyConfig } from '@n8n/instance-ai'; import type { AgentExecutionStreamChunk, SystemAgentTurn, SystemAgentTurnOutcome } from '../../../modules/agents/system-agents/system-agent.types'; import { InstanceAiBrowserSessionService } from '../browser/instance-ai-browser-session.service'; import { type TraceFileAttachment } from '../turn-setup/assistant-turn-trace-input'; interface TraceFinishOptions { reason?: string; completionSource?: string; } export interface AssistantTraceTurnSetup { runId: string; messageGroupId: string; proxyConfig?: ServiceProxyConfig; fileAttachments: TraceFileAttachment[]; contextAttachments: InstanceAiResourceAttachment[]; threadArtifacts?: InstanceAiThreadArtifactsContext; } export declare class AssistantTurnTrace { readonly context: InstanceAiTraceContext; private readonly runId; private readonly logger; private readonly orchestratorInputs; private readonly onFinished?; private readonly signals; private sawText; private outputText; private suspension; private finished; private firstResponseRecorded; private steeredMessageCount; constructor(context: InstanceAiTraceContext, runId: string, logger: Logger, orchestratorInputs?: Record, onFinished?: (() => void) | undefined); get payload(): AssistantTracePayload; hostMetadata(): JSONObject; private anchor; tracePromptBuild(inputs: Record, build: () => Promise, outputsOf: (result: T) => Record): Promise; startOrchestratorRun(): Promise; withContext(run: () => Promise): Promise; observeChunk(chunk: AgentExecutionStreamChunk): void; private recordSteeredMessage; private recordFirstResponse; observeEvent(event: InstanceAiEvent): void; finish(outcome: Pick, modelId?: ModelConfig, options?: TraceFinishOptions): Promise; } export declare class AssistantTurnTracer { private readonly browserSessionService; private readonly logger; private readonly openTraces; private closing; constructor(logger: Logger, browserSessionService: InstanceAiBrowserSessionService); startForTurn(turn: SystemAgentTurn, setup: AssistantTraceTurnSetup): Promise; private createForTurn; private startTurn; private resumeTurn; finishOpenTraces(): Promise; private commonOptions; private create; } export {};