@resolveio/server-lib 22.1.11 → 22.1.13

package/methods/ai-terminal.js

@@ -119,6 +119,7 @@ exports.buildDisplayTable = buildDisplayTable;
 exports.formatDisplayTableMarkdown = formatDisplayTableMarkdown;
 exports.resolveAssistantReadDisplayMaxRows = resolveAssistantReadDisplayMaxRows;
 exports.normalizeAssistantNowExprPlaceholders = normalizeAssistantNowExprPlaceholders;
+exports.repairAssistantFieldPathReferenceInPipeline = repairAssistantFieldPathReferenceInPipeline;
 exports.rewriteMatchExpressionsToExpr = rewriteMatchExpressionsToExpr;
 exports.normalizeAssistantMonthlyCalendarWindowPipeline = normalizeAssistantMonthlyCalendarWindowPipeline;
 exports.normalizeAssistantAggregatePipeline = normalizeAssistantAggregatePipeline;
@@ -128,6 +129,7 @@ exports.rewriteEmbeddedMatchObjects = rewriteEmbeddedMatchObjects;
 exports.resolveAssistantCollectionOverride = resolveAssistantCollectionOverride;
 exports.resolveAssistantCrossCollectionFallbackCandidates = resolveAssistantCrossCollectionFallbackCandidates;
 exports.resolveAssistantAvailableCrossCollectionFallbacksFromNames = resolveAssistantAvailableCrossCollectionFallbacksFromNames;
+exports.evaluateAssistantFallbackDocumentsQuality = evaluateAssistantFallbackDocumentsQuality;
 exports.shouldAcceptAssistantFallbackDocuments = shouldAcceptAssistantFallbackDocuments;
 exports.collectUserViewPermissions = collectUserViewPermissions;
 exports.userHasInvoiceAccess = userHasInvoiceAccess;
@@ -255,6 +257,9 @@ var AI_ASSISTANT_CHANGE_HISTORY_MIN_DEPTH = 80;
 var AI_ASSISTANT_CHANGE_HISTORY_MAX_DEPTH = 240;
 var AI_ASSISTANT_CHANGE_HISTORY_DURATION_MAX_DEPTH = 1200;
 var AI_ASSISTANT_GIT_COMMAND_TIMEOUT_MS = 15000;
+var AI_ASSISTANT_GIT_DISCOVERY_MAX_DEPTH = 4;
+var AI_ASSISTANT_GIT_DISCOVERY_MAX_ROOTS = 20;
+var AI_ASSISTANT_GIT_MIRROR_CACHE_TTL_MS = 5 * 60 * 1000;
 var AI_ASSISTANT_BLOCKED_COLLECTIONS = new Set([
     'user-groups',
     'logged-in-users',
@@ -285,6 +290,16 @@ var AI_ASSISTANT_CLIENT_SCOPE_CACHE = new Map();
 var AI_ASSISTANT_FIELD_INDEX_CACHE = new Map();
 var AI_ASSISTANT_COLLECTION_CACHE = new Map();
 var AI_ASSISTANT_COLLECTION_CACHE_TTL_MS = 5 * 60 * 1000;
+var AI_ASSISTANT_COLLECTION_METADATA_CACHE = new Map();
+var AI_ASSISTANT_COLLECTION_METADATA_CACHE_TTL_MS = 10 * 60 * 1000;
+var AI_ASSISTANT_COLLECTION_PROFILE_CACHE = new Map();
+var AI_ASSISTANT_COLLECTION_PROFILE_CACHE_TTL_MS = 10 * 60 * 1000;
+var AI_ASSISTANT_COLLECTION_PROFILE_FIELD_TOKEN_LIMIT = 240;
+var AI_ASSISTANT_SURFACE_INDEX_CACHE_TTL_MS = 10 * 60 * 1000;
+var AI_ASSISTANT_SURFACE_INDEX_MATCH_LIMIT = 8;
+var AI_ASSISTANT_SURFACE_INDEX_COLLECTION_HINT_LIMIT = 6;
+var AI_ASSISTANT_RELATIONSHIP_GRAPH_CACHE = new Map();
+var AI_ASSISTANT_RELATIONSHIP_GRAPH_CACHE_TTL_MS = 10 * 60 * 1000;
 var AI_ASSISTANT_COLLECTION_STOPWORDS = new Set([
     'the',
     'a',
@@ -770,6 +785,8 @@ var AI_ASSISTANT_PLANNER_USER_PROMPT_TEMPLATE = [
     '',
     'Collection hints (may be empty): {{collection_hints_json_array}}',
     'Field hints (may be empty): {{field_hints_json_array}}',
+    'Method hints (may be empty): {{method_hints_json_array}}',
+    'Publication hints (may be empty): {{publication_hints_json_array}}',
     '',
     'Important:',
     '- If invoice-related, permission is satisfied if ANY allowed view contains "invoice" case-insensitive.',
@@ -875,6 +892,8 @@ function drainAssistantCodexRunQueue() {
         });
     });
 }
+var cachedAssistantSurfaceIndex = null;
+var assistantGitMirrorCache = new Map();
 function loadAiTerminalMethods(methodManager) {
     var codexWorkerIndex = resolveSingleWorkerTarget(process.env.AI_ASSISTANT_CODEX_WORKER_INDEX
         || process.env.CODEX_WORKER_INDEX
@@ -1676,7 +1695,7 @@ function executeAiAssistantCodexRun(payload, context) {
                     insertResult = _e.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, steps, recordStep, progressTracker, streamProgress, assistantContent, toolResult, assistantDebug, directiveSource, requestClassification, dataQuestion, lastDirective, heuristicDirectivePrecomputed, usedDeterministicHeuristicFastPath, requestedTimeGrain, requestedBreakdownDimensions, enforceDatedDirective, enforceGroupedDirective, datedDirectiveRetryUsed, datedDirectiveResolved, toolResponseDebug, toolError, termHints, collectionHints, fieldHints, collectionTokenization, collectionRanking, collectionSelection, collectionOverride, collectionNames, plannerEnabled, plannerUsed, plannerSkipReason, plannerOutput, plannerRaw, timingBreakdown, codexUsage, accumulateCodexUsage, contextRoute, contextMode, hintSeed, termExpansion, hintText, baseTokens, expandedTokens, baseWeights, expandedWeights, dbName, db, _a, routeHints, rankedCollections, hintCollections, assistantContext, hasDeterministicHeuristicFastPath, prompt_1, workspaceRoot, codexConfig, runOptions, plannerRunOptions, shouldRunPlanner, 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, cleanedResponseText, effectiveDirective, toolRequest, toolStart, toolResponse, _h, toolPayload, skipFollowupCodex, followupPrompt, followupStart, followupText, _j, error_3, error_4, finishedAt, finalNow, finishedAt, codexMs, draftingMs, finalMetadata, finalUsage, usageClientId, usageError_1, finalAssistantDoc, setPayload;
+                        var runStart, steps, recordStep, progressTracker, streamProgress, assistantContent, toolResult, assistantDebug, directiveSource, requestClassification, dataQuestion, lastDirective, heuristicDirectivePrecomputed, usedDeterministicHeuristicFastPath, requestedTimeGrain, requestedBreakdownDimensions, enforceDatedDirective, enforceGroupedDirective, datedDirectiveRetryUsed, datedDirectiveResolved, toolResponseDebug, toolError, termHints, collectionHints, fieldHints, methodHints, publicationHints, collectionTokenization, collectionRanking, collectionSelection, collectionOverride, collectionNames, plannerEnabled, plannerUsed, plannerSkipReason, plannerOutput, plannerRaw, timingBreakdown, codexUsage, accumulateCodexUsage, contextRoute, contextMode, hintSeed, termExpansion, hintText, baseTokens, expandedTokens, baseWeights, expandedWeights, dbName, db, surfaceHints, _a, allowedRoutes, rankedAllowedRoutes, routeHints, rankedCollectionHints, rankedCollections, hintCollections, assistantContext, hasDeterministicHeuristicFastPath, prompt_1, workspaceRoot, codexConfig, runOptions, plannerRunOptions, shouldRunPlanner, 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, cleanedResponseText, effectiveDirective, toolRequest, toolStart, toolResponse, _h, toolPayload, skipFollowupCodex, followupPrompt, followupStart, followupText, _j, error_3, error_4, finishedAt, finalNow, finishedAt, codexMs, draftingMs, finalMetadata, finalUsage, usageClientId, usageError_1, finalAssistantDoc, setPayload;
                         var _k, _l, _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;
                         return __generator(this, function (_13) {
                             switch (_13.label) {
@@ -1724,6 +1743,8 @@ function executeAiAssistantCodexRun(payload, context) {
                                     termHints = [];
                                     collectionHints = [];
                                     fieldHints = [];
+                                    methodHints = [];
+                                    publicationHints = [];
                                     collectionTokenization = null;
                                     collectionRanking = null;
                                     collectionSelection = null;
@@ -1767,7 +1788,7 @@ function executeAiAssistantCodexRun(payload, context) {
                                     });
                                     _13.label = 1;
                                 case 1:
-                                    _13.trys.push([1, 51, 52, 53]);
+                                    _13.trys.push([1, 52, 53, 54]);
                                     hintSeed = [message, contextRoute].filter(Boolean).join(' ');
                                     termExpansion = expandAssistantTermSynonyms(hintSeed);
                                     hintText = termExpansion.expanded || hintSeed;
@@ -1790,7 +1811,7 @@ function executeAiAssistantCodexRun(payload, context) {
                                     });
                                     _13.label = 2;
                                 case 2:
-                                    _13.trys.push([2, 4, , 5]);
+                                    _13.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)];
@@ -1798,22 +1819,43 @@ function executeAiAssistantCodexRun(payload, context) {
                                     collectionNames = _13.sent();
                                     collectionHints = resolveCollectionHintsFromTokens(expandedTokens, collectionNames, 5);
                                     collectionRanking = buildCollectionRankingDebugFromTokens(expandedTokens, collectionNames, 8);
-                                    return [3 /*break*/, 5];
+                                    return [4 /*yield*/, resolveAssistantSurfaceHints(hintSeed, contextRoute, collectionNames)];
                                 case 4:
+                                    surfaceHints = _13.sent();
+                                    methodHints = surfaceHints.methodHints;
+                                    publicationHints = surfaceHints.publicationHints;
+                                    if (surfaceHints.collectionHints.length) {
+                                        collectionHints = mergeAssistantHintValues(surfaceHints.collectionHints, collectionHints);
+                                    }
+                                    return [3 /*break*/, 6];
+                                case 5:
                                     _a = _13.sent();
                                     collectionHints = [];
                                     collectionRanking = collectionRanking || ((collectionTokenization === null || collectionTokenization === void 0 ? void 0 : collectionTokenization.expandedTokens)
                                         ? buildCollectionRankingDebugFromTokens(collectionTokenization.expandedTokens || [], [], 0)
                                         : null);
-                                    return [3 /*break*/, 5];
-                                case 5:
-                                    routeHints = resolveCollectionHintsFromRoute(contextRoute, collectionNames);
+                                    return [3 /*break*/, 6];
+                                case 6:
+                                    allowedRoutes = resolveAssistantAllowedRoutesForUser(user, isSuperAdmin);
+                                    rankedAllowedRoutes = rankAssistantNavigationRoutes(hintSeed, allowedRoutes, 3);
+                                    routeHints = mergeAssistantHintValues(resolveCollectionHintsFromRoute(contextRoute, collectionNames), resolveCollectionHintsFromRoutes(rankedAllowedRoutes, collectionNames));
                                     if (routeHints.length) {
                                         collectionHints = mergeAssistantHintValues(routeHints, collectionHints);
                                     }
                                     if (!collectionHints.length) {
                                         collectionHints = resolveAssistantDefaultCollectionHints(message);
                                     }
+                                    collectionRanking = buildCollectionRankingDebugFromSignals(expandedTokens, collectionNames, {
+                                        requestedTokens: expandedTokens,
+                                        methodHints: methodHints,
+                                        publicationHints: publicationHints,
+                                        routeHints: mergeAssistantHintValues(contextRoute ? [contextRoute] : [], rankedAllowedRoutes),
+                                        boostedCollections: collectionHints
+                                    }, 8);
+                                    rankedCollectionHints = resolveCollectionHintsFromRanking(collectionRanking, 5);
+                                    if (rankedCollectionHints.length) {
+                                        collectionHints = mergeAssistantHintValues(rankedCollectionHints, collectionHints);
+                                    }
                                     rankedCollections = Array.isArray(collectionRanking === null || collectionRanking === void 0 ? void 0 : collectionRanking.ranked)
                                         ? collectionRanking === null || collectionRanking === void 0 ? void 0 : collectionRanking.ranked.map(function (entry) { return entry.name; })
                                         : [];
@@ -1825,7 +1867,9 @@ function executeAiAssistantCodexRun(payload, context) {
                                         contextMode: contextMode || undefined,
                                         collectionHints: collectionHints.length ? collectionHints : undefined,
                                         termHints: termHints.length ? termHints : undefined,
-                                        fieldHints: fieldHints.length ? fieldHints : undefined
+                                        fieldHints: fieldHints.length ? fieldHints : undefined,
+                                        methodHints: methodHints.length ? methodHints : undefined,
+                                        publicationHints: publicationHints.length ? publicationHints : undefined
                                     });
                                     assistantContext = buildAssistantContext(input, {
                                         isSuperAdmin: isSuperAdmin,
@@ -1834,6 +1878,8 @@ function executeAiAssistantCodexRun(payload, context) {
                                         collectionHints: collectionHints,
                                         termHints: termHints,
                                         fieldHints: fieldHints,
+                                        methodHints: methodHints,
+                                        publicationHints: publicationHints,
                                         recentToolError: recentToolError
                                     });
                                     heuristicDirectivePrecomputed = dataQuestion ? buildAssistantHeuristicDirective(message, collectionHints) : null;
@@ -1849,7 +1895,7 @@ function executeAiAssistantCodexRun(payload, context) {
                                     }
                                     prompt_1 = buildAssistantCodexPrompt(message, attachmentData.promptText, historyLines.join('\n'), assistantContext);
                                     return [4 /*yield*/, resolveAssistantWorkspaceRoot()];
-                                case 6:
+                                case 7:
                                     workspaceRoot = _13.sent();
                                     codexConfig = resolveCodexSettings({
                                         model: codexModel,
@@ -1880,37 +1926,39 @@ function executeAiAssistantCodexRun(payload, context) {
                                         requestClassification: requestClassification,
                                         hasDeterministicHeuristicFastPath: hasDeterministicHeuristicFastPath
                                     });
-                                    if (!shouldRunPlanner) return [3 /*break*/, 11];
+                                    if (!shouldRunPlanner) return [3 /*break*/, 12];
                                     plannerUsed = true;
                                     recordStep('Planning: planner prompt');
                                     plannerPrompt = buildAssistantPlannerPrompt({
                                         message: message,
                                         attachmentText: attachmentData.promptText,
                                         contextRoute: contextRoute,
-                                        knownRoutes: resolveAssistantPlannerKnownRoutes(),
+                                        knownRoutes: resolveAssistantPlannerKnownRoutes(user, isSuperAdmin),
                                         user: user,
                                         collectionHints: collectionHints,
                                         fieldHints: fieldHints,
+                                        methodHints: methodHints,
+                                        publicationHints: publicationHints,
                                         inputClientId: input.id_client
                                     });
-                                    _13.label = 7;
-                                case 7:
-                                    _13.trys.push([7, 9, , 10]);
+                                    _13.label = 8;
+                                case 8:
+                                    _13.trys.push([8, 10, , 11]);
                                     plannerStart = Date.now();
                                     return [4 /*yield*/, runCodexInWorkerThread(plannerPrompt, plannerRunOptions, codexConfig, streamProgress)];
-                                case 8:
+                                case 9:
                                     plannerRaw = _13.sent();
                                     accumulateCodexUsage(plannerPrompt, plannerRaw);
                                     timingBreakdown.plannerMs = Date.now() - plannerStart;
                                     plannerOutput = parseJsonObject(plannerRaw);
                                     recordStep('Planning: planner result', { parsed: !!plannerOutput });
-                                    return [3 /*break*/, 10];
-                                case 9:
+                                    return [3 /*break*/, 11];
+                                case 10:
                                     _b = _13.sent();
                                     recordStep('Planning: planner result', { parsed: false });
-                                    return [3 /*break*/, 10];
-                                case 10: return [3 /*break*/, 12];
-                                case 11:
+                                    return [3 /*break*/, 11];
+                                case 11: return [3 /*break*/, 13];
+                                case 12:
                                     if (plannerEnabled) {
                                         if (hasDeterministicHeuristicFastPath) {
                                             plannerSkipReason = 'heuristic_directive_fast_path';
@@ -1923,8 +1971,8 @@ function executeAiAssistantCodexRun(payload, context) {
                                         }
                                         recordStep('Planning: planner skipped', { reason: plannerSkipReason });
                                     }
-                                    _13.label = 12;
-                                case 12:
+                                    _13.label = 13;
+                                case 13:
                                     requestClassification = classifyAssistantRequestType(message, plannerOutput || undefined);
                                     dataQuestion = requestClassification.dataQuestion;
                                     requestedTimeGrain = resolveAssistantRequestedTimeGrain(message, plannerOutput || undefined);
@@ -1975,15 +2023,15 @@ function executeAiAssistantCodexRun(payload, context) {
                                             timeGrain: requestedTimeGrain || undefined
                                         });
                                     }
-                                    if (!(dataQuestion && !directive)) return [3 /*break*/, 16];
+                                    if (!(dataQuestion && !directive)) return [3 /*break*/, 17];
                                     recordStep('Directive: determine tool', { type: 'data-question' });
                                     directivePrompt = buildAssistantCodexDirectivePrompt(message, attachmentData.promptText, historyLines.join('\n'), assistantContext, directiveStyleHint, directivePromptMode);
-                                    _13.label = 13;
-                                case 13:
-                                    _13.trys.push([13, 15, , 16]);
+                                    _13.label = 14;
+                                case 14:
+                                    _13.trys.push([14, 16, , 17]);
                                     directiveStart = Date.now();
                                     return [4 /*yield*/, runCodexInWorkerThread(directivePrompt, runOptions, codexConfig, streamProgress)];
-                                case 14:
+                                case 15:
                                     directiveText = _13.sent();
                                     accumulateCodexUsage(directivePrompt, directiveText);
                                     timingBreakdown.directiveMs = Date.now() - directiveStart;
@@ -2000,19 +2048,19 @@ function executeAiAssistantCodexRun(payload, context) {
                                             permissionView: normalizeOptionalString((_t = directive.payload) === null || _t === void 0 ? void 0 : _t.permissionView) || undefined
                                         });
                                     }
-                                    return [3 /*break*/, 16];
-                                case 15:
-                                    _c = _13.sent();
-                                    return [3 /*break*/, 16];
+                                    return [3 /*break*/, 17];
                                 case 16:
-                                    if (!(!directive && !dataQuestion)) return [3 /*break*/, 20];
-                                    recordStep('Response: draft initial answer', { mode: 'full' });
-                                    _13.label = 17;
+                                    _c = _13.sent();
+                                    return [3 /*break*/, 17];
                                 case 17:
-                                    _13.trys.push([17, 19, , 20]);
+                                    if (!(!directive && !dataQuestion)) return [3 /*break*/, 21];
+                                    recordStep('Response: draft initial answer', { mode: 'full' });
+                                    _13.label = 18;
+                                case 18:
+                                    _13.trys.push([18, 20, , 21]);
                                     initialStart = Date.now();
                                     return [4 /*yield*/, runCodexInWorkerThread(prompt_1, runOptions, codexConfig, streamProgress)];
-                                case 18:
+                                case 19:
                                     responseText = _13.sent();
                                     accumulateCodexUsage(prompt_1, responseText);
                                     timingBreakdown.initialResponseMs = Date.now() - initialStart;
@@ -2029,23 +2077,23 @@ function executeAiAssistantCodexRun(payload, context) {
                                             permissionView: normalizeOptionalString((_w = directive.payload) === null || _w === void 0 ? void 0 : _w.permissionView) || undefined
                                         });
                                     }
-                                    return [3 /*break*/, 20];
-                                case 19:
+                                    return [3 /*break*/, 21];
+                                case 20:
                                     error_2 = _13.sent();
                                     recordStep('Response: initial draft failed', {
                                         message: normalizeOptionalString(error_2 === null || error_2 === void 0 ? void 0 : error_2.message) || 'Unknown error'
                                     });
-                                    return [3 /*break*/, 20];
-                                case 20:
-                                    if (!(!directive && dataQuestion)) return [3 /*break*/, 24];
+                                    return [3 /*break*/, 21];
+                                case 21:
+                                    if (!(!directive && dataQuestion)) return [3 /*break*/, 25];
                                     recordStep('Directive: forced retry', { mode: 'directive-only' });
                                     directivePrompt = buildAssistantCodexDirectivePrompt(message, attachmentData.promptText, historyLines.join('\n'), assistantContext, directiveStyleHint, directivePromptMode);
-                                    _13.label = 21;
-                                case 21:
-                                    _13.trys.push([21, 23, , 24]);
+                                    _13.label = 22;
+                                case 22:
+                                    _13.trys.push([22, 24, , 25]);
                                     forcedStart = Date.now();
                                     return [4 /*yield*/, runCodexInWorkerThread(directivePrompt, runOptions, codexConfig, streamProgress)];
-                                case 22:
+                                case 23:
                                     directiveText = _13.sent();
                                     accumulateCodexUsage(directivePrompt, directiveText);
                                     timingBreakdown.forcedDirectiveMs = Date.now() - forcedStart;
@@ -2062,15 +2110,15 @@ function executeAiAssistantCodexRun(payload, context) {
                                             permissionView: normalizeOptionalString((_z = directive.payload) === null || _z === void 0 ? void 0 : _z.permissionView) || undefined
                                         });
                                     }
-                                    return [3 /*break*/, 24];
-                                case 23:
-                                    _d = _13.sent();
-                                    return [3 /*break*/, 24];
+                                    return [3 /*break*/, 25];
                                 case 24:
+                                    _d = _13.sent();
+                                    return [3 /*break*/, 25];
+                                case 25:
                                     if (!(directive
                                         && enforceDatedDirective
                                         && !isAssistantDeterministicHeuristicDirective(directive)
-                                        && !isAssistantDirectiveDated(directive))) return [3 /*break*/, 28];
+                                        && !isAssistantDirectiveDated(directive))) return [3 /*break*/, 29];
                                     recordStep('Directive: dated retry', {
                                         currentType: directive.type,
                                         timeGrain: requestedTimeGrain || undefined
@@ -2082,12 +2130,12 @@ function executeAiAssistantCodexRun(payload, context) {
                                         requestedBreakdowns: requestedBreakdownDimensions,
                                         strict: true
                                     }), 'aggregate_only');
-                                    _13.label = 25;
-                                case 25:
-                                    _13.trys.push([25, 27, , 28]);
+                                    _13.label = 26;
+                                case 26:
+                                    _13.trys.push([26, 28, , 29]);
                                     strictStart = Date.now();
                                     return [4 /*yield*/, runCodexInWorkerThread(strictDirectivePrompt, runOptions, codexConfig, streamProgress)];
