@resolveio/server-lib 20.15.3 → 20.15.4

package/methods/ai-terminal.js

@@ -133,7 +133,7 @@ var DEFAULT_MAX_FILE_MB = 50;
 var DEFAULT_MAX_TOTAL_MB = 100;
 var DEFAULT_MAX_ATTACHMENT_CHARS = 12000;
 var DEFAULT_MAX_TOTAL_ATTACHMENT_CHARS = 40000;
-var DEFAULT_CODEX_MODEL = 'gpt-5.2-codex';
+var DEFAULT_CODEX_MODEL = 'gpt-5.1-codex-mini';
 var DEFAULT_CODEX_TIMEOUT_MS = 180000;
 var AI_ASSISTANT_MONGO_DEFAULT_LIMIT = 20;
 var AI_ASSISTANT_MONGO_MAX_LIMIT = 200;
@@ -199,6 +199,51 @@ var AI_ASSISTANT_SENSITIVE_FIELDS = [
     'roles'
 ];
 var AI_ASSISTANT_CLIENT_SCOPE_CACHE = new Map();
+var AI_ASSISTANT_COLLECTION_CACHE = new Map();
+var AI_ASSISTANT_COLLECTION_CACHE_TTL_MS = 5 * 60 * 1000;
+var AI_ASSISTANT_COLLECTION_STOPWORDS = new Set([
+    'the',
+    'a',
+    'an',
+    'of',
+    'for',
+    'by',
+    'with',
+    'and',
+    'or',
+    'to',
+    'from',
+    'in',
+    'on',
+    'at',
+    'last',
+    'recent',
+    'today',
+    'week',
+    'month',
+    'year',
+    'this',
+    'that',
+    'these',
+    'those',
+    'show',
+    'list',
+    'get',
+    'give',
+    'how',
+    'many',
+    'count',
+    'total',
+    'breakdown',
+    'group',
+    'grouped',
+    'per',
+    'open',
+    'closed',
+    'completed',
+    'missing',
+    'overdue'
+]);
 var AI_ASSISTANT_SYSTEM_PROMPT = [
     'You are the ResolveIO in-app AI assistant running with read-only access to the codebase.',
     'Core rules:',
@@ -209,11 +254,16 @@ var AI_ASSISTANT_SYSTEM_PROMPT = [
     '- If the user has a customer portal scope (other.id_customer), only discuss that customer\'s data and what is visible in their customer portal. Never reference other customers or internal/admin-only data. If asked for anything outside the portal, say it isn\'t available.',
     '- Do not assist with hacking, bypassing security, or abuse.',
     'Accuracy & tools:',
+    '- Step 1 (always): determine the target collections/models/modules/workflows using context, routes, and collection hints. Assume the user is non-technical and will not provide internal names.',
+    '- Map user wording to internal collections/fields yourself. Do not ask for property names unless required to run a query.',
     '- Do not guess or invent collections/fields. If unsure, verify in the codebase or run a small Mongo read (limit 1-5) to learn the shape.',
     '- Prefer running a small Mongo read over asking multiple questions.',
+    '- For any data request (counts, lists, breakdowns, recent/last items), you MUST run a MONGO_READ or MONGO_AGG before answering.',
     '- Ask at most one clarifying question only when required to run a query or resolve missing details.',
     '- If a field starts with id_ and refers to another collection, treat it as a foreign key and look up the related record when needed.',
+    '- When the user provides a customer, well, or chemical name, use case-insensitive regex matching to find it. Assume the name exists and try to match it before asking questions.',
     '- Use the codebase context to choose correct collections/fields/workflows and use MONGO_READ/MONGO_AGG to answer with real data when needed.',
+    '- Assume a relevant collection exists; if verification reads return zero data, report no data found instead of interrogating the user.',
     '- For direct questions, answer first. Ask a single follow-up only if required to proceed.',
     'Data Presentation:',
     '- Output plain Markdown (NO triple backticks).',
@@ -224,6 +274,7 @@ var AI_ASSISTANT_SYSTEM_PROMPT = [
     '- If `_id` & `__v` & `id_<other collection _id property>` is needed, show it as `id` and shorten (e.g., first 6-8 chars) unless asked otherwise.',
     '- Rename `createdAt` to `Created At` and `updatedAt` to `Updated At` in tables.',
     'Response style:',
+    '- Respond in English only. Do not include non-English text or characters unless required for JSON, links, or tool directives.',
     '- Keep responses concise: answer first, then 3-8 bullets, then a table when data is involved.',
     '- Prefer high-level explanations and point to routes instead of code. Only mention file paths if explicitly requested.',
     '- When asked where to do something, give the exact screen name and the in-app route as a standalone path starting with "/" so it can be clicked.',
@@ -261,7 +312,8 @@ var AI_ASSISTANT_SYSTEM_PROMPT = [
     '- When grouping by fields that can be arrays (drivers, deliveries, routes, chemicals), $unwind first and group by both id and name when available.',
     '- Use MONGO_READ/MONGO_AGG only to produce summaries/snapshots/health checks (not raw dumps) when permitted.',
     '- If the user explicitly asks for IDs, set options.includeIds: true.',
-    '- Keep responses concise and use low reasoning effort.'
+    '- If a data question returns zero results, verify the collection/date field with a tiny read (limit 1-5) or a date field fallback before concluding there is no data.',
+    '- Keep responses concise and use the configured reasoning effort level (default low).'
 ].join('\n');
 var AI_FORM_PATCH_SYSTEM_PROMPT = [
     'You are the ResolveIO form patch assistant.',
@@ -800,10 +852,10 @@ function executeAiFormPatch(payload, context) {
 }
 function executeAiAssistantCodexRun(payload, context) {
     return __awaiter(this, void 0, void 0, function () {
-        var input, message, requestId, guardrail, conversation_2, now_2, userMsg, assistantMsg, user, isSuperAdmin, hasInvoiceAccess, customerId, conversation, now, attachments, attachmentData, historyLimit, history, _a, historyLines, assistantContext, prompt, workspaceRoot, codexConfig, runOptions, userDoc, initialProgress, assistantDoc, insertResult, assistantMessageId, progressTracker, streamProgress, assistantContent, toolResult, responseText, directive, cleanedResponseText, toolRequest, toolResponse, _b, toolPayload, followupPrompt, followupText, _c, error_1, error_2, finalNow, finalMetadata, finalAssistantDoc;
-        var _d, _e;
-        return __generator(this, function (_f) {
-            switch (_f.label) {
+        var input, message, requestId, guardrail, conversation_2, now_2, userMsg, assistantMsg, user, isSuperAdmin, hasInvoiceAccess, customerId, conversation, now, attachments, attachmentData, historyLimit, history, _a, historyLines, collectionHints, dbName, db, hintText, _b, assistantContext, prompt, workspaceRoot, codexConfig, runOptions, userDoc, initialProgress, assistantDoc, insertResult, assistantMessageId, progressTracker, streamProgress, assistantContent, toolResult, assistantDebug, directiveSource, dataQuestion, lastDirective, toolResponseDebug, toolError, responseText, directive, directiveSourceText, directivePrompt, directiveText, forcedDirective, _c, cleanedResponseText, toolRequest, toolResponse, _d, toolPayload, followupPrompt, followupText, _e, error_1, error_2, finalNow, finalMetadata, finalAssistantDoc;
+        var _f, _g, _h;
+        return __generator(this, function (_j) {
+            switch (_j.label) {
                 case 0:
                     input = payload || {};
                     message = normalizeOptionalString(input.message);
@@ -818,7 +870,7 @@ function executeAiAssistantCodexRun(payload, context) {
                     if (!(guardrail === null || guardrail === void 0 ? void 0 : guardrail.blocked)) return [3 /*break*/, 5];
                     return [4 /*yield*/, ensureConversation(input, 'codex')];
                 case 1:
-                    conversation_2 = _f.sent();
+                    conversation_2 = _j.sent();
                     now_2 = new Date();
                     userMsg = {
                         id_conversation: conversation_2._id,
@@ -838,13 +890,13 @@ function executeAiAssistantCodexRun(payload, context) {
                     };
                     return [4 /*yield*/, ai_terminal_message_collection_1.AiTerminalMessages.insertOne(userMsg)];
                 case 2:
-                    _f.sent();
+                    _j.sent();
                     return [4 /*yield*/, ai_terminal_message_collection_1.AiTerminalMessages.insertOne(assistantMsg)];
                 case 3:
-                    _f.sent();
+                    _j.sent();
                     return [4 /*yield*/, touchConversation(conversation_2._id, now_2)];
                 case 4:
-                    _f.sent();
+                    _j.sent();
                     return [2 /*return*/, {
                             conversation: conversation_2,
                             message: assistantMsg,
@@ -852,27 +904,27 @@ function executeAiAssistantCodexRun(payload, context) {
                         }];
                 case 5: return [4 /*yield*/, user_collection_1.Users.findById(context === null || context === void 0 ? void 0 : context.id_user)];
                 case 6:
-                    user = _f.sent();
-                    isSuperAdmin = !!((_d = user === null || user === void 0 ? void 0 : user.roles) === null || _d === void 0 ? void 0 : _d.super_admin);
+                    user = _j.sent();
+                    isSuperAdmin = !!((_f = user === null || user === void 0 ? void 0 : user.roles) === null || _f === void 0 ? void 0 : _f.super_admin);
                     hasInvoiceAccess = userHasInvoiceAccess(user);
-                    customerId = normalizeOptionalString((_e = user === null || user === void 0 ? void 0 : user.other) === null || _e === void 0 ? void 0 : _e.id_customer);
+                    customerId = normalizeOptionalString((_g = user === null || user === void 0 ? void 0 : user.other) === null || _g === void 0 ? void 0 : _g.id_customer);
                     return [4 /*yield*/, ensureConversation(input, 'codex')];
                 case 7:
-                    conversation = _f.sent();
+                    conversation = _j.sent();
                     now = new Date();
                     attachments = Array.isArray(input.attachments) ? input.attachments : [];
                     return [4 /*yield*/, readAttachmentContents(attachments)];
                 case 8:
-                    attachmentData = _f.sent();
+                    attachmentData = _j.sent();
                     historyLimit = normalizeHistoryLimit(input.max_history);
                     if (!(historyLimit > 0)) return [3 /*break*/, 10];
                     return [4 /*yield*/, ai_terminal_message_collection_1.AiTerminalMessages.find({ id_conversation: conversation._id, role: { $in: ['user', 'assistant'] } }, { sort: { createdAt: 1 }, limit: historyLimit * 2 })];
                 case 9:
-                    _a = _f.sent();
+                    _a = _j.sent();
                     return [3 /*break*/, 11];
                 case 10:
                     _a = [];
-                    _f.label = 11;
+                    _j.label = 11;
                 case 11:
                     history = _a;
                     historyLines = [];
@@ -883,11 +935,35 @@ function executeAiAssistantCodexRun(payload, context) {
                             historyLines.push("".concat(role, ": ").concat(content));
                         }
                     });
-                    assistantContext = buildAssistantContext(input, { isSuperAdmin: isSuperAdmin, hasInvoiceAccess: hasInvoiceAccess, customerId: customerId });
+                    collectionHints = [];
+                    _j.label = 12;
+                case 12:
+                    _j.trys.push([12, 14, , 15]);
+                    dbName = resolveAssistantDatabaseName(undefined, input.mongo);
+                    db = resolveio_server_app_1.ResolveIOServer.getMongoConnection().db(dbName);
+                    hintText = [
+                        message,
+                        normalizeOptionalString((_h = input === null || input === void 0 ? void 0 : input.context) === null || _h === void 0 ? void 0 : _h.route)
+                    ].filter(Boolean).join(' ');
+                    return [4 /*yield*/, resolveAssistantCollectionHints(hintText, dbName, db)];
+                case 13:
+                    collectionHints = _j.sent();
+                    return [3 /*break*/, 15];
+                case 14:
+                    _b = _j.sent();
+                    collectionHints = [];
+                    return [3 /*break*/, 15];
+                case 15:
+                    assistantContext = buildAssistantContext(input, {
+                        isSuperAdmin: isSuperAdmin,
+                        hasInvoiceAccess: hasInvoiceAccess,
+                        customerId: customerId,
+                        collectionHints: collectionHints
+                    });
                     prompt = buildAssistantCodexPrompt(message, attachmentData.promptText, historyLines.join('\n'), assistantContext);
                     return [4 /*yield*/, resolveAssistantWorkspaceRoot()];
-                case 12:
-                    workspaceRoot = _f.sent();
+                case 16:
+                    workspaceRoot = _j.sent();
                     codexConfig = resolveCodexSettings();
                     runOptions = {
                         timeoutMs: resolveCodexTimeoutMs(),
@@ -895,7 +971,7 @@ function executeAiAssistantCodexRun(payload, context) {
                             workingDirectory: workspaceRoot,
                             sandboxMode: 'read-only',
                             skipGitRepoCheck: true,
-                            modelReasoningEffort: 'low',
+                            modelReasoningEffort: resolveCodexThoughtLevel(),
                             networkAccessEnabled: false,
                             webSearchMode: 'disabled',
                             webSearchEnabled: false,
@@ -921,83 +997,128 @@ function executeAiAssistantCodexRun(payload, context) {
                         updatedAt: now
                     };
                     return [4 /*yield*/, ai_terminal_message_collection_1.AiTerminalMessages.insertOne(userDoc)];
-                case 13:
-                    _f.sent();
+                case 17:
+                    _j.sent();
                     return [4 /*yield*/, ai_terminal_message_collection_1.AiTerminalMessages.insertOne(assistantDoc)];
-                case 14:
-                    insertResult = _f.sent();
+                case 18:
+                    insertResult = _j.sent();
                     assistantMessageId = (insertResult === null || insertResult === void 0 ? void 0 : insertResult._id) || (insertResult === null || insertResult === void 0 ? void 0 : insertResult.insertedId);
                     progressTracker = createAssistantProgressTracker(assistantMessageId, initialProgress);
                     streamProgress = createAssistantStreamProgressHandler(progressTracker);
                     assistantContent = '';
                     toolResult = null;
-                    _f.label = 15;
-                case 15:
-                    _f.trys.push([15, 30, 31, 32]);
+                    assistantDebug = null;
+                    directiveSource = 'none';
+                    dataQuestion = isAssistantDataQuestion(message);
+                    lastDirective = null;
+                    toolResponseDebug = null;
+                    toolError = null;
+                    _j.label = 19;
+                case 19:
+                    _j.trys.push([19, 38, 39, 40]);
                     return [4 /*yield*/, runCodexInWorkerThread(prompt, runOptions, codexConfig, streamProgress)];
-                case 16:
-                    responseText = _f.sent();
+                case 20:
+                    responseText = _j.sent();
                     directive = extractAssistantMongoDirective(responseText);
-                    cleanedResponseText = (directive === null || directive === void 0 ? void 0 : directive.cleaned) || responseText;
+                    directiveSourceText = responseText;
+                    if (directive) {
+                        directiveSource = 'model';
+                        lastDirective = directive;
+                    }
+                    if (!(!directive && dataQuestion)) return [3 /*break*/, 24];
+                    directivePrompt = buildAssistantCodexDirectivePrompt(message, attachmentData.promptText, historyLines.join('\n'), assistantContext);
+                    _j.label = 21;
+                case 21:
+                    _j.trys.push([21, 23, , 24]);
+                    return [4 /*yield*/, runCodexInWorkerThread(directivePrompt, runOptions, codexConfig, streamProgress)];
+                case 22:
+                    directiveText = _j.sent();
+                    forcedDirective = extractAssistantMongoDirective(directiveText);
+                    if (forcedDirective) {
+                        directive = forcedDirective;
+                        directiveSourceText = directiveText;
+                        directiveSource = 'forced';
+                        lastDirective = forcedDirective;
+                    }
+                    return [3 /*break*/, 24];
+                case 23:
+                    _c = _j.sent();
+                    return [3 /*break*/, 24];
+                case 24:
+                    cleanedResponseText = (directive === null || directive === void 0 ? void 0 : directive.cleaned) || directiveSourceText;
                     assistantContent = sanitizeAssistantResponse(cleanedResponseText);
-                    if (!((directive === null || directive === void 0 ? void 0 : directive.payload) && AI_ASSISTANT_TOOL_MAX_STEPS > 0)) return [3 /*break*/, 28];
+                    if (!((directive === null || directive === void 0 ? void 0 : directive.payload) && AI_ASSISTANT_TOOL_MAX_STEPS > 0)) return [3 /*break*/, 36];
                     toolRequest = buildAssistantToolRequest(directive, input);
                     progressTracker.push('Looking up Data');
-                    _f.label = 17;
-                case 17:
-                    _f.trys.push([17, 26, , 27]);
-                    if (!(directive.type === 'aggregate')) return [3 /*break*/, 19];
+                    _j.label = 25;
+                case 25:
+                    _j.trys.push([25, 34, , 35]);
+                    if (!(directive.type === 'aggregate')) return [3 /*break*/, 27];
                     return [4 /*yield*/, executeAiAssistantMongoAggregate(toolRequest, context)];
-                case 18:
-                    _b = _f.sent();
-                    return [3 /*break*/, 21];
-                case 19: return [4 /*yield*/, executeAiAssistantMongoRead(toolRequest, context)];
-                case 20:
-                    _b = _f.sent();
-                    _f.label = 21;
-                case 21:
-                    toolResponse = _b;
+                case 26:
+                    _d = _j.sent();
+                    return [3 /*break*/, 29];
+                case 27: return [4 /*yield*/, executeAiAssistantMongoRead(toolRequest, context)];
+                case 28:
+                    _d = _j.sent();
+                    _j.label = 29;
+                case 29:
+                    toolResponse = _d;
+                    toolResponseDebug = (toolResponse === null || toolResponse === void 0 ? void 0 : toolResponse.debug) && typeof toolResponse.debug === 'object'
+                        ? toolResponse.debug
+                        : null;
                     toolPayload = buildAssistantToolResultPayload(directive, toolResponse);
                     toolResult = toolPayload.result;
                     progressTracker.push('Drafting response');
                     followupPrompt = buildAssistantCodexToolFollowupPrompt(message, attachmentData.promptText, historyLines.join('\n'), assistantContext, toolPayload.prompt);
-                    _f.label = 22;
-                case 22:
-                    _f.trys.push([22, 24, , 25]);
+                    _j.label = 30;
+                case 30:
+                    _j.trys.push([30, 32, , 33]);
                     return [4 /*yield*/, runCodexInWorkerThread(followupPrompt, runOptions, codexConfig, streamProgress)];
-                case 23:
-                    followupText = _f.sent();
+                case 31:
+                    followupText = _j.sent();
                     assistantContent = sanitizeAssistantResponse(followupText);
-                    return [3 /*break*/, 25];
-                case 24:
-                    _c = _f.sent();
+                    return [3 /*break*/, 33];
+                case 32:
+                    _e = _j.sent();
                     assistantContent = buildAssistantToolFallbackResponse(toolPayload.result);
-                    return [3 /*break*/, 25];
-                case 25: return [3 /*break*/, 27];
-                case 26:
-                    error_1 = _f.sent();
+                    return [3 /*break*/, 33];
+                case 33: return [3 /*break*/, 35];
+                case 34:
+                    error_1 = _j.sent();
                     assistantContent = buildAssistantToolErrorMessage(error_1, directive, toolRequest);
-                    return [3 /*break*/, 27];
-                case 27: return [3 /*break*/, 29];
-                case 28:
+                    toolError = error_1;
+                    return [3 /*break*/, 35];
+                case 35: return [3 /*break*/, 37];
+                case 36:
                     progressTracker.push('Drafting response');
-                    _f.label = 29;
-                case 29: return [3 /*break*/, 32];
-                case 30:
-                    error_2 = _f.sent();
+                    _j.label = 37;
+                case 37: return [3 /*break*/, 40];
+                case 38:
+                    error_2 = _j.sent();
                     assistantContent = buildAssistantCodexErrorMessage(error_2);
-                    return [3 /*break*/, 32];
-                case 31:
+                    return [3 /*break*/, 40];
+                case 39:
                     progressTracker.stop();
                     return [7 /*endfinally*/];
-                case 32:
+                case 40:
                     if (!assistantContent) {
                         assistantContent = buildAssistantCodexErrorMessage(null);
                     }
                     finalNow = new Date();
-                    finalMetadata = __assign(__assign({ model: resolveCodexModel() }, (requestId ? { request_id: requestId } : {})), (toolResult ? { tool_result: toolResult } : {}));
+                    if (isSuperAdmin) {
+                        assistantDebug = buildAssistantDebugPayload({
+                            dataQuestion: dataQuestion,
+                            directive: lastDirective,
+                            directiveSource: directiveSource,
+                            toolResult: toolResult,
+                            toolResponseDebug: toolResponseDebug,
+                            toolError: toolError
+                        });
+                    }
+                    finalMetadata = __assign(__assign(__assign({ model: resolveCodexModel() }, (requestId ? { request_id: requestId } : {})), (toolResult ? { tool_result: toolResult } : {})), (assistantDebug ? { debug: assistantDebug } : {}));
                     finalAssistantDoc = __assign(__assign({}, assistantDoc), { _id: assistantMessageId, content: assistantContent, metadata: finalMetadata, updatedAt: finalNow });
-                    if (!assistantMessageId) return [3 /*break*/, 34];
+                    if (!assistantMessageId) return [3 /*break*/, 42];
                     return [4 /*yield*/, ai_terminal_message_collection_1.AiTerminalMessages.updateOne({ _id: assistantMessageId }, {
                             $set: {
                                 content: assistantContent,
@@ -1005,43 +1126,47 @@ function executeAiAssistantCodexRun(payload, context) {
                                 updatedAt: finalNow
                             }
                         })];
-                case 33:
-                    _f.sent();
-                    _f.label = 34;
-                case 34: return [4 /*yield*/, touchConversation(conversation._id, finalNow, assistantMessageId ? String(assistantMessageId) : undefined)];
-                case 35:
-                    _f.sent();
-                    if (!(input.delete_files_after_run !== false)) return [3 /*break*/, 37];
+                case 41:
+                    _j.sent();
+                    _j.label = 42;
+                case 42: return [4 /*yield*/, touchConversation(conversation._id, finalNow, assistantMessageId ? String(assistantMessageId) : undefined)];
+                case 43:
+                    _j.sent();
+                    if (!(input.delete_files_after_run !== false)) return [3 /*break*/, 45];
                     return [4 /*yield*/, cleanupAttachments(attachmentData.attachments)];
-                case 36:
-                    _f.sent();
-                    _f.label = 37;
-                case 37: return [2 /*return*/, __assign({ conversation: conversation, message: finalAssistantDoc }, (toolResult ? { tool_result: toolResult } : {}))];
+                case 44:
+                    _j.sent();
+                    _j.label = 45;
+                case 45: return [2 /*return*/, __assign({ conversation: conversation, message: finalAssistantDoc }, (toolResult ? { tool_result: toolResult } : {}))];
             }
         });
     });
 }
 function executeAiAssistantMongoRead(payload, context) {
     return __awaiter(this, void 0, void 0, function () {
-        var input, collection, _a, user, isSuperAdmin, customerId, dbName, db, baseQuery, userId, normalizedClient, shouldScopeByClient, _b, clientScopedQuery, scopedQuery, normalized, documents, total, sanitizedDocuments, includeIds, display;
+        var input, rawCollection, dbName, db, collectionResolution, collection, _a, user, isSuperAdmin, customerId, baseQuery, userId, normalizedClient, shouldScopeByClient, _b, clientScopedQuery, scopedQuery, normalized, documents, executedQuery, fallbackMeta, dateFallback, fallbackQuery, fallbackDocs, total, sanitizedDocuments, includeIds, display;
         var _c, _d;
         return __generator(this, function (_e) {
             switch (_e.label) {
                 case 0:
                     input = payload || {};
-                    collection = normalizeOptionalString(input.collection);
-                    if (!collection) {
+                    rawCollection = normalizeOptionalString(input.collection);
+                    if (!rawCollection) {
                         throw new Error('AI assistant mongo read: Collection is required.');
                     }
-                    return [4 /*yield*/, ensureAssistantReadAccess(context, input.permissionView, collection)];
+                    dbName = resolveAssistantDatabaseName(input.database, input.mongo);
+                    db = resolveio_server_app_1.ResolveIOServer.getMongoConnection().db(dbName);
+                    return [4 /*yield*/, resolveAssistantCollectionName(db, dbName, rawCollection)];
                 case 1:
+                    collectionResolution = _e.sent();
+                    collection = collectionResolution.name || rawCollection;
+                    return [4 /*yield*/, ensureAssistantReadAccess(context, input.permissionView, collection)];
+                case 2:
                     _a = _e.sent(), user = _a.user, isSuperAdmin = _a.isSuperAdmin;
                     if (!isSuperAdmin && AI_ASSISTANT_BLOCKED_COLLECTIONS.has(collection)) {
                         throw new Error('AI assistant mongo read: Access denied.');
                     }
                     customerId = normalizeOptionalString((_c = user === null || user === void 0 ? void 0 : user.other) === null || _c === void 0 ? void 0 : _c.id_customer);
-                    dbName = resolveAssistantDatabaseName(input.database, input.mongo);
-                    db = resolveio_server_app_1.ResolveIOServer.getMongoConnection().db(dbName);
                     baseQuery = normalizeMongoQuery(input.query);
                     if (!isSuperAdmin && (collection === 'users' || collection === 'user-versions')) {
                         userId = normalizeOptionalString(user === null || user === void 0 ? void 0 : user._id);
@@ -1053,15 +1178,15 @@ function executeAiAssistantMongoRead(payload, context) {
                         };
                     }
                     normalizedClient = normalizeOptionalString(input.id_client);
-                    if (!(!isSuperAdmin && normalizedClient)) return [3 /*break*/, 3];
+                    if (!(!isSuperAdmin && normalizedClient)) return [3 /*break*/, 4];
                     return [4 /*yield*/, collectionHasClientIndex(db, dbName, collection)];
-                case 2:
-                    _b = _e.sent();
-                    return [3 /*break*/, 4];
                 case 3:
-                    _b = false;
-                    _e.label = 4;
+                    _b = _e.sent();
+                    return [3 /*break*/, 5];
                 case 4:
+                    _b = false;
+                    _e.label = 5;
+                case 5:
                     shouldScopeByClient = _b;
                     clientScopedQuery = shouldScopeByClient
                         ? applyClientScopeFilter(baseQuery, normalizedClient, isSuperAdmin)
@@ -1069,15 +1194,32 @@ function executeAiAssistantMongoRead(payload, context) {
                     scopedQuery = applyCustomerScopeFilter(clientScopedQuery, collection, customerId, isSuperAdmin);
                     normalized = normalizeAssistantFindOptions(input.options);
                     return [4 /*yield*/, db.collection(collection).find(scopedQuery, normalized.findOptions).toArray()];
-                case 5:
+                case 6:
                     documents = _e.sent();
+                    executedQuery = scopedQuery;
+                    fallbackMeta = {};
+                    if (!!documents.length) return [3 /*break*/, 8];
+                    dateFallback = resolveQueryDateFieldFallback(scopedQuery);
+                    if (!dateFallback) return [3 /*break*/, 8];
+                    fallbackQuery = replaceQueryField(scopedQuery, dateFallback.from, dateFallback.to);
+                    fallbackMeta.dateField = __assign(__assign({}, dateFallback), { attempted: true, used: false });
+                    return [4 /*yield*/, db.collection(collection).find(fallbackQuery, normalized.findOptions).toArray()];
+                case 7:
+                    fallbackDocs = _e.sent();
+                    if (fallbackDocs.length) {
+                        documents = fallbackDocs;
+                        executedQuery = fallbackQuery;
+                        fallbackMeta.dateField.used = true;
+                    }
+                    _e.label = 8;
+                case 8:
                     total = null;
-                    if (!normalized.includeTotal) return [3 /*break*/, 7];
-                    return [4 /*yield*/, db.collection(collection).countDocuments(scopedQuery)];
-                case 6:
+                    if (!normalized.includeTotal) return [3 /*break*/, 10];
+                    return [4 /*yield*/, db.collection(collection).countDocuments(executedQuery)];
+                case 9:
                     total = _e.sent();
-                    _e.label = 7;
-                case 7:
+                    _e.label = 10;
+                case 10:
                     sanitizedDocuments = isSuperAdmin
                         ? documents
                         : documents.map(function (doc) { return redactSensitiveFields((0, common_1.deepCopy)(doc)); });
@@ -1093,10 +1235,16 @@ function executeAiAssistantMongoRead(payload, context) {
                     return [2 /*return*/, __assign({ documents: sanitizedDocuments, total: total, display: display }, (isSuperAdmin ? {
                             debug: {
                                 collection: collection,
+                                collectionRequested: rawCollection,
+                                collectionResolved: collection,
+                                collectionMatched: collectionResolution.matched,
+                                collectionCandidates: collectionResolution.candidates,
+                                collectionScore: collectionResolution.score,
                                 database: dbName,
-                                query: scopedQuery,
+                                query: executedQuery,
                                 options: normalized.findOptions,
-                                includeTotal: normalized.includeTotal
+                                includeTotal: normalized.includeTotal,
+                                fallbacks: fallbackMeta
                             }
                         } : {}))];
             }
@@ -1105,25 +1253,29 @@ function executeAiAssistantMongoRead(payload, context) {
 }
 function executeAiAssistantMongoAggregate(payload, context) {
     return __awaiter(this, void 0, void 0, function () {
-        var input, collection, _a, user, isSuperAdmin, customerId, dbName, db, baseQuery, userId, normalizedClient, shouldScopeByClient, _b, clientScopedQuery, scopedQuery, normalizedPipeline, pipelineWithScope, normalizedOptions, limitedPipeline, dateField, documents, executedPipeline, fallbackMeta, fallback, fallbackPipeline, fallbackDocs, createdFallback, createdPipeline, createdDocs, unwindFallback, fallbackPipeline, fallbackDocs, sanitizedDocuments, includeIds, display;
+        var input, rawCollection, dbName, db, collectionResolution, collection, _a, user, isSuperAdmin, customerId, baseQuery, userId, normalizedClient, shouldScopeByClient, _b, clientScopedQuery, scopedQuery, normalizedPipeline, pipelineWithScope, normalizedOptions, limitedPipeline, dateField, documents, executedPipeline, fallbackMeta, fallback, fallbackPipeline, fallbackDocs, createdFallback, createdPipeline, createdDocs, unwindFallback, fallbackPipeline, fallbackDocs, sanitizedDocuments, includeIds, display;
         var _c, _d;
         return __generator(this, function (_e) {
             switch (_e.label) {
                 case 0:
                     input = payload || {};
-                    collection = normalizeOptionalString(input.collection);
-                    if (!collection) {
+                    rawCollection = normalizeOptionalString(input.collection);
+                    if (!rawCollection) {
                         throw new Error('AI assistant mongo aggregate: Collection is required.');
                     }
-                    return [4 /*yield*/, ensureAssistantReadAccess(context, input.permissionView, collection)];
+                    dbName = resolveAssistantDatabaseName(input.database, input.mongo);
+                    db = resolveio_server_app_1.ResolveIOServer.getMongoConnection().db(dbName);
+                    return [4 /*yield*/, resolveAssistantCollectionName(db, dbName, rawCollection)];
                 case 1:
+                    collectionResolution = _e.sent();
+                    collection = collectionResolution.name || rawCollection;
+                    return [4 /*yield*/, ensureAssistantReadAccess(context, input.permissionView, collection)];
+                case 2:
                     _a = _e.sent(), user = _a.user, isSuperAdmin = _a.isSuperAdmin;
                     if (!isSuperAdmin && AI_ASSISTANT_BLOCKED_COLLECTIONS.has(collection)) {
                         throw new Error('AI assistant mongo aggregate: Access denied.');
                     }
                     customerId = normalizeOptionalString((_c = user === null || user === void 0 ? void 0 : user.other) === null || _c === void 0 ? void 0 : _c.id_customer);
-                    dbName = resolveAssistantDatabaseName(input.database, input.mongo);
-                    db = resolveio_server_app_1.ResolveIOServer.getMongoConnection().db(dbName);
                     baseQuery = normalizeMongoQuery(input.query);
                     if (!isSuperAdmin && (collection === 'users' || collection === 'user-versions')) {
                         userId = normalizeOptionalString(user === null || user === void 0 ? void 0 : user._id);
@@ -1135,15 +1287,15 @@ function executeAiAssistantMongoAggregate(payload, context) {
                         };
                     }
                     normalizedClient = normalizeOptionalString(input.id_client);
-                    if (!(!isSuperAdmin && normalizedClient)) return [3 /*break*/, 3];
+                    if (!(!isSuperAdmin && normalizedClient)) return [3 /*break*/, 4];
                     return [4 /*yield*/, collectionHasClientIndex(db, dbName, collection)];
-                case 2:
-                    _b = _e.sent();
-                    return [3 /*break*/, 4];
                 case 3:
-                    _b = false;
-                    _e.label = 4;
+                    _b = _e.sent();
+                    return [3 /*break*/, 5];
                 case 4:
+                    _b = false;
+                    _e.label = 5;
+                case 5:
                     shouldScopeByClient = _b;
                     clientScopedQuery = shouldScopeByClient
                         ? applyClientScopeFilter(baseQuery, normalizedClient, isSuperAdmin)
@@ -1160,63 +1312,63 @@ function executeAiAssistantMongoAggregate(payload, context) {
                     return [4 /*yield*/, db.collection(collection)
                             .aggregate(limitedPipeline, normalizedOptions.aggregateOptions)
                             .toArray()];
-                case 5:
+                case 6:
                     documents = _e.sent();
                     executedPipeline = limitedPipeline;
                     fallbackMeta = {};
-                    if (!(!documents.length && dateField)) return [3 /*break*/, 9];
+                    if (!(!documents.length && dateField)) return [3 /*break*/, 10];
                     fallback = resolveAggregateDateFieldFallback(limitedPipeline);
-                    if (!fallback) return [3 /*break*/, 7];
+                    if (!fallback) return [3 /*break*/, 8];
                     fallbackMeta.dateField = __assign(__assign({}, fallback), { attempted: true, used: false });
                     fallbackPipeline = replaceAggregateDateField(limitedPipeline, fallback.from, fallback.to);
-                    if (!!containsForbiddenMongoOperators(fallbackPipeline)) return [3 /*break*/, 7];
+                    if (!!containsForbiddenMongoOperators(fallbackPipeline)) return [3 /*break*/, 8];
                     return [4 /*yield*/, db.collection(collection)
                             .aggregate(fallbackPipeline, normalizedOptions.aggregateOptions)
                             .toArray()];
-                case 6:
+                case 7:
                     fallbackDocs = _e.sent();
                     if (fallbackDocs.length) {
                         documents = fallbackDocs;
                         executedPipeline = fallbackPipeline;
                         fallbackMeta.dateField.used = true;
                     }
-                    _e.label = 7;
-                case 7:
-                    if (!(!documents.length && dateField !== 'createdAt')) return [3 /*break*/, 9];
+                    _e.label = 8;
+                case 8:
+                    if (!(!documents.length && dateField !== 'createdAt')) return [3 /*break*/, 10];
                     createdFallback = { from: dateField, to: 'createdAt', attempted: true, used: false };
                     createdPipeline = replaceAggregateDateField(limitedPipeline, dateField, 'createdAt');
                     fallbackMeta.dateFieldCreatedAt = createdFallback;
-                    if (!!containsForbiddenMongoOperators(createdPipeline)) return [3 /*break*/, 9];
+                    if (!!containsForbiddenMongoOperators(createdPipeline)) return [3 /*break*/, 10];
                     return [4 /*yield*/, db.collection(collection)
                             .aggregate(createdPipeline, normalizedOptions.aggregateOptions)
                             .toArray()];
-                case 8:
+                case 9:
                     createdDocs = _e.sent();
                     if (createdDocs.length) {
                         documents = createdDocs;
                         executedPipeline = createdPipeline;
                         fallbackMeta.dateFieldCreatedAt.used = true;
                     }
-                    _e.label = 9;
-                case 9:
-                    if (!(documents.length <= 1)) return [3 /*break*/, 11];
+                    _e.label = 10;
+                case 10:
+                    if (!(documents.length <= 1)) return [3 /*break*/, 12];
                     unwindFallback = resolveAggregateUnwindFallback(executedPipeline);
-                    if (!unwindFallback) return [3 /*break*/, 11];
+                    if (!unwindFallback) return [3 /*break*/, 12];
                     fallbackMeta.unwind = { path: unwindFallback.path, attempted: true, used: false };
                     fallbackPipeline = buildAggregateUnwindFallbackPipeline(executedPipeline, unwindFallback);
-                    if (!!containsForbiddenMongoOperators(fallbackPipeline)) return [3 /*break*/, 11];
+                    if (!!containsForbiddenMongoOperators(fallbackPipeline)) return [3 /*break*/, 12];
                     return [4 /*yield*/, db.collection(collection)
                             .aggregate(fallbackPipeline, normalizedOptions.aggregateOptions)
                             .toArray()];
-                case 10:
+                case 11:
                     fallbackDocs = _e.sent();
                     if (fallbackDocs.length > documents.length) {
                         documents = fallbackDocs;
                         executedPipeline = fallbackPipeline;
                         fallbackMeta.unwind.used = true;
                     }
-                    _e.label = 11;
-                case 11:
+                    _e.label = 12;
+                case 12:
                     sanitizedDocuments = isSuperAdmin
                         ? documents
                         : documents.map(function (doc) { return redactSensitiveFields((0, common_1.deepCopy)(doc)); });
@@ -1229,6 +1381,11 @@ function executeAiAssistantMongoAggregate(payload, context) {
                     return [2 /*return*/, __assign({ documents: sanitizedDocuments, display: display }, (isSuperAdmin ? {
                             debug: {
                                 collection: collection,
+                                collectionRequested: rawCollection,
+                                collectionResolved: collection,
+                                collectionMatched: collectionResolution.matched,
+                                collectionCandidates: collectionResolution.candidates,
+                                collectionScore: collectionResolution.score,
                                 database: dbName,
                                 query: scopedQuery,
                                 options: normalizedOptions.aggregateOptions,
@@ -1299,7 +1456,7 @@ function buildAssistantToolRequest(directive, payload) {
     return request;
 }
 function buildAssistantToolResultPayload(directive, toolResponse) {
-    var _a;
+    var _a, _b, _c;
     var directivePayload = directive.payload || {};
     var documents = Array.isArray(toolResponse === null || toolResponse === void 0 ? void 0 : toolResponse.documents) ? toolResponse.documents : [];
     var includeIds = ((_a = directivePayload === null || directivePayload === void 0 ? void 0 : directivePayload.options) === null || _a === void 0 ? void 0 : _a.includeIds) === true;
@@ -1316,17 +1473,22 @@ function buildAssistantToolResultPayload(directive, toolResponse) {
     });
     var total = typeof (toolResponse === null || toolResponse === void 0 ? void 0 : toolResponse.total) === 'number' ? toolResponse.total : null;
     var rowCount = documents.length || trimmedDisplay.rowCount;
-    var collection = normalizeOptionalString(directivePayload === null || directivePayload === void 0 ? void 0 : directivePayload.collection) || '';
+    var requestedCollection = normalizeOptionalString(directivePayload === null || directivePayload === void 0 ? void 0 : directivePayload.collection);
+    var resolvedCollection = normalizeOptionalString((_b = toolResponse === null || toolResponse === void 0 ? void 0 : toolResponse.debug) === null || _b === void 0 ? void 0 : _b.collectionResolved)
+        || normalizeOptionalString((_c = toolResponse === null || toolResponse === void 0 ? void 0 : toolResponse.debug) === null || _c === void 0 ? void 0 : _c.collection)
+        || requestedCollection
+        || '';
     var result = {
         type: directive.type === 'aggregate' ? 'mongo_agg' : 'mongo_read',
         input: directivePayload,
         output: {
             display: trimmedDisplay,
             total: total !== null ? total : undefined,
-            collection: collection || undefined,
+            collection: resolvedCollection || undefined,
             rowCount: rowCount,
             columns: trimmedDisplay.columns,
-            truncated: trimmedDisplay.truncated
+            truncated: trimmedDisplay.truncated,
+            debug: (toolResponse === null || toolResponse === void 0 ? void 0 : toolResponse.debug) && typeof toolResponse.debug === 'object' ? toolResponse.debug : undefined
         }
     };
     return {
@@ -1382,6 +1544,82 @@ function buildAssistantToolFallbackResponse(result) {
     }
     return lines.join('\n').trim();
 }
+function buildAssistantDebugPayload(params) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t;
+    var notes = [];
+    if (params.dataQuestion) {
+        notes.push('Detected a data request; tool call required.');
+    }
+    if (params.directiveSource === 'forced') {
+        notes.push('Assistant response omitted a MONGO_* directive; ran a directive-only pass.');
+    }
+    var directive = params.directive;
+    var directivePayload = (directive === null || directive === void 0 ? void 0 : directive.payload) || {};
+    var rawCollection = normalizeOptionalString(directivePayload === null || directivePayload === void 0 ? void 0 : directivePayload.collection);
+    var debugCollectionRequested = normalizeOptionalString((_a = params.toolResponseDebug) === null || _a === void 0 ? void 0 : _a.collectionRequested);
+    var debugCollectionResolved = normalizeOptionalString((_b = params.toolResponseDebug) === null || _b === void 0 ? void 0 : _b.collectionResolved);
+    var debugCollection = normalizeOptionalString((_c = params.toolResponseDebug) === null || _c === void 0 ? void 0 : _c.collection);
+    var requestedCollection = debugCollectionRequested || rawCollection;
+    var resolvedCollection = debugCollectionResolved || debugCollection || requestedCollection;
+    var matchedCollection = typeof ((_d = params.toolResponseDebug) === null || _d === void 0 ? void 0 : _d.collectionMatched) === 'boolean'
+        ? params.toolResponseDebug.collectionMatched
+        : undefined;
+    var candidateCollections = Array.isArray((_e = params.toolResponseDebug) === null || _e === void 0 ? void 0 : _e.collectionCandidates)
+        ? params.toolResponseDebug.collectionCandidates.filter(Boolean)
+        : [];
+    if (requestedCollection && resolvedCollection && requestedCollection !== resolvedCollection) {
+        notes.push("Resolved collection \"".concat(requestedCollection, "\" -> \"").concat(resolvedCollection, "\"."));
+    }
+    else if (matchedCollection === false && candidateCollections.length) {
+        notes.push("No direct collection match; candidates: ".concat(candidateCollections.join(', '), "."));
+    }
+    if (((_f = params.toolResult) === null || _f === void 0 ? void 0 : _f.type) === 'mongo_agg') {
+        notes.push('Used aggregation for grouped/breakdown request.');
+    }
+    else if (((_g = params.toolResult) === null || _g === void 0 ? void 0 : _g.type) === 'mongo_read') {
+        notes.push('Used read query for list/count request.');
+    }
+    var fallbackInfo = (_h = params.toolResponseDebug) === null || _h === void 0 ? void 0 : _h.fallbacks;
+    if ((_j = fallbackInfo === null || fallbackInfo === void 0 ? void 0 : fallbackInfo.dateField) === null || _j === void 0 ? void 0 : _j.used) {
+        notes.push("Retried with date field fallback ".concat(fallbackInfo.dateField.from, " -> ").concat(fallbackInfo.dateField.to, "."));
+    }
+    if ((_k = fallbackInfo === null || fallbackInfo === void 0 ? void 0 : fallbackInfo.dateFieldCreatedAt) === null || _k === void 0 ? void 0 : _k.used) {
+        notes.push("Retried with date field fallback ".concat(fallbackInfo.dateFieldCreatedAt.from, " -> ").concat(fallbackInfo.dateFieldCreatedAt.to, "."));
+    }
+    if ((_l = fallbackInfo === null || fallbackInfo === void 0 ? void 0 : fallbackInfo.unwind) === null || _l === void 0 ? void 0 : _l.used) {
+        notes.push("Applied unwind fallback on ".concat(fallbackInfo.unwind.path, "."));
+    }
+    if (params.toolError) {
+        var errorMessage = ((_m = params.toolError) === null || _m === void 0 ? void 0 : _m.message) || String(params.toolError || '');
+        if (errorMessage) {
+            notes.push("Tool error: ".concat(errorMessage));
+        }
+    }
+    return {
+        decision: {
+            dataQuestion: params.dataQuestion,
+            directiveSource: params.directiveSource
+        },
+        directive: directive ? {
+            type: directive.type,
+            payload: directivePayload,
+            rawLine: directive.rawLine
+        } : null,
+        collection: resolvedCollection || requestedCollection || undefined,
+        collectionRequested: requestedCollection || undefined,
+        collectionResolved: resolvedCollection || undefined,
+        collectionMatched: matchedCollection,
+        collectionCandidates: candidateCollections.length ? candidateCollections : undefined,
+        collectionScore: typeof ((_o = params.toolResponseDebug) === null || _o === void 0 ? void 0 : _o.collectionScore) === 'number'
+            ? params.toolResponseDebug.collectionScore
+            : undefined,
+        query: ((_p = params.toolResponseDebug) === null || _p === void 0 ? void 0 : _p.query) || undefined,
+        pipeline: ((_q = params.toolResponseDebug) === null || _q === void 0 ? void 0 : _q.executedPipeline) || ((_r = params.toolResponseDebug) === null || _r === void 0 ? void 0 : _r.originalPipeline) || undefined,
+        options: ((_s = params.toolResponseDebug) === null || _s === void 0 ? void 0 : _s.options) || undefined,
+        fallbacks: ((_t = params.toolResponseDebug) === null || _t === void 0 ? void 0 : _t.fallbacks) || undefined,
+        notes: notes
+    };
+}
 function buildAssistantToolErrorMessage(error, directive, request) {
     var _a, _b;
     var rawMessage = normalizeOptionalString(error === null || error === void 0 ? void 0 : error.message) || 'Unable to access data.';
@@ -2006,7 +2244,18 @@ function normalizeAssistantAggregatePipeline(pipeline) {
     if (!Array.isArray(pipeline)) {
         return [];
     }
-    return pipeline.filter(function (stage) { return stage && typeof stage === 'object' && !Array.isArray(stage); });
+    return pipeline
+        .filter(function (stage) { return stage && typeof stage === 'object' && !Array.isArray(stage); })
+        .map(function (stage) {
+        var next = __assign({}, stage);
+        if (next.$match && typeof next.$match === 'object') {
+            next.$match = applyAssistantNameRegexToQuery(next.$match);
+        }
+        if (next.$geoNear && typeof next.$geoNear === 'object' && next.$geoNear.query) {
+            next.$geoNear = __assign(__assign({}, next.$geoNear), { query: applyAssistantNameRegexToQuery(next.$geoNear.query) });
+        }
+        return next;
+    });
 }
 function buildAssistantAggregatePipeline(query, pipeline) {
     var _a;
@@ -2275,10 +2524,302 @@ function normalizeMongoQuery(query) {
     if (containsForbiddenMongoOperators(normalized)) {
         throw new Error('AI assistant mongo read: Query contains restricted operators.');
     }
-    return normalized;
+    return applyAssistantNameRegexToQuery(normalized);
+}
+function shouldApplyAssistantNameRegex(field) {
+    var normalized = String(field || '').toLowerCase().trim();
+    if (!normalized) {
+        return false;
+    }
+    if (normalized.startsWith('$')) {
+        return false;
+    }
+    if (isAssistantIdField(normalized)) {
+        return false;
+    }
+    if (normalized === 'id' || normalized.endsWith('_id')) {
+        return false;
+    }
+    var tokens = normalized.split(/[^a-z0-9]+/g).filter(Boolean);
+    var targetTokens = new Set(['customer', 'well', 'chemical']);
+    var hasTargetToken = tokens.some(function (token) { return targetTokens.has(token); });
+    if (hasTargetToken) {
+        return true;
+    }
+    if (tokens.includes('name')) {
+        return true;
+    }
+    return /(^|[._-])name$/i.test(normalized);
+}
+function escapeRegexValue(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function applyAssistantNameRegexToQuery(query) {
+    if (Array.isArray(query)) {
+        return query.map(function (entry) { return applyAssistantNameRegexToQuery(entry); });
+    }
+    if (!query || typeof query !== 'object' || query instanceof Date || query instanceof RegExp || isMongoObjectId(query)) {
+        return query;
+    }
+    var result = {};
+    Object.keys(query).forEach(function (key) {
+        var value = query[key];
+        if (key.startsWith('$')) {
+            result[key] = applyAssistantNameRegexToQuery(value);
+            return;
+        }
+        if (typeof value === 'string' && shouldApplyAssistantNameRegex(key)) {
+            var trimmed = value.trim();
+            result[key] = trimmed ? new RegExp(escapeRegexValue(trimmed), 'i') : value;
+            return;
+        }
+        if (value && typeof value === 'object') {
+            result[key] = applyAssistantNameRegexToQuery(value);
+            return;
+        }
+        result[key] = value;
+    });
+    return result;
+}
+function normalizeCollectionKey(value) {
+    return String(value || '').toLowerCase().replace(/[^a-z0-9]/g, '');
+}
+function normalizeCollectionToken(token) {
+    var trimmed = token.trim();
+    if (!trimmed) {
+        return [];
+    }
+    var tokens = new Set([trimmed]);
+    if (trimmed.length > 4
+        && trimmed.endsWith('s')
+        && !trimmed.endsWith('ss')
+        && !trimmed.endsWith('us')
+        && !trimmed.endsWith('is')) {
+        tokens.add(trimmed.slice(0, -1));
+    }
+    return Array.from(tokens);
+}
+function tokenizeCollectionText(value) {
+    var rawTokens = String(value || '')
+        .toLowerCase()
+        .split(/[^a-z0-9]+/g)
+        .map(function (token) { return token.trim(); })
+        .filter(Boolean);
+    var tokens = [];
+    rawTokens.forEach(function (token) {
+        normalizeCollectionToken(token).forEach(function (normalized) {
+            if (!AI_ASSISTANT_COLLECTION_STOPWORDS.has(normalized)) {
+                tokens.push(normalized);
+            }
+        });
+    });
+    return Array.from(new Set(tokens));
+}
+function listAssistantCollections(db, dbName) {
+    return __awaiter(this, void 0, void 0, function () {
+        var cacheKey, cached, now, collections, names, _a;
+        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];
+                    }
+                    _b.label = 1;
+                case 1:
+                    _b.trys.push([1, 3, , 4]);
+                    return [4 /*yield*/, db.listCollections({}, { nameOnly: true }).toArray()];
+                case 2:
+                    collections = _b.sent();
+                    names = Array.isArray(collections)
+                        ? collections.map(function (entry) { return normalizeOptionalString(entry === null || entry === void 0 ? void 0 : entry.name); }).filter(Boolean)
+                        : [];
+                    AI_ASSISTANT_COLLECTION_CACHE.set(cacheKey, { names: names, updatedAt: now });
+                    return [2 /*return*/, names];
+                case 3:
+                    _a = _b.sent();
+                    return [2 /*return*/, (cached === null || cached === void 0 ? void 0 : cached.names) || []];
+                case 4: return [2 /*return*/];
+            }
+        });
+    });
+}
+function scoreCollectionMatch(requestedTokens, candidateName) {
+    if (!requestedTokens.length) {
+        return 0;
+    }
+    var candidateTokens = tokenizeCollectionText(candidateName);
+    if (!candidateTokens.length) {
+        return 0;
+    }
+    var score = 0;
+    requestedTokens.forEach(function (token) {
+        if (candidateTokens.includes(token)) {
+            score += 10;
+        }
+    });
+    var requestedKey = normalizeCollectionKey(requestedTokens.join('-'));
+    var candidateKey = normalizeCollectionKey(candidateName);
+    if (candidateKey === requestedKey && requestedKey) {
+        score += 50;
+    }
+    else if (requestedKey && (candidateKey.includes(requestedKey) || requestedKey.includes(candidateKey))) {
+        score += 20;
+    }
+    return score;
+}
+function findBestCollectionMatch(requested, collectionNames) {
+    var requestedTokens = tokenizeCollectionText(requested);
+    if (!requestedTokens.length || !collectionNames.length) {
+        return null;
+    }
+    var best = null;
+    collectionNames.forEach(function (name) {
+        var score = scoreCollectionMatch(requestedTokens, name);
+        if (!best || score > best.score) {
+            best = { name: name, score: score };
+        }
+    });
+    return best;
+}
+function resolveAssistantCollectionName(db, dbName, requested) {
+    return __awaiter(this, void 0, void 0, function () {
+        var trimmed, collectionNames, best, candidates;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    trimmed = normalizeOptionalString(requested);
+                    if (!trimmed) {
+                        return [2 /*return*/, { name: '', matched: false, candidates: [], score: 0 }];
+                    }
+                    return [4 /*yield*/, listAssistantCollections(db, dbName)];
+                case 1:
+                    collectionNames = _a.sent();
+                    if (collectionNames.includes(trimmed)) {
+                        return [2 /*return*/, { name: trimmed, matched: true, candidates: [], score: 100 }];
+                    }
+                    best = findBestCollectionMatch(trimmed, collectionNames);
+                    if (best && best.score >= 20) {
+                        return [2 /*return*/, { name: best.name, matched: true, candidates: [], score: best.score }];
+                    }
+                    candidates = collectionNames
+                        .map(function (name) { return ({ name: name, score: scoreCollectionMatch(tokenizeCollectionText(trimmed), name) }); })
+                        .filter(function (entry) { return entry.score > 0; })
+                        .sort(function (a, b) { return b.score - a.score; })
+                        .slice(0, 5)
+                        .map(function (entry) { return entry.name; });
+                    return [2 /*return*/, { name: trimmed, matched: false, candidates: candidates, score: (best === null || best === void 0 ? void 0 : best.score) || 0 }];
+            }
+        });
+    });
+}
+function resolveAssistantCollectionHints(message, dbName, db) {
+    return __awaiter(this, void 0, void 0, function () {
+        var text, collectionNames, tokens;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    text = normalizeOptionalString(message);
+                    if (!text) {
+                        return [2 /*return*/, []];
+                    }
+                    return [4 /*yield*/, listAssistantCollections(db, dbName)];
+                case 1:
+                    collectionNames = _a.sent();
+                    if (!collectionNames.length) {
+                        return [2 /*return*/, []];
+                    }
+                    tokens = tokenizeCollectionText(text);
+                    if (!tokens.length) {
+                        return [2 /*return*/, []];
+                    }
+                    return [2 /*return*/, collectionNames
+                            .map(function (name) { return ({ name: name, score: scoreCollectionMatch(tokens, name) }); })
+                            .filter(function (entry) { return entry.score > 0; })
+                            .sort(function (a, b) { return b.score - a.score; })
+                            .slice(0, 5)
+                            .map(function (entry) { return entry.name; })];
+            }
+        });
+    });
+}
+function findQueryDateField(query) {
+    var e_1, _a, e_2, _b;
+    if (!query || typeof query !== 'object') {
+        return null;
+    }
+    if (Array.isArray(query)) {
+        try {
+            for (var query_1 = __values(query), query_1_1 = query_1.next(); !query_1_1.done; query_1_1 = query_1.next()) {
+                var entry = query_1_1.value;
+                var found = findQueryDateField(entry);
+                if (found) {
+                    return found;
+                }
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (query_1_1 && !query_1_1.done && (_a = query_1.return)) _a.call(query_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        return null;
+    }
+    try {
+        for (var _c = __values(Object.keys(query)), _d = _c.next(); !_d.done; _d = _c.next()) {
+            var key = _d.value;
+            if (key.startsWith('$')) {
+                var found = findQueryDateField(query[key]);
+                if (found) {
+                    return found;
+                }
+                continue;
+            }
+            if (AI_ASSISTANT_DATE_FALLBACKS[key]) {
+                return key;
+            }
+        }
+    }
+    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    finally {
+        try {
+            if (_d && !_d.done && (_b = _c.return)) _b.call(_c);
+        }
+        finally { if (e_2) throw e_2.error; }
+    }
+    return null;
+}
+function replaceQueryField(query, fromField, toField) {
+    if (Array.isArray(query)) {
+        return query.map(function (entry) { return replaceQueryField(entry, fromField, toField); });
+    }
+    if (!query || typeof query !== 'object' || query instanceof Date) {
+        return query;
+    }
+    var result = {};
+    Object.keys(query).forEach(function (key) {
+        var nextKey = key === fromField ? toField : key;
+        result[nextKey] = replaceQueryField(query[key], fromField, toField);
+    });
+    return result;
+}
+function resolveQueryDateFieldFallback(query) {
+    var dateField = findQueryDateField(query);
+    if (!dateField) {
+        return null;
+    }
+    var fallback = AI_ASSISTANT_DATE_FALLBACKS[dateField];
+    if (!fallback) {
+        return null;
+    }
+    return { from: dateField, to: fallback };
 }
 function containsForbiddenMongoOperators(value) {
-    var e_1, _a;
+    var e_3, _a;
     if (!value || typeof value !== 'object') {
         return false;
     }
@@ -2297,12 +2838,12 @@ function containsForbiddenMongoOperators(value) {
             }
         }
     }
-    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    catch (e_3_1) { e_3 = { error: e_3_1 }; }
     finally {
         try {
             if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
         }
-        finally { if (e_1) throw e_1.error; }
+        finally { if (e_3) throw e_3.error; }
     }
     return false;
 }
@@ -2465,6 +3006,20 @@ function resolveCodexModel() {
         || process.env.AI_DASHBOARD_CODEX_MODEL);
     return raw || DEFAULT_CODEX_MODEL;
 }
+function resolveCodexThoughtLevel() {
+    var config = resolveio_server_app_1.ResolveIOServer.getServerConfig() || {};
+    var raw = normalizeOptionalString(config['AI_ASSISTANT_CODEX_THOUGHT_LEVEL']
+        || process.env.AI_ASSISTANT_CODEX_THOUGHT_LEVEL
+        || config['AI_TERMINAL_CODEX_THOUGHT_LEVEL']
+        || process.env.AI_TERMINAL_CODEX_THOUGHT_LEVEL
+        || config['AI_DASHBOARD_CODEX_THOUGHT_LEVEL']
+        || process.env.AI_DASHBOARD_CODEX_THOUGHT_LEVEL);
+    var normalized = (raw || '').trim().toLowerCase();
+    if (normalized === 'minimal' || normalized === 'low' || normalized === 'medium' || normalized === 'high' || normalized === 'xhigh') {
+        return normalized;
+    }
+    return 'low';
+}
 function resolveCodexSettings() {
     var serverConfig = resolveio_server_app_1.ResolveIOServer.getServerConfig() || {};
     var apiKey = (serverConfig['OPENAI_API_KEY'] || process.env.OPENAI_API_KEY || '').trim();
@@ -2522,8 +3077,8 @@ function applyCodexStreamStatusHandler(runOptions, streamStatusHandler) {
 }
 function waitForCodexWorkerMessage(worker, streamStatusHandler) {
     return __awaiter(this, void 0, void 0, function () {
-        var _a, _b, _c, _d, message, payload, status_1, e_2_1;
-        var _e, e_2, _f, _g;
+        var _a, _b, _c, _d, message, payload, status_1, e_4_1;
+        var _e, e_4, _f, _g;
         return __generator(this, function (_h) {
             switch (_h.label) {
                 case 0:
@@ -2550,8 +3105,8 @@ function waitForCodexWorkerMessage(worker, streamStatusHandler) {
                     return [3 /*break*/, 1];
                 case 4: return [3 /*break*/, 11];
                 case 5:
-                    e_2_1 = _h.sent();
-                    e_2 = { error: e_2_1 };
+                    e_4_1 = _h.sent();
+                    e_4 = { error: e_4_1 };
                     return [3 /*break*/, 11];
                 case 6:
                     _h.trys.push([6, , 9, 10]);
@@ -2562,7 +3117,7 @@ function waitForCodexWorkerMessage(worker, streamStatusHandler) {
                     _h.label = 8;
                 case 8: return [3 /*break*/, 10];
                 case 9:
-                    if (e_2) throw e_2.error;
+                    if (e_4) throw e_4.error;
                     return [7 /*endfinally*/];
                 case 10: return [7 /*endfinally*/];
                 case 11: throw new CodexWorkerBootstrapError('Codex worker exited before completing.');
@@ -2838,6 +3393,43 @@ function resolveAssistantWorkspaceRoot() {
         });
     });
 }
+function isAssistantDataQuestion(message) {
+    var text = normalizeOptionalString(message).toLowerCase();
+    if (!text) {
+        return false;
+    }
+    var patterns = [
+        /\bshow\b/,
+        /\blist\b/,
+        /\bhow many\b/,
+        /\bcount\b/,
+        /\btotal\b/,
+        /\bnumber of\b/,
+        /\blast\b/,
+        /\brecent\b/,
+        /\bthis week\b/,
+        /\blast month\b/,
+        /\boverdue\b/,
+        /\bopen\b/,
+        /\bclosed\b/,
+        /\bcompleted\b/,
+        /\bmissing\b/,
+        /\bgroup(ed)? by\b/,
+        /\bbreakdown\b/,
+        /\bper day\b/,
+        /\bper week\b/,
+        /\bper month\b/
+    ];
+    return patterns.some(function (pattern) { return pattern.test(text); });
+}
+function buildAssistantCodexDirectivePrompt(message, attachmentText, historyText, contextText) {
+    var trimmedContext = normalizeOptionalString(contextText);
+    var contextBlock = trimmedContext ? "\n\nContext:\n".concat(trimmedContext) : '';
+    var trimmedHistory = normalizeOptionalString(historyText);
+    var historyBlock = trimmedHistory ? "\n\nConversation so far:\n".concat(trimmedHistory) : '';
+    var instruction = '\n\nInstruction:\nReturn ONLY a single MONGO_READ or MONGO_AGG directive line. Do not include any other text.';
+    return "System:\n".concat(AI_ASSISTANT_SYSTEM_PROMPT).concat(contextBlock).concat(historyBlock, "\n\nUser:\n").concat(message).concat(attachmentText || '').concat(instruction).trim();
+}
 function buildAssistantCodexPrompt(message, attachmentText, historyText, contextText) {
     var trimmedContext = normalizeOptionalString(contextText);
     var contextBlock = trimmedContext ? "\n\nContext:\n".concat(trimmedContext) : '';
@@ -2871,6 +3463,12 @@ function buildAssistantContext(input, userContext) {
     if (contextRoute) {
         lines.push("Current page route: ".concat(contextRoute));
     }
+    var collectionHints = Array.isArray(userContext === null || userContext === void 0 ? void 0 : userContext.collectionHints)
+        ? userContext === null || userContext === void 0 ? void 0 : userContext.collectionHints.filter(Boolean)
+        : [];
+    if (collectionHints.length) {
+        lines.push("Collection hints: ".concat(collectionHints.join(', ')));
+    }
     var mongoDb = normalizeOptionalString((_c = input === null || input === void 0 ? void 0 : input.mongo) === null || _c === void 0 ? void 0 : _c.database);
     var mongoDbs = Array.isArray((_d = input === null || input === void 0 ? void 0 : input.mongo) === null || _d === void 0 ? void 0 : _d.databases)
         ? input.mongo.databases.map(function (value) { return normalizeOptionalString(value); }).filter(Boolean)
@@ -2901,7 +3499,7 @@ function normalizeRouteMatchKey(value) {
     return normalizeRouteKey(value).toLowerCase();
 }
 function buildClientRouteIndex() {
-    var e_3, _a;
+    var e_5, _a;
     var _b;
     var routes = ((_b = resolveio_server_app_1.ResolveIOServer.getClientRoutes) === null || _b === void 0 ? void 0 : _b.call(resolveio_server_app_1.ResolveIOServer)) || [];
     var set = new Set();
@@ -2920,12 +3518,12 @@ function buildClientRouteIndex() {
             }
         }
     }
-    catch (e_3_1) { e_3 = { error: e_3_1 }; }
+    catch (e_5_1) { e_5 = { error: e_5_1 }; }
     finally {
         try {
             if (routes_1_1 && !routes_1_1.done && (_a = routes_1.return)) _a.call(routes_1);
         }
-        finally { if (e_3) throw e_3.error; }
+        finally { if (e_5) throw e_5.error; }
     }
     return { set: set, map: map, size: routes.length };
 }
@@ -3045,10 +3643,13 @@ function sanitizeAssistantResponse(value) {
     if (!cleaned) {
         return 'I can’t share code, but I can point you to files or explain behavior at a high level.';
     }
-    return normalizeAssistantRoutes(cleaned);
+    var normalizedCurrency = cleaned.replace(/\bUSD\s*([0-9][0-9,]*(?:\.[0-9]+)?)/g, function (_match, amount) {
+        return "$".concat(amount);
+    });
+    return normalizeAssistantRoutes(normalizedCurrency);
 }
 function evaluateAssistantGuardrails(message) {
-    var e_4, _a;
+    var e_6, _a;
     var normalized = String(message || '').toLowerCase();
     var patterns = [
         {
@@ -3094,12 +3695,12 @@ function evaluateAssistantGuardrails(message) {
             }
         }
     }
-    catch (e_4_1) { e_4 = { error: e_4_1 }; }
+    catch (e_6_1) { e_6 = { error: e_6_1 }; }
     finally {
         try {
             if (patterns_1_1 && !patterns_1_1.done && (_a = patterns_1.return)) _a.call(patterns_1);
         }
-        finally { if (e_4) throw e_4.error; }
+        finally { if (e_6) throw e_6.error; }
     }
     return null;
 }
@@ -3263,8 +3864,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_1, type, readable, content, _a, e_5_1;
-        var e_5, _b;
+        var limits, totalBytes, totalChars, chunks, cleaned, attachments_1, attachments_1_1, attachment, localPath, safe, stat, ext, name_1, type, readable, content, _a, e_7_1;
+        var e_7, _b;
         return __generator(this, function (_c) {
             switch (_c.label) {
                 case 0:
@@ -3343,14 +3944,14 @@ function readAttachmentContents(attachments) {
                     return [3 /*break*/, 2];
                 case 10: return [3 /*break*/, 13];
                 case 11:
-                    e_5_1 = _c.sent();
-                    e_5 = { error: e_5_1 };
+                    e_7_1 = _c.sent();
+                    e_7 = { error: e_7_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_5) throw e_5.error; }
+                    finally { if (e_7) throw e_7.error; }
                     return [7 /*endfinally*/];
                 case 13: return [2 /*return*/, {
                         promptText: chunks.length ? "\n\nAttachments:\n".concat(chunks.join('\n\n')) : '',
@@ -3527,7 +4128,7 @@ function estimateUsage(messages, responseText, model) {
     };
 }
 function evaluateGuardrails(message) {
-    var e_6, _a;
+    var e_8, _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.' },
@@ -3549,12 +4150,12 @@ function evaluateGuardrails(message) {
             }
         }
     }
-    catch (e_6_1) { e_6 = { error: e_6_1 }; }
+    catch (e_8_1) { e_8 = { error: e_8_1 }; }
     finally {
         try {
             if (patterns_2_1 && !patterns_2_1.done && (_a = patterns_2.return)) _a.call(patterns_2);
         }
-        finally { if (e_6) throw e_6.error; }
+        finally { if (e_8) throw e_8.error; }
     }
     return null;
 }