import type { AgentRevision, Variable, Message } from '@omniloq/db'; import { extractText, estimateTokens } from './text'; export interface BuildContextInput { agentRevision: AgentRevision; variables: Variable[]; /** Tous les messages de la conversation (le builder n'en charge jamais la totalité côté LLM). */ allMessages: Message[]; triggerMessage: Message; contactProfile?: Record; recentMessageCount?: number; maxContextTokens?: number; } export interface BuiltContext { system: string; prompt: string; systemTokens: number; promptTokens: number; totalTokens: number; truncated: boolean; includedMessageCount: number; variableNames: string[]; } const DEFAULT_RECENT = 20; const DEFAULT_MAX_TOKENS = 8000; function renderMessage(msg: Message): string { const role = msg.senderType === 'agent' || msg.senderType === 'human' ? 'Assistant' : 'Contact'; return `${role}: ${extractText(msg.content)}`; } /** Substitue {{key}} → value des variables de l'agent dans le system prompt. */ function applyVariables(systemPrompt: string, variables: Variable[]): string { let out = systemPrompt; for (const v of variables) { out = out.split(`{{${v.key}}}`).join(v.value); } return out; } /** * Construit le contexte LLM depuis la révision d'agent + variables + profil + derniers messages. * * Règle essentielle : on ne charge JAMAIS toute la conversation. On garde les * `recentMessageCount` derniers messages, puis on tronque les plus anciens pour * respecter `maxContextTokens` (budget approximatif en tokens). */ export function buildContext(input: BuildContextInput): BuiltContext { const recent = input.recentMessageCount ?? DEFAULT_RECENT; const maxTokens = input.maxContextTokens ?? DEFAULT_MAX_TOKENS; // 1. Variables agent substituées dans le system prompt let system = applyVariables(input.agentRevision.systemPrompt, input.variables); // 2. Profil contact (optionnel) ajouté au system prompt if (input.contactProfile && Object.keys(input.contactProfile).length > 0) { system += `\n\nProfil du contact : ${JSON.stringify(input.contactProfile)}`; } const systemTokens = estimateTokens(system); // 3. Derniers N messages (jamais toute la conversation) const sorted = [...input.allMessages].sort( (a, b) => a.createdAt.getTime() - b.createdAt.getTime() ); let selected = sorted.slice(-recent); let truncated = sorted.length > selected.length; // 4. Budget tokens : retirer les plus anciens tant que ça dépasse (on garde au moins le dernier message) while (selected.length > 1) { const prompt = selected.map(renderMessage).join('\n'); if (systemTokens + estimateTokens(prompt) <= maxTokens) break; selected = selected.slice(1); truncated = true; } const prompt = selected.map(renderMessage).join('\n'); const promptTokens = estimateTokens(prompt); return { system, prompt, systemTokens, promptTokens, totalTokens: systemTokens + promptTokens, truncated, includedMessageCount: selected.length, variableNames: input.variables.map((v) => v.key), }; }