-                                case 26:
+                                case 27:
                                     strictDirectiveText = _13.sent();
                                     accumulateCodexUsage(strictDirectivePrompt, strictDirectiveText);
                                     timingBreakdown.forcedDirectiveMs += Date.now() - strictStart;
@@ -2109,15 +2157,15 @@ function executeAiAssistantCodexRun(payload, context) {
                                             timeGrain: requestedTimeGrain || undefined
                                         });
                                     }
-                                    return [3 /*break*/, 28];
-                                case 27:
-                                    _e = _13.sent();
-                                    return [3 /*break*/, 28];
+                                    return [3 /*break*/, 29];
                                 case 28:
+                                    _e = _13.sent();
+                                    return [3 /*break*/, 29];
+                                case 29:
                                     if (!(directive
                                         && enforceDatedDirective
                                         && !isAssistantDeterministicHeuristicDirective(directive)
-                                        && directive.type === 'read')) return [3 /*break*/, 32];
+                                        && directive.type === 'read')) return [3 /*break*/, 33];
                                     recordStep('Directive: dated guard retry', {
                                         currentType: directive.type,
                                         timeGrain: requestedTimeGrain || undefined
@@ -2129,12 +2177,12 @@ function executeAiAssistantCodexRun(payload, context) {
                                         requestedBreakdowns: requestedBreakdownDimensions,
                                         strict: true
                                     }), 'aggregate_only');
-                                    _13.label = 29;
-                                case 29:
-                                    _13.trys.push([29, 31, , 32]);
+                                    _13.label = 30;
+                                case 30:
+                                    _13.trys.push([30, 32, , 33]);
                                     guardStart = Date.now();
                                     return [4 /*yield*/, runCodexInWorkerThread(guardDirectivePrompt, runOptions, codexConfig, streamProgress)];
-                                case 30:
+                                case 31:
                                     guardDirectiveText = _13.sent();
                                     accumulateCodexUsage(guardDirectivePrompt, guardDirectiveText);
                                     timingBreakdown.forcedDirectiveMs += Date.now() - guardStart;
@@ -2154,15 +2202,15 @@ function executeAiAssistantCodexRun(payload, context) {
                                             timeGrain: requestedTimeGrain || undefined
                                         });
                                     }
-                                    return [3 /*break*/, 32];
-                                case 31:
-                                    _f = _13.sent();
-                                    return [3 /*break*/, 32];
+                                    return [3 /*break*/, 33];
                                 case 32:
+                                    _f = _13.sent();
+                                    return [3 /*break*/, 33];
+                                case 33:
                                     if (!(directive
                                         && enforceGroupedDirective
                                         && !isAssistantDeterministicHeuristicDirective(directive)
-                                        && !isAssistantDirectiveGrouped(directive))) return [3 /*break*/, 36];
+                                        && !isAssistantDirectiveGrouped(directive))) return [3 /*break*/, 37];
                                     recordStep('Directive: grouped guard retry', {
                                         currentType: directive.type,
                                         breakdownDimensions: requestedBreakdownDimensions.length ? requestedBreakdownDimensions : undefined
@@ -2174,12 +2222,12 @@ function executeAiAssistantCodexRun(payload, context) {
                                         requestedBreakdowns: requestedBreakdownDimensions,
                                         strict: true
                                     }), 'aggregate_only');
-                                    _13.label = 33;
-                                case 33:
-                                    _13.trys.push([33, 35, , 36]);
+                                    _13.label = 34;
+                                case 34:
+                                    _13.trys.push([34, 36, , 37]);
                                     groupedStart = Date.now();
                                     return [4 /*yield*/, runCodexInWorkerThread(groupedDirectivePrompt, runOptions, codexConfig, streamProgress)];
-                                case 34:
+                                case 35:
                                     groupedDirectiveText = _13.sent();
                                     accumulateCodexUsage(groupedDirectivePrompt, groupedDirectiveText);
                                     timingBreakdown.forcedDirectiveMs += Date.now() - groupedStart;
@@ -2202,11 +2250,11 @@ function executeAiAssistantCodexRun(payload, context) {
                                             timeGrain: requestedTimeGrain || undefined
                                         });
                                     }
-                                    return [3 /*break*/, 36];
-                                case 35:
-                                    _g = _13.sent();
-                                    return [3 /*break*/, 36];
+                                    return [3 /*break*/, 37];
                                 case 36:
+                                    _g = _13.sent();
+                                    return [3 /*break*/, 37];
+                                case 37:
                                     if (!directive && dataQuestion) {
                                         heuristicDirective = buildAssistantHeuristicDirective(message, collectionHints);
                                         if (isAssistantExecutableDirective(heuristicDirective)) {
@@ -2245,7 +2293,7 @@ function executeAiAssistantCodexRun(payload, context) {
                                     if (cleanedResponseText) {
                                         assistantContent = sanitizeAssistantResponse(cleanedResponseText);
                                     }
-                                    if (!((directive === null || directive === void 0 ? void 0 : directive.payload) && AI_ASSISTANT_TOOL_MAX_STEPS > 0)) return [3 /*break*/, 49];
+                                    if (!((directive === null || directive === void 0 ? void 0 : directive.payload) && AI_ASSISTANT_TOOL_MAX_STEPS > 0)) return [3 /*break*/, 50];
                                     effectiveDirective = collectionOverride
                                         ? __assign(__assign({}, directive), { payload: __assign(__assign({}, (directive.payload || {})), { collection: collectionOverride.to }) }) : directive;
                                     toolRequest = buildAssistantToolRequest(effectiveDirective, input);
@@ -2255,20 +2303,20 @@ function executeAiAssistantCodexRun(payload, context) {
                                         collection: normalizeOptionalString(toolRequest === null || toolRequest === void 0 ? void 0 : toolRequest.collection) || undefined,
                                         permissionView: normalizeOptionalString(toolRequest === null || toolRequest === void 0 ? void 0 : toolRequest.permissionView) || undefined
                                     });
-                                    _13.label = 37;
-                                case 37:
-                                    _13.trys.push([37, 47, , 48]);
+                                    _13.label = 38;
+                                case 38:
+                                    _13.trys.push([38, 48, , 49]);
                                     toolStart = Date.now();
-                                    if (!(effectiveDirective.type === 'aggregate')) return [3 /*break*/, 39];
+                                    if (!(effectiveDirective.type === 'aggregate')) return [3 /*break*/, 40];
                                     return [4 /*yield*/, executeAiAssistantReportBuilderAggregate(toolRequest, context)];
-                                case 38:
+                                case 39:
                                     _h = _13.sent();
-                                    return [3 /*break*/, 41];
-                                case 39: return [4 /*yield*/, executeAiAssistantReportBuilderRead(toolRequest, context)];
-                                case 40:
-                                    _h = _13.sent();
-                                    _13.label = 41;
+                                    return [3 /*break*/, 42];
+                                case 40: return [4 /*yield*/, executeAiAssistantReportBuilderRead(toolRequest, context)];
                                 case 41:
+                                    _h = _13.sent();
+                                    _13.label = 42;
+                                case 42:
                                     toolResponse = _h;
                                     timingBreakdown.toolMs = Date.now() - toolStart;
                                     toolResponseDebug = (toolResponse === null || toolResponse === void 0 ? void 0 : toolResponse.debug) && typeof toolResponse.debug === 'object'
@@ -2284,54 +2332,54 @@ function executeAiAssistantCodexRun(payload, context) {
                                     progressTracker.push('Drafting response');
                                     skipFollowupCodex = usedDeterministicHeuristicFastPath
                                         || isAssistantDeterministicHeuristicDirective(effectiveDirective);
-                                    if (!skipFollowupCodex) return [3 /*break*/, 42];
+                                    if (!skipFollowupCodex) return [3 /*break*/, 43];
                                     recordStep('Drafting response: deterministic summary', {
                                         reason: normalizeOptionalString(effectiveDirective.rawLine) || 'deterministic_heuristic'
                                     });
                                     assistantContent = buildAssistantToolFallbackResponse(toolPayload.result);
                                     assistantContent = applyAssistantDisplayTableToResponse(assistantContent, toolPayload.result.output.display);
-                                    return [3 /*break*/, 46];
-                                case 42:
+                                    return [3 /*break*/, 47];
+                                case 43:
                                     recordStep('Drafting response');
                                     followupPrompt = buildAssistantCodexToolFollowupPrompt(message, attachmentData.promptText, historyLines.join('\n'), assistantContext, toolPayload.prompt);
-                                    _13.label = 43;
-                                case 43:
-                                    _13.trys.push([43, 45, , 46]);
+                                    _13.label = 44;
+                                case 44:
+                                    _13.trys.push([44, 46, , 47]);
                                     followupStart = Date.now();
                                     return [4 /*yield*/, runCodexInWorkerThread(followupPrompt, runOptions, codexConfig, streamProgress)];
-                                case 44:
+                                case 45:
                                     followupText = _13.sent();
                                     accumulateCodexUsage(followupPrompt, followupText);
                                     timingBreakdown.followupMs = Date.now() - followupStart;
                                     assistantContent = sanitizeAssistantResponse(followupText);
                                     assistantContent = applyAssistantDisplayTableToResponse(assistantContent, toolPayload.result.output.display);
-                                    return [3 /*break*/, 46];
-                                case 45:
+                                    return [3 /*break*/, 47];
+                                case 46:
                                     _j = _13.sent();
                                     assistantContent = buildAssistantToolFallbackResponse(toolPayload.result);
                                     assistantContent = applyAssistantDisplayTableToResponse(assistantContent, toolPayload.result.output.display);
-                                    return [3 /*break*/, 46];
-                                case 46: return [3 /*break*/, 48];
-                                case 47:
+                                    return [3 /*break*/, 47];
+                                case 47: return [3 /*break*/, 49];
+                                case 48:
                                     error_3 = _13.sent();
                                     assistantContent = buildAssistantToolErrorMessage(error_3);
                                     toolError = error_3;
-                                    return [3 /*break*/, 48];
-                                case 48: return [3 /*break*/, 50];
-                                case 49:
+                                    return [3 /*break*/, 49];
+                                case 49: return [3 /*break*/, 51];
+                                case 50:
                                     progressTracker.push('Drafting response');
                                     recordStep('Drafting response');
-                                    _13.label = 50;
-                                case 50: return [3 /*break*/, 53];
-                                case 51:
+                                    _13.label = 51;
+                                case 51: return [3 /*break*/, 54];
+                                case 52:
                                     error_4 = _13.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*/, 53];
-                                case 52:
+                                    return [3 /*break*/, 54];
+                                case 53:
                                     progressTracker.stop();
                                     return [7 /*endfinally*/];
-                                case 53:
+                                case 54:
                                     if (!assistantContent) {
                                         assistantContent = buildAssistantCodexErrorMessage(null);
                                     }
@@ -2388,6 +2436,8 @@ function executeAiAssistantCodexRun(payload, context) {
                                                     termHints: termHints.length ? termHints : undefined,
                                                     collectionHints: collectionHints.length ? collectionHints : undefined,
                                                     fieldHints: fieldHints.length ? fieldHints : undefined,
+                                                    methodHints: methodHints.length ? methodHints : undefined,
+                                                    publicationHints: publicationHints.length ? publicationHints : undefined,
                                                     collectionTokenization: collectionTokenization || undefined,
                                                     collectionRanking: collectionRanking || undefined,
                                                     collectionSelection: collectionSelection || undefined,
@@ -2427,14 +2477,14 @@ function executeAiAssistantCodexRun(payload, context) {
                                         output_tokens: codexUsage.output_tokens,
                                         total_tokens: codexUsage.total_tokens
                                     } : null;
-                                    if (!finalUsage) return [3 /*break*/, 58];
+                                    if (!finalUsage) return [3 /*break*/, 59];
                                     return [4 /*yield*/, resolveClientId(conversation, input.id_client, context === null || context === void 0 ? void 0 : context.id_user)];
-                                case 54:
-                                    usageClientId = _13.sent();
-                                    if (!usageClientId) return [3 /*break*/, 58];
-                                    _13.label = 55;
                                 case 55:
-                                    _13.trys.push([55, 57, , 58]);
+                                    usageClientId = _13.sent();
+                                    if (!usageClientId) return [3 /*break*/, 59];
+                                    _13.label = 56;
+                                case 56:
+                                    _13.trys.push([56, 58, , 59]);
                                     return [4 /*yield*/, (0, openai_usage_ledger_manager_1.recordOpenAIUsage)({
                                             id_client: usageClientId,
                                             model: finalUsage.model,
@@ -2445,16 +2495,16 @@ function executeAiAssistantCodexRun(payload, context) {
                                             id_request: requestId || undefined,
                                             id_conversation: conversation._id
                                         })];
-                                case 56:
-                                    _13.sent();
-                                    return [3 /*break*/, 58];
                                 case 57:
+                                    _13.sent();
+                                    return [3 /*break*/, 59];
+                                case 58:
                                     usageError_1 = _13.sent();
                                     console.error(new Date(), 'Failed to record codex usage', usageError_1);
-                                    return [3 /*break*/, 58];
-                                case 58:
+                                    return [3 /*break*/, 59];
+                                case 59:
                                     finalAssistantDoc = __assign(__assign(__assign(__assign({}, assistantDoc), { _id: assistantMessageId, content: assistantContent, metadata: finalMetadata }), (finalUsage ? { usage: finalUsage } : {})), { updatedAt: finalNow });
-                                    if (!assistantMessageId) return [3 /*break*/, 60];
+                                    if (!assistantMessageId) return [3 /*break*/, 61];
                                     setPayload = {
                                         content: assistantContent,
                                         metadata: finalMetadata,
@@ -2464,18 +2514,18 @@ function executeAiAssistantCodexRun(payload, context) {
                                         setPayload.usage = finalUsage;
                                     }
                                     return [4 /*yield*/, updateAssistantMessageWithFallback(assistantMessageId, setPayload)];
-                                case 59:
+                                case 60:
                                     _13.sent();
-                                    _13.label = 60;
-                                case 60: return [4 /*yield*/, touchConversation(conversation._id, finalNow, assistantMessageId ? String(assistantMessageId) : undefined)];
-                                case 61:
+                                    _13.label = 61;
+                                case 61: return [4 /*yield*/, touchConversation(conversation._id, finalNow, assistantMessageId ? String(assistantMessageId) : undefined)];
+                                case 62:
                                     _13.sent();
-                                    if (!(input.delete_files_after_run !== false)) return [3 /*break*/, 63];
+                                    if (!(input.delete_files_after_run !== false)) return [3 /*break*/, 64];
                                     return [4 /*yield*/, cleanupAttachments(attachmentData.attachments)];
-                                case 62:
+                                case 63:
                                     _13.sent();
-                                    _13.label = 63;
-                                case 63: return [2 /*return*/, finalAssistantDoc];
+                                    _13.label = 64;
+                                case 64: return [2 /*return*/, finalAssistantDoc];
                             }
                         });
                     }); });
