import type { IDataObject, ISupplyDataFunctions } from 'n8n-workflow'; import { NodeConnectionType, NodeError } from 'n8n-workflow'; /** * LLM output structure for token usage parsing */ interface LLMOutput { tokenUsage?: { completionTokens?: number; promptTokens?: number; totalTokens?: number; completion_tokens?: number; prompt_tokens?: number; total_tokens?: number; }; usage?: { completionTokens?: number; promptTokens?: number; totalTokens?: number; completion_tokens?: number; prompt_tokens?: number; total_tokens?: number; }; } /** * Generation result structure */ interface Generation { text: string; generationInfo?: Record; } /** * LLM result structure */ interface LLMResult { generations: Generation[][]; llmOutput?: LLMOutput; } export type TokensUsageParser = (llmOutput?: LLMOutput) => { completionTokens: number; promptTokens: number; totalTokens: number; }; type RunDetail = { index: number; messages: string[] | string; options: IDataObject; }; /** * Callback handler interface for language model tracing * Compatible with n8n AI Agent nodes */ export declare class N8nLlmTracing { private executionFunctions; name: string; awaitHandlers: boolean; connectionType: NodeConnectionType; promptTokensEstimate: number; completionTokensEstimate: number; /** * A map to associate LLM run IDs to run details. * Key: Unique identifier for each LLM run (run ID) * Value: RunDetails object */ runsMap: Record; options: { tokensUsageParser: (llmOutput?: LLMOutput) => { completionTokens: number; promptTokens: number; totalTokens: number; }; errorDescriptionMapper: (error: NodeError) => string | null | undefined; }; constructor(executionFunctions: ISupplyDataFunctions, options?: { tokensUsageParser?: TokensUsageParser; errorDescriptionMapper?: (error: NodeError) => string; }); /** * Estimate tokens from generation results */ estimateTokensFromGeneration(generations: Generation[][]): Promise; /** * Estimate tokens from a list of strings * Uses simple character-based estimation as fallback */ estimateTokensFromStringList(list: string[]): Promise; /** * Handle LLM end event */ handleLLMEnd(output: LLMResult, runId: string): Promise; /** * Handle LLM start event */ handleLLMStart(llm: IDataObject | { type?: string; kwargs?: IDataObject; }, prompts: string[], runId: string): Promise; /** * Handle LLM error event */ handleLLMError(error: IDataObject | Error, runId: string, parentRunId?: string | undefined): Promise; } export {}; //# sourceMappingURL=N8nLlmTracing.d.ts.map