@resolveio/server-lib 22.3.151 → 22.3.153

package/methods/ai-terminal.js

@@ -170,6 +170,7 @@ var promises_1 = require("timers/promises");
 var worker_threads_1 = require("worker_threads");
 var child_process_1 = require("child_process");
 var util_1 = require("util");
+var crypto_1 = require("crypto");
 var mongodb_1 = require("mongodb");
 var simpl_schema_1 = require("simpl-schema");
 var resolveio_server_app_1 = require("../resolveio-server-app");
@@ -181,9 +182,11 @@ var common_1 = require("../util/common");
 var tokenizer_1 = require("../util/tokenizer");
 var codex_client_1 = require("../services/codex-client");
 var openai_usage_ledger_manager_1 = require("../managers/openai-usage-ledger.manager");
+var ai_run_evidence_manager_1 = require("../managers/ai-run-evidence.manager");
 var assistant_core_heuristics_1 = require("../ai/assistant-core-heuristics");
 var resolveio_platform_intelligence_memory_1 = require("../ai/resolveio-platform-intelligence-memory");
 var ai_qa_policy_1 = require("../util/ai-qa-policy");
+var ai_run_evidence_adapters_1 = require("../util/ai-run-evidence-adapters");
 var DEFAULT_MAX_FILE_MB = 50;
 var DEFAULT_MAX_TOTAL_MB = 100;
 var DEFAULT_MAX_ATTACHMENT_CHARS = 12000;