@@ -3003,7 +3053,9 @@ function executeAiAssistantMongoRead(payload, context) {
                 case 34:
                     hasActiveStatusFilters = collectAssistantActiveMatchFields(executedQuery).length > 0;
                     if (!(!documents.length && crossCollectionRetryEnabled && !hasActiveStatusFilters)) return [3 /*break*/, 44];
-                    return [4 /*yield*/, resolveAssistantAvailableCrossCollectionFallbacks(db, dbName, collection, triedCollections)];
+                    return [4 /*yield*/, resolveAssistantAvailableCrossCollectionFallbacks(db, dbName, collection, triedCollections, {
+                            fieldHints: extractQueryFieldPaths(executedQuery || {})
+                        })];
                 case 35:
                     crossCollectionCandidates = _s.sent();
                     if (!crossCollectionCandidates.length) return [3 /*break*/, 43];
@@ -3277,7 +3329,7 @@ function executeAiAssistantMongoRead(payload, context) {
 }
 function executeAiAssistantMongoAggregate(payload, context) {
     return __awaiter(this, void 0, void 0, function () {
-        var input, rawCollection, retryState, triedCollections, crossCollectionRetryEnabled, dbName, db, collectionResolution, collection, bridgeCollection, retryRootCollection, schemaFields, effectivePermissionView, _a, user, isSuperAdmin, customerId, fallbackMeta, baseQuery, stripped, userId, normalizedClient, shouldScopeByClient, _b, clientScopedQuery, scopedQuery, normalizedPipeline, sanitizedPipeline, strippedPipeline, pipelineWithScope, normalizedOptions, limitedPipeline, executedPipeline, dateField, aggregateOptions, runAggregateWithRepair, initialAggregate, documents, probeDocs, fallback, fallbackPipeline, fallbackAggregate, fallbackDocs, createdFallback, createdPipeline, createdAggregate, createdDocs, expanded, expandedAggregate, expandedDocs, completionFallback, fallbackPipeline, fallbackAggregate, fallbackDocs, completionExprFallback, fallbackPipeline, fallbackAggregate, fallbackDocs, unwindFallback, shouldUnwind, _c, _d, fallbackPipeline, fallbackAggregate, fallbackDocs, nameFallback, fallbackPipeline, fallbackAggregate, fallbackDocs, _e, _loop_1, i, state_1, matchFields_1, _f, aliases, rewrittenPipeline, fallbackAggregate, fallbackDocs, _loop_2, i, state_2, nestedFallbacks, nestedFallbacks_1, nestedFallbacks_1_1, nestedFallback, fallbackPayload, fallbackResult, existingFallbacks, error_6, errorMessage, existingErrors, e_2_1, baseCollection, fallbackPayload, fallbackResult, existingFallbacks, crossCollectionCandidates, crossCollectionCandidates_2, crossCollectionCandidates_2_1, candidateCollection, fallbackPayload, fallbackResult, fallbackDocs, existingFallbacks, rejectedQuality, e_3_1, matchStages, diagnostics, combinedMatch, nameFields, dateFields, queryNoName, _g, queryNoDate, _h, _j, _k, _l, allCollections, base, alt, altCount, _m, verification, sanitizedDocuments, includeIds, displayDocs, idLookupDisplay, display;
+        var input, rawCollection, retryState, triedCollections, crossCollectionRetryEnabled, dbName, db, collectionResolution, collection, bridgeCollection, retryRootCollection, schemaFields, effectivePermissionView, _a, user, isSuperAdmin, customerId, fallbackMeta, baseQuery, stripped, userId, normalizedClient, shouldScopeByClient, _b, clientScopedQuery, scopedQuery, normalizedPipeline, sanitizedPipeline, strippedPipeline, pipelineWithScope, normalizedOptions, limitedPipeline, executedPipeline, dateField, aggregateOptions, runAggregateWithRepair, initialAggregate, documents, probeDocs, fallback, fallbackPipeline, fallbackAggregate, fallbackDocs, createdFallback, createdPipeline, createdAggregate, createdDocs, expanded, expandedAggregate, expandedDocs, completionFallback, fallbackPipeline, fallbackAggregate, fallbackDocs, completionExprFallback, fallbackPipeline, fallbackAggregate, fallbackDocs, unwindFallback, shouldUnwind, _c, _d, fallbackPipeline, fallbackAggregate, fallbackDocs, nameFallback, fallbackPipeline, fallbackAggregate, fallbackDocs, _e, _loop_1, i, state_1, matchFields_1, _f, aliases, rewrittenPipeline, fallbackAggregate, fallbackDocs, _loop_2, i, state_2, nestedFallbacks, nestedFallbacks_1, nestedFallbacks_1_1, nestedFallback, fallbackPayload, fallbackResult, existingFallbacks, error_6, errorMessage, existingErrors, e_2_1, baseCollection, fallbackPayload, fallbackResult, existingFallbacks, fallbackAcceptanceOptions, crossCollectionCandidates, crossCollectionCandidates_2, crossCollectionCandidates_2_1, candidateCollection, fallbackPayload, fallbackResult, fallbackDocs, fallbackQuality, existingFallbacks, rejectedQuality, e_3_1, matchStages, diagnostics, combinedMatch, nameFields, dateFields, queryNoName, _g, queryNoDate, _h, _j, _k, _l, allCollections, base, alt, altCount, _m, verification, sanitizedDocuments, includeIds, displayDocs, idLookupDisplay, display;
         var e_2, _o, e_3, _p;
         var _this = this;
         var _q, _r;
@@ -3367,7 +3419,7 @@ function executeAiAssistantMongoAggregate(payload, context) {
                         ? applyClientScopeFilter(baseQuery, normalizedClient, isSuperAdmin)
                         : baseQuery;
                     scopedQuery = applyCustomerScopeFilter(clientScopedQuery, collection, customerId, isSuperAdmin);
-                    normalizedPipeline = normalizeAssistantAggregatePipeline(input.pipeline, collection);
+                    normalizedPipeline = normalizeAssistantAggregatePipeline(input.pipeline, collection, input.__assistantMessage);
                     sanitizedPipeline = normalizedPipeline;
                     if (!isSuperAdmin && customerId) {
                         strippedPipeline = stripScopedFieldsFromPipelineWithMeta(normalizedPipeline, ['id_customer', 'other.id_customer']);
@@ -3388,7 +3440,7 @@ function executeAiAssistantMongoAggregate(payload, context) {
                     }
                     aggregateOptions = __assign(__assign({}, normalizedOptions.aggregateOptions), { readPreference: AI_ASSISTANT_READ_PREFERENCE });
                     runAggregateWithRepair = function (pipeline, stage) { return __awaiter(_this, void 0, void 0, function () {
-                        var docs, error_7, isDateRepair, isRankSortByRepair, isDottedOutputFieldRepair, repaired, docs;
+                        var docs, error_7, isDateRepair, isRankSortByRepair, isDottedOutputFieldRepair, repaired, dottedFieldPath, dottedFieldReferenceRepairUsed, pathReferenceRepair, docs;
                         return __generator(this, function (_a) {
                             switch (_a.label) {
                                 case 0:
@@ -3412,6 +3464,21 @@ function executeAiAssistantMongoAggregate(payload, context) {
                                         : isRankSortByRepair
                                             ? repairAssistantRankSortByInPipeline(pipeline)
                                             : repairAssistantDottedOutputFieldNamesInPipeline(pipeline);
+                                    dottedFieldPath = null;
+                                    dottedFieldReferenceRepairUsed = false;
+                                    if (isDottedOutputFieldRepair) {
+                                        dottedFieldPath = extractAssistantDottedFieldPathFromError(error_7);
+                                        if (dottedFieldPath) {
+                                            pathReferenceRepair = repairAssistantFieldPathReferenceInPipeline(repaired.pipeline, dottedFieldPath);
+                                            if (pathReferenceRepair.changed) {
+                                                dottedFieldReferenceRepairUsed = true;
+                                                repaired = {
+                                                    pipeline: pathReferenceRepair.pipeline,
+                                                    changed: repaired.changed || pathReferenceRepair.changed
+                                                };
+                                            }
+                                        }
+                                    }
                                     if (!repaired.changed || containsForbiddenMongoOperators(repaired.pipeline)) {
                                         throw error_7;
                                     }
@@ -3441,7 +3508,10 @@ function executeAiAssistantMongoAggregate(payload, context) {
                                             attempted: true,
                                             used: true,
                                             stage: stage,
-                                            reason: 'normalized_dotted_output_field_names'
+                                            reason: dottedFieldReferenceRepairUsed
+                                                ? 'normalized_dotted_output_field_names_and_field_path_references'
+                                                : 'normalized_dotted_output_field_names',
+                                            fieldPath: dottedFieldPath || undefined
                                         };
                                     }
                                     return [2 /*return*/, { documents: docs, pipeline: repaired.pipeline }];
@@ -3935,7 +4005,10 @@ function executeAiAssistantMongoAggregate(payload, context) {
                     _s.label = 56;
                 case 56:
                     if (!(!documents.length && crossCollectionRetryEnabled)) return [3 /*break*/, 65];
-                    return [4 /*yield*/, resolveAssistantAvailableCrossCollectionFallbacks(db, dbName, collection, triedCollections)];
+                    fallbackAcceptanceOptions = buildAssistantAggregateFallbackAcceptanceOptions(executedPipeline || []);
+                    return [4 /*yield*/, resolveAssistantAvailableCrossCollectionFallbacks(db, dbName, collection, triedCollections, {
+                            fieldHints: collectAggregateReferencedFieldPaths(executedPipeline || [])
+                        })];
                 case 57:
                     crossCollectionCandidates = _s.sent();
                     if (!crossCollectionCandidates.length) return [3 /*break*/, 65];
@@ -3963,7 +4036,8 @@ function executeAiAssistantMongoAggregate(payload, context) {
                 case 60:
                     fallbackResult = _s.sent();
                     fallbackDocs = Array.isArray(fallbackResult === null || fallbackResult === void 0 ? void 0 : fallbackResult.documents) ? fallbackResult.documents : [];
-                    if (fallbackDocs.length && shouldAcceptAssistantFallbackDocuments(fallbackDocs)) {
+                    fallbackQuality = evaluateAssistantFallbackDocumentsQuality(fallbackDocs, fallbackAcceptanceOptions);
+                    if (fallbackDocs.length && fallbackQuality.accepted) {
                         if (isSuperAdmin && (fallbackResult === null || fallbackResult === void 0 ? void 0 : fallbackResult.debug) && typeof fallbackResult.debug === 'object') {
                             existingFallbacks = fallbackResult.debug.fallbacks && typeof fallbackResult.debug.fallbacks === 'object'
                                 ? fallbackResult.debug.fallbacks
@@ -3984,7 +4058,12 @@ function executeAiAssistantMongoAggregate(payload, context) {
                             : [];
                         rejectedQuality.push({
                             collection: candidateCollection,
-                            reason: 'empty_dimension_values'
+                            reason: 'sparse_dimension_values',
+                            rowCount: fallbackQuality.rowCount,
+                            dimensionFields: fallbackQuality.dimensionFields,
+                            bestField: fallbackQuality.bestField,
+                            bestFillRate: (0, common_1.round)(fallbackQuality.bestFillRate * 100, 2),
+                            averageFillRate: (0, common_1.round)(fallbackQuality.averageFillRate * 100, 2)
                         });
                         fallbackMeta.collectionRetry.rejectedQuality = rejectedQuality;
                     }
@@ -4798,6 +4877,12 @@ function buildAssistantToolRequest(directive, payload) {
     if (!request.mongo && (payload === null || payload === void 0 ? void 0 : payload.mongo)) {
         request.mongo = payload.mongo;
     }
+    if (directive.type === 'aggregate' && !request.__assistantMessage) {
+        var message = normalizeOptionalString(payload === null || payload === void 0 ? void 0 : payload.message);
+        if (message) {
+            request.__assistantMessage = message;
+        }
+    }
     return request;
 }
 function buildAssistantTrimmedStringExpr(value) {
@@ -4944,6 +5029,139 @@ function resolveAssistantGenericTimeGrain(message) {
     }
     return null;
 }
+function resolveAssistantBlendThroughputWindowDays(message) {
+    var window = resolveAssistantGenericWindow(message);
+    if (!window) {
+        return null;
+    }
+    var amount = Math.max((0, common_1.round)(window.amount || 0), 1);
+    switch (window.unit) {
+        case 'day':
+            return amount;
+        case 'week':
+            return amount * 7;
+        case 'month':
+            return amount * 30;
+        case 'year':
+            return amount * 365;
+        default:
+            return null;
+    }
+}
+function shouldUseAssistantBlendThroughputHeuristic(message) {
+    var normalized = normalizeOptionalString(message).toLowerCase();
+    if (!normalized) {
+        return false;
+    }
+    if (!/\bblend(?:ing|s)?\b/.test(normalized)) {
+        return false;
+    }
+    if (!/\b(throughput|volume|output)\b/.test(normalized)) {
+        return false;
+    }
+    var requestedGrain = resolveAssistantRequestedTimeGrain(message);
+    var genericGrain = resolveAssistantGenericTimeGrain(message);
+    var grain = requestedGrain || genericGrain;
+    if (grain && grain !== 'day') {
+        return false;
+    }
+    if (/\b(by|per|each)\s+day\b|\bdaily\b/.test(normalized)) {
+        return true;
+    }
+    return !grain;
+}
+function buildAssistantBlendThroughputDirective(message) {
+    if (!shouldUseAssistantBlendThroughputHeuristic(message)) {
+        return null;
+    }
+    var resolvedDays = resolveAssistantBlendThroughputWindowDays(message);
+    if (!resolvedDays || resolvedDays <= 0) {
+        return null;
+    }
+    var windowDays = Math.min(Math.max((0, common_1.round)(resolvedDays), 1), 366);
+    var startOfDayExpr = { $dateTrunc: { date: '$$NOW', unit: 'day' } };
+    return {
+        type: 'aggregate',
+        payload: {
+            collection: 'chemical-blends',
+            permissionView: '/chemical-blend/list',
+            pipeline: [
+                {
+                    $match: {
+                        $and: [
+                            { 'deleted.is_deleted': false },
+                            {
+                                $expr: {
+                                    $and: [
+                                        {
+                                            $gte: [
+                                                '$date',
+                                                {
+                                                    $dateSubtract: {
+                                                        startDate: startOfDayExpr,
+                                                        unit: 'day',
+                                                        amount: windowDays
+                                                    }
+                                                }
+                                            ]
+                                        },
+                                        {
+                                            $lt: [
+                                                '$date',
+                                                startOfDayExpr
+                                            ]
+                                        }
+                                    ]
+                                }
+                            }
+                        ]
+                    }
+                },
+                {
+                    $group: {
+                        _id: {
+                            day: {
+                                $dateTrunc: {
+                                    date: '$date',
+                                    unit: 'day'
+                                }
+                            }
+                        },
+                        total_gal: {
+                            $sum: {
+                                $ifNull: ['$quantity', 0]
+                            }
+                        },
+                        total_lb: {
+                            $sum: {
+                                $ifNull: ['$quantity_pounds', 0]
+                            }
+                        }
+                    }
+                },
+                {
+                    $project: {
+                        _id: 0,
+                        day: '$_id.day',
+                        total_gal: 1,
+                        total_lb: 1
+                    }
+                },
+                {
+                    $sort: {
+                        day: 1
+                    }
+                }
+            ],
+            options: {
+                allowDiskUse: true,
+                limit: Math.min(windowDays + 6, 400)
+            }
+        },
+        cleaned: '',
+        rawLine: 'HEURISTIC_AGG(blend-throughput-day-window)'
+    };
+}
 function resolveAssistantGenericPersonName(message) {
     var e_4, _a;
     var raw = normalizeOptionalString(message);
@@ -5410,13 +5628,22 @@ function isAssistantSchemaHoursHeuristicDirective(directive) {
     var rawLine = normalizeOptionalString(directive === null || directive === void 0 ? void 0 : directive.rawLine).toLowerCase();
     return rawLine.includes('heuristic_agg(schema-hours-user-time)');
 }
+function isAssistantBlendThroughputHeuristicDirective(directive) {
+    var rawLine = normalizeOptionalString(directive === null || directive === void 0 ? void 0 : directive.rawLine).toLowerCase();
+    return rawLine.includes('heuristic_agg(blend-throughput-day-window)');
+}
 function isAssistantDeterministicHeuristicDirective(directive) {
-    return isAssistantSchemaHoursHeuristicDirective(directive);
+    return isAssistantSchemaHoursHeuristicDirective(directive)
+        || isAssistantBlendThroughputHeuristicDirective(directive);
 }
 function buildAssistantHeuristicDirective(message, collectionHints) {
     if (!normalizeOptionalString(message)) {
         return null;
     }
+    var blendThroughputDirective = buildAssistantBlendThroughputDirective(message);
+    if (blendThroughputDirective) {
+        return blendThroughputDirective;
+    }
     var schemaHoursDirective = buildAssistantGenericHoursDirective(message, collectionHints);
     if (schemaHoursDirective) {
         return schemaHoursDirective;
@@ -6866,63 +7093,74 @@ function tokenizeFieldKey(value) {
 function normalizeFieldMatchKey(value) {
     return tokenizeFieldKey(value).join('');
 }
-function getCollectionSchemaFieldNames(collectionName) {
+function getAssistantCollectionMetadata(collectionName) {
     var _a;
     var normalized = normalizeOptionalString(collectionName);
     if (!normalized) {
-        return [];
+        return { fields: [], lookups: [] };
+    }
+    var now = Date.now();
+    var cached = AI_ASSISTANT_COLLECTION_METADATA_CACHE.get(normalized);
+    if (cached && now - cached.updatedAt < AI_ASSISTANT_COLLECTION_METADATA_CACHE_TTL_MS) {
+        return {
+            fields: cached.fields,
+            lookups: cached.lookups
+        };
     }
     try {
         var collection = (_a = resolveio_server_app_1.ResolveIOServer.getMongoManager()) === null || _a === void 0 ? void 0 : _a.collection(normalized);
         var schema = collection === null || collection === void 0 ? void 0 : collection.simplschema;
-        var fields_1 = schema && typeof schema.schema === 'function'
-            ? Object.keys(schema.schema())
-            : [];
-        var rbSchema = collection === null || collection === void 0 ? void 0 : collection.rbSchema;
-        if (rbSchema && typeof rbSchema === 'object') {
-            Object.keys(rbSchema).forEach(function (field) {
-                if (field && !fields_1.includes(field)) {
-                    fields_1.push(field);
+        var rbSchema_1 = collection === null || collection === void 0 ? void 0 : collection.rbSchema;
+        var fieldSet_1 = new Set();
+        var lookups_1 = [];
+        if (schema && typeof schema.schema === 'function') {
+            Object.keys(schema.schema()).forEach(function (field) {
+                var normalizedField = normalizeOptionalString(field);
+                if (normalizedField) {
+                    fieldSet_1.add(normalizedField);
+                }
+            });
+        }
+        if (rbSchema_1 && typeof rbSchema_1 === 'object') {
+            Object.keys(rbSchema_1).forEach(function (field) {
+                var normalizedField = normalizeOptionalString(field);
+                if (normalizedField) {
+                    fieldSet_1.add(normalizedField);
+                }
+                var entry = rbSchema_1[field];
+                if (!entry || typeof entry !== 'object') {
+                    return;
+                }
+                var lookupCollection = normalizeOptionalString(entry.lookup_collection);
+                var localKey = normalizeOptionalString(entry.local_key);
+                if (!lookupCollection || !localKey) {
+                    return;
                 }
+                var lookupKey = normalizeOptionalString(entry.lookup_key) || '_id';
+                lookups_1.push({ localKey: localKey, lookupCollection: lookupCollection, lookupKey: lookupKey });
             });
         }
-        return fields_1;
+        var value = {
+            fields: Array.from(fieldSet_1),
+            lookups: lookups_1
+        };
+        AI_ASSISTANT_COLLECTION_METADATA_CACHE.set(normalized, __assign(__assign({}, value), { updatedAt: now }));
+        return value;
     }
     catch (_b) {
-        return [];
+        return cached
+            ? {
+                fields: cached.fields,
+                lookups: cached.lookups
+            }
+            : { fields: [], lookups: [] };
     }
 }
+function getCollectionSchemaFieldNames(collectionName) {
+    return getAssistantCollectionMetadata(collectionName).fields;
+}
 function getCollectionLookupMappings(collectionName) {
-    var _a;
-    var normalized = normalizeOptionalString(collectionName);
-    if (!normalized) {
-        return [];
-    }
-    try {
-        var collection = (_a = resolveio_server_app_1.ResolveIOServer.getMongoManager()) === null || _a === void 0 ? void 0 : _a.collection(normalized);
-        var rbSchema_1 = collection === null || collection === void 0 ? void 0 : collection.rbSchema;
-        if (!rbSchema_1 || typeof rbSchema_1 !== 'object') {
-            return [];
-        }
-        var mappings_1 = [];
-        Object.keys(rbSchema_1).forEach(function (key) {
-            var entry = rbSchema_1[key];
-            if (!entry || typeof entry !== 'object') {
-                return;
-            }
-            var lookupCollection = normalizeOptionalString(entry.lookup_collection);
-            var localKey = normalizeOptionalString(entry.local_key);
-            if (!lookupCollection || !localKey) {
-                return;
-            }
-            var lookupKey = normalizeOptionalString(entry.lookup_key) || '_id';
-            mappings_1.push({ localKey: localKey, lookupCollection: lookupCollection, lookupKey: lookupKey });
-        });
-        return mappings_1;
-    }
-    catch (_b) {
-        return [];
-    }
+    return getAssistantCollectionMetadata(collectionName).lookups;
 }
 function normalizeLookupPath(value) {
     var trimmed = normalizeOptionalString(value);
@@ -7235,51 +7473,105 @@ function collectTopLevelIdFieldValues(docs, options) {
         });
     });
 }
-function resolveLookupDisplayField(baseToken, probeDocs, schemaFields) {
-    var e_12, _a, e_13, _b;
+function resolveLookupDisplayFieldCandidates(baseToken, probeDocs, schemaFields) {
     var normalizedBase = normalizeOptionalString(baseToken);
     if (!normalizedBase) {
-        return null;
+        return [];
     }
-    var candidates = buildNameLookupFields(normalizedBase, probeDocs || []);
+    var seededCandidates = buildNameLookupFields(normalizedBase, probeDocs || []);
     var schema = Array.isArray(schemaFields) ? schemaFields : [];
-    if (schema.length) {
-        var schemaCandidates = candidates.filter(function (candidate) { return schema.includes(candidate); });
-        if (schemaCandidates.length) {
-            try {
-                for (var schemaCandidates_1 = __values(schemaCandidates), schemaCandidates_1_1 = schemaCandidates_1.next(); !schemaCandidates_1_1.done; schemaCandidates_1_1 = schemaCandidates_1.next()) {
-                    var candidate = schemaCandidates_1_1.value;
-                    if (hasNonEmptyValue(probeDocs || [], candidate, { treatObjectLikeAsEmpty: true })) {
-                        return candidate;
-                    }
-                }
-            }
-            catch (e_12_1) { e_12 = { error: e_12_1 }; }
-            finally {
-                try {
-                    if (schemaCandidates_1_1 && !schemaCandidates_1_1.done && (_a = schemaCandidates_1.return)) _a.call(schemaCandidates_1);
-                }
-                finally { if (e_12) throw e_12.error; }
-            }
-            return schemaCandidates[0];
+    var schemaCandidates = schema.filter(function (field) {
+        var normalized = normalizeOptionalString(field).toLowerCase();
+        if (!normalized) {
+            return false;
         }
-    }
-    try {
-        for (var candidates_1 = __values(candidates), candidates_1_1 = candidates_1.next(); !candidates_1_1.done; candidates_1_1 = candidates_1.next()) {
-            var candidate = candidates_1_1.value;
-            if (hasNonEmptyValue(probeDocs || [], candidate, { treatObjectLikeAsEmpty: true })) {
-                return candidate;
-            }
+        if (!/(name|label|title|display|billing|company|account|client|customer|full)/.test(normalized)) {
+            return false;
         }
-    }
-    catch (e_13_1) { e_13 = { error: e_13_1 }; }
-    finally {
-        try {
-            if (candidates_1_1 && !candidates_1_1.done && (_b = candidates_1.return)) _b.call(candidates_1);
+        return !/(^|\.)(id|code|number|count|qty|quantity|total)(\.|_|$)/.test(normalized);
+    });
+    var probeFieldStats = collectFieldCandidates(probeDocs || []);
+    var probeCandidates = Array.from(probeFieldStats.entries())
+        .filter(function (_a) {
+        var _b = __read(_a, 2), stats = _b[1];
+        return stats.nonEmpty > 0;
+    })
+        .map(function (_a) {
+        var _b = __read(_a, 1), field = _b[0];
+        return field;
+    })
+        .filter(function (field) {
+        var normalized = normalizeOptionalString(field).toLowerCase();
+        if (!normalized) {
+            return false;
+        }
+        if (!/(name|label|title|display|billing|company|account|client|customer|full)/.test(normalized)) {
+            return false;
+        }
+        return !/(^|\.)(id|code|number|count|qty|quantity|total)(\.|_|$)/.test(normalized);
+    });
+    return normalizeAggregateFieldList(__spreadArray(__spreadArray(__spreadArray([], __read(seededCandidates), false), __read(schemaCandidates), false), __read(probeCandidates), false)).slice(0, 24);
+}
+function scoreLookupDisplayFieldFromDocs(field, lookupDocs) {
+    var docs = Array.isArray(lookupDocs) ? lookupDocs : [];
+    var uniqueValues = new Set();
+    var nonEmptyCount = 0;
+    docs.forEach(function (doc) {
+        var _a;
+        var raw = (_a = getValueAtPath(doc, field)) !== null && _a !== void 0 ? _a : doc === null || doc === void 0 ? void 0 : doc[field];
+        if (isEmptyDisplayValue(raw) || isDisplayObjectLike(raw)) {
+            return;
+        }
+        var text = normalizeOptionalString(typeof raw === 'string' ? raw : String(raw));
+        if (!text) {
+            return;
         }
-        finally { if (e_13) throw e_13.error; }
+        nonEmptyCount += 1;
+        uniqueValues.add(text.toLowerCase());
+    });
+    var fillRate = docs.length ? (nonEmptyCount / docs.length) : 0;
+    var uniqueCount = uniqueValues.size;
+    var normalizedField = normalizeOptionalString(field).toLowerCase();
+    var semanticBonus = 0;
+    if (/billing_name|customer_name|client_name|company_name/.test(normalizedField)) {
+        semanticBonus += 18;
+    }
+    if (/(^|\.)(name|label|title|display_name|displayname|fullname|full_name)(\.|_|$)/.test(normalizedField)) {
+        semanticBonus += 12;
+    }
+    if (/(^|\.)(id|code|number|count|qty|quantity|total)(\.|_|$)/.test(normalizedField)) {
+        semanticBonus -= 20;
+    }
+    var score = (fillRate * 100) + (Math.min(uniqueCount, nonEmptyCount) * 3) + semanticBonus;
+    return {
+        field: field,
+        score: score,
+        fillRate: fillRate,
+        uniqueCount: uniqueCount,
+        nonEmptyCount: nonEmptyCount
+    };
+}
+function resolveBestLookupDisplayFieldFromDocs(candidates, lookupDocs) {
+    var normalizedCandidates = normalizeAggregateFieldList(candidates || []);
+    if (!normalizedCandidates.length) {
+        return null;
     }
-    return candidates.length ? candidates[0] : null;
+    var ranked = normalizedCandidates
+        .map(function (field) { return scoreLookupDisplayFieldFromDocs(field, lookupDocs); })
+        .filter(function (entry) { return entry.nonEmptyCount > 0; })
+        .sort(function (a, b) {
+        if (a.score !== b.score) {
+            return b.score - a.score;
+        }
+        if (a.fillRate !== b.fillRate) {
+            return b.fillRate - a.fillRate;
+        }
+        if (a.uniqueCount !== b.uniqueCount) {
+            return b.uniqueCount - a.uniqueCount;
+        }
+        return a.field.localeCompare(b.field);
+    });
+    return ranked[0] || null;
 }
 function resolveLookupMappingsForField(field, mappings) {
     var normalizedField = normalizeLookupPath(field);
@@ -7290,8 +7582,8 @@ function resolveLookupMappingsForField(field, mappings) {
 }
 function applyIdLookupDisplayEnrichment(params) {
     return __awaiter(this, void 0, void 0, function () {
-        var docs, collection, db, dbName, idClient, idCustomer, isSuperAdmin, idFields, lookupMappings, allCollections, collectionProbeCache, collectionSchemaCache, lookupMeta, enrichedDocs, _loop_4, idFields_1, idFields_1_1, fieldEntry, e_14_1;
-        var e_14, _a;
+        var docs, collection, db, dbName, idClient, idCustomer, isSuperAdmin, idFields, lookupMappings, allCollections, collectionProbeCache, collectionSchemaCache, lookupMeta, enrichedDocs, _loop_4, idFields_1, idFields_1_1, fieldEntry, e_12_1;
+        var e_12, _a;
         return __generator(this, function (_b) {
             switch (_b.label) {
                 case 0:
@@ -7315,8 +7607,8 @@ function applyIdLookupDisplayEnrichment(params) {
                     lookupMeta = [];
                     enrichedDocs = docs.map(function (doc) { return (__assign({}, doc)); });
                     _loop_4 = function (fieldEntry) {
-                        var values, baseToken, mappingMatches, candidateCollections, filteredCandidates, _loop_5, filteredCandidates_1, filteredCandidates_1_1, candidate, state_3, e_15_1;
-                        var e_15, _c;
+                        var values, baseToken, mappingMatches, candidateCollections, filteredCandidates, _loop_5, filteredCandidates_1, filteredCandidates_1_1, candidate, state_3, e_13_1;
+                        var e_13, _c;
                         return __generator(this, function (_d) {
                             switch (_d.label) {
                                 case 0:
@@ -7342,7 +7634,7 @@ function applyIdLookupDisplayEnrichment(params) {
                                         return [2 /*return*/, "continue"];
                                     }
                                     _loop_5 = function (candidate) {
-                                        var probeDocs, candidateHasClientScope, _e, schemaFields, nameField, mapping, lookupKey, idsForQuery, query, candidateHasClientScope, _f, lookupDocs, nameMap, displayField;
+                                        var probeDocs, candidateHasClientScope, _e, schemaFields, nameFieldCandidates, mapping, lookupKey, idsForQuery, query, candidateHasClientScope, _f, projection, lookupDocs, bestLookupField, nameField, nameMap, displayField;
                                         var _g, _h;
                                         return __generator(this, function (_j) {
                                             switch (_j.label) {
@@ -7375,8 +7667,8 @@ function applyIdLookupDisplayEnrichment(params) {
                                                     schemaFields = collectionSchemaCache.get(candidate)
                                                         || getCollectionSchemaFieldNames(candidate);
                                                     collectionSchemaCache.set(candidate, schemaFields);
-                                                    nameField = resolveLookupDisplayField(baseToken, probeDocs, schemaFields);
-                                                    if (!nameField) {
+                                                    nameFieldCandidates = resolveLookupDisplayFieldCandidates(baseToken, probeDocs, schemaFields);
+                                                    if (!nameFieldCandidates.length) {
                                                         return [2 /*return*/, "continue"];
                                                     }
                                                     mapping = mappingMatches.find(function (entry) { return entry.lookupCollection === candidate; });
@@ -7402,16 +7694,26 @@ function applyIdLookupDisplayEnrichment(params) {
                                                     }
                                                     query = applyCustomerScopeFilter(query, candidate, idCustomer, isSuperAdmin);
                                                     _j.label = 9;
-                                                case 9: return [4 /*yield*/, db.collection(candidate).find(query, {
-                                                        projection: (_h = {}, _h[lookupKey] = 1, _h[nameField] = 1, _h),
-                                                        limit: AI_ASSISTANT_ID_DISPLAY_LOOKUP_MAX_IDS,
-                                                        readPreference: AI_ASSISTANT_READ_PREFERENCE
-                                                    }).toArray()];
+                                                case 9:
+                                                    projection = (_h = {}, _h[lookupKey] = 1, _h);
+                                                    nameFieldCandidates.forEach(function (field) {
+                                                        projection[field] = 1;
+                                                    });
+                                                    return [4 /*yield*/, db.collection(candidate).find(query, {
+                                                            projection: projection,
+                                                            limit: AI_ASSISTANT_ID_DISPLAY_LOOKUP_MAX_IDS,
+                                                            readPreference: AI_ASSISTANT_READ_PREFERENCE
+                                                        }).toArray()];
                                                 case 10:
                                                     lookupDocs = _j.sent();
                                                     if (!lookupDocs.length) {
                                                         return [2 /*return*/, "continue"];
                                                     }
+                                                    bestLookupField = resolveBestLookupDisplayFieldFromDocs(nameFieldCandidates, lookupDocs);
+                                                    if (!(bestLookupField === null || bestLookupField === void 0 ? void 0 : bestLookupField.field)) {
+                                                        return [2 /*return*/, "continue"];
+                                                    }
+                                                    nameField = bestLookupField.field;
                                                     nameMap = new Map();
                                                     lookupDocs.forEach(function (doc) {
                                                         var _a, _b;
@@ -7454,6 +7756,9 @@ function applyIdLookupDisplayEnrichment(params) {
                                                         displayField: displayField,
                                                         collection: candidate,
                                                         nameField: nameField,
+                                                        nameFieldFillRate: (0, common_1.round)(bestLookupField.fillRate * 100, 2),
+                                                        nameFieldUniqueValues: bestLookupField.uniqueCount,
+                                                        candidateFieldsTested: nameFieldCandidates.length,
                                                         idCount: values.length,
                                                         matched: nameMap.size,
                                                         strategy: mapping ? 'schema' : 'token'
@@ -7465,7 +7770,7 @@ function applyIdLookupDisplayEnrichment(params) {
                                     _d.label = 1;
                                 case 1:
                                     _d.trys.push([1, 6, 7, 8]);
-                                    filteredCandidates_1 = (e_15 = void 0, __values(filteredCandidates)), filteredCandidates_1_1 = filteredCandidates_1.next();
+                                    filteredCandidates_1 = (e_13 = void 0, __values(filteredCandidates)), filteredCandidates_1_1 = filteredCandidates_1.next();
                                     _d.label = 2;
                                 case 2:
                                     if (!!filteredCandidates_1_1.done) return [3 /*break*/, 5];
@@ -7481,14 +7786,14 @@ function applyIdLookupDisplayEnrichment(params) {
                                     return [3 /*break*/, 2];
                                 case 5: return [3 /*break*/, 8];
                                 case 6:
-                                    e_15_1 = _d.sent();
-                                    e_15 = { error: e_15_1 };
+                                    e_13_1 = _d.sent();
+                                    e_13 = { error: e_13_1 };
                                     return [3 /*break*/, 8];
                                 case 7:
                                     try {
                                         if (filteredCandidates_1_1 && !filteredCandidates_1_1.done && (_c = filteredCandidates_1.return)) _c.call(filteredCandidates_1);
                                     }
-                                    finally { if (e_15) throw e_15.error; }
+                                    finally { if (e_13) throw e_13.error; }
                                     return [7 /*endfinally*/];
                                 case 8: return [2 /*return*/];
                             }
@@ -7511,14 +7816,14 @@ function applyIdLookupDisplayEnrichment(params) {
                     return [3 /*break*/, 3];
                 case 6: return [3 /*break*/, 9];
                 case 7:
-                    e_14_1 = _b.sent();
-                    e_14 = { error: e_14_1 };
+                    e_12_1 = _b.sent();
+                    e_12 = { error: e_12_1 };
                     return [3 /*break*/, 9];
                 case 8:
                     try {
                         if (idFields_1_1 && !idFields_1_1.done && (_a = idFields_1.return)) _a.call(idFields_1);
                     }
-                    finally { if (e_14) throw e_14.error; }
+                    finally { if (e_12) throw e_12.error; }
                     return [7 /*endfinally*/];
                 case 9:
                     if (!lookupMeta.length) {
@@ -7537,7 +7842,7 @@ function applyIdLookupDisplayEnrichment(params) {
     });
 }
 function hasNonEmptyValue(docs, fieldPath, options) {
-    var e_16, _a;
+    var e_14, _a;
     if (!Array.isArray(docs) || !fieldPath) {
         return false;
     }
@@ -7554,12 +7859,12 @@ function hasNonEmptyValue(docs, fieldPath, options) {
             }
         }
     }
-    catch (e_16_1) { e_16 = { error: e_16_1 }; }
+    catch (e_14_1) { e_14 = { error: e_14_1 }; }
     finally {
         try {
             if (docs_4_1 && !docs_4_1.done && (_a = docs_4.return)) _a.call(docs_4);
         }
-        finally { if (e_16) throw e_16.error; }
+        finally { if (e_14) throw e_14.error; }
     }
     return false;
 }
@@ -8336,7 +8641,7 @@ function isAssistantCurrencyColumn(column) {
     return hasMoneyHint;
 }
 function isAssistantDateColumn(column) {
-    return /(date|time|created|updated|timestamp|at)\b/.test(column);
+    return /(date|day|week|time|created|updated|timestamp|period)\b/.test(column) || /_at\b/.test(column);
 }
 function isAssistantLikelyDateValue(value) {
     if (!value) {
@@ -8346,10 +8651,17 @@ function isAssistantLikelyDateValue(value) {
         return true;
     }
     if (typeof value === 'string') {
-        if (!/[0-9]/.test(value)) {
+        var normalized = value.trim();
+        if (!normalized || !/[0-9]/.test(normalized)) {
+            return false;
+        }
+        if (/^\d{1,6}$/.test(normalized) || /^\d{4}$/.test(normalized)) {
+            return false;
+        }
+        if (!/[-/:T\s]/.test(normalized) && !/^\d{8}$/.test(normalized)) {
             return false;
         }
-        var parsed = Date.parse(value);
+        var parsed = Date.parse(normalized);
         return !Number.isNaN(parsed);
     }
     return false;
@@ -9549,6 +9861,23 @@ function isAssistantDottedOutputFieldError(error) {
     }
     return message.includes("fieldpath field names may not contain '.'");
 }
+function extractAssistantDottedFieldPathFromError(error) {
+    var message = normalizeOptionalString(error === null || error === void 0 ? void 0 : error.message);
+    if (!message) {
+        return null;
+    }
+    var quotedMatch = message.match(/given\s+'([^']+)'/i);
+    if (quotedMatch && quotedMatch[1]) {
+        var normalized = normalizeOptionalString(quotedMatch[1]);
+        return normalized.includes('.') ? normalized : null;
+    }
+    var plainMatch = message.match(/given\s+([a-z0-9_.-]+)/i);
+    if (plainMatch && plainMatch[1]) {
+        var normalized = normalizeOptionalString(plainMatch[1]);
+        return normalized.includes('.') ? normalized : null;
+    }
+    return null;
+}
 function didAssistantValueChange(before, after) {
     try {
         return JSON.stringify(before) !== JSON.stringify(after);
@@ -9637,6 +9966,59 @@ function repairAssistantDottedOutputFieldNamesInPipeline(pipeline) {
         changed: didAssistantValueChange(pipeline, repaired)
     };
 }
+function buildAssistantGetFieldExpressionFromPath(path) {
+    var normalizedPath = normalizeOptionalString(path);
+    var segments = normalizedPath.split('.').filter(Boolean);
+    if (!segments.length) {
+        return "$".concat(normalizedPath);
+    }
+    var expression = "$".concat(segments[0]);
+    for (var i = 1; i < segments.length; i += 1) {
+        expression = {
+            $getField: {
+                field: segments[i],
+                input: expression
+            }
+        };
+    }
+    return expression;
+}
+function repairAssistantFieldPathReferenceInPipeline(pipeline, fieldPath) {
+    var normalizedFieldPath = normalizeOptionalString(fieldPath).replace(/^\$+/, '');
+    if (!normalizedFieldPath || !normalizedFieldPath.includes('.')) {
+        return { pipeline: pipeline, changed: false };
+    }
+    var targetRef = "$".concat(normalizedFieldPath);
+    var rewriteValue = function (value) {
+        if (Array.isArray(value)) {
+            return value.map(function (entry) { return rewriteValue(entry); });
+        }
+        if (typeof value === 'string') {
+            if (value === targetRef) {
+                return buildAssistantGetFieldExpressionFromPath(normalizedFieldPath);
+            }
+            if (value.startsWith("".concat(targetRef, "."))) {
+                return buildAssistantGetFieldExpressionFromPath(value.slice(1));
+            }
+            return value;
+        }
+        if (!value || typeof value !== 'object' || value instanceof Date || value instanceof RegExp || isMongoObjectId(value)) {
+            return value;
+        }
+        var next = {};
+        Object.keys(value).forEach(function (key) {
+            next[key] = rewriteValue(value[key]);
+        });
+        return next;
+    };
+    var repaired = Array.isArray(pipeline)
+        ? pipeline.map(function (stage) { return rewriteValue(stage); })
+        : pipeline;
+    return {
+        pipeline: repaired,
+        changed: didAssistantValueChange(pipeline, repaired)
+    };
+}
 function isMatchExpressionOperand(value) {
     if (typeof value === 'string') {
         return value.startsWith('$$');
@@ -9899,7 +10281,7 @@ function flattenAssistantExprClauses(expr) {
     return [expr];
 }
 function detectAssistantMonthWindowInExpr(expr, allowedDateFields) {
-    var e_17, _a;
+    var e_15, _a;
     var clauses = flattenAssistantExprClauses(expr);
     if (!clauses.length) {
         return null;
@@ -9973,12 +10355,12 @@ function detectAssistantMonthWindowInExpr(expr, allowedDateFields) {
                 return state_4.value;
         }
     }
-    catch (e_17_1) { e_17 = { error: e_17_1 }; }
+    catch (e_15_1) { e_15 = { error: e_15_1 }; }
     finally {
         try {
             if (lowerClauses_1_1 && !lowerClauses_1_1.done && (_a = lowerClauses_1.return)) _a.call(lowerClauses_1);
         }
-        finally { if (e_17) throw e_17.error; }
+        finally { if (e_15) throw e_15.error; }
     }
     return null;
 }
@@ -10041,7 +10423,7 @@ function resolveAssistantMonthlyGroupDateFields(pipeline) {
     return fields;
 }
 function detectAssistantMonthWindowFromPipeline(pipeline) {
-    var e_18, _a;
+    var e_16, _a;
     var _b;
     var monthlyFields = resolveAssistantMonthlyGroupDateFields(pipeline);
     var scanMatch = function (match) {
@@ -10069,12 +10451,12 @@ function detectAssistantMonthWindowFromPipeline(pipeline) {
             }
         }
     }
-    catch (e_18_1) { e_18 = { error: e_18_1 }; }
+    catch (e_16_1) { e_16 = { error: e_16_1 }; }
     finally {
         try {
             if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
         }
-        finally { if (e_18) throw e_18.error; }
+        finally { if (e_16) throw e_16.error; }
     }
     return null;
 }
@@ -10178,7 +10560,234 @@ function normalizeAssistantSortTieBreakersForLimit(pipeline) {
         return __assign(__assign({}, stage), { $sort: __assign(__assign({}, sort), { _id: 1 }) });
     });
 }
-function normalizeAssistantAggregatePipeline(pipeline, collection) {
+function resolveAssistantRecentGroupedRecordLimit(message) {
+    var normalized = normalizeOptionalString(message);
+    if (!normalized) {
+        return null;
+    }
+    if (!/\b(last|latest|recent)\b/i.test(normalized)) {
+        return null;
+    }
+    var groupedHint = /\bgroup(?:ed|ing)?\s+by\b/i.test(normalized)
+        || /\bby\s+(status|state|type)\b/i.test(normalized);
+    if (!groupedHint) {
+        return null;
+    }
+    if (/\b(by|per)\s+(day|week|month|quarter|year)\b/i.test(normalized) || /\btrend|over\s+time|timeline\b/i.test(normalized)) {
+        return null;
+    }
+    var tokenMatch = normalized.match(/\b(?:last|latest|recent)\s+(\d{1,4})\s+([a-z][a-z_-]*)\b/i);
+    if (!tokenMatch) {
+        return null;
+    }
+    var entityToken = normalizeOptionalString(tokenMatch[2]).toLowerCase();
+    if (['minute', 'minutes', 'hour', 'hours', 'day', 'days', 'week', 'weeks', 'month', 'months', 'quarter', 'quarters', 'year', 'years'].includes(entityToken)) {
+        return null;
+    }
+    var value = Number(tokenMatch[1]);
+    if (!Number.isFinite(value) || value <= 0) {
+        return null;
+    }
+    return Math.max(1, Math.min((0, common_1.round)(value), AI_ASSISTANT_MONGO_MAX_LIMIT));
+}
+function normalizeAssistantRecentGroupedLimitBeforeGroup(pipeline, message) {
+    var _a;
+    var requestedLimit = resolveAssistantRecentGroupedRecordLimit(message || '');
+    if (!requestedLimit || !Array.isArray(pipeline) || !pipeline.length) {
+        return pipeline;
+    }
+    var groupIndex = findAggregateGroupIndex(pipeline);
+    if (groupIndex <= 0) {
+        return pipeline;
+    }
+    var hasPreGroupLimit = pipeline
+        .slice(0, groupIndex)
+        .some(function (stage) { return stage && typeof stage === 'object' && typeof stage.$limit === 'number' && stage.$limit > 0; });
+    if (hasPreGroupLimit) {
+        return pipeline;
+    }
+    var postGroupLimitIndex = pipeline.findIndex(function (stage, index) {
+        return index > groupIndex
+            && stage
+            && typeof stage === 'object'
+            && typeof stage.$limit === 'number'
+            && stage.$limit > 0;
+    });
+    var nextPipeline = pipeline
+        .map(function (stage) { return (stage && typeof stage === 'object' && !Array.isArray(stage) ? __assign({}, stage) : stage); })
+        .filter(function (_stage, index) { return index !== postGroupLimitIndex; });
+    var insertionIndex = groupIndex;
+    var hasPreGroupSort = nextPipeline
+        .slice(0, groupIndex)
+        .some(function (stage) { return stage && typeof stage === 'object' && stage.$sort && typeof stage.$sort === 'object'; });
+    if (!hasPreGroupSort) {
+        var dateField = findAggregateDateField(nextPipeline) || 'createdAt';
+        nextPipeline.splice(insertionIndex, 0, { $sort: (_a = {}, _a[dateField] = -1, _a._id = -1, _a) });
+        insertionIndex += 1;
+    }
+    nextPipeline.splice(insertionIndex, 0, { $limit: requestedLimit });
+    return nextPipeline;
+}
+function isAssistantCustomerLookupCollectionName(value) {
+    var normalized = normalizeOptionalString(value).toLowerCase();
+    if (!normalized) {
+        return false;
+    }
+    return /(customer|client|account)/.test(normalized);
+}
+function isAssistantCustomerLabelFieldName(field) {
+    var normalized = normalizeOptionalString(field).toLowerCase();
+    if (!normalized) {
+        return false;
+    }
+    return /(customer|client|account|company)/.test(normalized)
+        && !/(id|count|number|qty|quantity|total)/.test(normalized);
+}
+function isAssistantCustomerLookupLeafName(path) {
+    var normalized = normalizeOptionalString(path).toLowerCase();
+    if (!normalized) {
+        return false;
+    }
+    var leaf = normalized.split('.').pop() || normalized;
+    return /(name|billing|company|display|label|title|account|client|customer|full)/.test(leaf)
+        && !/(id|count|number|qty|quantity|total)/.test(leaf);
+}
+function buildAssistantCustomerLookupBestLabelExpr(lookupAlias, fallbackPaths) {
+    var alias = normalizeOptionalString(lookupAlias);
+    if (!alias) {
+        return buildAssistantTrimmedStringExpr('$id_customer');
+    }
+    var aliasPrefix = "$".concat(alias);
+    var candidatePaths = normalizeAggregateFieldList(__spreadArray([
+        "".concat(aliasPrefix, ".billing_name"),
+        "".concat(aliasPrefix, ".customer_name"),
+        "".concat(aliasPrefix, ".name"),
+        "".concat(aliasPrefix, ".fullname"),
+        "".concat(aliasPrefix, ".full_name"),
+        "".concat(aliasPrefix, ".display_name"),
+        "".concat(aliasPrefix, ".displayName"),
+        "".concat(aliasPrefix, ".label"),
+        "".concat(aliasPrefix, ".title"),
+        "".concat(aliasPrefix, ".company_name"),
+        "".concat(aliasPrefix, ".company"),
+        "".concat(aliasPrefix, ".client_name"),
+        "".concat(aliasPrefix, ".clientName"),
+        "".concat(aliasPrefix, ".account_name"),
+        "".concat(aliasPrefix, ".accountName"),
+        "".concat(aliasPrefix, ".quickbooks.FullName"),
+        "".concat(aliasPrefix, ".quickbooks.fullname"),
+        "".concat(aliasPrefix, ".quickbooks.Name"),
+        "".concat(aliasPrefix, ".quickbooks.name")
+    ], __read(fallbackPaths), false));
+    var candidateValues = candidatePaths.map(function (path) { return buildAssistantTrimmedStringExpr(path); });
+    return {
+        $let: {
+            vars: {
+                candidate_values: candidateValues
+            },
+            in: {
+                $ifNull: [
+                    {
+                        $arrayElemAt: [
+                            {
+                                $filter: {
+                                    input: '$$candidate_values',
+                                    as: 'candidate',
+                                    cond: { $gt: [{ $strLenCP: '$$candidate' }, 0] }
+                                }
+                            },
+                            0
+                        ]
+                    },
+                    ''
+                ]
+            }
+        }
+    };
+}
+function normalizeAssistantCustomerLookupProjectionPipeline(pipeline) {
+    if (!Array.isArray(pipeline) || !pipeline.length) {
+        return pipeline;
+    }
+    var lookupAliasToLocalField = new Map();
+    var changed = false;
+    var normalizedPipeline = pipeline.map(function (stage) { return (stage && typeof stage === 'object' && !Array.isArray(stage)
+        ? __assign({}, stage) : stage); });
+    normalizedPipeline.forEach(function (stage) {
+        if (!stage || typeof stage !== 'object' || Array.isArray(stage)) {
+            return;
+        }
+        var lookup = stage.$lookup;
+        if (lookup && typeof lookup === 'object' && !Array.isArray(lookup)) {
+            var lookupFrom = normalizeOptionalString(lookup.from);
+            var lookupAlias = normalizeOptionalString(lookup.as);
+            if (lookupAlias && isAssistantCustomerLookupCollectionName(lookupFrom)) {
+                lookupAliasToLocalField.set(lookupAlias, normalizeOptionalString(lookup.localField));
+            }
+            return;
+        }
+        if (!lookupAliasToLocalField.size) {
+            return;
+        }
+        var project = stage.$project;
+        if (!project || typeof project !== 'object' || Array.isArray(project)) {
+            return;
+        }
+        var nextProject = __assign({}, project);
+        var stageChanged = false;
+        Object.keys(nextProject).forEach(function (field) {
+            var e_17, _a;
+            var expression = nextProject[field];
+            if (typeof expression !== 'string') {
+                return;
+            }
+            var expressionPath = normalizeOptionalString(expression);
+            if (!expressionPath || !expressionPath.startsWith('$')) {
+                return;
+            }
+            try {
+                for (var _b = __values(lookupAliasToLocalField.entries()), _c = _b.next(); !_c.done; _c = _b.next()) {
+                    var _d = __read(_c.value, 2), lookupAlias = _d[0], localField = _d[1];
+                    var aliasPath = "$".concat(lookupAlias);
+                    if (expressionPath !== aliasPath && !expressionPath.startsWith("".concat(aliasPath, "."))) {
+                        continue;
+                    }
+                    var lookupLeafPath = expressionPath === aliasPath
+                        ? ''
+                        : expressionPath.slice(aliasPath.length + 1);
+                    if (!isAssistantCustomerLabelFieldName(field) && !isAssistantCustomerLookupLeafName(lookupLeafPath)) {
+                        continue;
+                    }
+                    var fallbackPaths = normalizeAggregateFieldList([
+                        localField ? "$".concat(localField) : '',
+                        '$_id',
+                        '$id_customer',
+                        '$id_client',
+                        '$customer',
+                        '$customer_name',
+                        '$client_name'
+                    ]);
+                    nextProject[field] = buildAssistantCustomerLookupBestLabelExpr(lookupAlias, fallbackPaths);
+                    stageChanged = true;
+                    break;
+                }
+            }
+            catch (e_17_1) { e_17 = { error: e_17_1 }; }
+            finally {
+                try {
+                    if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+                }
+                finally { if (e_17) throw e_17.error; }
+            }
+        });
+        if (stageChanged) {
+            stage.$project = nextProject;
+            changed = true;
+        }
+    });
+    return changed ? normalizedPipeline : pipeline;
+}
+function normalizeAssistantAggregatePipeline(pipeline, collection, originalMessage) {
     if (!Array.isArray(pipeline)) {
         return [];
     }
@@ -10205,7 +10814,9 @@ function normalizeAssistantAggregatePipeline(pipeline, collection) {
         return normalizeAssistantNowExprPlaceholdersDeep(next);
     });
     var stableSortPipeline = normalizeAssistantSortTieBreakersForLimit(normalizedPipeline);
-    return normalizeAssistantMonthlyCalendarWindowPipeline(stableSortPipeline);
+    var recordLimitedPipeline = normalizeAssistantRecentGroupedLimitBeforeGroup(stableSortPipeline, originalMessage);
+    var customerLookupNormalizedPipeline = normalizeAssistantCustomerLookupProjectionPipeline(recordLimitedPipeline);
+    return normalizeAssistantMonthlyCalendarWindowPipeline(customerLookupNormalizedPipeline);
 }
 function buildAssistantAggregatePipeline(query, pipeline) {
     var _a;
@@ -10334,7 +10945,7 @@ function matchContainsField(value, field) {
     });
 }
 function resolveAggregateCompletionFallback(pipeline) {
-    var e_19, _a;
+    var e_18, _a;
     if (!Array.isArray(pipeline)) {
         return null;
     }
@@ -10347,7 +10958,7 @@ function resolveAggregateCompletionFallback(pipeline) {
         }
         var addFields = stage.$addFields;
         try {
-            for (var _b = (e_19 = void 0, __values(Object.keys(addFields))), _c = _b.next(); !_c.done; _c = _b.next()) {
+            for (var _b = (e_18 = void 0, __values(Object.keys(addFields))), _c = _b.next(); !_c.done; _c = _b.next()) {
                 var key = _c.value;
                 if (!isCompletionFieldName(key)) {
                     continue;
@@ -10361,12 +10972,12 @@ function resolveAggregateCompletionFallback(pipeline) {
                 }
             }
         }
-        catch (e_19_1) { e_19 = { error: e_19_1 }; }
+        catch (e_18_1) { e_18 = { error: e_18_1 }; }
         finally {
             try {
                 if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
             }
-            finally { if (e_19) throw e_19.error; }
+            finally { if (e_18) throw e_18.error; }
         }
         if (candidateField) {
             break;
@@ -10522,7 +11133,7 @@ function buildCompletionFallbackSources(field) {
     ]);
 }
 function resolveAggregateCompletionExprFallback(pipeline) {
-    var e_20, _a;
+    var e_19, _a;
     if (!Array.isArray(pipeline)) {
         return null;
     }
@@ -10542,7 +11153,7 @@ function resolveAggregateCompletionExprFallback(pipeline) {
         }
         if (!candidateField) {
             try {
-                for (var _b = (e_20 = void 0, __values(Object.keys(matchStage))), _c = _b.next(); !_c.done; _c = _b.next()) {
+                for (var _b = (e_19 = void 0, __values(Object.keys(matchStage))), _c = _b.next(); !_c.done; _c = _b.next()) {
                     var key = _c.value;
                     if (key.startsWith('$')) {
                         continue;
@@ -10557,12 +11168,12 @@ function resolveAggregateCompletionExprFallback(pipeline) {
                     }
                 }
             }
-            catch (e_20_1) { e_20 = { error: e_20_1 }; }
+            catch (e_19_1) { e_19 = { error: e_19_1 }; }
             finally {
                 try {
                     if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
                 }
-                finally { if (e_20) throw e_20.error; }
+                finally { if (e_19) throw e_19.error; }
             }
         }
         if (!candidateField) {
@@ -10641,6 +11252,68 @@ function findAggregateGroupIndex(pipeline) {
     }
     return -1;
 }
+function doesAssistantAggregateRequireDimension(pipeline) {
+    var _a;
+    var groupIndex = findAggregateGroupIndex(pipeline || []);
+    if (groupIndex === -1) {
+        return false;
+    }
+    var groupStage = pipeline[groupIndex];
+    var groupId = (_a = groupStage === null || groupStage === void 0 ? void 0 : groupStage.$group) === null || _a === void 0 ? void 0 : _a._id;
+    if (groupId === null || groupId === undefined) {
+        return false;
+    }
+    if (typeof groupId === 'object' && !Array.isArray(groupId) && Object.keys(groupId).length === 0) {
+        return false;
+    }
+    return true;
+}
+function resolveAssistantAggregateDimensionFieldHints(pipeline) {
+    var groupIndex = findAggregateGroupIndex(pipeline || []);
+    if (groupIndex === -1) {
+        return [];
+    }
+    var hints = [];
+    var pushHint = function (value) {
+        var normalized = normalizeOptionalString(value);
+        if (!normalized || hints.includes(normalized)) {
+            return;
+        }
+        hints.push(normalized);
+    };
+    var _loop_7 = function (index) {
+        var stage = pipeline[index];
+        if (!stage || typeof stage !== 'object' || Array.isArray(stage) || !stage.$project || typeof stage.$project !== 'object') {
+            return "continue";
+        }
+        Object.keys(stage.$project).forEach(function (key) {
+            if (key === '_id') {
+                return;
+            }
+            var expression = stage.$project[key];
+            if (expression === 0 || expression === false) {
+                return;
+            }
+            if (!isAssistantCustomerLabelFieldName(key) && !/(name|label|title|customer|client|account|vendor|location|well|chemical|status|type|group|category)/i.test(key)) {
+                return;
+            }
+            pushHint(formatDisplayColumnName(key) || key);
+            pushHint(key);
+        });
+    };
+    for (var index = groupIndex + 1; index < pipeline.length; index += 1) {
+        _loop_7(index);
+    }
+    return hints.slice(0, 6);
+}
+function buildAssistantAggregateFallbackAcceptanceOptions(pipeline) {
+    var requireDimensionFields = doesAssistantAggregateRequireDimension(pipeline || []);
+    return {
+        requireDimensionFields: requireDimensionFields,
+        minDimensionFillRate: requireDimensionFields ? 0.35 : 0.1,
+        preferredDimensionFields: resolveAssistantAggregateDimensionFieldHints(pipeline || [])
+    };
+}
 function extractGroupFieldPaths(groupStage) {
     if (!groupStage || typeof groupStage !== 'object') {
         return [];
@@ -10702,7 +11375,7 @@ function hasAssistantDateGroupingOperator(value) {
     return Object.keys(value).some(function (key) { return hasAssistantDateGroupingOperator(value[key]); });
 }
 function isGroupFieldDerivedFromDateExpression(pipeline, groupIndex, groupPaths) {
-    var e_21, _a, e_22, _b;
+    var e_20, _a, e_21, _b;
     if (!Array.isArray(pipeline) || groupIndex <= 0 || !groupPaths.length) {
         return false;
     }
@@ -10728,14 +11401,14 @@ function isGroupFieldDerivedFromDateExpression(pipeline, groupIndex, groupPaths)
             continue;
         }
         try {
-            for (var stageKeys_1 = (e_21 = void 0, __values(stageKeys)), stageKeys_1_1 = stageKeys_1.next(); !stageKeys_1_1.done; stageKeys_1_1 = stageKeys_1.next()) {
+            for (var stageKeys_1 = (e_20 = void 0, __values(stageKeys)), stageKeys_1_1 = stageKeys_1.next(); !stageKeys_1_1.done; stageKeys_1_1 = stageKeys_1.next()) {
                 var stageKey = stageKeys_1_1.value;
                 var payload = stage[stageKey];
                 if (!payload || typeof payload !== 'object' || Array.isArray(payload)) {
                     continue;
                 }
                 try {
-                    for (var groupFields_1 = (e_22 = void 0, __values(groupFields)), groupFields_1_1 = groupFields_1.next(); !groupFields_1_1.done; groupFields_1_1 = groupFields_1.next()) {
+                    for (var groupFields_1 = (e_21 = void 0, __values(groupFields)), groupFields_1_1 = groupFields_1.next(); !groupFields_1_1.done; groupFields_1_1 = groupFields_1.next()) {
                         var groupField = groupFields_1_1.value;
                         if (!Object.prototype.hasOwnProperty.call(payload, groupField)) {
                             continue;
@@ -10745,21 +11418,21 @@ function isGroupFieldDerivedFromDateExpression(pipeline, groupIndex, groupPaths)
                         }
                     }
                 }
-                catch (e_22_1) { e_22 = { error: e_22_1 }; }
+                catch (e_21_1) { e_21 = { error: e_21_1 }; }
                 finally {
                     try {
                         if (groupFields_1_1 && !groupFields_1_1.done && (_b = groupFields_1.return)) _b.call(groupFields_1);
                     }
-                    finally { if (e_22) throw e_22.error; }
+                    finally { if (e_21) throw e_21.error; }
                 }
             }
         }
-        catch (e_21_1) { e_21 = { error: e_21_1 }; }
+        catch (e_20_1) { e_20 = { error: e_20_1 }; }
         finally {
             try {
                 if (stageKeys_1_1 && !stageKeys_1_1.done && (_a = stageKeys_1.return)) _a.call(stageKeys_1);
             }
-            finally { if (e_21) throw e_21.error; }
+            finally { if (e_20) throw e_20.error; }
         }
     }
     return false;
@@ -10866,7 +11539,7 @@ function isRegexMatchCondition(value) {
     return false;
 }
 function findRegexMatchInMatchObject(match, prefix) {
-    var e_23, _a, e_24, _b;
+    var e_22, _a, e_23, _b;
     if (prefix === void 0) { prefix = ''; }
     if (Array.isArray(match)) {
         try {
@@ -10878,12 +11551,12 @@ function findRegexMatchInMatchObject(match, prefix) {
                 }
             }
         }
-        catch (e_23_1) { e_23 = { error: e_23_1 }; }
+        catch (e_22_1) { e_22 = { error: e_22_1 }; }
         finally {
             try {
                 if (match_1_1 && !match_1_1.done && (_a = match_1.return)) _a.call(match_1);
             }
-            finally { if (e_23) throw e_23.error; }
+            finally { if (e_22) throw e_22.error; }
         }
         return null;
     }
@@ -10914,12 +11587,12 @@ function findRegexMatchInMatchObject(match, prefix) {
             }
         }
     }
-    catch (e_24_1) { e_24 = { error: e_24_1 }; }
+    catch (e_23_1) { e_23 = { error: e_23_1 }; }
     finally {
         try {
             if (keys_2_1 && !keys_2_1.done && (_b = keys_2.return)) _b.call(keys_2);
         }
-        finally { if (e_24) throw e_24.error; }
+        finally { if (e_23) throw e_23.error; }
     }
     return null;
 }
@@ -11143,7 +11816,7 @@ function collectMatchFieldsByCondition(match, predicate, prefix) {
     return results;
 }
 function findMatchConditionForField(match, targetField, prefix) {
-    var e_25, _a, e_26, _b;
+    var e_24, _a, e_25, _b;
     if (prefix === void 0) { prefix = ''; }
     if (!match || typeof match !== 'object') {
         return undefined;
@@ -11158,12 +11831,12 @@ function findMatchConditionForField(match, targetField, prefix) {
                 }
             }
         }
-        catch (e_25_1) { e_25 = { error: e_25_1 }; }
+        catch (e_24_1) { e_24 = { error: e_24_1 }; }
         finally {
             try {
                 if (match_2_1 && !match_2_1.done && (_a = match_2.return)) _a.call(match_2);
             }
-            finally { if (e_25) throw e_25.error; }
+            finally { if (e_24) throw e_24.error; }
         }
         return undefined;
     }
@@ -11190,12 +11863,12 @@ function findMatchConditionForField(match, targetField, prefix) {
             }
         }
     }
-    catch (e_26_1) { e_26 = { error: e_26_1 }; }
+    catch (e_25_1) { e_25 = { error: e_25_1 }; }
     finally {
         try {
             if (_d && !_d.done && (_b = _c.return)) _b.call(_c);
         }
-        finally { if (e_26) throw e_26.error; }
+        finally { if (e_25) throw e_25.error; }
     }
     return undefined;
 }
@@ -11341,7 +12014,7 @@ function detectIdLikeValue(value) {
     return false;
 }
 function detectChemicalIdFromProbe(probeDocs, fields) {
-    var e_27, _a, e_28, _b;
+    var e_26, _a, e_27, _b;
     if (!Array.isArray(probeDocs) || !probeDocs.length) {
         return false;
     }
@@ -11353,7 +12026,7 @@ function detectChemicalIdFromProbe(probeDocs, fields) {
         for (var probeDocs_1 = __values(probeDocs), probeDocs_1_1 = probeDocs_1.next(); !probeDocs_1_1.done; probeDocs_1_1 = probeDocs_1.next()) {
             var doc = probeDocs_1_1.value;
             try {
-                for (var targets_1 = (e_28 = void 0, __values(targets)), targets_1_1 = targets_1.next(); !targets_1_1.done; targets_1_1 = targets_1.next()) {
+                for (var targets_1 = (e_27 = void 0, __values(targets)), targets_1_1 = targets_1.next(); !targets_1_1.done; targets_1_1 = targets_1.next()) {
                     var field = targets_1_1.value;
                     var value = getValueAtPath(doc, field);
                     if (Array.isArray(value)) {
@@ -11366,21 +12039,21 @@ function detectChemicalIdFromProbe(probeDocs, fields) {
                     }
                 }
             }
-            catch (e_28_1) { e_28 = { error: e_28_1 }; }
+            catch (e_27_1) { e_27 = { error: e_27_1 }; }
             finally {
                 try {
                     if (targets_1_1 && !targets_1_1.done && (_b = targets_1.return)) _b.call(targets_1);
                 }
-                finally { if (e_28) throw e_28.error; }
+                finally { if (e_27) throw e_27.error; }
             }
         }
     }
-    catch (e_27_1) { e_27 = { error: e_27_1 }; }
+    catch (e_26_1) { e_26 = { error: e_26_1 }; }
     finally {
         try {
             if (probeDocs_1_1 && !probeDocs_1_1.done && (_a = probeDocs_1.return)) _a.call(probeDocs_1);
         }
-        finally { if (e_27) throw e_27.error; }
+        finally { if (e_26) throw e_26.error; }
     }
     return false;
 }
@@ -11601,8 +12274,8 @@ function buildChemicalIdFieldCandidates(field) {
 }
 function applyChemicalNameLookupFallbackToQuery(params) {
     return __awaiter(this, void 0, void 0, function () {
-        var query, db, dbName, idClient, idCustomer, isSuperAdmin, probeDocs, chemicalFields, targetField, condition, regex, sampleDocs, collectionNames, candidates, _loop_7, candidates_2, candidates_2_1, candidate, state_5, e_29_1;
-        var e_29, _a;
+        var query, db, dbName, idClient, idCustomer, isSuperAdmin, probeDocs, chemicalFields, targetField, condition, regex, sampleDocs, collectionNames, candidates, _loop_8, candidates_1, candidates_1_1, candidate, state_5, e_28_1;
+        var e_28, _a;
         var _b;
         return __generator(this, function (_c) {
             switch (_c.label) {
@@ -11626,7 +12299,7 @@ function applyChemicalNameLookupFallbackToQuery(params) {
                 case 1:
                     collectionNames = _c.sent();
                     candidates = resolveIdLookupCandidates('chemical', collectionNames);
-                    _loop_7 = function (candidate) {
+                    _loop_8 = function (candidate) {
                         var candidateHasClientScope, _d, candidateProbe, lookup, idFields, baseMatch, orConditions, nextMatch;
                         return __generator(this, function (_e) {
                             switch (_e.label) {
@@ -11699,30 +12372,30 @@ function applyChemicalNameLookupFallbackToQuery(params) {
                     _c.label = 2;
                 case 2:
                     _c.trys.push([2, 7, 8, 9]);
-                    candidates_2 = __values(candidates), candidates_2_1 = candidates_2.next();
+                    candidates_1 = __values(candidates), candidates_1_1 = candidates_1.next();
                     _c.label = 3;
                 case 3:
-                    if (!!candidates_2_1.done) return [3 /*break*/, 6];
-                    candidate = candidates_2_1.value;
-                    return [5 /*yield**/, _loop_7(candidate)];
+                    if (!!candidates_1_1.done) return [3 /*break*/, 6];
+                    candidate = candidates_1_1.value;
+                    return [5 /*yield**/, _loop_8(candidate)];
                 case 4:
                     state_5 = _c.sent();
                     if (typeof state_5 === "object")
                         return [2 /*return*/, state_5.value];
                     _c.label = 5;
                 case 5:
-                    candidates_2_1 = candidates_2.next();
+                    candidates_1_1 = candidates_1.next();
                     return [3 /*break*/, 3];
                 case 6: return [3 /*break*/, 9];
                 case 7:
-                    e_29_1 = _c.sent();
-                    e_29 = { error: e_29_1 };
+                    e_28_1 = _c.sent();
+                    e_28 = { error: e_28_1 };
                     return [3 /*break*/, 9];
                 case 8:
                     try {
-                        if (candidates_2_1 && !candidates_2_1.done && (_a = candidates_2.return)) _a.call(candidates_2);
+                        if (candidates_1_1 && !candidates_1_1.done && (_a = candidates_1.return)) _a.call(candidates_1);
                     }
-                    finally { if (e_29) throw e_29.error; }
+                    finally { if (e_28) throw e_28.error; }
                     return [7 /*endfinally*/];
                 case 9: return [2 /*return*/, null];
             }
@@ -11816,8 +12489,8 @@ function lookupIdsForNameMatch(params) {
 }
 function applyIdLookupFallbackToQuery(params) {
     return __awaiter(this, void 0, void 0, function () {
-        var query, db, dbName, idClient, idCustomer, isSuperAdmin, probeDocs, conditions, collectionNames, _a, conditions_1, conditions_1_1, condition, regex, baseToken, targetFieldType, nextValue, localNameField, candidates, candidates_3, candidates_3_1, candidate, candidateHasClientScope, _b, candidateProbe, lookup, targetFieldType, normalizedIds, idsForQuery, e_30_1, e_31_1;
-        var e_31, _c, e_30, _d;
+        var query, db, dbName, idClient, idCustomer, isSuperAdmin, probeDocs, conditions, collectionNames, _a, conditions_1, conditions_1_1, condition, regex, baseToken, targetFieldType, nextValue, localNameField, candidates, candidates_2, candidates_2_1, candidate, candidateHasClientScope, _b, candidateProbe, lookup, targetFieldType, normalizedIds, idsForQuery, e_29_1, e_30_1;
+        var e_30, _c, e_29, _d;
         var _e;
         return __generator(this, function (_f) {
             switch (_f.label) {
@@ -11887,11 +12560,11 @@ function applyIdLookupFallbackToQuery(params) {
                     _f.label = 5;
                 case 5:
                     _f.trys.push([5, 14, 15, 16]);
-                    candidates_3 = (e_30 = void 0, __values(candidates)), candidates_3_1 = candidates_3.next();
+                    candidates_2 = (e_29 = void 0, __values(candidates)), candidates_2_1 = candidates_2.next();
                     _f.label = 6;
                 case 6:
-                    if (!!candidates_3_1.done) return [3 /*break*/, 13];
-                    candidate = candidates_3_1.value;
+                    if (!!candidates_2_1.done) return [3 /*break*/, 13];
+                    candidate = candidates_2_1.value;
                     if (!candidate) {
                         return [3 /*break*/, 12];
                     }
@@ -11950,32 +12623,32 @@ function applyIdLookupFallbackToQuery(params) {
                     }
                     _f.label = 12;
                 case 12:
-                    candidates_3_1 = candidates_3.next();
+                    candidates_2_1 = candidates_2.next();
                     return [3 /*break*/, 6];
                 case 13: return [3 /*break*/, 16];
                 case 14:
-                    e_30_1 = _f.sent();
-                    e_30 = { error: e_30_1 };
+                    e_29_1 = _f.sent();
+                    e_29 = { error: e_29_1 };
                     return [3 /*break*/, 16];
                 case 15:
                     try {
-                        if (candidates_3_1 && !candidates_3_1.done && (_d = candidates_3.return)) _d.call(candidates_3);
+                        if (candidates_2_1 && !candidates_2_1.done && (_d = candidates_2.return)) _d.call(candidates_2);
                     }
-                    finally { if (e_30) throw e_30.error; }
+                    finally { if (e_29) throw e_29.error; }
                     return [7 /*endfinally*/];
                 case 16:
                     conditions_1_1 = conditions_1.next();
                     return [3 /*break*/, 4];
                 case 17: return [3 /*break*/, 20];
                 case 18:
-                    e_31_1 = _f.sent();
-                    e_31 = { error: e_31_1 };
+                    e_30_1 = _f.sent();
+                    e_30 = { error: e_30_1 };
                     return [3 /*break*/, 20];
                 case 19:
                     try {
                         if (conditions_1_1 && !conditions_1_1.done && (_c = conditions_1.return)) _c.call(conditions_1);
                     }
-                    finally { if (e_31) throw e_31.error; }
+                    finally { if (e_30) throw e_30.error; }
                     return [7 /*endfinally*/];
                 case 20: return [2 /*return*/, null];
             }
@@ -12378,27 +13051,255 @@ function listAssistantReportBuilderCollectionsFromManager() {
     });
     return names;
 }
-function listAssistantCollections(db, dbName) {
+function resolveAssistantSurfaceFileCandidates(baseName) {
+    var fileNames = ["".concat(baseName, ".ts"), "".concat(baseName, ".js")];
+    var roots = [
+        normalizeOptionalString(process.cwd()),
+        normalizeOptionalString(path.resolve(process.cwd(), 'resolveio-server-lib')),
+        normalizeOptionalString(path.resolve(__dirname, '..', '..', '..', '..')),
+        normalizeOptionalString(path.resolve(__dirname, '..', '..', '..')),
+        normalizeOptionalString(path.resolve(__dirname, '..', '..')),
+        normalizeOptionalString(path.resolve(__dirname, '..'))
+    ].filter(Boolean);
+    var candidates = [];
+    roots.forEach(function (root) {
+        fileNames.forEach(function (fileName) {
+            candidates.push(path.resolve(root, fileName));
+        });
+    });
+    return Array.from(new Set(candidates.map(function (value) { return normalizeOptionalString(value); }).filter(Boolean)));
+}
+function readFirstAssistantSurfaceFile(candidates) {
     return __awaiter(this, void 0, void 0, function () {
-        var cacheKey, cached, now, seen, merged, pushName, collections, _a, names;
+        var candidates_3, candidates_3_1, candidate, normalized, _a, e_31_1;
+        var e_31, _b;
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0:
+                    _c.trys.push([0, 7, 8, 9]);
+                    candidates_3 = __values(candidates), candidates_3_1 = candidates_3.next();
+                    _c.label = 1;
+                case 1:
+                    if (!!candidates_3_1.done) return [3 /*break*/, 6];
+                    candidate = candidates_3_1.value;
+                    normalized = normalizeOptionalString(candidate);
+                    if (!normalized) {
+                        return [3 /*break*/, 5];
+                    }
+                    _c.label = 2;
+                case 2:
+                    _c.trys.push([2, 4, , 5]);
+                    return [4 /*yield*/, fs_1.promises.readFile(normalized, 'utf8')];
+                case 3: return [2 /*return*/, _c.sent()];
+                case 4:
+                    _a = _c.sent();
+                    return [3 /*break*/, 5];
+                case 5:
+                    candidates_3_1 = candidates_3.next();
+                    return [3 /*break*/, 1];
+                case 6: return [3 /*break*/, 9];
+                case 7:
+                    e_31_1 = _c.sent();
+                    e_31 = { error: e_31_1 };
+                    return [3 /*break*/, 9];
+                case 8:
+                    try {
+                        if (candidates_3_1 && !candidates_3_1.done && (_b = candidates_3.return)) _b.call(candidates_3);
+                    }
+                    finally { if (e_31) throw e_31.error; }
+                    return [7 /*endfinally*/];
+                case 9: return [2 /*return*/, ''];
+            }
+        });
+    });
+}
+function extractAssistantSurfaceNamesFromFile(source) {
+    var text = normalizeOptionalString(source);
+    if (!text) {
+        return [];
+    }
+    var names = [];
+    var seen = new Set();
+    var keyPattern = /^\s*([A-Za-z_$][A-Za-z0-9_$]*)\s*:\s*\(/gm;
+    var match = keyPattern.exec(text);
+    while (match) {
+        var key = normalizeOptionalString(match[1]);
+        if (key && !seen.has(key)) {
+            seen.add(key);
+            names.push(key);
+        }
+        match = keyPattern.exec(text);
+    }
+    return names;
+}
+function loadAssistantSurfaceIndex() {
+    return __awaiter(this, void 0, void 0, function () {
+        var now, _a, methodsSource, publicationsSource, methods, publications, index;
         return __generator(this, function (_b) {
             switch (_b.label) {
                 case 0:
-                    cacheKey = normalizeOptionalString(dbName) || 'default';
-                    cached = AI_ASSISTANT_COLLECTION_CACHE.get(cacheKey);
                     now = Date.now();
-                    if (cached && now - cached.updatedAt < AI_ASSISTANT_COLLECTION_CACHE_TTL_MS) {
-                        return [2 /*return*/, cached.names];
+                    if (cachedAssistantSurfaceIndex
+                        && now - cachedAssistantSurfaceIndex.updatedAt < AI_ASSISTANT_SURFACE_INDEX_CACHE_TTL_MS) {
+                        return [2 /*return*/, cachedAssistantSurfaceIndex];
                     }
-                    seen = new Set();
-                    merged = [];
-                    pushName = function (name) {
-                        var normalized = normalizeOptionalString(name);
-                        if (!normalized || seen.has(normalized)) {
-                            return;
-                        }
-                        seen.add(normalized);
-                        merged.push(normalized);
+                    return [4 /*yield*/, Promise.all([
+                            readFirstAssistantSurfaceFile(resolveAssistantSurfaceFileCandidates('methods')),
+                            readFirstAssistantSurfaceFile(resolveAssistantSurfaceFileCandidates('publications'))
+                        ])];
+                case 1:
+                    _a = __read.apply(void 0, [_b.sent(), 2]), methodsSource = _a[0], publicationsSource = _a[1];
+                    methods = extractAssistantSurfaceNamesFromFile(methodsSource);
+                    publications = extractAssistantSurfaceNamesFromFile(publicationsSource);
+                    index = {
+                        methods: methods,
+                        publications: publications,
+                        updatedAt: now
+                    };
+                    cachedAssistantSurfaceIndex = index;
+                    return [2 /*return*/, index];
+            }
+        });
+    });
+}
+function tokenizeAssistantSurfaceName(name) {
+    var normalized = normalizeOptionalString(name);
+    if (!normalized) {
+        return [];
+    }
+    return mergeAssistantHintValues(tokenizeCollectionText(normalized), tokenizeFieldKey(normalized).flatMap(function (token) { return normalizeCollectionToken(token); }));
+}
+function scoreAssistantSurfaceName(messageTokens, surfaceName) {
+    var requestTokens = Array.isArray(messageTokens) ? messageTokens.filter(Boolean) : [];
+    var normalizedSurface = normalizeOptionalString(surfaceName);
+    if (!requestTokens.length || !normalizedSurface) {
+        return 0;
+    }
+    var surfaceTokens = tokenizeAssistantSurfaceName(normalizedSurface);
+    if (!surfaceTokens.length) {
+        return 0;
+    }
+    var score = 0;
+    requestTokens.forEach(function (token) {
+        if (surfaceTokens.includes(token)) {
+            score += 10;
+            return;
+        }
+        if (surfaceTokens.some(function (surfaceToken) { return surfaceToken.startsWith(token) || token.startsWith(surfaceToken); })) {
+            score += 4;
+        }
+    });
+    var messageKey = normalizeCollectionKey(requestTokens.join(' '));
+    var surfaceKey = normalizeCollectionKey(normalizedSurface);
+    if (messageKey && surfaceKey.includes(messageKey)) {
+        score += 18;
+    }
+    else if (messageKey && messageKey.includes(surfaceKey) && surfaceKey.length >= 5) {
+        score += 8;
+    }
+    return score;
+}
+function rankAssistantSurfaceNames(queryText, names, limit) {
+    if (limit === void 0) { limit = AI_ASSISTANT_SURFACE_INDEX_MATCH_LIMIT; }
+    var tokens = mergeAssistantHintValues(tokenizeCollectionText(queryText), tokenizeFieldKey(queryText).flatMap(function (token) { return normalizeCollectionToken(token); }));
+    if (!tokens.length || !Array.isArray(names) || !names.length || limit <= 0) {
+        return [];
+    }
+    return names
+        .map(function (name) { return ({
+        name: name,
+        score: scoreAssistantSurfaceName(tokens, name)
+    }); })
+        .filter(function (entry) { return entry.score > 0; })
+        .sort(function (a, b) {
+        if (a.score !== b.score) {
+            return b.score - a.score;
+        }
+        if (a.name.length !== b.name.length) {
+            return a.name.length - b.name.length;
+        }
+        return a.name.localeCompare(b.name);
+    })
+        .slice(0, limit)
+        .map(function (entry) { return entry.name; });
+}
+function resolveAssistantCollectionHintsFromSurfaceNames(surfaceNames, collectionNames) {
+    if (!Array.isArray(surfaceNames) || !surfaceNames.length || !Array.isArray(collectionNames) || !collectionNames.length) {
+        return [];
+    }
+    var hints = [];
+    surfaceNames.forEach(function (surfaceName) {
+        var tokens = tokenizeAssistantSurfaceName(surfaceName);
+        if (!tokens.length) {
+            return;
+        }
+        var tokenHints = resolveCollectionHintsFromTokens(tokens, collectionNames, 2);
+        tokenHints.forEach(function (hint) {
+            if (!hints.includes(hint)) {
+                hints.push(hint);
+            }
+        });
+        tokens.forEach(function (token) {
+            var aliasCandidates = resolveAssistantBridgeCollectionAliasCandidates(token);
+            aliasCandidates.forEach(function (aliasCandidate) {
+                if (collectionNames.includes(aliasCandidate) && !hints.includes(aliasCandidate)) {
+                    hints.push(aliasCandidate);
+                }
+            });
+        });
+    });
+    return hints.slice(0, AI_ASSISTANT_SURFACE_INDEX_COLLECTION_HINT_LIMIT);
+}
+function resolveAssistantSurfaceHints(message, contextRoute, collectionNames) {
+    return __awaiter(this, void 0, void 0, function () {
+        var queryText, surfaceIndex, methodHints, publicationHints, collectionHints;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    queryText = [message, contextRoute].filter(Boolean).join(' ');
+                    if (!normalizeOptionalString(queryText) || !Array.isArray(collectionNames) || !collectionNames.length) {
+                        return [2 /*return*/, {
+                                collectionHints: [],
+                                methodHints: [],
+                                publicationHints: []
+                            }];
+                    }
+                    return [4 /*yield*/, loadAssistantSurfaceIndex()];
+                case 1:
+                    surfaceIndex = _a.sent();
+                    methodHints = rankAssistantSurfaceNames(queryText, surfaceIndex.methods, AI_ASSISTANT_SURFACE_INDEX_MATCH_LIMIT);
+                    publicationHints = rankAssistantSurfaceNames(queryText, surfaceIndex.publications, AI_ASSISTANT_SURFACE_INDEX_MATCH_LIMIT);
+                    collectionHints = resolveAssistantCollectionHintsFromSurfaceNames(mergeAssistantHintValues(methodHints, publicationHints), collectionNames);
+                    return [2 /*return*/, {
+                            collectionHints: collectionHints,
+                            methodHints: methodHints,
+                            publicationHints: publicationHints
+                        }];
+            }
+        });
+    });
+}
+function listAssistantCollections(db, dbName) {
+    return __awaiter(this, void 0, void 0, function () {
+        var cacheKey, cached, now, seen, merged, pushName, collections, _a, names;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    cacheKey = normalizeOptionalString(dbName) || 'default';
+                    cached = AI_ASSISTANT_COLLECTION_CACHE.get(cacheKey);
+                    now = Date.now();
+                    if (cached && now - cached.updatedAt < AI_ASSISTANT_COLLECTION_CACHE_TTL_MS) {
+                        return [2 /*return*/, cached.names];
+                    }
+                    seen = new Set();
+                    merged = [];
+                    pushName = function (name) {
+                        var normalized = normalizeOptionalString(name);
+                        if (!normalized || seen.has(normalized)) {
+                            return;
+                        }
+                        seen.add(normalized);
+                        merged.push(normalized);
                     };
                     listAssistantReportBuilderCollectionsFromManager().forEach(pushName);
                     _b.label = 1;
@@ -12502,6 +13403,164 @@ function resolveCollectionHintsFromTokens(tokens, collectionNames, max) {
         .slice(0, Math.max(max, 0))
         .map(function (entry) { return entry.name; });
 }
+function resolveCollectionHintsFromRanking(collectionRanking, max) {
+    if (max === void 0) { max = 5; }
+    var ranked = Array.isArray(collectionRanking === null || collectionRanking === void 0 ? void 0 : collectionRanking.ranked) ? collectionRanking === null || collectionRanking === void 0 ? void 0 : collectionRanking.ranked : [];
+    if (!ranked.length || max <= 0) {
+        return [];
+    }
+    return ranked
+        .map(function (entry) { return normalizeOptionalString(entry === null || entry === void 0 ? void 0 : entry.name); })
+        .filter(Boolean)
+        .slice(0, max);
+}
+function buildAssistantCollectionProfile(collectionName) {
+    var normalized = normalizeOptionalString(collectionName);
+    if (!normalized) {
+        return {
+            nameTokens: [],
+            fieldTokens: [],
+            lookupFamilyTokens: [],
+            idBaseTokens: []
+        };
+    }
+    var now = Date.now();
+    var cached = AI_ASSISTANT_COLLECTION_PROFILE_CACHE.get(normalized);
+    if (cached && now - cached.updatedAt < AI_ASSISTANT_COLLECTION_PROFILE_CACHE_TTL_MS) {
+        return cached.profile;
+    }
+    var metadata = getAssistantCollectionMetadata(normalized);
+    var fieldTokenCounts = new Map();
+    var idBaseTokens = new Set();
+    (metadata.fields || []).forEach(function (fieldPath) {
+        var normalizedPath = normalizeLookupPath(fieldPath);
+        if (!normalizedPath) {
+            return;
+        }
+        var tokens = mergeAssistantHintValues(tokenizeFieldKey(normalizedPath).flatMap(function (token) { return normalizeCollectionToken(token); }), tokenizeCollectionText(normalizedPath));
+        tokens.forEach(function (token) {
+            if (!token) {
+                return;
+            }
+            fieldTokenCounts.set(token, (fieldTokenCounts.get(token) || 0) + 1);
+        });
+        var leaf = normalizedPath.split('.').pop() || normalizedPath;
+        if (/^id_[a-z0-9_]+$/i.test(leaf)) {
+            var token = normalizeOptionalString(leaf.slice(3)).toLowerCase();
+            if (token) {
+                idBaseTokens.add(token);
+                fieldTokenCounts.set(token, (fieldTokenCounts.get(token) || 0) + 2);
+            }
+        }
+    });
+    var fieldTokens = Array.from(fieldTokenCounts.entries())
+        .sort(function (a, b) {
+        if (a[1] !== b[1]) {
+            return b[1] - a[1];
+        }
+        return a[0].localeCompare(b[0]);
+    })
+        .slice(0, AI_ASSISTANT_COLLECTION_PROFILE_FIELD_TOKEN_LIMIT)
+        .map(function (entry) { return entry[0]; });
+    var lookupFamilyTokens = mergeAssistantHintValues((metadata.lookups || [])
+        .map(function (mapping) { return normalizeAssistantCollectionFamilyName(mapping.lookupCollection); })
+        .filter(Boolean)
+        .flatMap(function (family) { return mergeAssistantHintValues([family], tokenizeCollectionText(family), family.split(/[^a-z0-9]+/g).filter(Boolean)); }));
+    var profile = {
+        nameTokens: tokenizeCollectionText(normalized),
+        fieldTokens: fieldTokens,
+        lookupFamilyTokens: lookupFamilyTokens,
+        idBaseTokens: Array.from(idBaseTokens)
+    };
+    AI_ASSISTANT_COLLECTION_PROFILE_CACHE.set(normalized, {
+        profile: profile,
+        updatedAt: now
+    });
+    return profile;
+}
+function buildCollectionRankingDebugFromSignals(tokens, collectionNames, signals, max) {
+    if (max === void 0) { max = 8; }
+    var requestedTokens = Array.from(new Set(mergeAssistantHintValues(tokens || [], (signals === null || signals === void 0 ? void 0 : signals.requestedTokens) || [])));
+    var requestedKey = normalizeCollectionKey(requestedTokens.join('-'));
+    var _a = computeCollectionTokenWeights(requestedTokens), weights = _a.weights, hasDomain = _a.hasDomain;
+    var methodTokens = mergeAssistantHintValues.apply(void 0, __spreadArray([], __read((Array.isArray(signals === null || signals === void 0 ? void 0 : signals.methodHints) ? signals === null || signals === void 0 ? void 0 : signals.methodHints : [])
+        .map(function (name) { return tokenizeAssistantSurfaceName(name); })), false));
+    var publicationTokens = mergeAssistantHintValues.apply(void 0, __spreadArray([], __read((Array.isArray(signals === null || signals === void 0 ? void 0 : signals.publicationHints) ? signals === null || signals === void 0 ? void 0 : signals.publicationHints : [])
+        .map(function (name) { return tokenizeAssistantSurfaceName(name); })), false));
+    var routeTokens = mergeAssistantHintValues.apply(void 0, __spreadArray([], __read((Array.isArray(signals === null || signals === void 0 ? void 0 : signals.routeHints) ? signals === null || signals === void 0 ? void 0 : signals.routeHints : [])
+        .map(function (route) { return tokenizeCollectionText(route); })), false));
+    var boostedNames = new Set((Array.isArray(signals === null || signals === void 0 ? void 0 : signals.boostedCollections) ? signals === null || signals === void 0 ? void 0 : signals.boostedCollections : [])
+        .map(function (value) { return normalizeOptionalString(value); })
+        .filter(Boolean));
+    var boostedFamilies = new Set(Array.from(boostedNames)
+        .map(function (value) { return normalizeAssistantCollectionFamilyName(value); })
+        .filter(Boolean));
+    if (!requestedTokens.length || !collectionNames.length) {
+        return {
+            tokens: requestedTokens,
+            requestedKey: requestedKey,
+            hasDomain: hasDomain,
+            tokenWeights: weights,
+            rankingMode: 'qualified',
+            ranked: []
+        };
+    }
+    var surfaceTokens = mergeAssistantHintValues(methodTokens, publicationTokens);
+    var ranked = collectionNames
+        .map(function (name) {
+        var base = scoreCollectionMatchDetailed(requestedTokens, name, weights);
+        var profile = buildAssistantCollectionProfile(name);
+        var profileTokenPool = new Set(__spreadArray(__spreadArray(__spreadArray(__spreadArray([], __read(profile.nameTokens), false), __read(profile.fieldTokens), false), __read(profile.lookupFamilyTokens), false), __read(profile.idBaseTokens), false));
+        var profileTokenMatches = requestedTokens.filter(function (token) { return profileTokenPool.has(token); });
+        var lookupMatches = requestedTokens.filter(function (token) { return profile.lookupFamilyTokens.includes(token); });
+        var surfaceMatches = surfaceTokens.filter(function (token) { return profileTokenPool.has(token); });
+        var routeMatches = routeTokens.filter(function (token) { return profile.nameTokens.includes(token) || profile.fieldTokens.includes(token); });
+        var family = normalizeAssistantCollectionFamilyName(name);
+        var boosted = boostedNames.has(name) || (family ? boostedFamilies.has(family) : false);
+        var signalScore = (profileTokenMatches.length * 3)
+            + (lookupMatches.length * 4)
+            + (surfaceMatches.length * 2)
+            + (routeMatches.length * 3)
+            + (boosted ? 14 : 0);
+        return {
+            name: name,
+            score: base.score + signalScore,
+            baseScore: base.score,
+            signalScore: signalScore,
+            tokenMatches: base.tokenMatches,
+            keyMatch: base.keyMatch,
+            candidateTokens: base.candidateTokens,
+            tokenScore: base.tokenScore,
+            tokenWeights: base.tokenWeights,
+            signal: {
+                profileMatches: profileTokenMatches.slice(0, 8),
+                lookupMatches: lookupMatches.slice(0, 6),
+                surfaceMatches: surfaceMatches.slice(0, 6),
+                routeMatches: routeMatches.slice(0, 6),
+                boosted: boosted
+            }
+        };
+    })
+        .filter(function (entry) { return entry.score > 0; })
+        .sort(function (a, b) {
+        if (a.score !== b.score) {
+            return b.score - a.score;
+        }
+        if (a.baseScore !== b.baseScore) {
+            return b.baseScore - a.baseScore;
+        }
+        return a.name.localeCompare(b.name);
+    })
+        .slice(0, Math.max(max, 0));
+    return {
+        tokens: requestedTokens,
+        requestedKey: requestedKey,
+        hasDomain: hasDomain,
+        tokenWeights: weights,
+        rankingMode: 'qualified',
+        ranked: ranked
+    };
+}
 function mergeAssistantHintValues() {
     var groups = [];
     for (var _i = 0; _i < arguments.length; _i++) {
@@ -12559,6 +13618,13 @@ function hasAssistantChemicalCatalogAliasTerms(value) {
     }
     return /\b(chemicals?|products?|items?)\b/i.test(normalized);
 }
+function hasAssistantWorkOrderAliasTerms(value) {
+    var normalized = normalizeOptionalString(value).toLowerCase();
+    if (!normalized) {
+        return false;
+    }
+    return /\bwork[\s_-]*orders?\b/i.test(normalized);
+}
 var AI_ASSISTANT_DELIVERY_HINT_CANDIDATES = [
     'work-order-dynamics',
     'work-orders',
@@ -12580,6 +13646,13 @@ var AI_ASSISTANT_CHEMICAL_HINT_CANDIDATES = [
     'inventory',
     'blends'
 ];
+var AI_ASSISTANT_WORK_ORDER_HINT_CANDIDATES = [
+    'work-order-dynamics',
+    'work-orders',
+    'maintenance-orders',
+    'repair-orders',
+    'orders'
+];
 function resolveCollectionHintsFromRoute(route, collectionNames) {
     var normalizedRoute = normalizeOptionalString(route);
     if (!normalizedRoute || !collectionNames.length) {
@@ -12611,6 +13684,12 @@ function resolveCollectionHintsFromRoute(route, collectionNames) {
     });
     return mergeAssistantHintValues(hints);
 }
+function resolveCollectionHintsFromRoutes(routes, collectionNames) {
+    if (!Array.isArray(routes) || !routes.length || !Array.isArray(collectionNames) || !collectionNames.length) {
+        return [];
+    }
+    return mergeAssistantHintValues.apply(void 0, __spreadArray([], __read(routes.map(function (route) { return resolveCollectionHintsFromRoute(route, collectionNames); })), false));
+}
 function resolveAssistantDefaultCollectionHints(message) {
     var text = normalizeOptionalString(message).toLowerCase();
     if (!text) {
@@ -12637,6 +13716,9 @@ function resolveAssistantDefaultCollectionHints(message) {
     if (hasAssistantChemicalCatalogAliasTerms(text)) {
         AI_ASSISTANT_CHEMICAL_HINT_CANDIDATES.forEach(push);
     }
+    if (hasAssistantWorkOrderAliasTerms(text)) {
+        AI_ASSISTANT_WORK_ORDER_HINT_CANDIDATES.forEach(push);
+    }
     return hints;
 }
 function buildCollectionRankingDebugFromTokens(tokens, collectionNames, max) {
@@ -13151,6 +14233,155 @@ function buildAssistantRetryState(baseState, triedCollections, options) {
     }
     return next;
 }
+function addAssistantCollectionRelationshipEdge(graph, fromFamily, toFamily, weight) {
+    var from = normalizeAssistantCollectionFamilyName(fromFamily);
+    var to = normalizeAssistantCollectionFamilyName(toFamily);
+    if (!from || !to || from === to || !Number.isFinite(weight) || weight <= 0) {
+        return;
+    }
+    var neighbors = graph.get(from);
+    if (!neighbors) {
+        neighbors = new Map();
+        graph.set(from, neighbors);
+    }
+    neighbors.set(to, (neighbors.get(to) || 0) + weight);
+}
+function buildAssistantCollectionGraphSignature(collectionNames) {
+    if (!Array.isArray(collectionNames) || !collectionNames.length) {
+        return '';
+    }
+    var normalized = collectionNames
+        .map(function (name) { return normalizeOptionalString(name); })
+        .filter(Boolean)
+        .sort(function (a, b) { return a.localeCompare(b); });
+    return normalized.join('|');
+}
+function buildAssistantCollectionRelationshipGraph(collectionNames) {
+    var graph = new Map();
+    var names = Array.isArray(collectionNames) ? collectionNames.map(function (name) { return normalizeOptionalString(name); }).filter(Boolean) : [];
+    if (!names.length) {
+        return graph;
+    }
+    var signature = buildAssistantCollectionGraphSignature(names);
+    if (signature) {
+        var cached = AI_ASSISTANT_RELATIONSHIP_GRAPH_CACHE.get(signature);
+        var now = Date.now();
+        if (cached && now - cached.updatedAt < AI_ASSISTANT_RELATIONSHIP_GRAPH_CACHE_TTL_MS) {
+            return cached.graph;
+        }
+    }
+    var knownFamilies = new Set(names
+        .map(function (name) { return normalizeAssistantCollectionFamilyName(name); })
+        .filter(Boolean));
+    names.forEach(function (collectionName) {
+        var fromFamily = normalizeAssistantCollectionFamilyName(collectionName);
+        if (!fromFamily) {
+            return;
+        }
+        var lookupMappings = getCollectionLookupMappings(collectionName);
+        lookupMappings.forEach(function (mapping) {
+            var toFamily = normalizeAssistantCollectionFamilyName(mapping.lookupCollection);
+            if (!toFamily || !knownFamilies.has(toFamily)) {
+                return;
+            }
+            addAssistantCollectionRelationshipEdge(graph, fromFamily, toFamily, 6);
+            addAssistantCollectionRelationshipEdge(graph, toFamily, fromFamily, 4);
+        });
+        var schemaFields = getCollectionSchemaFieldNames(collectionName);
+        schemaFields.forEach(function (field) {
+            var normalizedPath = normalizeLookupPath(field);
+            if (!normalizedPath) {
+                return;
+            }
+            var leaf = normalizedPath.split('.').pop() || normalizedPath;
+            if (!/^id_[a-z0-9_]+$/i.test(leaf)) {
+                return;
+            }
+            var token = normalizeOptionalString(leaf.slice(3));
+            if (!token) {
+                return;
+            }
+            var aliasCandidates = mergeAssistantHintValues(resolveAssistantBridgeCollectionAliasCandidates(token), resolveAssistantBridgeCollectionAliasCandidates(normalizeCollectionKey(token)), [token, "".concat(token, "s")]);
+            aliasCandidates.forEach(function (candidate) {
+                var toFamily = normalizeAssistantCollectionFamilyName(candidate);
+                if (!toFamily || !knownFamilies.has(toFamily)) {
+                    return;
+                }
+                addAssistantCollectionRelationshipEdge(graph, fromFamily, toFamily, 3);
+                addAssistantCollectionRelationshipEdge(graph, toFamily, fromFamily, 2);
+            });
+        });
+    });
+    if (signature) {
+        AI_ASSISTANT_RELATIONSHIP_GRAPH_CACHE.set(signature, {
+            graph: graph,
+            updatedAt: Date.now()
+        });
+    }
+    return graph;
+}
+function resolveAssistantRelationshipFallbackCandidates(collection, collectionNames, triedCollections) {
+    var currentFamily = normalizeAssistantCollectionFamilyName(collection);
+    if (!currentFamily) {
+        return [];
+    }
+    var graph = buildAssistantCollectionRelationshipGraph(collectionNames || []);
+    var familyScores = new Map();
+    var depthByFamily = new Map();
+    var queue = [{ family: currentFamily, depth: 0 }];
+    depthByFamily.set(currentFamily, 0);
+    var _loop_9 = function () {
+        var current = queue.shift();
+        if (!current) {
+            return "continue";
+        }
+        if (current.depth >= 2) {
+            return "continue";
+        }
+        var neighbors = graph.get(current.family);
+        if (!neighbors || !neighbors.size) {
+            return "continue";
+        }
+        Array.from(neighbors.entries()).forEach(function (_a) {
+            var _b = __read(_a, 2), neighborFamily = _b[0], weight = _b[1];
+            if (!neighborFamily || neighborFamily === currentFamily || !Number.isFinite(weight) || weight <= 0) {
+                return;
+            }
+            var nextDepth = current.depth + 1;
+            var currentBestDepth = depthByFamily.get(neighborFamily);
+            if (typeof currentBestDepth !== 'number' || nextDepth < currentBestDepth) {
+                depthByFamily.set(neighborFamily, nextDepth);
+                if (nextDepth < 2) {
+                    queue.push({ family: neighborFamily, depth: nextDepth });
+                }
+            }
+            var depthFactor = nextDepth === 1 ? 1 : 0.55;
+            var score = weight * depthFactor;
+            if (score > (familyScores.get(neighborFamily) || 0)) {
+                familyScores.set(neighborFamily, score);
+            }
+        });
+    };
+    while (queue.length) {
+        _loop_9();
+    }
+    var preferredCollections = Array.from(familyScores.entries())
+        .map(function (_a) {
+        var _b = __read(_a, 2), family = _b[0], score = _b[1];
+        var preferred = resolveAssistantPreferredCollectionForFamily(family, collectionNames || []);
+        return { family: family, score: score, preferred: normalizeOptionalString(preferred) };
+    })
+        .filter(function (entry) { return !!entry.preferred; })
+        .sort(function (a, b) {
+        if (a.score !== b.score) {
+            return b.score - a.score;
+        }
+        return (a.preferred || '').localeCompare(b.preferred || '');
+    })
+        .map(function (entry) { return entry.preferred; })
+        .filter(function (preferred) { return !hasAssistantCollectionBeenTried(triedCollections, preferred); });
+    return Array.from(new Set(preferredCollections));
+}
 function resolveAssistantCrossCollectionFallbackCandidates(collection) {
     var normalized = normalizeAssistantCollectionFamilyName(collection);
     if (!normalized) {
@@ -13173,7 +14404,84 @@ function resolveAssistantCrossCollectionFallbackCandidates(collection) {
     }
     return Array.from(candidates);
 }
-function resolveAssistantAvailableCrossCollectionFallbacksFromNames(collection, triedCollections, collectionNames) {
+function normalizeAssistantFieldHints(fieldHints) {
+    if (!Array.isArray(fieldHints) || !fieldHints.length) {
+        return [];
+    }
+    var normalized = fieldHints
+        .map(function (value) { return normalizeLookupPath(value); })
+        .filter(Boolean);
+    return Array.from(new Set(normalized));
+}
+function scoreAssistantFallbackCandidateFieldCoverage(candidate, fieldHints) {
+    var hints = normalizeAssistantFieldHints(fieldHints || []);
+    if (!hints.length) {
+        return 0;
+    }
+    var fields = getCollectionSchemaFieldNames(candidate);
+    if (!fields.length) {
+        return 0;
+    }
+    var normalizedFields = fields
+        .map(function (field) { return normalizeLookupPath(field); })
+        .filter(Boolean);
+    var fieldSet = new Set(normalizedFields);
+    var leafSet = new Set(normalizedFields.map(function (field) { return field.split('.').pop() || field; }));
+    var rootSet = new Set(normalizedFields.map(function (field) { return field.split('.')[0] || field; }));
+    var score = 0;
+    hints.forEach(function (hint) {
+        if (fieldSet.has(hint)) {
+            score += 6;
+            return;
+        }
+        var leaf = hint.split('.').pop() || hint;
+        if (leafSet.has(leaf)) {
+            score += 3;
+            return;
+        }
+        var root = hint.split('.')[0] || hint;
+        if (rootSet.has(root)) {
+            score += 1;
+        }
+        if (/^id_[a-z0-9_]+$/i.test(leaf)) {
+            var idToken = normalizeOptionalString(leaf.slice(3)).toLowerCase();
+            var family = normalizeAssistantCollectionFamilyName(candidate);
+            if (idToken && family && family.includes(idToken)) {
+                score += 2;
+            }
+        }
+    });
+    var hintTokens = mergeAssistantHintValues.apply(void 0, __spreadArray([], __read(hints.map(function (value) { return tokenizeCollectionText(value); })), false));
+    if (hintTokens.length) {
+        score += (0, common_1.round)(scoreCollectionMatch(hintTokens, candidate) / 4);
+    }
+    return score;
+}
+function rankAssistantFallbackCandidatesByFieldHints(candidates, fieldHints) {
+    var normalizedCandidates = Array.isArray(candidates) ? candidates.filter(Boolean) : [];
+    if (normalizedCandidates.length <= 1) {
+        return normalizedCandidates;
+    }
+    var hints = normalizeAssistantFieldHints(fieldHints || []);
+    if (!hints.length) {
+        return normalizedCandidates;
+    }
+    return normalizedCandidates
+        .map(function (candidate, index) { return ({
+        candidate: candidate,
+        coverageScore: scoreAssistantFallbackCandidateFieldCoverage(candidate, hints),
+        originalIndex: index
+    }); })
+        .sort(function (a, b) {
+        if (a.coverageScore !== b.coverageScore) {
+            return b.coverageScore - a.coverageScore;
+        }
+        return a.originalIndex - b.originalIndex;
+    })
+        .map(function (entry) { return entry.candidate; });
+}
+function resolveAssistantAvailableCrossCollectionFallbacksFromNames(collection, triedCollections, collectionNames, options) {
+    var _a;
     var candidates = resolveAssistantCrossCollectionFallbackCandidates(collection);
     var namesByFamily = new Map();
     (collectionNames || []).forEach(function (name) {
@@ -13205,6 +14513,8 @@ function resolveAssistantAvailableCrossCollectionFallbacksFromNames(collection,
         }
         available.push(preferred);
     };
+    var relationshipCandidates = resolveAssistantRelationshipFallbackCandidates(collection, collectionNames || [], triedCollections);
+    relationshipCandidates.forEach(pushPreferredCandidate);
     candidates.forEach(pushPreferredCandidate);
     var collectionTokenSeed = normalizeAssistantCollectionFamilyName(collection) || normalizeOptionalString(collection);
     var requestedTokens = tokenizeCollectionText(collectionTokenSeed);
@@ -13216,9 +14526,12 @@ function resolveAssistantAvailableCrossCollectionFallbacksFromNames(collection,
             .slice(0, 8)
             .forEach(function (entry) { return pushPreferredCandidate(entry.name); });
     }
+    if ((_a = options === null || options === void 0 ? void 0 : options.fieldHints) === null || _a === void 0 ? void 0 : _a.length) {
+        return rankAssistantFallbackCandidatesByFieldHints(available, options.fieldHints);
+    }
     return available;
 }
-function resolveAssistantAvailableCrossCollectionFallbacks(db, dbName, collection, triedCollections) {
+function resolveAssistantAvailableCrossCollectionFallbacks(db, dbName, collection, triedCollections, options) {
     return __awaiter(this, void 0, void 0, function () {
         var collectionNames;
         return __generator(this, function (_a) {
@@ -13226,7 +14539,7 @@ function resolveAssistantAvailableCrossCollectionFallbacks(db, dbName, collectio
                 case 0: return [4 /*yield*/, listAssistantCollections(db, dbName)];
                 case 1:
                     collectionNames = _a.sent();
-                    return [2 /*return*/, resolveAssistantAvailableCrossCollectionFallbacksFromNames(collection, triedCollections, collectionNames)];
+                    return [2 /*return*/, resolveAssistantAvailableCrossCollectionFallbacksFromNames(collection, triedCollections, collectionNames, options)];
             }
         });
     });
@@ -13333,20 +14646,61 @@ function resolveAssistantFallbackDimensionFields(documents) {
     });
     return dimensions;
 }
-function shouldAcceptAssistantFallbackDocuments(documents) {
+function evaluateAssistantFallbackDocumentsQuality(documents, options) {
     var docs = Array.isArray(documents)
         ? documents.filter(function (doc) { return doc && typeof doc === 'object' && !Array.isArray(doc); })
         : [];
     if (!docs.length) {
-        return false;
+        return {
+            accepted: false,
+            rowCount: 0,
+            dimensionFields: [],
+            bestFillRate: 0,
+            averageFillRate: 0
+        };
     }
-    var dimensionFields = resolveAssistantFallbackDimensionFields(docs);
+    var rowCount = docs.length;
+    var preferredFields = normalizeAggregateFieldList((Array.isArray(options === null || options === void 0 ? void 0 : options.preferredDimensionFields) ? options === null || options === void 0 ? void 0 : options.preferredDimensionFields : [])
+        .filter(function (field) { return field && docs.some(function (doc) { return Object.prototype.hasOwnProperty.call(doc, field); }); }));
+    var inferredFields = resolveAssistantFallbackDimensionFields(docs);
+    var dimensionFields = normalizeAggregateFieldList(__spreadArray(__spreadArray([], __read(preferredFields), false), __read(inferredFields), false));
+    var requiresDimensions = (options === null || options === void 0 ? void 0 : options.requireDimensionFields) === true;
     if (!dimensionFields.length) {
-        return true;
+        return {
+            accepted: !requiresDimensions,
+            rowCount: rowCount,
+            dimensionFields: dimensionFields,
+            bestFillRate: 0,
+            averageFillRate: 0
+        };
     }
-    return docs.some(function (doc) {
-        return dimensionFields.some(function (field) { return isAssistantNonEmptyDimensionValue(doc[field]); });
+    var fillStats = dimensionFields.map(function (field) {
+        var nonEmpty = 0;
+        docs.forEach(function (doc) {
+            if (isAssistantNonEmptyDimensionValue(doc[field])) {
+                nonEmpty += 1;
+            }
+        });
+        return {
+            field: field,
+            fillRate: rowCount ? (nonEmpty / rowCount) : 0
+        };
     });
+    var best = fillStats
+        .slice()
+        .sort(function (a, b) { return b.fillRate - a.fillRate; })[0];
+    var averageFillRate = fillStats.length
+        ? (fillStats.reduce(function (sum, current) { return sum + current.fillRate; }, 0) / fillStats.length)
+        : 0;
+    var defaultMinFillRate = requiresDimensions ? 0.35 : 0.1;
+    var minFillRate = typeof (options === null || options === void 0 ? void 0 : options.minDimensionFillRate) === 'number'
+        ? Math.min(Math.max(options.minDimensionFillRate, 0), 1)
+        : defaultMinFillRate;
+    var accepted = !!best && best.fillRate >= minFillRate;
+    return __assign(__assign({ accepted: accepted, rowCount: rowCount, dimensionFields: dimensionFields }, (best ? { bestField: best.field } : {})), { bestFillRate: best ? best.fillRate : 0, averageFillRate: averageFillRate });
+}
+function shouldAcceptAssistantFallbackDocuments(documents, options) {
+    return evaluateAssistantFallbackDocumentsQuality(documents, options).accepted;
 }
 function collectAggregateReferencedFieldPaths(pipeline) {
     var fields = new Set();
@@ -13976,7 +15330,7 @@ function expandAggregateDateMatchFallback(pipeline, schemaFields) {
     if (!Array.isArray(pipeline)) {
         return null;
     }
-    var _loop_8 = function (i) {
+    var _loop_10 = function (i) {
         var stage = pipeline[i];
         if (!stage || typeof stage !== 'object' || !stage.$match || typeof stage.$match !== 'object') {
             return "continue";
@@ -14024,7 +15378,7 @@ function expandAggregateDateMatchFallback(pipeline, schemaFields) {
         return { value: { pipeline: updated, fields: Array.from(addedFields) } };
     };
     for (var i = 0; i < pipeline.length; i += 1) {
-        var state_6 = _loop_8(i);
+        var state_6 = _loop_10(i);
         if (typeof state_6 === "object")
             return state_6.value;
     }
@@ -14784,12 +16138,42 @@ function directoryExists(target) {
         });
     });
 }
+function parseAssistantPathList(value) {
+    var normalized = normalizeOptionalString(value);
+    if (!normalized) {
+        return [];
+    }
+    return normalized
+        .split(/[\n,;]+/g)
+        .map(function (entry) { return normalizeOptionalString(entry); })
+        .filter(Boolean);
+}
+function buildAssistantParentDirectoryCandidates(basePath, maxDepth) {
+    if (maxDepth === void 0) { maxDepth = 4; }
+    var normalized = normalizeOptionalString(basePath);
+    if (!normalized) {
+        return [];
+    }
+    var results = [];
+    var current = path.resolve(normalized);
+    for (var depth = 0; depth < Math.max(maxDepth, 0); depth += 1) {
+        var parent_1 = path.dirname(current);
+        if (!parent_1 || parent_1 === current) {
+            break;
+        }
+        results.push(parent_1);
+        current = parent_1;
+    }
+    return results;
+}
 function buildAssistantWorkspaceRootCandidates(params) {
     var serverConfig = (params === null || params === void 0 ? void 0 : params.serverConfig) || resolveio_server_app_1.ResolveIOServer.getServerConfig() || {};
     var env = (params === null || params === void 0 ? void 0 : params.env) || process.env || {};
     var cwdValue = normalizeOptionalString((params === null || params === void 0 ? void 0 : params.cwd) || process.cwd());
     var dirnameValue = normalizeOptionalString((params === null || params === void 0 ? void 0 : params.dirname) || __dirname);
-    var pathCandidates = [
+    var homeDir = normalizeOptionalString(os.homedir());
+    var configuredRoots = mergeAssistantHintValues(parseAssistantPathList(serverConfig['AI_ASSISTANT_WORKSPACE_ROOTS']), parseAssistantPathList(env['AI_ASSISTANT_WORKSPACE_ROOTS']), parseAssistantPathList(serverConfig['AI_ASSISTANT_GIT_ROOTS']), parseAssistantPathList(env['AI_ASSISTANT_GIT_ROOTS']));
+    var pathCandidates = __spreadArray(__spreadArray(__spreadArray([
         serverConfig['AI_ASSISTANT_WORKSPACE_ROOT'],
         env['AI_ASSISTANT_WORKSPACE_ROOT'],
         serverConfig['AI_ASSISTANT_ROOT_WORKSPACE'],
@@ -14801,8 +16185,10 @@ function buildAssistantWorkspaceRootCandidates(params) {
         '/var/app/current',
         cwdValue,
         dirnameValue ? path.resolve(dirnameValue, '../../..') : '',
-        dirnameValue ? path.resolve(dirnameValue, '../../../..') : ''
-    ];
+        dirnameValue ? path.resolve(dirnameValue, '../../../..') : '',
+        homeDir ? path.resolve(homeDir, 'ResolveIO') : '',
+        homeDir ? path.resolve(homeDir, 'workspace') : ''
+    ], __read(configuredRoots), false), __read(buildAssistantParentDirectoryCandidates(cwdValue, 5)), false), __read(buildAssistantParentDirectoryCandidates(dirnameValue, 5)), false);
     var seen = new Set();
     var candidates = [];
     pathCandidates.forEach(function (value) {
@@ -15502,9 +16888,10 @@ function resolveAssistantPlannerEnabled() {
         || process.env.AI_ASSISTANT_CODEX_PLANNER_ENABLED);
     return raw === undefined ? true : raw === true;
 }
-function resolveAssistantPlannerKnownRoutes() {
+function resolveAssistantPlannerKnownRoutes(user, isSuperAdmin) {
     var e_43, _a;
     var _b;
+    if (isSuperAdmin === void 0) { isSuperAdmin = false; }
     var routes = ((_b = resolveio_server_app_1.ResolveIOServer.getClientRoutes) === null || _b === void 0 ? void 0 : _b.call(resolveio_server_app_1.ResolveIOServer)) || [];
     var unique = new Set();
     try {
@@ -15523,7 +16910,12 @@ function resolveAssistantPlannerKnownRoutes() {
         }
         finally { if (e_43) throw e_43.error; }
     }
-    return Array.from(unique).slice(0, AI_ASSISTANT_PLANNER_MAX_ROUTES);
+    var normalizedRoutes = Array.from(unique);
+    var allowedRoutes = collectAssistantAllowedRoutesForUser(user, normalizedRoutes, isSuperAdmin);
+    if (allowedRoutes.length) {
+        return allowedRoutes.slice(0, AI_ASSISTANT_PLANNER_MAX_ROUTES);
+    }
+    return normalizedRoutes.slice(0, AI_ASSISTANT_PLANNER_MAX_ROUTES);
 }
 function buildAssistantPlannerUserSnapshot(user, inputClientId) {
     var _a, _b, _c, _d, _e;
@@ -15572,7 +16964,9 @@ function buildAssistantPlannerPrompt(params) {
         known_routes_json_array: JSON.stringify(params.knownRoutes || []),
         user_json: JSON.stringify(userSnapshot || {}),
         collection_hints_json_array: JSON.stringify(params.collectionHints || []),
-        field_hints_json_array: JSON.stringify(params.fieldHints || [])
+        field_hints_json_array: JSON.stringify(params.fieldHints || []),
+        method_hints_json_array: JSON.stringify(params.methodHints || []),
+        publication_hints_json_array: JSON.stringify(params.publicationHints || [])
     };
     var userPrompt = applyTemplate(AI_ASSISTANT_PLANNER_USER_PROMPT_TEMPLATE, templateData);
     return "System:\n".concat(AI_ASSISTANT_PLANNER_SYSTEM_PROMPT, "\n\nUser:\n").concat(userPrompt).trim();
@@ -15623,6 +17017,18 @@ function buildAssistantContext(input, userContext) {
             lines.push(hint);
         });
     }
+    var methodHints = Array.isArray(userContext === null || userContext === void 0 ? void 0 : userContext.methodHints)
+        ? userContext.methodHints.filter(Boolean)
+        : [];
+    if (methodHints.length) {
+        lines.push("Method hints: ".concat(methodHints.join(', ')));
+    }
+    var publicationHints = Array.isArray(userContext === null || userContext === void 0 ? void 0 : userContext.publicationHints)
+        ? userContext.publicationHints.filter(Boolean)
+        : [];
+    if (publicationHints.length) {
+        lines.push("Publication hints: ".concat(publicationHints.join(', ')));
+    }
     var recentToolError = normalizeOptionalString(userContext === null || userContext === void 0 ? void 0 : userContext.recentToolError);
     if (recentToolError) {
         lines.push("Most recent data-query error: ".concat(recentToolError));
@@ -16509,7 +17915,7 @@ function summarizeAssistantChangeThemes(commits) {
 }
 function resolveAssistantGitRoot(startDir) {
     return __awaiter(this, void 0, void 0, function () {
-        var current, gitPath, _a, parent_1;
+        var current, gitPath, _a, parent_2;
         return __generator(this, function (_b) {
             switch (_b.label) {
                 case 0:
@@ -16534,24 +17940,43 @@ function resolveAssistantGitRoot(startDir) {
                     if (_a) {
                         return [2 /*return*/, current];
                     }
-                    parent_1 = path.dirname(current);
-                    if (!parent_1 || parent_1 === current) {
+                    parent_2 = path.dirname(current);
+                    if (!parent_2 || parent_2 === current) {
                         return [3 /*break*/, 5];
                     }
-                    current = parent_1;
+                    current = parent_2;
                     return [3 /*break*/, 1];
                 case 5: return [2 /*return*/, ''];
             }
         });
     });
 }
+function shouldSkipAssistantGitDiscoveryDirectory(name) {
+    var normalized = normalizeOptionalString(name).toLowerCase();
+    if (!normalized) {
+        return true;
+    }
+    var skipNames = new Set([
+        'node_modules',
+        'dist',
+        'build',
+        'tmp',
+        'temp',
+        'coverage',
+        'logs',
+        'log',
+        '.next',
+        '.nuxt'
+    ]);
+    return normalized.startsWith('.') || skipNames.has(normalized);
+}
 function resolveAssistantWorkspaceGitRoots(workspaceRoot) {
     return __awaiter(this, void 0, void 0, function () {
-        var roots, seen, push, _a, entries, _b, skipNames, entries_1, entries_1_1, entry, name_1, candidate, gitPath, _c, e_45_1;
-        var e_45, _d;
-        var _e;
-        return __generator(this, function (_f) {
-            switch (_f.label) {
+        var roots, seen, push, _a, configuredRoots, configuredRoots_1, configuredRoots_1_1, configuredRoot, _b, e_45_1, queue, queued, enqueue, next, entries, _c, entries_1, entries_1_1, entry, childName, candidate, gitPath, _d, e_46_1;
+        var e_45, _e, e_46, _f;
+        var _g;
+        return __generator(this, function (_h) {
+            switch (_h.label) {
                 case 0:
                     roots = [];
                     seen = new Set();
@@ -16570,69 +17995,126 @@ function resolveAssistantWorkspaceGitRoots(workspaceRoot) {
                     _a = push;
                     return [4 /*yield*/, resolveAssistantGitRoot(workspaceRoot)];
                 case 1:
-                    _a.apply(void 0, [_f.sent()]);
-                    entries = [];
-                    _f.label = 2;
+                    _a.apply(void 0, [_h.sent()]);
+                    configuredRoots = mergeAssistantHintValues(parseAssistantPathList(process.env.AI_ASSISTANT_GIT_ROOTS), parseAssistantPathList(process.env.AI_ASSISTANT_WORKSPACE_ROOTS));
+                    _h.label = 2;
                 case 2:
-                    _f.trys.push([2, 4, , 5]);
-                    return [4 /*yield*/, fs_1.promises.readdir(workspaceRoot, { withFileTypes: true })];
+                    _h.trys.push([2, 7, 8, 9]);
+                    configuredRoots_1 = __values(configuredRoots), configuredRoots_1_1 = configuredRoots_1.next();
+                    _h.label = 3;
                 case 3:
-                    entries = _f.sent();
-                    return [3 /*break*/, 5];
+                    if (!!configuredRoots_1_1.done) return [3 /*break*/, 6];
+                    configuredRoot = configuredRoots_1_1.value;
+                    if (roots.length >= AI_ASSISTANT_GIT_DISCOVERY_MAX_ROOTS) {
+                        return [3 /*break*/, 6];
+                    }
+                    _b = push;
+                    return [4 /*yield*/, resolveAssistantGitRoot(configuredRoot)];
                 case 4:
-                    _b = _f.sent();
-                    entries = [];
-                    return [3 /*break*/, 5];
+                    _b.apply(void 0, [_h.sent()]);
+                    _h.label = 5;
                 case 5:
-                    skipNames = new Set(['node_modules', 'dist', 'build', 'tmp', 'temp', 'coverage']);
-                    _f.label = 6;
-                case 6:
-                    _f.trys.push([6, 13, 14, 15]);
-                    entries_1 = __values(entries), entries_1_1 = entries_1.next();
-                    _f.label = 7;
+                    configuredRoots_1_1 = configuredRoots_1.next();
+                    return [3 /*break*/, 3];
+                case 6: return [3 /*break*/, 9];
                 case 7:
-                    if (!!entries_1_1.done) return [3 /*break*/, 12];
+                    e_45_1 = _h.sent();
+                    e_45 = { error: e_45_1 };
+                    return [3 /*break*/, 9];
+                case 8:
+                    try {
+                        if (configuredRoots_1_1 && !configuredRoots_1_1.done && (_e = configuredRoots_1.return)) _e.call(configuredRoots_1);
+                    }
+                    finally { if (e_45) throw e_45.error; }
+                    return [7 /*endfinally*/];
+                case 9:
+                    queue = [];
+                    queued = new Set();
+                    enqueue = function (dir, depth) {
+                        var normalized = normalizeOptionalString(dir);
+                        if (!normalized) {
+                            return;
+                        }
+                        var resolved = path.resolve(normalized);
+                        if (queued.has(resolved)) {
+                            return;
+                        }
+                        queued.add(resolved);
+                        queue.push({ dir: resolved, depth: depth });
+                    };
+                    enqueue(workspaceRoot, 0);
+                    configuredRoots.forEach(function (root) { return enqueue(root, 0); });
+                    _h.label = 10;
+                case 10:
+                    if (!(queue.length && roots.length < AI_ASSISTANT_GIT_DISCOVERY_MAX_ROOTS)) return [3 /*break*/, 24];
+                    next = queue.shift();
+                    if (!next) {
+                        return [3 /*break*/, 10];
+                    }
+                    entries = [];
+                    _h.label = 11;
+                case 11:
+                    _h.trys.push([11, 13, , 14]);
+                    return [4 /*yield*/, fs_1.promises.readdir(next.dir, { withFileTypes: true })];
+                case 12:
+                    entries = _h.sent();
+                    return [3 /*break*/, 14];
+                case 13:
+                    _c = _h.sent();
+                    entries = [];
+                    return [3 /*break*/, 14];
+                case 14:
+                    _h.trys.push([14, 21, 22, 23]);
+                    entries_1 = (e_46 = void 0, __values(entries)), entries_1_1 = entries_1.next();
+                    _h.label = 15;
+                case 15:
+                    if (!!entries_1_1.done) return [3 /*break*/, 20];
                     entry = entries_1_1.value;
-                    if (roots.length >= 12) {
-                        return [3 /*break*/, 12];
+                    if (roots.length >= AI_ASSISTANT_GIT_DISCOVERY_MAX_ROOTS) {
+                        return [3 /*break*/, 20];
                     }
-                    if (!((_e = entry === null || entry === void 0 ? void 0 : entry.isDirectory) === null || _e === void 0 ? void 0 : _e.call(entry))) {
-                        return [3 /*break*/, 11];
+                    if (!((_g = entry === null || entry === void 0 ? void 0 : entry.isDirectory) === null || _g === void 0 ? void 0 : _g.call(entry))) {
+                        return [3 /*break*/, 19];
                     }
-                    name_1 = normalizeOptionalString(entry.name).toLowerCase();
-                    if (!name_1 || name_1.startsWith('.') || skipNames.has(name_1)) {
-                        return [3 /*break*/, 11];
+                    childName = normalizeOptionalString(entry.name);
+                    if (shouldSkipAssistantGitDiscoveryDirectory(childName)) {
+                        return [3 /*break*/, 19];
                     }
-                    candidate = path.join(workspaceRoot, entry.name);
+                    candidate = path.join(next.dir, childName);
                     gitPath = path.join(candidate, '.git');
                     return [4 /*yield*/, directoryExists(gitPath)];
-                case 8:
-                    _c = (_f.sent());
-                    if (_c) return [3 /*break*/, 10];
+                case 16:
+                    _d = (_h.sent());
+                    if (_d) return [3 /*break*/, 18];
                     return [4 /*yield*/, pathExists(gitPath)];
-                case 9:
-                    _c = (_f.sent());
-                    _f.label = 10;
-                case 10:
-                    if (_c) {
+                case 17:
+                    _d = (_h.sent());
+                    _h.label = 18;
+                case 18:
+                    if (_d) {
                         push(candidate);
+                        return [3 /*break*/, 19];
                     }
-                    _f.label = 11;
-                case 11:
+                    if (next.depth + 1 < AI_ASSISTANT_GIT_DISCOVERY_MAX_DEPTH) {
+                        enqueue(candidate, next.depth + 1);
+                    }
+                    _h.label = 19;
+                case 19:
                     entries_1_1 = entries_1.next();
-                    return [3 /*break*/, 7];
-                case 12: return [3 /*break*/, 15];
-                case 13:
-                    e_45_1 = _f.sent();
-                    e_45 = { error: e_45_1 };
                     return [3 /*break*/, 15];
-                case 14:
+                case 20: return [3 /*break*/, 23];
+                case 21:
+                    e_46_1 = _h.sent();
+                    e_46 = { error: e_46_1 };
+                    return [3 /*break*/, 23];
+                case 22:
                     try {
-                        if (entries_1_1 && !entries_1_1.done && (_d = entries_1.return)) _d.call(entries_1);
+                        if (entries_1_1 && !entries_1_1.done && (_f = entries_1.return)) _f.call(entries_1);
                     }
-                    finally { if (e_45) throw e_45.error; }
+                    finally { if (e_46) throw e_46.error; }
                     return [7 /*endfinally*/];
-                case 15: return [2 /*return*/, roots];
+                case 23: return [3 /*break*/, 10];
+                case 24: return [2 /*return*/, roots];
             }
         });
     });
@@ -16783,9 +18265,9 @@ function buildAssistantChangeHistoryUnavailableResponse(message, reason) {
         lines.push('- I could not read repository history in this environment right now, so exact rollout dates are unavailable.');
     }
     else {
-        lines.push('- Repository history is not accessible in this environment, so exact rollout dates are unavailable here.');
+        lines.push('- I could not locate a readable git repository from configured workspace paths, so exact rollout dates are unavailable right now.');
     }
-    lines.push('- I can still explain current behavior now, and provide exact dates once repository history is available.');
+    lines.push('- I can still explain current behavior now, and provide exact dates once repository history is reachable.');
     if (asksDuration) {
         lines.push('- Best-known timing: unable to confirm exact first release date from this runtime.');
     }
@@ -16796,10 +18278,189 @@ function buildAssistantChangeHistoryUnavailableResponse(message, reason) {
         generic: true
     };
 }
+function resolveAssistantChangeHistoryGitRepoUrls() {
+    var serverConfig = resolveio_server_app_1.ResolveIOServer.getServerConfig() || {};
+    var rawValues = [
+        serverConfig['AI_ASSISTANT_CHANGE_HISTORY_GIT_REPO_URL'],
+        process.env.AI_ASSISTANT_CHANGE_HISTORY_GIT_REPO_URL,
+        serverConfig['AI_ASSISTANT_GIT_REPO_URL'],
+        process.env.AI_ASSISTANT_GIT_REPO_URL,
+        serverConfig['AI_ASSISTANT_CHANGE_HISTORY_GIT_REPO_URLS'],
+        process.env.AI_ASSISTANT_CHANGE_HISTORY_GIT_REPO_URLS,
+        serverConfig['AI_ASSISTANT_GIT_REPO_URLS'],
+        process.env.AI_ASSISTANT_GIT_REPO_URLS
+    ];
+    var urls = mergeAssistantHintValues.apply(void 0, __spreadArray([], __read(rawValues.map(function (value) { return parseAssistantPathList(value); })), false));
+    return urls.filter(function (url) { return /^https?:\/\//i.test(url) || /^git@/i.test(url) || /^ssh:\/\//i.test(url); });
+}
+function resolveAssistantGitMirrorRootDir() {
+    var serverConfig = resolveio_server_app_1.ResolveIOServer.getServerConfig() || {};
+    var configured = normalizeOptionalString(serverConfig['AI_ASSISTANT_GIT_MIRROR_ROOT']
+        || process.env.AI_ASSISTANT_GIT_MIRROR_ROOT);
+    if (configured) {
+        return path.resolve(configured);
+    }
+    return path.resolve(os.tmpdir(), 'resolveio-ai-assistant-git-mirrors');
+}
+function buildAssistantGitMirrorName(repoUrl) {
+    var normalized = normalizeOptionalString(repoUrl);
+    if (!normalized) {
+        return 'repo';
+    }
+    var withoutSuffix = normalized.replace(/\.git$/i, '');
+    var tail = withoutSuffix.split(/[/:]/g).filter(Boolean).slice(-2).join('-');
+    var slug = normalizeOptionalString(tail)
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]+/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+    return slug || 'repo';
+}
+function syncAssistantGitMirror(repoUrl) {
+    return __awaiter(this, void 0, void 0, function () {
+        var normalizedUrl, now, cached, _a, mirrorRoot, _b, targetRoot, hasGitDir, _c, _d, resolvedRoot;
+        return __generator(this, function (_e) {
+            switch (_e.label) {
+                case 0:
+                    normalizedUrl = normalizeOptionalString(repoUrl);
+                    if (!normalizedUrl) {
+                        return [2 /*return*/, ''];
+                    }
+                    now = Date.now();
+                    cached = assistantGitMirrorCache.get(normalizedUrl);
+                    if (!(cached && now - cached.updatedAt < AI_ASSISTANT_GIT_MIRROR_CACHE_TTL_MS)) return [3 /*break*/, 4];
+                    return [4 /*yield*/, directoryExists(path.join(cached.root, '.git'))];
+                case 1:
+                    _a = (_e.sent());
+                    if (_a) return [3 /*break*/, 3];
+                    return [4 /*yield*/, pathExists(path.join(cached.root, '.git'))];
+                case 2:
+                    _a = (_e.sent());
+                    _e.label = 3;
+                case 3:
+                    if (_a) {
+                        return [2 /*return*/, cached.root];
+                    }
+                    _e.label = 4;
+                case 4:
+                    mirrorRoot = resolveAssistantGitMirrorRootDir();
+                    _e.label = 5;
+                case 5:
+                    _e.trys.push([5, 7, , 8]);
+                    return [4 /*yield*/, fs_1.promises.mkdir(mirrorRoot, { recursive: true })];
+                case 6:
+                    _e.sent();
+                    return [3 /*break*/, 8];
+                case 7:
+                    _b = _e.sent();
+                    return [2 /*return*/, ''];
+                case 8:
+                    targetRoot = path.join(mirrorRoot, buildAssistantGitMirrorName(normalizedUrl));
+                    return [4 /*yield*/, directoryExists(path.join(targetRoot, '.git'))];
+                case 9:
+                    _c = (_e.sent());
+                    if (_c) return [3 /*break*/, 11];
+                    return [4 /*yield*/, pathExists(path.join(targetRoot, '.git'))];
+                case 10:
+                    _c = (_e.sent());
+                    _e.label = 11;
+                case 11:
+                    hasGitDir = _c;
+                    _e.label = 12;
+                case 12:
+                    _e.trys.push([12, 17, , 18]);
+                    if (!!hasGitDir) return [3 /*break*/, 14];
+                    return [4 /*yield*/, execFileAsync('git', ['clone', '--depth', '400', '--no-single-branch', normalizedUrl, targetRoot], {
+                            timeout: AI_ASSISTANT_GIT_COMMAND_TIMEOUT_MS * 6,
+                            maxBuffer: 1024 * 1024 * 6
+                        })];
+                case 13:
+                    _e.sent();
+                    return [3 /*break*/, 16];
+                case 14:
+                    if (!resolveAssistantChangeHistoryFetchEnabled()) return [3 /*break*/, 16];
+                    return [4 /*yield*/, execFileAsync('git', ['fetch', '--all', '--prune', '--quiet'], {
+                            cwd: targetRoot,
+                            timeout: AI_ASSISTANT_GIT_COMMAND_TIMEOUT_MS * 2,
+                            maxBuffer: 1024 * 1024 * 6
+                        })];
+                case 15:
+                    _e.sent();
+                    _e.label = 16;
+                case 16: return [3 /*break*/, 18];
+                case 17:
+                    _d = _e.sent();
+                    return [2 /*return*/, ''];
+                case 18: return [4 /*yield*/, resolveAssistantGitRoot(targetRoot)];
+                case 19:
+                    resolvedRoot = _e.sent();
+                    if (!resolvedRoot) {
+                        return [2 /*return*/, ''];
+                    }
+                    assistantGitMirrorCache.set(normalizedUrl, {
+                        root: resolvedRoot,
+                        updatedAt: now
+                    });
+                    return [2 /*return*/, resolvedRoot];
+            }
+        });
+    });
+}
+function resolveAssistantChangeHistoryGitRoots(workspaceRoot) {
+    return __awaiter(this, void 0, void 0, function () {
+        var roots, repoUrls, mirroredRoots, repoUrls_1, repoUrls_1_1, repoUrl, mirrorRoot, e_47_1;
+        var e_47, _a;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0: return [4 /*yield*/, resolveAssistantWorkspaceGitRoots(workspaceRoot)];
+                case 1:
+                    roots = _b.sent();
+                    if (roots.length) {
+                        return [2 /*return*/, roots];
+                    }
+                    repoUrls = resolveAssistantChangeHistoryGitRepoUrls();
+                    if (!repoUrls.length) {
+                        return [2 /*return*/, []];
+                    }
+                    mirroredRoots = [];
+                    _b.label = 2;
+                case 2:
+                    _b.trys.push([2, 7, 8, 9]);
+                    repoUrls_1 = __values(repoUrls), repoUrls_1_1 = repoUrls_1.next();
+                    _b.label = 3;
+                case 3:
+                    if (!!repoUrls_1_1.done) return [3 /*break*/, 6];
+                    repoUrl = repoUrls_1_1.value;
+                    return [4 /*yield*/, syncAssistantGitMirror(repoUrl)];
+                case 4:
+                    mirrorRoot = _b.sent();
+                    if (mirrorRoot && !mirroredRoots.includes(mirrorRoot)) {
+                        mirroredRoots.push(mirrorRoot);
+                    }
+                    _b.label = 5;
+                case 5:
+                    repoUrls_1_1 = repoUrls_1.next();
+                    return [3 /*break*/, 3];
+                case 6: return [3 /*break*/, 9];
+                case 7:
+                    e_47_1 = _b.sent();
+                    e_47 = { error: e_47_1 };
+                    return [3 /*break*/, 9];
+                case 8:
+                    try {
+                        if (repoUrls_1_1 && !repoUrls_1_1.done && (_a = repoUrls_1.return)) _a.call(repoUrls_1);
+                    }
+                    finally { if (e_47) throw e_47.error; }
+                    return [7 /*endfinally*/];
+                case 9: return [2 /*return*/, mirroredRoots];
+            }
+        });
+    });
+}
 function resolveAssistantChangeHistoryFastPathResponse(params) {
     return __awaiter(this, void 0, void 0, function () {
-        var workspaceRoot, _a, gitRoots, featureKeywords, sawExecutionError, bestFallback, gitRoots_1, gitRoots_1_1, gitRoot, _b, branch, _c, _d, limit, historyDepth, rawHistory, commits, summary, hasKeywordMatches, _e, e_46_1;
-        var e_46, _f;
+        var workspaceRoot, _a, gitRoots, featureKeywords, sawExecutionError, bestFallback, gitRoots_1, gitRoots_1_1, gitRoot, _b, branch, _c, _d, limit, historyDepth, rawHistory, commits, summary, hasKeywordMatches, _e, e_48_1;
+        var e_48, _f;
         return __generator(this, function (_g) {
             switch (_g.label) {
                 case 0:
@@ -16822,7 +18483,7 @@ function resolveAssistantChangeHistoryFastPathResponse(params) {
                     if (!workspaceRoot) {
                         return [2 /*return*/, buildAssistantChangeHistoryUnavailableResponse(params.message, 'no_repo')];
                     }
-                    return [4 /*yield*/, resolveAssistantWorkspaceGitRoots(workspaceRoot)];
+                    return [4 /*yield*/, resolveAssistantChangeHistoryGitRoots(workspaceRoot)];
                 case 5:
                     gitRoots = _g.sent();
                     if (!gitRoots.length) {
@@ -16921,14 +18582,14 @@ function resolveAssistantChangeHistoryFastPathResponse(params) {
                     return [3 /*break*/, 7];
                 case 20: return [3 /*break*/, 23];
                 case 21:
-                    e_46_1 = _g.sent();
-                    e_46 = { error: e_46_1 };
+                    e_48_1 = _g.sent();
+                    e_48 = { error: e_48_1 };
                     return [3 /*break*/, 23];
                 case 22:
                     try {
                         if (gitRoots_1_1 && !gitRoots_1_1.done && (_f = gitRoots_1.return)) _f.call(gitRoots_1);
                     }
-                    finally { if (e_46) throw e_46.error; }
+                    finally { if (e_48) throw e_48.error; }
                     return [7 /*endfinally*/];
                 case 23:
                     if (bestFallback) {
@@ -17109,7 +18770,7 @@ function sanitizeAssistantResponse(value) {
     return normalizeAssistantRoutes(normalizedCurrency);
 }
 function evaluateAssistantGuardrails(message) {
-    var e_47, _a;
+    var e_49, _a;
     var normalized = String(message || '').toLowerCase();
     var patterns = [
         {
@@ -17155,12 +18816,12 @@ function evaluateAssistantGuardrails(message) {
             }
         }
     }
-    catch (e_47_1) { e_47 = { error: e_47_1 }; }
+    catch (e_49_1) { e_49 = { error: e_49_1 }; }
     finally {
         try {
             if (patterns_2_1 && !patterns_2_1.done && (_a = patterns_2.return)) _a.call(patterns_2);
         }
-        finally { if (e_47) throw e_47.error; }
+        finally { if (e_49) throw e_49.error; }
     }
     return null;
 }
@@ -17275,7 +18936,7 @@ function tokenizeArithmeticExpression(expression) {
     return tokens;
 }
 function evaluateArithmeticExpression(expression) {
-    var e_48, _a, e_49, _b;
+    var e_50, _a, e_51, _b;
     var tokens = tokenizeArithmeticExpression(expression);
     if (!tokens || !tokens.length) {
         return null;
@@ -17332,12 +18993,12 @@ function evaluateArithmeticExpression(expression) {
             prevToken = token;
         }
     }
-    catch (e_48_1) { e_48 = { error: e_48_1 }; }
+    catch (e_50_1) { e_50 = { error: e_50_1 }; }
     finally {
         try {
             if (tokens_2_1 && !tokens_2_1.done && (_a = tokens_2.return)) _a.call(tokens_2);
         }
-        finally { if (e_48) throw e_48.error; }
+        finally { if (e_50) throw e_50.error; }
     }
     while (ops.length) {
         var op = ops.pop();
@@ -17377,12 +19038,12 @@ function evaluateArithmeticExpression(expression) {
             stack.push(Number(token));
         }
     }
-    catch (e_49_1) { e_49 = { error: e_49_1 }; }
+    catch (e_51_1) { e_51 = { error: e_51_1 }; }
     finally {
         try {
             if (output_1_1 && !output_1_1.done && (_b = output_1.return)) _b.call(output_1);
         }
-        finally { if (e_49) throw e_49.error; }
+        finally { if (e_51) throw e_51.error; }
     }
     if (stack.length !== 1 || Number.isNaN(stack[0])) {
         return null;
@@ -17566,8 +19227,8 @@ function handleCodexUpload(id_conversation, file_name, content_base64, size, con
 }
 function readAttachmentContents(attachments) {
     return __awaiter(this, void 0, void 0, function () {
-        var limits, totalBytes, totalChars, chunks, cleaned, attachments_1, attachments_1_1, attachment, localPath, safe, stat, ext, name_2, type, readable, content, _a, e_50_1;
-        var e_50, _b;
+        var limits, totalBytes, totalChars, chunks, cleaned, attachments_1, attachments_1_1, attachment, localPath, safe, stat, ext, name_1, type, readable, content, _a, e_52_1;
+        var e_52, _b;
         return __generator(this, function (_c) {
             switch (_c.label) {
                 case 0:
@@ -17609,7 +19270,7 @@ function readAttachmentContents(attachments) {
                         return [3 /*break*/, 10];
                     }
                     ext = path.extname(localPath).toLowerCase();
-                    name_2 = normalizeOptionalString(attachment.name) || path.basename(localPath);
+                    name_1 = normalizeOptionalString(attachment.name) || path.basename(localPath);
                     type = normalizeOptionalString(attachment.type);
                     readable = isReadableAttachment(type, ext);
                     content = '';
@@ -17622,17 +19283,17 @@ function readAttachmentContents(attachments) {
                     }
                     return [3 /*break*/, 7];
                 case 6:
-                    content = "[".concat(name_2, " attached; binary content omitted]");
+                    content = "[".concat(name_1, " attached; binary content omitted]");
                     _c.label = 7;
                 case 7:
                     totalChars += content.length;
                     if (totalChars > limits.maxTotalAttachmentChars) {
                         return [3 /*break*/, 10];
                     }
-                    chunks.push("File: ".concat(name_2, "\n").concat(content));
+                    chunks.push("File: ".concat(name_1, "\n").concat(content));
                     cleaned.push({
                         id: attachment.id,
-                        name: name_2,
+                        name: name_1,
                         type: type,
                         size: stat.size,
                         local_path: localPath
@@ -17646,14 +19307,14 @@ function readAttachmentContents(attachments) {
                     return [3 /*break*/, 2];
                 case 10: return [3 /*break*/, 13];
                 case 11:
-                    e_50_1 = _c.sent();
-                    e_50 = { error: e_50_1 };
+                    e_52_1 = _c.sent();
+                    e_52 = { error: e_52_1 };
                     return [3 /*break*/, 13];
                 case 12:
                     try {
                         if (attachments_1_1 && !attachments_1_1.done && (_b = attachments_1.return)) _b.call(attachments_1);
                     }
-                    finally { if (e_50) throw e_50.error; }
+                    finally { if (e_52) throw e_52.error; }
                     return [7 /*endfinally*/];
                 case 13: return [2 /*return*/, {
                         promptText: chunks.length ? "\n\nAttachments:\n".concat(chunks.join('\n\n')) : '',
@@ -17977,7 +19638,7 @@ function estimateUsage(messages, responseText, model) {
     };
 }
 function evaluateGuardrails(message) {
-    var e_51, _a;
+    var e_53, _a;
     var normalized = String(message || '').toLowerCase();
     var patterns = [
         { pattern: /\b(source\s*code|full\s*code|entire\s*code|repo\s*dump|repository|git\s*clone)\b/i, reason: 'Code access is restricted.' },
@@ -17999,12 +19660,12 @@ function evaluateGuardrails(message) {
             }
         }
     }
-    catch (e_51_1) { e_51 = { error: e_51_1 }; }
+    catch (e_53_1) { e_53 = { error: e_53_1 }; }
     finally {
         try {
             if (patterns_3_1 && !patterns_3_1.done && (_a = patterns_3.return)) _a.call(patterns_3);
         }
-        finally { if (e_51) throw e_51.error; }
+        finally { if (e_53) throw e_53.error; }
     }
     return null;
 }