@@ -1361,7 +1364,7 @@ function loadAiTerminalMethods(methodManager) {
 }
 function executeAiTerminalRun(payload, context) {
     return __awaiter(this, void 0, void 0, function () {
-        var input, message, requestId, identityGuardrail, conversation_1, now_1, userMsg, assistantMsg, isSuperAdmin, guardrailsEnabled, guardrail, conversation_2, now_2, userMsg, assistantMsg, conversation, now, attachments, attachmentData, config, systemPrompt, userPromptTemplate, userPrompt, historyLimit, history, _a, messages, codexModel, codexFallbackModels, codexSettings, client, responseText, usage, idClient, userDoc, assistantDoc, insertResult;
+        var input, message, requestId, identityGuardrail, conversation_1, now_1, userMsg, assistantMsg, isSuperAdmin, guardrailsEnabled, guardrail, conversation_2, now_2, userMsg, assistantMsg, conversation, now, attachments, attachmentData, config, systemPrompt, userPromptTemplate, userPrompt, historyLimit, history, _a, messages, codexModel, codexFallbackModels, codexSettings, client, responseText, usage, idClient, usageLedgerEntry, userDoc, assistantDoc, userInsertResult, insertResult, assistantMessageId, userMessageId;
         return __generator(this, function (_b) {
             switch (_b.label) {
                 case 0:
@@ -1510,24 +1513,23 @@ function executeAiTerminalRun(payload, context) {
                     return [4 /*yield*/, resolveClientId(conversation, input.id_client, context === null || context === void 0 ? void 0 : context.id_user)];
                 case 18:
                     idClient = _b.sent();
-                    return [4 /*yield*/, (0, openai_usage_ledger_manager_1.recordOpenAIUsage)({
-                            id_client: idClient || '',
-                            model: codexModel || 'unknown',
-                            input_tokens: usage.inputTokens,
-                            output_tokens: usage.outputTokens,
-                            total_tokens: usage.totalTokens,
-                            category: 'ai-terminal',
-                            id_conversation: conversation._id,
-                            usage_source: 'ai_assistant',
-                            usage_surface: 'assistant',
-                            usage_phase: 'chat',
-                            cost_basis: 'estimated_tokens',
-                            id_app: String((conversation === null || conversation === void 0 ? void 0 : conversation.id_app) || ''),
-                            metadata: {
-                                conversationId: conversation._id,
-                                requestId: input.request_id || ''
-                            }
-                        })];
+                    usageLedgerEntry = buildAssistantAIRunUsageLedgerEntry({
+                        idClient: idClient || '',
+                        model: codexModel || 'unknown',
+                        inputTokens: usage.inputTokens,
+                        outputTokens: usage.outputTokens,
+                        totalTokens: usage.totalTokens,
+                        category: 'ai-terminal',
+                        conversationId: conversation._id,
+                        requestId: input.request_id || '',
+                        usagePhase: 'chat',
+                        idApp: String((conversation === null || conversation === void 0 ? void 0 : conversation.id_app) || ''),
+                        metadata: {
+                            conversationId: conversation._id,
+                            requestId: input.request_id || ''
+                        }
+                    });
+                    return [4 /*yield*/, (0, openai_usage_ledger_manager_1.recordOpenAIUsage)(usageLedgerEntry)];
                 case 19:
                     _b.sent();
                     userDoc = {
@@ -1555,19 +1557,33 @@ function executeAiTerminalRun(payload, context) {
                     };
                     return [4 /*yield*/, ai_terminal_message_collection_1.AiTerminalMessages.insertOne(userDoc)];
                 case 20:
-                    _b.sent();
+                    userInsertResult = _b.sent();
                     return [4 /*yield*/, ai_terminal_message_collection_1.AiTerminalMessages.insertOne(assistantDoc)];
                 case 21:
                     insertResult = _b.sent();
-                    return [4 /*yield*/, touchConversation(conversation._id, now, insertResult._id)];
+                    assistantMessageId = String((insertResult === null || insertResult === void 0 ? void 0 : insertResult._id) || (insertResult === null || insertResult === void 0 ? void 0 : insertResult.insertedId) || '');
+                    userMessageId = String((userInsertResult === null || userInsertResult === void 0 ? void 0 : userInsertResult._id) || (userInsertResult === null || userInsertResult === void 0 ? void 0 : userInsertResult.insertedId) || '');
+                    return [4 /*yield*/, touchConversation(conversation._id, now, assistantMessageId)];
                 case 22:
                     _b.sent();
-                    if (!(input.delete_files_after_run !== false)) return [3 /*break*/, 24];
-                    return [4 /*yield*/, cleanupAttachments(attachmentData.attachments)];
+                    return [4 /*yield*/, recordAssistantAnswerAIRun({
+                            runId: buildAssistantAIRunId('chat', [conversation._id, assistantMessageId || input.request_id]),
+                            requestId: input.request_id,
+                            messageId: assistantMessageId,
+                            conversation: conversation,
+                            userMessage: __assign(__assign({}, userDoc), { _id: userMessageId || undefined }),
+                            assistantMessage: __assign(__assign({}, assistantDoc), { _id: assistantMessageId || undefined }),
+                            usageLedgerEntry: usageLedgerEntry,
+                            now: now
+                        })];
                 case 23:
                     _b.sent();
-                    _b.label = 24;
-                case 24: return [2 /*return*/, {
+                    if (!(input.delete_files_after_run !== false)) return [3 /*break*/, 25];
+                    return [4 /*yield*/, cleanupAttachments(attachmentData.attachments)];
+                case 24:
+                    _b.sent();
+                    _b.label = 25;
+                case 25: return [2 /*return*/, {
                         conversation: conversation,
                         message: assistantDoc,
                         usage: assistantDoc.usage
@@ -1578,7 +1594,7 @@ function executeAiTerminalRun(payload, context) {
 }
 function executeAiFormPatch(payload, context) {
     return __awaiter(this, void 0, void 0, function () {
-        var input, message, allowedFields, guardrail, systemPrompt, userPrompt, messages, config, codexModel, codexFallbackModels, codexSettings, client, responseText, usage, idClient, parsed;
+        var input, message, allowedFields, guardrail, systemPrompt, userPrompt, messages, config, codexModel, codexFallbackModels, codexSettings, client, responseText, usage, idClient, usageLedgerEntry, parsed, formRunId;
         var _a;
         return __generator(this, function (_b) {
             switch (_b.label) {
@@ -1628,27 +1644,62 @@ function executeAiFormPatch(payload, context) {
                     return [4 /*yield*/, resolveClientIdFromConfig(input.id_client, context === null || context === void 0 ? void 0 : context.id_user)];
                 case 2:
                     idClient = _b.sent();
-                    return [4 /*yield*/, (0, openai_usage_ledger_manager_1.recordOpenAIUsage)({
-                            id_client: idClient || '',
-                            model: codexModel || 'unknown',
-                            input_tokens: usage.inputTokens,
-                            output_tokens: usage.outputTokens,
-                            total_tokens: usage.totalTokens,
-                            category: 'ai-form',
-                            usage_source: 'ai_assistant',
-                            usage_surface: 'assistant',
-                            usage_phase: 'form_patch',
-                            cost_basis: 'estimated_tokens',
-                            metadata: {
-                                route: input.route || ''
-                            }
-                        })];
+                    usageLedgerEntry = buildAssistantAIRunUsageLedgerEntry({
+                        idClient: idClient || '',
+                        model: codexModel || 'unknown',
+                        inputTokens: usage.inputTokens,
+                        outputTokens: usage.outputTokens,
+                        totalTokens: usage.totalTokens,
+                        category: 'ai-form',
+                        requestId: (0, crypto_1.createHash)('sha1').update("".concat(input.route || '', ":").concat(message, ":").concat(responseText)).digest('hex').slice(0, 24),
+                        usagePhase: 'form_patch',
+                        idApp: input.id_app || '',
+                        metadata: {
+                            route: input.route || ''
+                        }
+                    });
+                    return [4 /*yield*/, (0, openai_usage_ledger_manager_1.recordOpenAIUsage)(usageLedgerEntry)];
                 case 3:
                     _b.sent();
                     parsed = parseJsonObject(responseText);
                     if (!parsed || typeof parsed !== 'object') {
                         throw new Error('AI form patch response was not valid JSON.');
                     }
+                    formRunId = buildAssistantAIRunId('form_patch', [input.route, usageLedgerEntry.id_request]);
+                    return [4 /*yield*/, recordAssistantAnswerAIRun({
+                            runId: formRunId,
+                            requestId: String(usageLedgerEntry.id_request || ''),
+                            messageId: formRunId,
+                            conversation: {
+                                _id: "ai-form:".concat(usageLedgerEntry.id_request),
+                                id_app: input.id_app || '',
+                                title: input.route ? "AI form patch: ".concat(input.route) : 'AI form patch',
+                                status: 'complete',
+                                updatedAt: new Date()
+                            },
+                            userMessage: {
+                                _id: "".concat(formRunId, ":user"),
+                                role: 'user',
+                                content: message,
+                                createdAt: new Date()
+                            },
+                            assistantMessage: {
+                                _id: "".concat(formRunId, ":assistant"),
+                                role: 'assistant',
+                                content: responseText,
+                                usage: {
+                                    model: codexModel || 'unknown',
+                                    input_tokens: usage.inputTokens,
+                                    output_tokens: usage.outputTokens,
+                                    total_tokens: usage.totalTokens
+                                },
+                                createdAt: new Date()
+                            },
+                            usageLedgerEntry: usageLedgerEntry,
+                            now: new Date()
+                        })];
+                case 4:
+                    _b.sent();
                     return [2 /*return*/, {
                             patch: (_a = parsed.patch) !== null && _a !== void 0 ? _a : parsed,
                             notes: normalizeOptionalString(parsed.notes) || undefined,
@@ -1665,7 +1716,7 @@ function executeAiFormPatch(payload, context) {
 }
 function executeAiAssistantCodexRun(payload, context) {
     return __awaiter(this, void 0, void 0, function () {
-        var input, message, aiWorkerDebug, requestId, codexModel, codexFallbackModels, user, isSuperAdmin, guardrail, conversation_3, now_3, userMsg, assistantMsg, canViewDebug, hasInvoiceAccess, customerId, conversation, now, attachments, navigationFastPath, userMsg, assistantMsg, assistantInsert, assistantMessageId_1, changeHistoryFastPath, changeHistoryFastPathBypassedReason, userMsg, assistantMsg, assistantInsert, assistantMessageId_2, userMsg, assistantMsg, assistantInsert, assistantMessageId_3, attachmentData, historyLines, recentToolError, userDoc, initialProgress, assistantDoc, insertResult, assistantMessageId;
+        var input, message, aiWorkerDebug, requestId, codexModel, codexFallbackModels, user, isSuperAdmin, guardrail, conversation_3, now_3, userMsg, assistantMsg, canViewDebug, hasInvoiceAccess, customerId, conversation, now, attachments, navigationFastPath, userMsg, assistantMsg, assistantInsert, assistantMessageId_1, changeHistoryFastPath, changeHistoryFastPathBypassedReason, userMsg, assistantMsg, assistantInsert, assistantMessageId_2, userMsg, assistantMsg, assistantInsert, assistantMessageId_3, attachmentData, historyLines, recentToolError, userDoc, initialProgress, assistantDoc, userInsertResult, userMessageId, insertResult, assistantMessageId;
         var _this = this;
         var _a, _b, _c;
         return __generator(this, function (_d) {
@@ -1911,16 +1962,17 @@ function executeAiAssistantCodexRun(payload, context) {
                     };
                     return [4 /*yield*/, ai_terminal_message_collection_1.AiTerminalMessages.insertOne(userDoc)];
                 case 22:
-                    _d.sent();
+                    userInsertResult = _d.sent();
+                    userMessageId = (userInsertResult === null || userInsertResult === void 0 ? void 0 : userInsertResult._id) || (userInsertResult === null || userInsertResult === void 0 ? void 0 : userInsertResult.insertedId);
                     return [4 /*yield*/, ai_terminal_message_collection_1.AiTerminalMessages.insertOne(assistantDoc)];
                 case 23:
                     insertResult = _d.sent();
                     assistantMessageId = (insertResult === null || insertResult === void 0 ? void 0 : insertResult._id) || (insertResult === null || insertResult === void 0 ? void 0 : insertResult.insertedId);
                     enqueueAssistantCodexRun(function () { return __awaiter(_this, void 0, void 0, function () {
-                        var runStart, fastModeEnabled, alwaysAllowProbeEnabled, plannerEnabled, runBudgetMs, assistantMongoMaxTimeMs, assistantSystemPrompt, runDeadlineMs, steps, recordStep, requestClassification, dataQuestion, progressTracker, streamProgress, remainingRunBudgetMs, hasRunBudget, applyCodexStageBudget, assistantContent, toolResult, assistantDebug, directiveSource, lastDirective, heuristicDirectivePrecomputed, usedDeterministicHeuristicFastPath, requestedTimeGrain, requestedBreakdownDimensions, enforceDatedDirective, enforceGroupedDirective, datedDirectiveRetryUsed, datedDirectiveResolved, toolResponseDebug, toolError, toolTelemetry, termHints, collectionHints, fieldHints, schemaHints, methodHints, publicationHints, collectionTokenization, collectionRanking, collectionSelection, collectionOverride, collectionNames, plannerUsed, plannerSkipReason, plannerOutput, plannerRaw, timingBreakdown, codexUsage, accumulateCodexUsage, contextRoute, contextMode, hintSeed, termExpansion, hintText, baseTokens, expandedTokens, baseWeights, expandedWeights, dbName, db, surfaceHints, _a, allowedRoutes, rankedAllowedRoutes, routeHints, appCollectionHints, rankedCollectionHints, rankedCollections, hintCollections, schemaHintCollections, assistantContext, hasDeterministicHeuristicFastPath, prompt_1, workspaceRoot, codexConfig, runOptions, plannerRunOptions, shouldRunPlanner, plannerBudgetAvailable, plannerPrompt, plannerStart, _b, preferListDirective, directiveStyleHint, directivePromptMode, responseText, directiveText, directive, heuristicDirectiveFastPath, directivePrompt, directiveStart, forcedDirective, _c, initialStart, extractedDirective, error_2, directivePrompt, forcedStart, forcedDirective, _d, strictDirectivePrompt, strictStart, strictDirectiveText, strictDirective, strictDirectiveIsDated, shouldUseStrictDirective, _e, guardDirectivePrompt, guardStart, guardDirectiveText, guardDirective, _f, groupedDirectivePrompt, groupedStart, groupedDirectiveText, groupedDirective, _g, heuristicDirective, requestedCollection, allowCollectionOverride, cleanedResponseText, deniedModuleByIntent, permissionLabel, effectiveDirective, effectiveDirectiveMetadata, directiveAcknowledgementText, directiveProgressMessages, deterministicDataIntentDirective, rankedCollections_1, directiveHintsBase_1, buildToolRequestForDirective, executionDirective, probeFieldHints, aggregateProbeDisabled, probeEnabled, probeBudgetAllowed, probeDirective, probeRequest, probeStart, probeResponse, _h, probeDurationMs, probeRowCount, probeRewrite, probeError_1, probeDurationMs, probeErrorMessage, toolRequest, requestedToolCollection, toolStart, toolResponse, _j, toolDurationMs, toolPayload, resolvedToolCollection, zeroRowResult, followupCodexEnabled, skipFollowupCodex, followupPrompt, followupStart, followupText, _k, error_3, errorMessage, existingFinal, error_4, runBudgetExceeded, includeToolExecutionTelemetry, toolExecutionTelemetry, finishedAt, finalNow, finishedAt, codexMs, draftingMs, finalMetadata, finalUsage, usageClientId, usageError_1, finalAssistantDoc, setPayload, finalizeError_1, failedAt, fallbackContent, failureMetadata, persistError_1, _l;
-                        var _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12, _13, _14, _15, _16, _17, _18, _19, _20, _21;
-                        return __generator(this, function (_22) {
-                            switch (_22.label) {
+                        var runStart, fastModeEnabled, alwaysAllowProbeEnabled, plannerEnabled, runBudgetMs, assistantMongoMaxTimeMs, assistantSystemPrompt, runDeadlineMs, steps, recordStep, requestClassification, dataQuestion, progressTracker, streamProgress, remainingRunBudgetMs, hasRunBudget, applyCodexStageBudget, assistantContent, toolResult, assistantDebug, directiveSource, lastDirective, heuristicDirectivePrecomputed, usedDeterministicHeuristicFastPath, requestedTimeGrain, requestedBreakdownDimensions, enforceDatedDirective, enforceGroupedDirective, datedDirectiveRetryUsed, datedDirectiveResolved, toolResponseDebug, toolError, toolTelemetry, termHints, collectionHints, fieldHints, schemaHints, methodHints, publicationHints, collectionTokenization, collectionRanking, collectionSelection, collectionOverride, collectionNames, plannerUsed, plannerSkipReason, plannerOutput, plannerRaw, timingBreakdown, codexUsage, accumulateCodexUsage, contextRoute, contextMode, hintSeed, termExpansion, hintText, baseTokens, expandedTokens, baseWeights, expandedWeights, dbName, db, surfaceHints, _a, allowedRoutes, rankedAllowedRoutes, routeHints, appCollectionHints, rankedCollectionHints, rankedCollections, hintCollections, schemaHintCollections, assistantContext, hasDeterministicHeuristicFastPath, prompt_1, workspaceRoot, codexConfig, runOptions, plannerRunOptions, shouldRunPlanner, plannerBudgetAvailable, plannerPrompt, plannerStart, _b, preferListDirective, directiveStyleHint, directivePromptMode, responseText, directiveText, directive, heuristicDirectiveFastPath, directivePrompt, directiveStart, forcedDirective, _c, initialStart, extractedDirective, error_2, directivePrompt, forcedStart, forcedDirective, _d, strictDirectivePrompt, strictStart, strictDirectiveText, strictDirective, strictDirectiveIsDated, shouldUseStrictDirective, _e, guardDirectivePrompt, guardStart, guardDirectiveText, guardDirective, _f, groupedDirectivePrompt, groupedStart, groupedDirectiveText, groupedDirective, _g, heuristicDirective, requestedCollection, allowCollectionOverride, cleanedResponseText, deniedModuleByIntent, permissionLabel, effectiveDirective, effectiveDirectiveMetadata, directiveAcknowledgementText, directiveProgressMessages, deterministicDataIntentDirective, rankedCollections_1, directiveHintsBase_1, buildToolRequestForDirective, executionDirective, probeFieldHints, aggregateProbeDisabled, probeEnabled, probeBudgetAllowed, probeDirective, probeRequest, probeStart, probeResponse, _h, probeDurationMs, probeRowCount, probeRewrite, probeError_1, probeDurationMs, probeErrorMessage, toolRequest, requestedToolCollection, toolStart, toolResponse, _j, toolDurationMs, toolPayload, resolvedToolCollection, zeroRowResult, followupCodexEnabled, skipFollowupCodex, followupPrompt, followupStart, followupText, _k, error_3, errorMessage, existingFinal, error_4, runBudgetExceeded, includeToolExecutionTelemetry, toolExecutionTelemetry, finishedAt, finalNow, finishedAt, codexMs, draftingMs, finalMetadata, finalUsage, finalUsageLedgerEntry, usageClientId, usageError_1, finalAssistantDoc, setPayload, finalizeError_1, failedAt, fallbackContent, failureMetadata, persistError_1, _l;
+                        var _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12, _13, _14, _15, _16, _17, _18, _19, _20, _21, _22;
+                        return __generator(this, function (_23) {
+                            switch (_23.label) {
                                 case 0:
                                     runStart = Date.now();
                                     fastModeEnabled = resolveAssistantFastModeEnabled(input.config);
@@ -2061,9 +2113,9 @@ function executeAiAssistantCodexRun(payload, context) {
                                         source: requestClassification.source,
                                         dataQuestion: dataQuestion
                                     });
-                                    _22.label = 1;
+                                    _23.label = 1;
                                 case 1:
-                                    _22.trys.push([1, 68, 69, 70]);
+                                    _23.trys.push([1, 68, 69, 70]);
                                     hintSeed = [message, contextRoute].filter(Boolean).join(' ');
                                     termExpansion = expandAssistantTermSynonyms(hintSeed);
                                     hintText = termExpansion.expanded || hintSeed;
@@ -2084,19 +2136,19 @@ function executeAiAssistantCodexRun(payload, context) {
                                     recordStep('Planning: term expansion', {
                                         termMatches: termExpansion.matches.length ? termExpansion.matches : undefined
                                     });
-                                    _22.label = 2;
+                                    _23.label = 2;
                                 case 2:
-                                    _22.trys.push([2, 5, , 6]);
+                                    _23.trys.push([2, 5, , 6]);
                                     dbName = resolveAssistantDatabaseName(undefined, input.mongo);
                                     db = resolveio_server_app_1.ResolveIOServer.getMongoConnection().db(dbName);
                                     return [4 /*yield*/, listAssistantCollections(db, dbName)];
                                 case 3:
-                                    collectionNames = _22.sent();
+                                    collectionNames = _23.sent();
                                     collectionHints = resolveCollectionHintsFromTokens(expandedTokens, collectionNames, 5);
                                     collectionRanking = buildCollectionRankingDebugFromTokens(expandedTokens, collectionNames, 8);
                                     return [4 /*yield*/, resolveAssistantSurfaceHints(hintSeed, contextRoute, collectionNames)];
                                 case 4:
-                                    surfaceHints = _22.sent();
+                                    surfaceHints = _23.sent();
                                     methodHints = surfaceHints.methodHints;
                                     publicationHints = surfaceHints.publicationHints;
                                     if (surfaceHints.collectionHints.length) {
@@ -2104,7 +2156,7 @@ function executeAiAssistantCodexRun(payload, context) {
                                     }
                                     return [3 /*break*/, 6];
                                 case 5:
-                                    _a = _22.sent();
+                                    _a = _23.sent();
                                     collectionHints = [];
                                     collectionRanking = collectionRanking || ((collectionTokenization === null || collectionTokenization === void 0 ? void 0 : collectionTokenization.expandedTokens)
                                         ? buildCollectionRankingDebugFromTokens(collectionTokenization.expandedTokens || [], [], 0)
@@ -2184,7 +2236,7 @@ function executeAiAssistantCodexRun(payload, context) {
                                     prompt_1 = buildAssistantCodexPrompt(message, attachmentData.promptText, historyLines.join('\n'), assistantContext, assistantSystemPrompt);
                                     return [4 /*yield*/, resolveAssistantWorkspaceRoot()];
                                 case 7:
-                                    workspaceRoot = _22.sent();
+                                    workspaceRoot = _23.sent();
                                     codexConfig = resolveCodexSettings({
                                         model: codexModel,
                                         fallbackModels: codexFallbackModels
@@ -2233,20 +2285,20 @@ function executeAiAssistantCodexRun(payload, context) {
                                         publicationHints: publicationHints,
                                         inputClientId: input.id_client
                                     });
-                                    _22.label = 8;
+                                    _23.label = 8;
                                 case 8:
-                                    _22.trys.push([8, 10, , 11]);
+                                    _23.trys.push([8, 10, , 11]);
                                     plannerStart = Date.now();
                                     return [4 /*yield*/, runCodexInWorkerThread(plannerPrompt, applyCodexStageBudget(plannerRunOptions), codexConfig, streamProgress)];
                                 case 9:
-                                    plannerRaw = _22.sent();
+                                    plannerRaw = _23.sent();
                                     accumulateCodexUsage(plannerPrompt, plannerRaw);
                                     timingBreakdown.plannerMs = Date.now() - plannerStart;
                                     plannerOutput = parseJsonObject(plannerRaw);
                                     recordStep('Planning: planner result', { parsed: !!plannerOutput });
                                     return [3 /*break*/, 11];
                                 case 10:
-                                    _b = _22.sent();
+                                    _b = _23.sent();
                                     recordStep('Planning: planner result', { parsed: false });
                                     return [3 /*break*/, 11];
                                 case 11: return [3 /*break*/, 13];
@@ -2266,7 +2318,7 @@ function executeAiAssistantCodexRun(payload, context) {
                                         }
                                         recordStep('Planning: planner skipped', { reason: plannerSkipReason });
                                     }
-                                    _22.label = 13;
+                                    _23.label = 13;
                                 case 13:
                                     requestClassification = classifyAssistantRequestType(message, plannerOutput || undefined);
                                     dataQuestion = requestClassification.dataQuestion;
@@ -2322,13 +2374,13 @@ function executeAiAssistantCodexRun(payload, context) {
                                     recordStep('Directive: determine tool', { type: 'data-question' });
                                     directivePrompt = buildAssistantCodexDirectivePrompt(message, attachmentData.promptText, historyLines.join('\n'), assistantContext, directiveStyleHint, directivePromptMode, assistantSystemPrompt);
                                     if (!hasRunBudget('Directive: determine tool')) return [3 /*break*/, 17];
-                                    _22.label = 14;
+                                    _23.label = 14;
                                 case 14:
-                                    _22.trys.push([14, 16, , 17]);
+                                    _23.trys.push([14, 16, , 17]);
                                     directiveStart = Date.now();
                                     return [4 /*yield*/, runCodexInWorkerThread(directivePrompt, applyCodexStageBudget(runOptions), codexConfig, streamProgress)];
                                 case 15:
-                                    directiveText = _22.sent();
+                                    directiveText = _23.sent();
                                     accumulateCodexUsage(directivePrompt, directiveText);
                                     timingBreakdown.directiveMs = Date.now() - directiveStart;
                                     forcedDirective = extractAssistantMongoDirective(directiveText);
@@ -2346,19 +2398,19 @@ function executeAiAssistantCodexRun(payload, context) {
                                     }
                                     return [3 /*break*/, 17];
                                 case 16:
-                                    _c = _22.sent();
+                                    _c = _23.sent();
                                     return [3 /*break*/, 17];
                                 case 17:
                                     if (!(!directive && !dataQuestion)) return [3 /*break*/, 21];
                                     recordStep('Response: draft initial answer', { mode: 'full' });
                                     if (!hasRunBudget('Response: initial draft')) return [3 /*break*/, 21];
-                                    _22.label = 18;
+                                    _23.label = 18;
                                 case 18:
-                                    _22.trys.push([18, 20, , 21]);
+                                    _23.trys.push([18, 20, , 21]);
                                     initialStart = Date.now();
                                     return [4 /*yield*/, runCodexInWorkerThread(prompt_1, applyCodexStageBudget(runOptions), codexConfig, streamProgress)];
                                 case 19:
-                                    responseText = _22.sent();
+                                    responseText = _23.sent();
                                     accumulateCodexUsage(prompt_1, responseText);
                                     timingBreakdown.initialResponseMs = Date.now() - initialStart;
                                     extractedDirective = extractAssistantMongoDirective(responseText);
@@ -2376,7 +2428,7 @@ function executeAiAssistantCodexRun(payload, context) {
                                     }
                                     return [3 /*break*/, 21];
                                 case 20:
-                                    error_2 = _22.sent();
+                                    error_2 = _23.sent();
                                     recordStep('Response: initial draft failed', {
                                         message: normalizeOptionalString(error_2 === null || error_2 === void 0 ? void 0 : error_2.message) || 'Unknown error'
                                     });
@@ -2386,13 +2438,13 @@ function executeAiAssistantCodexRun(payload, context) {
                                     recordStep('Directive: forced retry', { mode: 'directive-only' });
                                     directivePrompt = buildAssistantCodexDirectivePrompt(message, attachmentData.promptText, historyLines.join('\n'), assistantContext, directiveStyleHint, directivePromptMode, assistantSystemPrompt);
                                     if (!hasRunBudget('Directive: forced retry')) return [3 /*break*/, 25];
-                                    _22.label = 22;
+                                    _23.label = 22;
                                 case 22:
-                                    _22.trys.push([22, 24, , 25]);
+                                    _23.trys.push([22, 24, , 25]);
                                     forcedStart = Date.now();
                                     return [4 /*yield*/, runCodexInWorkerThread(directivePrompt, applyCodexStageBudget(runOptions), codexConfig, streamProgress)];
                                 case 23:
-                                    directiveText = _22.sent();
+                                    directiveText = _23.sent();
                                     accumulateCodexUsage(directivePrompt, directiveText);
                                     timingBreakdown.forcedDirectiveMs = Date.now() - forcedStart;
                                     forcedDirective = extractAssistantMongoDirective(directiveText);
@@ -2410,7 +2462,7 @@ function executeAiAssistantCodexRun(payload, context) {
                                     }
                                     return [3 /*break*/, 25];
                                 case 24:
-                                    _d = _22.sent();
+                                    _d = _23.sent();
                                     return [3 /*break*/, 25];
                                 case 25:
                                     if (!(directive
@@ -2429,13 +2481,13 @@ function executeAiAssistantCodexRun(payload, context) {
                                         strict: true
                                     }), 'aggregate_only', assistantSystemPrompt);
                                     if (!hasRunBudget('Directive: dated retry')) return [3 /*break*/, 29];
-                                    _22.label = 26;
+                                    _23.label = 26;
                                 case 26:
-                                    _22.trys.push([26, 28, , 29]);
+                                    _23.trys.push([26, 28, , 29]);
                                     strictStart = Date.now();
                                     return [4 /*yield*/, runCodexInWorkerThread(strictDirectivePrompt, applyCodexStageBudget(runOptions), codexConfig, streamProgress)];
                                 case 27:
-                                    strictDirectiveText = _22.sent();
+                                    strictDirectiveText = _23.sent();
                                     accumulateCodexUsage(strictDirectivePrompt, strictDirectiveText);
                                     timingBreakdown.forcedDirectiveMs += Date.now() - strictStart;
                                     strictDirective = extractAssistantMongoDirective(strictDirectiveText);
@@ -2458,7 +2510,7 @@ function executeAiAssistantCodexRun(payload, context) {
                                     }
                                     return [3 /*break*/, 29];
                                 case 28:
-                                    _e = _22.sent();
+                                    _e = _23.sent();
                                     return [3 /*break*/, 29];
                                 case 29:
                                     if (!(directive
@@ -2477,13 +2529,13 @@ function executeAiAssistantCodexRun(payload, context) {
                                         strict: true
                                     }), 'aggregate_only', assistantSystemPrompt);
                                     if (!hasRunBudget('Directive: dated guard retry')) return [3 /*break*/, 33];
-                                    _22.label = 30;
+                                    _23.label = 30;
                                 case 30:
-                                    _22.trys.push([30, 32, , 33]);
+                                    _23.trys.push([30, 32, , 33]);
                                     guardStart = Date.now();
                                     return [4 /*yield*/, runCodexInWorkerThread(guardDirectivePrompt, applyCodexStageBudget(runOptions), codexConfig, streamProgress)];
                                 case 31:
-                                    guardDirectiveText = _22.sent();
+                                    guardDirectiveText = _23.sent();
                                     accumulateCodexUsage(guardDirectivePrompt, guardDirectiveText);
                                     timingBreakdown.forcedDirectiveMs += Date.now() - guardStart;
                                     guardDirective = extractAssistantMongoDirective(guardDirectiveText);
@@ -2504,7 +2556,7 @@ function executeAiAssistantCodexRun(payload, context) {
                                     }
                                     return [3 /*break*/, 33];
                                 case 32:
-                                    _f = _22.sent();
+                                    _f = _23.sent();
                                     return [3 /*break*/, 33];
                                 case 33:
                                     if (!(directive
@@ -2523,13 +2575,13 @@ function executeAiAssistantCodexRun(payload, context) {
                                         strict: true
                                     }), 'aggregate_only', assistantSystemPrompt);
                                     if (!hasRunBudget('Directive: grouped guard retry')) return [3 /*break*/, 37];
-                                    _22.label = 34;
+                                    _23.label = 34;
                                 case 34:
-                                    _22.trys.push([34, 36, , 37]);
+                                    _23.trys.push([34, 36, , 37]);
                                     groupedStart = Date.now();
                                     return [4 /*yield*/, runCodexInWorkerThread(groupedDirectivePrompt, applyCodexStageBudget(runOptions), codexConfig, streamProgress)];
                                 case 35:
-                                    groupedDirectiveText = _22.sent();
+                                    groupedDirectiveText = _23.sent();
                                     accumulateCodexUsage(groupedDirectivePrompt, groupedDirectiveText);
                                     timingBreakdown.forcedDirectiveMs += Date.now() - groupedStart;
                                     groupedDirective = extractAssistantMongoDirective(groupedDirectiveText);
@@ -2553,7 +2605,7 @@ function executeAiAssistantCodexRun(payload, context) {
                                     }
                                     return [3 /*break*/, 37];
                                 case 36:
-                                    _g = _22.sent();
+                                    _g = _23.sent();
                                     return [3 /*break*/, 37];
                                 case 37:
                                     if (!directive && dataQuestion) {
@@ -2674,9 +2726,9 @@ function executeAiAssistantCodexRun(payload, context) {
                                     directiveProgressMessages.slice(0, 2).forEach(function (messageText) { return progressTracker.push(messageText); });
                                     executionDirective = effectiveDirective;
                                     probeFieldHints = [];
-                                    _22.label = 39;
+                                    _23.label = 39;
                                 case 39:
-                                    _22.trys.push([39, 64, , 65]);
+                                    _23.trys.push([39, 64, , 65]);
                                     if (!(!alwaysAllowProbeEnabled && !hasRunBudget('Grabbing Data', AI_ASSISTANT_MONGO_MIN_STAGE_BUDGET_MS))) return [3 /*break*/, 40];
                                     assistantContent = buildAssistantRunBudgetExceededMessage();
                                     toolTelemetry.final = {
@@ -2708,18 +2760,18 @@ function executeAiAssistantCodexRun(payload, context) {
                                         attempted: true
                                     };
                                     probeStart = Date.now();
-                                    _22.label = 41;
+                                    _23.label = 41;
                                 case 41:
-                                    _22.trys.push([41, 46, , 47]);
+                                    _23.trys.push([41, 46, , 47]);
                                     if (!(probeDirective.type === 'aggregate')) return [3 /*break*/, 43];
                                     return [4 /*yield*/, executeAiAssistantReportBuilderAggregate(probeRequest, context)];
                                 case 42:
-                                    _h = _22.sent();
+                                    _h = _23.sent();
                                     return [3 /*break*/, 45];
                                 case 43: return [4 /*yield*/, executeAiAssistantReportBuilderRead(probeRequest, context)];
                                 case 44:
-                                    _h = _22.sent();
-                                    _22.label = 45;
+                                    _h = _23.sent();
+                                    _23.label = 45;
                                 case 45:
                                     probeResponse = _h;
                                     probeDurationMs = Date.now() - probeStart;
@@ -2751,7 +2803,7 @@ function executeAiAssistantCodexRun(payload, context) {
                                     }
                                     return [3 /*break*/, 47];
                                 case 46:
-                                    probeError_1 = _22.sent();
+                                    probeError_1 = _23.sent();
                                     probeDurationMs = Date.now() - probeStart;
                                     probeErrorMessage = normalizeOptionalString(probeError_1 === null || probeError_1 === void 0 ? void 0 : probeError_1.message) || 'Unknown error';
                                     toolTelemetry.probe = {
@@ -2770,7 +2822,7 @@ function executeAiAssistantCodexRun(payload, context) {
                                         attempted: false,
                                         skippedReason: 'probe_directive_missing_payload'
                                     };
-                                    _22.label = 49;
+                                    _23.label = 49;
                                 case 49: return [3 /*break*/, 51];
                                 case 50:
                                     if (probeEnabled) {
@@ -2785,7 +2837,7 @@ function executeAiAssistantCodexRun(payload, context) {
                                             skippedReason: 'aggregate_probe_disabled'
                                         };
                                     }
-                                    _22.label = 51;
+                                    _23.label = 51;
                                 case 51:
                                     if (!(!alwaysAllowProbeEnabled && !hasRunBudget('Grabbing Data: final', AI_ASSISTANT_MONGO_MIN_STAGE_BUDGET_MS))) return [3 /*break*/, 52];
                                     assistantContent = buildAssistantRunBudgetExceededMessage();
@@ -2815,12 +2867,12 @@ function executeAiAssistantCodexRun(payload, context) {
                                     if (!(executionDirective.type === 'aggregate')) return [3 /*break*/, 54];
                                     return [4 /*yield*/, executeAiAssistantReportBuilderAggregate(toolRequest, context)];
                                 case 53:
-                                    _j = _22.sent();
+                                    _j = _23.sent();
                                     return [3 /*break*/, 56];
                                 case 54: return [4 /*yield*/, executeAiAssistantReportBuilderRead(toolRequest, context)];
                                 case 55:
-                                    _j = _22.sent();
-                                    _22.label = 56;
+                                    _j = _23.sent();
+                                    _23.label = 56;
                                 case 56:
                                     toolResponse = _j;
                                     toolDurationMs = Date.now() - toolStart;
@@ -2871,20 +2923,20 @@ function executeAiAssistantCodexRun(payload, context) {
                                     recordStep('Drafting response');
                                     followupPrompt = buildAssistantCodexToolFollowupPrompt(message, attachmentData.promptText, historyLines.join('\n'), assistantContext, toolPayload.prompt, assistantSystemPrompt);
                                     if (!hasRunBudget('Drafting response: followup')) return [3 /*break*/, 62];
-                                    _22.label = 58;
+                                    _23.label = 58;
                                 case 58:
-                                    _22.trys.push([58, 60, , 61]);
+                                    _23.trys.push([58, 60, , 61]);
                                     followupStart = Date.now();
                                     return [4 /*yield*/, runCodexInWorkerThread(followupPrompt, applyCodexStageBudget(runOptions), codexConfig, streamProgress)];
                                 case 59:
-                                    followupText = _22.sent();
+                                    followupText = _23.sent();
                                     accumulateCodexUsage(followupPrompt, followupText);
                                     timingBreakdown.followupMs = Date.now() - followupStart;
                                     assistantContent = sanitizeAssistantResponse(followupText);
                                     assistantContent = applyAssistantDisplayTableToResponse(assistantContent, toolPayload.result.output.display);
                                     return [3 /*break*/, 61];
                                 case 60:
-                                    _k = _22.sent();
+                                    _k = _23.sent();
                                     assistantContent = buildAssistantToolFallbackResponse(toolPayload.result);
                                     assistantContent = applyAssistantDisplayTableToResponse(assistantContent, toolPayload.result.output.display);
                                     return [3 /*break*/, 61];
@@ -2892,10 +2944,10 @@ function executeAiAssistantCodexRun(payload, context) {
                                 case 62:
                                     assistantContent = buildAssistantToolFallbackResponse(toolPayload.result);
                                     assistantContent = applyAssistantDisplayTableToResponse(assistantContent, toolPayload.result.output.display);
-                                    _22.label = 63;
+                                    _23.label = 63;
                                 case 63: return [3 /*break*/, 65];
                                 case 64:
-                                    error_3 = _22.sent();
+                                    error_3 = _23.sent();
                                     assistantContent = buildAssistantToolErrorMessage(error_3);
                                     toolError = error_3;
                                     errorMessage = normalizeOptionalString(error_3 === null || error_3 === void 0 ? void 0 : error_3.message) || 'Unknown error';
@@ -2909,10 +2961,10 @@ function executeAiAssistantCodexRun(payload, context) {
                                 case 66:
                                     progressTracker.push('Drafting response');
                                     recordStep('Drafting response');
-                                    _22.label = 67;
+                                    _23.label = 67;
                                 case 67: return [3 /*break*/, 70];
                                 case 68:
-                                    error_4 = _22.sent();
+                                    error_4 = _23.sent();
                                     assistantContent = buildAssistantCodexErrorMessage(error_4);
                                     recordStep('Error', { message: normalizeOptionalString(error_4 === null || error_4 === void 0 ? void 0 : error_4.message) || 'Unknown error' });
                                     return [3 /*break*/, 70];
@@ -2963,9 +3015,9 @@ function executeAiAssistantCodexRun(payload, context) {
                                         });
                                     }
                                     finalNow = new Date();
-                                    _22.label = 71;
+                                    _23.label = 71;
                                 case 71:
-                                    _22.trys.push([71, 82, , 93]);
+                                    _23.trys.push([71, 83, , 94]);
                                     if (canViewDebug) {
                                         finishedAt = Date.now();
                                         codexMs = timingBreakdown.directiveMs
@@ -3048,39 +3100,38 @@ function executeAiAssistantCodexRun(payload, context) {
                                         output_tokens: codexUsage.output_tokens,
                                         total_tokens: codexUsage.total_tokens
                                     } : null;
+                                    finalUsageLedgerEntry = null;
                                     if (!finalUsage) return [3 /*break*/, 76];
                                     return [4 /*yield*/, resolveClientId(conversation, input.id_client, context === null || context === void 0 ? void 0 : context.id_user)];
                                 case 72:
-                                    usageClientId = _22.sent();
-                                    _22.label = 73;
+                                    usageClientId = _23.sent();
+                                    _23.label = 73;
                                 case 73:
-                                    _22.trys.push([73, 75, , 76]);
-                                    return [4 /*yield*/, (0, openai_usage_ledger_manager_1.recordOpenAIUsage)({
-                                            id_client: usageClientId || '',
-                                            model: finalUsage.model,
-                                            input_tokens: finalUsage.input_tokens,
-                                            output_tokens: finalUsage.output_tokens,
-                                            total_tokens: finalUsage.total_tokens,
-                                            category: 'ai-terminal-codex',
-                                            id_request: requestId || undefined,
-                                            id_conversation: conversation._id,
-                                            usage_source: 'ai_assistant',
-                                            usage_surface: 'assistant',
-                                            usage_phase: 'codex_query',
-                                            cost_basis: 'estimated_tokens',
-                                            id_app: String((conversation === null || conversation === void 0 ? void 0 : conversation.id_app) || ''),
-                                            metadata: {
-                                                conversationId: conversation._id,
-                                                requestId: requestId || '',
-                                                plannerUsed: plannerUsed,
-                                                toolMode: toolTelemetry.mode
-                                            }
-                                        })];
+                                    _23.trys.push([73, 75, , 76]);
+                                    finalUsageLedgerEntry = buildAssistantAIRunUsageLedgerEntry({
+                                        idClient: usageClientId || '',
+                                        model: finalUsage.model,
+                                        inputTokens: finalUsage.input_tokens,
+                                        outputTokens: finalUsage.output_tokens,
+                                        totalTokens: finalUsage.total_tokens,
+                                        category: 'ai-terminal-codex',
+                                        conversationId: conversation._id,
+                                        requestId: requestId || undefined,
+                                        usagePhase: 'codex_query',
+                                        idApp: String((conversation === null || conversation === void 0 ? void 0 : conversation.id_app) || ''),
+                                        metadata: {
+                                            conversationId: conversation._id,
+                                            requestId: requestId || '',
+                                            plannerUsed: plannerUsed,
+                                            toolMode: toolTelemetry.mode
+                                        }
+                                    });
+                                    return [4 /*yield*/, (0, openai_usage_ledger_manager_1.recordOpenAIUsage)(finalUsageLedgerEntry)];
                                 case 74:
-                                    _22.sent();
+                                    _23.sent();
                                     return [3 /*break*/, 76];
                                 case 75:
-                                    usageError_1 = _22.sent();
+                                    usageError_1 = _23.sent();
                                     console.error(new Date(), 'Failed to record AI usage', usageError_1);
                                     return [3 /*break*/, 76];
                                 case 76:
@@ -3096,58 +3147,76 @@ function executeAiAssistantCodexRun(payload, context) {
                                     }
                                     return [4 /*yield*/, updateAssistantMessageWithFallback(assistantMessageId, setPayload)];
                                 case 77:
-                                    _22.sent();
-                                    _22.label = 78;
+                                    _23.sent();
+                                    _23.label = 78;
                                 case 78: return [4 /*yield*/, touchConversation(conversation._id, finalNow, assistantMessageId ? String(assistantMessageId) : undefined)];
                                 case 79:
-                                    _22.sent();
-                                    if (!(input.delete_files_after_run !== false)) return [3 /*break*/, 81];
-                                    return [4 /*yield*/, cleanupAttachments(attachmentData.attachments)];
+                                    _23.sent();
+                                    return [4 /*yield*/, recordAssistantAnswerAIRun({
+                                            runId: buildAssistantAIRunId('codex_query', [conversation._id, assistantMessageId || requestId]),
+                                            requestId: requestId || undefined,
+                                            messageId: assistantMessageId ? String(assistantMessageId) : undefined,
+                                            conversation: conversation,
+                                            userMessage: __assign(__assign({}, userDoc), { _id: userMessageId ? String(userMessageId) : undefined }),
+                                            assistantMessage: finalAssistantDoc,
+                                            usageLedgerEntry: finalUsageLedgerEntry || undefined,
+                                            correctnessChecks: ((_22 = toolTelemetry === null || toolTelemetry === void 0 ? void 0 : toolTelemetry.outcome) === null || _22 === void 0 ? void 0 : _22.error) ? [{
+                                                    assertion: 'assistant_tool_execution',
+                                                    status: 'fail',
+                                                    observed: toolTelemetry.outcome.error,
+                                                    message: 'Assistant tool execution reported an error.'
+                                                }] : [],
+                                            now: finalNow
+                                        })];
                                 case 80:
-                                    _22.sent();
-                                    _22.label = 81;
-                                case 81: return [2 /*return*/, finalAssistantDoc];
-                                case 82:
-                                    finalizeError_1 = _22.sent();
+                                    _23.sent();
+                                    if (!(input.delete_files_after_run !== false)) return [3 /*break*/, 82];
+                                    return [4 /*yield*/, cleanupAttachments(attachmentData.attachments)];
+                                case 81:
+                                    _23.sent();
+                                    _23.label = 82;
+                                case 82: return [2 /*return*/, finalAssistantDoc];
+                                case 83:
+                                    finalizeError_1 = _23.sent();
                                     failedAt = new Date();
                                     fallbackContent = assistantContent || buildAssistantCodexErrorMessage(finalizeError_1);
                                     failureMetadata = __assign(__assign(__assign(__assign(__assign({ model: codexModel }, (codexFallbackModels.length ? { model_fallbacks: codexFallbackModels } : {})), (requestId ? { request_id: requestId } : {})), { pending: false, failed: true }), (toolExecutionTelemetry ? { tool_execution: toolExecutionTelemetry } : {})), { error_message: normalizeOptionalString(finalizeError_1 === null || finalizeError_1 === void 0 ? void 0 : finalizeError_1.message) || 'Unknown error' });
-                                    _22.label = 83;
-                                case 83:
-                                    _22.trys.push([83, 87, , 88]);
-                                    if (!assistantMessageId) return [3 /*break*/, 85];
+                                    _23.label = 84;
+                                case 84:
+                                    _23.trys.push([84, 88, , 89]);
+                                    if (!assistantMessageId) return [3 /*break*/, 86];
                                     return [4 /*yield*/, updateAssistantMessageWithFallback(assistantMessageId, {
                                             content: fallbackContent,
                                             metadata: failureMetadata,
                                             updatedAt: failedAt
                                         })];
-                                case 84:
-                                    _22.sent();
-                                    _22.label = 85;
-                                case 85: return [4 /*yield*/, touchConversation(conversation._id, failedAt, assistantMessageId ? String(assistantMessageId) : undefined)];
-                                case 86:
-                                    _22.sent();
-                                    return [3 /*break*/, 88];
+                                case 85:
+                                    _23.sent();
+                                    _23.label = 86;
+                                case 86: return [4 /*yield*/, touchConversation(conversation._id, failedAt, assistantMessageId ? String(assistantMessageId) : undefined)];
                                 case 87:
-                                    persistError_1 = _22.sent();
-                                    console.error(new Date(), 'AI assistant finalize fallback update failed', persistError_1);
-                                    return [3 /*break*/, 88];
+                                    _23.sent();
+                                    return [3 /*break*/, 89];
                                 case 88:
-                                    if (!(input.delete_files_after_run !== false)) return [3 /*break*/, 92];
-                                    _22.label = 89;
+                                    persistError_1 = _23.sent();
+                                    console.error(new Date(), 'AI assistant finalize fallback update failed', persistError_1);
+                                    return [3 /*break*/, 89];
                                 case 89:
-                                    _22.trys.push([89, 91, , 92]);
-                                    return [4 /*yield*/, cleanupAttachments(attachmentData.attachments)];
+                                    if (!(input.delete_files_after_run !== false)) return [3 /*break*/, 93];
+                                    _23.label = 90;
                                 case 90:
-                                    _22.sent();
-                                    return [3 /*break*/, 92];
+                                    _23.trys.push([90, 92, , 93]);
+                                    return [4 /*yield*/, cleanupAttachments(attachmentData.attachments)];
                                 case 91:
-                                    _l = _22.sent();
-                                    return [3 /*break*/, 92];
+                                    _23.sent();
+                                    return [3 /*break*/, 93];
                                 case 92:
+                                    _l = _23.sent();
+                                    return [3 /*break*/, 93];
+                                case 93:
                                     console.error(new Date(), 'AI assistant run finalize failed:', finalizeError_1);
                                     return [2 /*return*/, __assign(__assign({}, assistantDoc), { _id: assistantMessageId, content: fallbackContent, metadata: failureMetadata, updatedAt: failedAt })];
-                                case 93: return [2 /*return*/];
+                                case 94: return [2 /*return*/];
                             }
                         });
                     }); });
@@ -23034,6 +23103,68 @@ function estimateUsage(messages, responseText, model) {
         totalTokens: inputTokens + outputTokens
     };
 }
+function buildAssistantAIRunUsageLedgerEntry(input) {
+    return {
+        id_client: normalizeOptionalString(input.idClient),
+        model: normalizeOptionalString(input.model) || 'unknown',
+        input_tokens: Number(input.inputTokens || 0),
+        output_tokens: Number(input.outputTokens || 0),
+        total_tokens: Number(input.totalTokens || 0),
+        category: input.category,
+        id_request: normalizeOptionalString(input.requestId) || undefined,
+        id_conversation: normalizeOptionalString(input.conversationId) || undefined,
+        usage_source: 'ai_assistant',
+        usage_surface: 'assistant',
+        usage_phase: input.usagePhase,
+        cost_basis: 'estimated_tokens',
+        id_app: normalizeOptionalString(input.idApp),
+        metadata: input.metadata
+    };
+}
+function buildAssistantAIRunId(prefix, parts) {
+    var normalizedParts = parts
+        .map(function (part) { return normalizeOptionalString(part); })
+        .filter(Boolean);
+    if (normalizedParts.length) {
+        return "ai-run:ai_assistant:".concat(prefix, ":").concat(normalizedParts.join(':'));
+    }
+    var digest = (0, crypto_1.createHash)('sha1').update("".concat(prefix, ":").concat(Date.now(), ":").concat(Math.random())).digest('hex').slice(0, 20);
+    return "ai-run:ai_assistant:".concat(prefix, ":").concat(digest);
+}
+function recordAssistantAnswerAIRun(input) {
+    return __awaiter(this, void 0, void 0, function () {
+        var messages, run, error_14;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    _a.trys.push([0, 2, , 3]);
+                    messages = [
+                        input.userMessage,
+                        input.assistantMessage
+                    ].filter(function (message) { return !!message; });
+                    run = (0, ai_run_evidence_adapters_1.buildAssistantAIRunFromEvidence)({
+                        runId: input.runId,
+                        requestId: input.requestId,
+                        messageId: input.messageId,
+                        conversation: input.conversation || {},
+                        messages: messages,
+                        usageLedger: input.usageLedgerEntry ? [input.usageLedgerEntry] : [],
+                        correctnessChecks: input.correctnessChecks || [],
+                        now: input.now || new Date()
+                    });
+                    return [4 /*yield*/, ai_run_evidence_manager_1.AIRunEvidenceManager.upsertRuns([run])];
+                case 1:
+                    _a.sent();
+                    return [3 /*break*/, 3];
+                case 2:
+                    error_14 = _a.sent();
+                    console.error(new Date(), 'Failed to record AI assistant AIRun evidence', error_14);
+                    return [3 /*break*/, 3];
+                case 3: return [2 /*return*/];
+            }
+        });
+    });
+}
 function evaluateGuardrails(message) {
     var e_58, _a;
     var normalized = String(message || '').toLowerCase();