@resolveio/server-lib 20.14.45 → 20.14.47

package/methods/ai-terminal.js

@@ -101,6 +101,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadAiTerminalMethods = loadAiTerminalMethods;
 exports.executeAiAssistantMongoRead = executeAiAssistantMongoRead;
 exports.executeAiAssistantMongoAggregate = executeAiAssistantMongoAggregate;
+exports.extractAssistantMongoDirective = extractAssistantMongoDirective;
+exports.serializeMongoValue = serializeMongoValue;
+exports.flattenForTable = flattenForTable;
+exports.buildDisplayTable = buildDisplayTable;
+exports.formatDisplayTableMarkdown = formatDisplayTableMarkdown;
 var fs_1 = require("fs");
 var events_1 = require("events");
 var os = require("os");
@@ -125,6 +130,35 @@ var DEFAULT_CODEX_MODEL = 'gpt-5.2-codex';
 var DEFAULT_CODEX_TIMEOUT_MS = 180000;
 var AI_ASSISTANT_MONGO_DEFAULT_LIMIT = 20;
 var AI_ASSISTANT_MONGO_MAX_LIMIT = 200;
+var AI_ASSISTANT_TOOL_MAX_STEPS = 1;
+var AI_ASSISTANT_DISPLAY_MAX_COLUMNS = 12;
+var AI_ASSISTANT_DISPLAY_PREVIEW_MAX_ROWS = 20;
+var AI_ASSISTANT_DISPLAY_STRING_LIMIT = 160;
+var AI_ASSISTANT_PROGRESS_PLACEHOLDER = 'Thinking...';
+var AI_ASSISTANT_PROGRESS_TICK_MS = 8000;
+var AI_ASSISTANT_PROGRESS_TICKS = [
+    'Reviewing context',
+    'Checking data',
+    'Drafting response'
+];
+var AI_ASSISTANT_DISPLAY_PRIORITY_FIELDS = [
+    'name',
+    'title',
+    'status',
+    'type',
+    'stage',
+    'state',
+    'category',
+    'date_created',
+    'createdAt',
+    'updatedAt',
+    'date_updated',
+    'date_completed',
+    'id_customer',
+    'id_client',
+    'id_user',
+    'id_invoice'
+];
 var AI_ASSISTANT_DATE_FALLBACKS = {
     date_created: 'createdAt',
     createdAt: 'date_created'
@@ -157,12 +191,29 @@ var AI_ASSISTANT_SENSITIVE_FIELDS = [
 var AI_ASSISTANT_CLIENT_SCOPE_CACHE = new Map();
 var AI_ASSISTANT_SYSTEM_PROMPT = [
     'You are the ResolveIO in-app AI assistant running with read-only access to the codebase.',
+    'Core rules:',
     '- Never share code or file contents. All code is proprietary.',
     '- Do not modify files, run destructive commands, or access databases directly.',
-    '- Read-only Mongo access is allowed only via the MONGO_READ directive (see below).',
+    '- Read-only Mongo access is allowed only via the MONGO_READ/MONGO_AGG directives (see below).',
     '- Do not access secrets, credentials, or user data.',
     '- 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:',
+    '- 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.',
+    '- Ask at most one clarifying question only when required to run a query or resolve missing details.',
+    '- Use the codebase context to choose correct collections/fields/workflows and use MONGO_READ/MONGO_AGG to answer with real data when needed.',
+    '- For direct questions, answer first. Ask a single follow-up only if required to proceed.',
+    'Data Presentation:',
+    '- Output plain Markdown (NO triple backticks).',
+    '- When you reference database results, summarize first, then include a Markdown table.',
+    '- When presenting record lists or aggregates, produce a Markdown table (pipes).',
+    '- Never show raw JSON dumps.',
+    '- Do not include `_id` & `__v` & `id_<other collection _id property>` in tables by default.',
+    '- 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:',
+    '- 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.',
     '- When asked "why is this happening," respond with: cause, trigger, data source(s), and expected vs actual outcome.',
@@ -174,7 +225,7 @@ var AI_ASSISTANT_SYSTEM_PROMPT = [
     '- If access is blocked, name the permission/role needed and how to request it.',
     '- Avoid vague labels like "Operations app"; use the specific screen/workflow name.',
     '- Do not mention other client projects or ask which client; stay within the current project context.',
-    '- Respond with a single concise message. Do not add labels like "Customer-facing summary" or "Work ticket summary" and do not include estimated hours.',
+    '- Do not add labels like "Customer-facing summary" or "Work ticket summary" and do not include estimated hours.',
     '- Use structured responses by default: short heading, then bullet points. For "how do I" questions, provide a step-by-step list (numbered) with explicit page/screen names and actions.',
     '- When giving steps, include navigation guidance like "Go to <screen>" and "Click/Select/Enter <field>" so the user can follow it exactly.',
     '- If context scope is provided (ex: current page), prioritize that screen in your answer.',
@@ -183,8 +234,7 @@ var AI_ASSISTANT_SYSTEM_PROMPT = [
     '- SUPPORT_TICKET_CREATE: <one-line summary>',
     '- Only include that line when the user clearly wants a ticket created. Do not claim a ticket is created unless you include that line.',
     '- Do not end responses with tentative phrasing like "I could" or "I’m going to." Complete the request or state what is required to proceed.',
-    '- Use the codebase context to choose correct collections/fields/workflows and use MONGO_READ/MONGO_AGG to answer with real data when needed.',
-    '- For direct questions, answer first. Ask a single follow-up only if required to run a query or resolve missing details.',
+    'Mongo directives:',
     '- If you need database data to answer, end your response with a single line exactly in this format:',
     '- MONGO_READ: {"collection":"<name>","query":{...},"options":{"projection":{...},"sort":{...},"limit":20},"permissionView":"</route>"}',
     '- If you need grouped/aggregated data (totals by user, rankings, trends), end your response with a single line exactly in this format:',
@@ -199,7 +249,7 @@ var AI_ASSISTANT_SYSTEM_PROMPT = [
     '- For creation-date questions when both date_created and createdAt exist, match both with $or so results are not missed.',
     '- 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.',
-    '- When referencing data, summarize it in bullets and avoid raw JSON or dumps.',
+    '- If the user explicitly asks for IDs, set options.includeIds: true.',
     '- Keep responses concise and use low reasoning effort.'
 ].join('\n');
 var AI_FORM_PATCH_SYSTEM_PROMPT = [
@@ -738,10 +788,10 @@ function executeAiFormPatch(payload, context) {
 }
 function executeAiAssistantCodexRun(payload, context) {
     return __awaiter(this, void 0, void 0, function () {
-        var input, message, guardrail, conversation_2, now_2, userMsg, assistantMsg, user, isSuperAdmin, hasInvoiceAccess, customerId, conversation, now, attachments, attachmentData, historyLimit, history, _a, historyLines, prompt, workspaceRoot, codexConfig, runOptions, responseText, assistantContent, userDoc, assistantDoc, insertResult;
-        var _b, _c;
-        return __generator(this, function (_d) {
-            switch (_d.label) {
+        var input, message, 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, 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) {
                 case 0:
                     input = payload || {};
                     message = normalizeOptionalString(input.message);
@@ -755,7 +805,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 = _d.sent();
+                    conversation_2 = _f.sent();
                     now_2 = new Date();
                     userMsg = {
                         id_conversation: conversation_2._id,
@@ -777,13 +827,13 @@ function executeAiAssistantCodexRun(payload, context) {
                     };
                     return [4 /*yield*/, ai_terminal_message_collection_1.AiTerminalMessages.insertOne(userMsg)];
                 case 2:
-                    _d.sent();
+                    _f.sent();
                     return [4 /*yield*/, ai_terminal_message_collection_1.AiTerminalMessages.insertOne(assistantMsg)];
                 case 3:
-                    _d.sent();
+                    _f.sent();
                     return [4 /*yield*/, touchConversation(conversation_2._id, now_2)];
                 case 4:
-                    _d.sent();
+                    _f.sent();
                     return [2 /*return*/, {
                             conversation: conversation_2,
                             message: assistantMsg,
@@ -791,27 +841,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 = _d.sent();
-                    isSuperAdmin = !!((_b = user === null || user === void 0 ? void 0 : user.roles) === null || _b === void 0 ? void 0 : _b.super_admin);
+                    user = _f.sent();
+                    isSuperAdmin = !!((_d = user === null || user === void 0 ? void 0 : user.roles) === null || _d === void 0 ? void 0 : _d.super_admin);
                     hasInvoiceAccess = userHasInvoiceAccess(user);
-                    customerId = normalizeOptionalString((_c = user === null || user === void 0 ? void 0 : user.other) === null || _c === void 0 ? void 0 : _c.id_customer);
+                    customerId = normalizeOptionalString((_e = user === null || user === void 0 ? void 0 : user.other) === null || _e === void 0 ? void 0 : _e.id_customer);
                     return [4 /*yield*/, ensureConversation(input, 'codex')];
                 case 7:
-                    conversation = _d.sent();
+                    conversation = _f.sent();
                     now = new Date();
                     attachments = Array.isArray(input.attachments) ? input.attachments : [];
                     return [4 /*yield*/, readAttachmentContents(attachments)];
                 case 8:
-                    attachmentData = _d.sent();
+                    attachmentData = _f.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 = _d.sent();
+                    _a = _f.sent();
                     return [3 /*break*/, 11];
                 case 10:
                     _a = [];
-                    _d.label = 11;
+                    _f.label = 11;
                 case 11:
                     history = _a;
                     historyLines = [];
@@ -822,10 +872,11 @@ function executeAiAssistantCodexRun(payload, context) {
                             historyLines.push("".concat(role, ": ").concat(content));
                         }
                     });
-                    prompt = buildAssistantCodexPrompt(message, attachmentData.promptText, historyLines.join('\n'), buildAssistantContext(input, { isSuperAdmin: isSuperAdmin, hasInvoiceAccess: hasInvoiceAccess, customerId: customerId }));
+                    assistantContext = buildAssistantContext(input, { isSuperAdmin: isSuperAdmin, hasInvoiceAccess: hasInvoiceAccess, customerId: customerId });
+                    prompt = buildAssistantCodexPrompt(message, attachmentData.promptText, historyLines.join('\n'), assistantContext);
                     return [4 /*yield*/, resolveAssistantWorkspaceRoot()];
                 case 12:
-                    workspaceRoot = _d.sent();
+                    workspaceRoot = _f.sent();
                     codexConfig = resolveCodexSettings();
                     runOptions = {
                         timeoutMs: resolveCodexTimeoutMs(),
@@ -840,10 +891,6 @@ function executeAiAssistantCodexRun(payload, context) {
                             approvalPolicy: 'never'
                         }
                     };
-                    return [4 /*yield*/, runCodexInWorkerThread(prompt, runOptions, codexConfig)];
-                case 13:
-                    responseText = _d.sent();
-                    assistantContent = sanitizeAssistantResponse(responseText);
                     userDoc = {
                         id_conversation: conversation._id,
                         role: 'user',
@@ -852,44 +899,125 @@ function executeAiAssistantCodexRun(payload, context) {
                         createdAt: now,
                         updatedAt: now
                     };
+                    initialProgress = ['Thinking'];
                     assistantDoc = {
                         id_conversation: conversation._id,
                         role: 'assistant',
-                        content: assistantContent,
+                        content: AI_ASSISTANT_PROGRESS_PLACEHOLDER,
                         metadata: {
-                            model: resolveCodexModel()
+                            model: resolveCodexModel(),
+                            pending: true,
+                            progress: initialProgress
                         },
                         createdAt: now,
                         updatedAt: now
                     };
                     return [4 /*yield*/, ai_terminal_message_collection_1.AiTerminalMessages.insertOne(userDoc)];
-                case 14:
-                    _d.sent();
+                case 13:
+                    _f.sent();
                     return [4 /*yield*/, ai_terminal_message_collection_1.AiTerminalMessages.insertOne(assistantDoc)];
+                case 14:
+                    insertResult = _f.sent();
+                    assistantMessageId = (insertResult === null || insertResult === void 0 ? void 0 : insertResult._id) || (insertResult === null || insertResult === void 0 ? void 0 : insertResult.insertedId);
+                    progressTracker = createAssistantProgressTracker(assistantMessageId, initialProgress);
+                    assistantContent = '';
+                    toolResult = null;
+                    _f.label = 15;
                 case 15:
-                    insertResult = _d.sent();
-                    return [4 /*yield*/, touchConversation(conversation._id, now, insertResult._id)];
+                    _f.trys.push([15, 30, 31, 32]);
+                    return [4 /*yield*/, runCodexInWorkerThread(prompt, runOptions, codexConfig)];
                 case 16:
-                    _d.sent();
-                    if (!(input.delete_files_after_run !== false)) return [3 /*break*/, 18];
-                    return [4 /*yield*/, cleanupAttachments(attachmentData.attachments)];
+                    responseText = _f.sent();
+                    directive = extractAssistantMongoDirective(responseText);
+                    cleanedResponseText = (directive === null || directive === void 0 ? void 0 : directive.cleaned) || responseText;
+                    assistantContent = sanitizeAssistantResponse(cleanedResponseText);
+                    if (!((directive === null || directive === void 0 ? void 0 : directive.payload) && AI_ASSISTANT_TOOL_MAX_STEPS > 0)) return [3 /*break*/, 28];
+                    toolRequest = buildAssistantToolRequest(directive, input);
+                    progressTracker.push(directive.type === 'aggregate' ? 'Running Mongo aggregation' : 'Running Mongo read');
+                    _f.label = 17;
                 case 17:
-                    _d.sent();
-                    _d.label = 18;
-                case 18: return [2 /*return*/, {
-                        conversation: conversation,
-                        message: assistantDoc
-                    }];
+                    _f.trys.push([17, 26, , 27]);
+                    if (!(directive.type === 'aggregate')) return [3 /*break*/, 19];
+                    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;
+                    toolPayload = buildAssistantToolResultPayload(directive, toolResponse);
+                    toolResult = toolPayload.result;
+                    progressTracker.push('Summarizing results');
+                    followupPrompt = buildAssistantCodexToolFollowupPrompt(message, attachmentData.promptText, historyLines.join('\n'), assistantContext, toolPayload.prompt);
+                    _f.label = 22;
+                case 22:
+                    _f.trys.push([22, 24, , 25]);
+                    return [4 /*yield*/, runCodexInWorkerThread(followupPrompt, runOptions, codexConfig)];
+                case 23:
+                    followupText = _f.sent();
+                    assistantContent = sanitizeAssistantResponse(followupText);
+                    return [3 /*break*/, 25];
+                case 24:
+                    _c = _f.sent();
+                    assistantContent = buildAssistantToolFallbackResponse(toolPayload.result);
+                    return [3 /*break*/, 25];
+                case 25: return [3 /*break*/, 27];
+                case 26:
+                    error_1 = _f.sent();
+                    assistantContent = buildAssistantToolErrorMessage(error_1, directive, toolRequest);
+                    return [3 /*break*/, 27];
+                case 27: return [3 /*break*/, 29];
+                case 28:
+                    progressTracker.push('Drafting response');
+                    _f.label = 29;
+                case 29: return [3 /*break*/, 32];
+                case 30:
+                    error_2 = _f.sent();
+                    assistantContent = buildAssistantCodexErrorMessage(error_2);
+                    return [3 /*break*/, 32];
+                case 31:
+                    progressTracker.stop();
+                    return [7 /*endfinally*/];
+                case 32:
+                    if (!assistantContent) {
+                        assistantContent = buildAssistantCodexErrorMessage(null);
+                    }
+                    finalNow = new Date();
+                    finalMetadata = __assign({ model: resolveCodexModel() }, (toolResult ? { tool_result: toolResult } : {}));
+                    finalAssistantDoc = __assign(__assign({}, assistantDoc), { _id: assistantMessageId, content: assistantContent, metadata: finalMetadata, updatedAt: finalNow });
+                    if (!assistantMessageId) return [3 /*break*/, 34];
+                    return [4 /*yield*/, ai_terminal_message_collection_1.AiTerminalMessages.updateOne({ _id: assistantMessageId }, {
+                            $set: {
+                                content: assistantContent,
+                                metadata: finalMetadata,
+                                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];
+                    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 } : {}))];
             }
         });
     });
 }
 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;
-        var _c;
-        return __generator(this, function (_d) {
-            switch (_d.label) {
+        var input, collection, _a, user, isSuperAdmin, customerId, dbName, db, baseQuery, userId, normalizedClient, shouldScopeByClient, _b, clientScopedQuery, scopedQuery, normalized, documents, total, sanitizedDocuments, includeIds, display;
+        var _c, _d;
+        return __generator(this, function (_e) {
+            switch (_e.label) {
                 case 0:
                     input = payload || {};
                     collection = normalizeOptionalString(input.collection);
@@ -898,7 +1026,7 @@ function executeAiAssistantMongoRead(payload, context) {
                     }
                     return [4 /*yield*/, ensureAssistantReadAccess(context, input.permissionView, collection)];
                 case 1:
-                    _a = _d.sent(), user = _a.user, isSuperAdmin = _a.isSuperAdmin;
+                    _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.');
                     }
@@ -919,11 +1047,11 @@ function executeAiAssistantMongoRead(payload, context) {
                     if (!(!isSuperAdmin && normalizedClient)) return [3 /*break*/, 3];
                     return [4 /*yield*/, collectionHasClientIndex(db, dbName, collection)];
                 case 2:
-                    _b = _d.sent();
+                    _b = _e.sent();
                     return [3 /*break*/, 4];
                 case 3:
                     _b = false;
-                    _d.label = 4;
+                    _e.label = 4;
                 case 4:
                     shouldScopeByClient = _b;
                     clientScopedQuery = shouldScopeByClient
@@ -933,18 +1061,27 @@ function executeAiAssistantMongoRead(payload, context) {
                     normalized = normalizeAssistantFindOptions(input.options);
                     return [4 /*yield*/, db.collection(collection).find(scopedQuery, normalized.findOptions).toArray()];
                 case 5:
-                    documents = _d.sent();
+                    documents = _e.sent();
                     total = null;
                     if (!normalized.includeTotal) return [3 /*break*/, 7];
                     return [4 /*yield*/, db.collection(collection).countDocuments(scopedQuery)];
                 case 6:
-                    total = _d.sent();
-                    _d.label = 7;
+                    total = _e.sent();
+                    _e.label = 7;
                 case 7:
                     sanitizedDocuments = isSuperAdmin
                         ? documents
                         : documents.map(function (doc) { return redactSensitiveFields((0, common_1.deepCopy)(doc)); });
-                    return [2 /*return*/, __assign({ documents: sanitizedDocuments, total: total }, (isSuperAdmin ? {
+                    includeIds = ((_d = input.options) === null || _d === void 0 ? void 0 : _d.includeIds) === true;
+                    display = buildDisplayTable(sanitizedDocuments, {
+                        includeIds: includeIds,
+                        maxColumns: AI_ASSISTANT_DISPLAY_MAX_COLUMNS,
+                        maxRows: normalized.findOptions.limit
+                    });
+                    if (total !== null) {
+                        display.total = total;
+                    }
+                    return [2 /*return*/, __assign({ documents: sanitizedDocuments, total: total, display: display }, (isSuperAdmin ? {
                             debug: {
                                 collection: collection,
                                 database: dbName,
@@ -959,10 +1096,10 @@ 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, documents, executedPipeline, fallbackMeta, fallback, fallbackPipeline, fallbackDocs, unwindFallback, fallbackPipeline, fallbackDocs, sanitizedDocuments;
-        var _c;
-        return __generator(this, function (_d) {
-            switch (_d.label) {
+        var input, collection, _a, user, isSuperAdmin, customerId, dbName, db, baseQuery, userId, normalizedClient, shouldScopeByClient, _b, clientScopedQuery, scopedQuery, normalizedPipeline, pipelineWithScope, normalizedOptions, limitedPipeline, documents, executedPipeline, fallbackMeta, fallback, fallbackPipeline, fallbackDocs, 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);
@@ -971,7 +1108,7 @@ function executeAiAssistantMongoAggregate(payload, context) {
                     }
                     return [4 /*yield*/, ensureAssistantReadAccess(context, input.permissionView, collection)];
                 case 1:
-                    _a = _d.sent(), user = _a.user, isSuperAdmin = _a.isSuperAdmin;
+                    _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.');
                     }
@@ -992,11 +1129,11 @@ function executeAiAssistantMongoAggregate(payload, context) {
                     if (!(!isSuperAdmin && normalizedClient)) return [3 /*break*/, 3];
                     return [4 /*yield*/, collectionHasClientIndex(db, dbName, collection)];
                 case 2:
-                    _b = _d.sent();
+                    _b = _e.sent();
                     return [3 /*break*/, 4];
                 case 3:
                     _b = false;
-                    _d.label = 4;
+                    _e.label = 4;
                 case 4:
                     shouldScopeByClient = _b;
                     clientScopedQuery = shouldScopeByClient
@@ -1014,7 +1151,7 @@ function executeAiAssistantMongoAggregate(payload, context) {
                             .aggregate(limitedPipeline, normalizedOptions.aggregateOptions)
                             .toArray()];
                 case 5:
-                    documents = _d.sent();
+                    documents = _e.sent();
                     executedPipeline = limitedPipeline;
                     fallbackMeta = {};
                     if (!!documents.length) return [3 /*break*/, 7];
@@ -1027,13 +1164,13 @@ function executeAiAssistantMongoAggregate(payload, context) {
                             .aggregate(fallbackPipeline, normalizedOptions.aggregateOptions)
                             .toArray()];
                 case 6:
-                    fallbackDocs = _d.sent();
+                    fallbackDocs = _e.sent();
                     if (fallbackDocs.length) {
                         documents = fallbackDocs;
                         executedPipeline = fallbackPipeline;
                         fallbackMeta.dateField.used = true;
                     }
-                    _d.label = 7;
+                    _e.label = 7;
                 case 7:
                     if (!(documents.length <= 1)) return [3 /*break*/, 9];
                     unwindFallback = resolveAggregateUnwindFallback(executedPipeline);
@@ -1045,18 +1182,24 @@ function executeAiAssistantMongoAggregate(payload, context) {
                             .aggregate(fallbackPipeline, normalizedOptions.aggregateOptions)
                             .toArray()];
                 case 8:
-                    fallbackDocs = _d.sent();
+                    fallbackDocs = _e.sent();
                     if (fallbackDocs.length > documents.length) {
                         documents = fallbackDocs;
                         executedPipeline = fallbackPipeline;
                         fallbackMeta.unwind.used = true;
                     }
-                    _d.label = 9;
+                    _e.label = 9;
                 case 9:
                     sanitizedDocuments = isSuperAdmin
                         ? documents
                         : documents.map(function (doc) { return redactSensitiveFields((0, common_1.deepCopy)(doc)); });
-                    return [2 /*return*/, __assign({ documents: sanitizedDocuments }, (isSuperAdmin ? {
+                    includeIds = ((_d = input.options) === null || _d === void 0 ? void 0 : _d.includeIds) === true;
+                    display = buildDisplayTable(sanitizedDocuments, {
+                        includeIds: includeIds,
+                        maxColumns: AI_ASSISTANT_DISPLAY_MAX_COLUMNS,
+                        maxRows: normalizedOptions.limit || sanitizedDocuments.length
+                    });
+                    return [2 /*return*/, __assign({ documents: sanitizedDocuments, display: display }, (isSuperAdmin ? {
                             debug: {
                                 collection: collection,
                                 database: dbName,
@@ -1071,6 +1214,607 @@ function executeAiAssistantMongoAggregate(payload, context) {
         });
     });
 }
+function extractAssistantMongoDirective(content) {
+    var lines = String(content || '').split('\n');
+    var directiveIndex = -1;
+    var directiveLine = '';
+    var directiveType = null;
+    var directiveIndexes = new Set();
+    lines.forEach(function (line, index) {
+        var normalized = line.trim().replace(/^[-*]+\s*/, '');
+        var upper = normalized.toUpperCase();
+        if (upper.startsWith('MONGO_READ:')) {
+            directiveIndexes.add(index);
+            directiveIndex = index;
+            directiveLine = normalized;
+            directiveType = 'read';
+            return;
+        }
+        if (upper.startsWith('MONGO_AGG:') || upper.startsWith('MONGO_AGGREGATE:')) {
+            directiveIndexes.add(index);
+            directiveIndex = index;
+            directiveLine = normalized;
+            directiveType = 'aggregate';
+        }
+    });
+    if (directiveIndex === -1 || !directiveType) {
+        return null;
+    }
+    var colonIndex = directiveLine.indexOf(':');
+    var after = colonIndex >= 0 ? directiveLine.slice(colonIndex + 1).trim() : '';
+    var parsed = after ? parseJsonObject(after) : null;
+    var payload = parsed && typeof parsed === 'object' ? parsed : null;
+    var cleaned = lines.filter(function (_, index) { return !directiveIndexes.has(index); }).join('\n').trim();
+    return {
+        type: directiveType,
+        payload: payload,
+        cleaned: cleaned,
+        rawLine: directiveLine
+    };
+}
+function buildAssistantToolRequest(directive, payload) {
+    var _a;
+    var base = directive.payload && typeof directive.payload === 'object' ? directive.payload : {};
+    var request = __assign({}, base);
+    var route = normalizeOptionalString((_a = payload === null || payload === void 0 ? void 0 : payload.context) === null || _a === void 0 ? void 0 : _a.route);
+    if (!request.permissionView && route) {
+        request.permissionView = route;
+    }
+    if (!request.id_client) {
+        var idClient = normalizeOptionalString(payload === null || payload === void 0 ? void 0 : payload.id_client);
+        if (idClient) {
+            request.id_client = idClient;
+        }
+    }
+    if (!request.mongo && (payload === null || payload === void 0 ? void 0 : payload.mongo)) {
+        request.mongo = payload.mongo;
+    }
+    return request;
+}
+function buildAssistantToolResultPayload(directive, toolResponse) {
+    var _a;
+    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;
+    var display = (toolResponse === null || toolResponse === void 0 ? void 0 : toolResponse.display) && typeof toolResponse.display === 'object'
+        ? toolResponse.display
+        : buildDisplayTable(documents, {
+            includeIds: includeIds,
+            maxColumns: AI_ASSISTANT_DISPLAY_MAX_COLUMNS,
+            maxRows: AI_ASSISTANT_DISPLAY_PREVIEW_MAX_ROWS
+        });
+    var trimmedDisplay = trimDisplayTable(display, {
+        maxColumns: AI_ASSISTANT_DISPLAY_MAX_COLUMNS,
+        maxRows: AI_ASSISTANT_DISPLAY_PREVIEW_MAX_ROWS
+    });
+    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 result = {
+        type: directive.type === 'aggregate' ? 'mongo_agg' : 'mongo_read',
+        input: directivePayload,
+        output: {
+            display: trimmedDisplay,
+            total: total !== null ? total : undefined,
+            collection: collection || undefined,
+            rowCount: rowCount,
+            columns: trimmedDisplay.columns,
+            truncated: trimmedDisplay.truncated
+        }
+    };
+    return {
+        result: result,
+        prompt: buildAssistantToolResultPrompt(result)
+    };
+}
+function buildAssistantToolResultPrompt(result) {
+    var _a, _b;
+    var lines = ['Tool Result:'];
+    lines.push("Type: ".concat(result.type));
+    if (result.output.collection) {
+        lines.push("Collection: ".concat(result.output.collection));
+    }
+    lines.push("Row count: ".concat(result.output.rowCount));
+    if (typeof result.output.total === 'number') {
+        lines.push("Total: ".concat(result.output.total));
+    }
+    if (Array.isArray(result.output.columns) && result.output.columns.length) {
+        lines.push("Columns: ".concat(result.output.columns.join(', ')));
+    }
+    if ((_b = (_a = result.output.display) === null || _a === void 0 ? void 0 : _a.rows) === null || _b === void 0 ? void 0 : _b.length) {
+        lines.push('Preview:');
+        lines.push(formatDisplayTableMarkdown(result.output.display));
+    }
+    else {
+        lines.push('Preview: (no rows)');
+    }
+    return lines.join('\n');
+}
+function buildAssistantCodexToolFollowupPrompt(message, attachmentText, historyText, contextText, toolResultText) {
+    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 toolBlock = toolResultText ? "\n\nTool Result:\n".concat(toolResultText) : '';
+    var instruction = '\n\nInstruction:\nNow answer the user. Do NOT output another MONGO_* directive. Output plain Markdown. Summarize first, then include a Markdown table.';
+    return "System:\n".concat(AI_ASSISTANT_SYSTEM_PROMPT).concat(contextBlock).concat(historyBlock, "\n\nUser:\n").concat(message).concat(attachmentText || '').concat(toolBlock).concat(instruction).trim();
+}
+function buildAssistantToolFallbackResponse(result) {
+    var _a, _b;
+    var lines = ['Here is a data snapshot based on the tool result:'];
+    if (result.output.collection) {
+        lines.push("- Collection: ".concat(result.output.collection));
+    }
+    lines.push("- Rows returned: ".concat(result.output.rowCount));
+    if (typeof result.output.total === 'number') {
+        lines.push("- Total: ".concat(result.output.total));
+    }
+    if ((_b = (_a = result.output.display) === null || _a === void 0 ? void 0 : _a.rows) === null || _b === void 0 ? void 0 : _b.length) {
+        lines.push('');
+        lines.push(formatDisplayTableMarkdown(result.output.display));
+    }
+    return lines.join('\n').trim();
+}
+function buildAssistantToolErrorMessage(error, directive, request) {
+    var _a, _b;
+    var rawMessage = normalizeOptionalString(error === null || error === void 0 ? void 0 : error.message) || 'Unable to access data.';
+    var normalized = rawMessage.toLowerCase();
+    var routeHint = normalizeOptionalString(request === null || request === void 0 ? void 0 : request.permissionView)
+        || normalizeOptionalString((_a = directive.payload) === null || _a === void 0 ? void 0 : _a.permissionView);
+    var collection = normalizeOptionalString(request === null || request === void 0 ? void 0 : request.collection) || normalizeOptionalString((_b = directive.payload) === null || _b === void 0 ? void 0 : _b.collection);
+    var routeLine = routeHint
+        ? "Open ".concat(routeHint, " in the app to view this data or request access.")
+        : 'Open the related screen in the app to view this data or request access.';
+    if (!routeHint && collection && requiresInvoicePermission(collection)) {
+        routeLine = 'Open /invoice/list or /report/invoice to view this data or request access.';
+    }
+    if (normalized.includes('permission scope required')) {
+        return "I need a permission scope to access that data. ".concat(routeLine);
+    }
+    if (normalized.includes('access denied')) {
+        if (collection && requiresInvoicePermission(collection)) {
+            return "Invoice access is required to view that data. ".concat(routeLine);
+        }
+        return "You don't have permission to view that data. ".concat(routeLine);
+    }
+    if (normalized.includes('database access denied')) {
+        return "Database access is restricted for that request. ".concat(routeLine);
+    }
+    if (normalized.includes('collection is required')) {
+        return 'I need a valid collection to read from. Please specify which screen or dataset you want.';
+    }
+    return "I couldn't access the requested data. ".concat(routeLine);
+}
+function normalizeAssistantProgress(items) {
+    var seen = new Set();
+    var cleaned = [];
+    items.forEach(function (item) {
+        var trimmed = String(item || '').trim();
+        if (!trimmed) {
+            return;
+        }
+        var key = trimmed.toLowerCase();
+        if (seen.has(key)) {
+            return;
+        }
+        seen.add(key);
+        cleaned.push(trimmed);
+    });
+    return cleaned;
+}
+function updateAssistantProgress(messageId, progress) {
+    return __awaiter(this, void 0, void 0, function () {
+        var normalized, _a;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    normalized = normalizeAssistantProgress(progress);
+                    if (!messageId || !normalized.length) {
+                        return [2 /*return*/];
+                    }
+                    _b.label = 1;
+                case 1:
+                    _b.trys.push([1, 3, , 4]);
+                    return [4 /*yield*/, ai_terminal_message_collection_1.AiTerminalMessages.updateOne({ _id: messageId, 'metadata.pending': true }, {
+                            $set: {
+                                'metadata.pending': true,
+                                'metadata.progress': normalized,
+                                updatedAt: new Date()
+                            }
+                        })];
+                case 2:
+                    _b.sent();
+                    return [3 /*break*/, 4];
+                case 3:
+                    _a = _b.sent();
+                    return [3 /*break*/, 4];
+                case 4: return [2 /*return*/];
+            }
+        });
+    });
+}
+function createAssistantProgressTracker(messageId, initialProgress) {
+    var _this = this;
+    var progress = normalizeAssistantProgress(initialProgress);
+    var stopped = false;
+    var tickIndex = 0;
+    var updateScheduled = false;
+    var timer = null;
+    var queueProgressUpdate = function () {
+        if (stopped || !messageId || updateScheduled) {
+            return;
+        }
+        updateScheduled = true;
+        setTimeout(function () { return __awaiter(_this, void 0, void 0, function () {
+            var _a;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        updateScheduled = false;
+                        if (stopped) {
+                            return [2 /*return*/];
+                        }
+                        _b.label = 1;
+                    case 1:
+                        _b.trys.push([1, 3, , 4]);
+                        return [4 /*yield*/, updateAssistantProgress(messageId, progress)];
+                    case 2:
+                        _b.sent();
+                        return [3 /*break*/, 4];
+                    case 3:
+                        _a = _b.sent();
+                        return [3 /*break*/, 4];
+                    case 4: return [2 /*return*/];
+                }
+            });
+        }); }, 0);
+    };
+    if (messageId) {
+        timer = setInterval(function () {
+            if (stopped) {
+                if (timer) {
+                    clearInterval(timer);
+                    timer = null;
+                }
+                return;
+            }
+            if (tickIndex >= AI_ASSISTANT_PROGRESS_TICKS.length) {
+                if (timer) {
+                    clearInterval(timer);
+                    timer = null;
+                }
+                return;
+            }
+            var next = AI_ASSISTANT_PROGRESS_TICKS[tickIndex++];
+            progress = normalizeAssistantProgress(__spreadArray(__spreadArray([], __read(progress), false), [next], false));
+            queueProgressUpdate();
+        }, AI_ASSISTANT_PROGRESS_TICK_MS);
+    }
+    return {
+        push: function (item) {
+            if (stopped || !messageId) {
+                return;
+            }
+            progress = normalizeAssistantProgress(__spreadArray(__spreadArray([], __read(progress), false), [item], false));
+            queueProgressUpdate();
+        },
+        stop: function () {
+            stopped = true;
+            if (timer) {
+                clearInterval(timer);
+                timer = null;
+            }
+        }
+    };
+}
+function buildAssistantCodexErrorMessage(error) {
+    var raw = normalizeOptionalString(error === null || error === void 0 ? void 0 : error.message);
+    if (raw && /timed out/i.test(raw)) {
+        return 'That took longer than expected. Please try again or narrow the request.';
+    }
+    return 'I ran into an internal error while preparing that response. Please try again.';
+}
+function isAssistantIdField(key) {
+    var normalized = String(key || '').trim().toLowerCase();
+    if (!normalized) {
+        return false;
+    }
+    if (normalized === '_id' || normalized === '__v') {
+        return true;
+    }
+    if (normalized.startsWith('id_')) {
+        return true;
+    }
+    var parts = normalized.split('.');
+    var last = parts[parts.length - 1] || '';
+    return last.startsWith('id_');
+}
+function isMongoObjectId(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    if (typeof value.toHexString === 'function') {
+        return true;
+    }
+    return value._bsontype === 'ObjectId';
+}
+function isPlainObject(value) {
+    return !!value && typeof value === 'object' && Object.prototype.toString.call(value) === '[object Object]';
+}
+function normalizeColumnPriorityKey(column) {
+    var trimmed = String(column || '').trim();
+    if (!trimmed) {
+        return '';
+    }
+    var base = trimmed.includes('.') ? trimmed.split('.').pop() || trimmed : trimmed;
+    return base.toLowerCase();
+}
+function formatDisplayColumnName(column) {
+    var trimmed = String(column || '').trim();
+    if (!trimmed) {
+        return '';
+    }
+    if (trimmed === '_id') {
+        return 'id';
+    }
+    if (trimmed === '_group') {
+        return 'Group';
+    }
+    var normalized = trimmed.replace(/[\s_]+/g, '').toLowerCase();
+    if (normalized === 'createdat') {
+        return 'Created At';
+    }
+    if (normalized === 'updatedat') {
+        return 'Updated At';
+    }
+    return trimmed;
+}
+function truncateDisplayText(value, maxLength) {
+    if (maxLength === void 0) { maxLength = AI_ASSISTANT_DISPLAY_STRING_LIMIT; }
+    if (!value) {
+        return value;
+    }
+    if (value.length <= maxLength) {
+        return value;
+    }
+    var sliceLength = Math.max(0, maxLength - 3);
+    return "".concat(value.slice(0, sliceLength), "...");
+}
+function serializeMongoValue(value, maxLength) {
+    if (maxLength === void 0) { maxLength = AI_ASSISTANT_DISPLAY_STRING_LIMIT; }
+    if (value === null || value === undefined) {
+        return null;
+    }
+    if (typeof value === 'number' || typeof value === 'boolean') {
+        return value;
+    }
+    if (typeof value === 'string') {
+        return truncateDisplayText(value, maxLength);
+    }
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    if (isMongoObjectId(value)) {
+        try {
+            var hex = typeof value.toHexString === 'function' ? value.toHexString() : String(value);
+            var shortened = hex.length > 8 ? hex.slice(0, 8) : hex;
+            return truncateDisplayText(shortened, maxLength);
+        }
+        catch (_a) {
+            return truncateDisplayText(String(value), maxLength);
+        }
+    }
+    if (Array.isArray(value)) {
+        var preview = value.slice(0, 3).map(function (entry) { return serializeMongoValue(entry, maxLength); });
+        var compact = preview.map(function (entry) { return (entry === null || entry === undefined) ? '' : String(entry); }).join(', ');
+        var suffix = value.length > 3 ? ', ...' : '';
+        return truncateDisplayText("[".concat(compact).concat(suffix, "]"), maxLength);
+    }
+    if (typeof value === 'object') {
+        var text = '';
+        try {
+            text = JSON.stringify(value);
+        }
+        catch (_b) {
+            text = String(value);
+        }
+        if (!text || text === '[object Object]') {
+            try {
+                text = JSON.stringify(value, null, 2);
+            }
+            catch (_c) {
+                text = String(value);
+            }
+        }
+        return truncateDisplayText(text, maxLength);
+    }
+    return truncateDisplayText(String(value), maxLength);
+}
+function flattenForTable(doc) {
+    var result = {};
+    if (!doc || typeof doc !== 'object') {
+        return result;
+    }
+    if (Object.prototype.hasOwnProperty.call(doc, '_id')) {
+        var idValue_1 = doc._id;
+        if (idValue_1 !== null && idValue_1 !== undefined) {
+            if (isPlainObject(idValue_1) && !isMongoObjectId(idValue_1) && !(idValue_1 instanceof Date)) {
+                Object.keys(idValue_1).forEach(function (key) {
+                    if (!key || Object.prototype.hasOwnProperty.call(result, key)) {
+                        return;
+                    }
+                    result[key] = idValue_1[key];
+                });
+            }
+            else if (!Object.prototype.hasOwnProperty.call(result, '_group')) {
+                result._group = idValue_1;
+            }
+        }
+    }
+    Object.keys(doc).forEach(function (key) {
+        if (key === '_id') {
+            return;
+        }
+        var value = doc[key];
+        if (value === undefined) {
+            return;
+        }
+        if (isPlainObject(value) && !isMongoObjectId(value) && !(value instanceof Date)) {
+            var nestedKeys = Object.keys(value);
+            if (nestedKeys.length && nestedKeys.length <= 6) {
+                nestedKeys.forEach(function (nestedKey) {
+                    if (!nestedKey) {
+                        return;
+                    }
+                    var nestedValue = value[nestedKey];
+                    if (nestedValue === undefined) {
+                        return;
+                    }
+                    result["".concat(key, ".").concat(nestedKey)] = nestedValue;
+                });
+                return;
+            }
+        }
+        result[key] = value;
+    });
+    return result;
+}
+function buildDisplayTable(docs, options) {
+    var rowsRaw = Array.isArray(docs) ? docs.map(function (doc) { return flattenForTable(doc); }) : [];
+    var stats = new Map();
+    rowsRaw.forEach(function (row) {
+        Object.keys(row).forEach(function (key) {
+            var value = row[key];
+            var entry = stats.get(key) || { nonEmpty: 0, objectLike: 0 };
+            if (!isEmptyDisplayValue(value)) {
+                entry.nonEmpty += 1;
+            }
+            if (isDisplayObjectLike(value)) {
+                entry.objectLike += 1;
+            }
+            stats.set(key, entry);
+        });
+    });
+    var columns = Array.from(stats.keys()).filter(function (key) {
+        var entry = stats.get(key);
+        if (!entry || entry.nonEmpty === 0) {
+            return false;
+        }
+        if (!(options === null || options === void 0 ? void 0 : options.includeIds) && isAssistantIdField(key)) {
+            return false;
+        }
+        if (entry.objectLike / Math.max(entry.nonEmpty, 1) > 0.5) {
+            return false;
+        }
+        return true;
+    });
+    if (!columns.length && rowsRaw.length) {
+        columns = Object.keys(rowsRaw[0] || {}).filter(function (key) { return (options === null || options === void 0 ? void 0 : options.includeIds) || !isAssistantIdField(key); });
+    }
+    var priorityFields = (options === null || options === void 0 ? void 0 : options.priorityFields) || AI_ASSISTANT_DISPLAY_PRIORITY_FIELDS;
+    var priorityMap = new Map(priorityFields.map(function (field, index) { return [field.toLowerCase(), index]; }));
+    columns.sort(function (a, b) {
+        var _a, _b, _c, _d;
+        var aPriority = (_a = priorityMap.get(normalizeColumnPriorityKey(a))) !== null && _a !== void 0 ? _a : 999;
+        var bPriority = (_b = priorityMap.get(normalizeColumnPriorityKey(b))) !== null && _b !== void 0 ? _b : 999;
+        if (aPriority !== bPriority) {
+            return aPriority - bPriority;
+        }
+        var aCount = ((_c = stats.get(a)) === null || _c === void 0 ? void 0 : _c.nonEmpty) || 0;
+        var bCount = ((_d = stats.get(b)) === null || _d === void 0 ? void 0 : _d.nonEmpty) || 0;
+        if (aCount !== bCount) {
+            return bCount - aCount;
+        }
+        return a.localeCompare(b);
+    });
+    var maxColumns = typeof (options === null || options === void 0 ? void 0 : options.maxColumns) === 'number'
+        ? Math.max(options.maxColumns, 0)
+        : AI_ASSISTANT_DISPLAY_MAX_COLUMNS;
+    if (maxColumns && columns.length > maxColumns) {
+        columns = columns.slice(0, maxColumns);
+    }
+    var columnLabels = columns.map(function (column) { return formatDisplayColumnName(column) || column; });
+    var maxRows = typeof (options === null || options === void 0 ? void 0 : options.maxRows) === 'number'
+        ? Math.max(options.maxRows, 0)
+        : rowsRaw.length;
+    var limitedRows = maxRows ? rowsRaw.slice(0, maxRows) : [];
+    var rows = limitedRows.map(function (row) {
+        var next = {};
+        columns.forEach(function (column, index) {
+            var label = columnLabels[index] || column;
+            next[label] = serializeMongoValue(row[column]);
+        });
+        return next;
+    });
+    return {
+        columns: columnLabels,
+        rows: rows,
+        rowCount: rowsRaw.length,
+        truncated: rowsRaw.length > maxRows || columns.length > maxColumns,
+        includeIds: (options === null || options === void 0 ? void 0 : options.includeIds) === true
+    };
+}
+function trimDisplayTable(display, options) {
+    if (!display || !Array.isArray(display.columns)) {
+        return display;
+    }
+    var rowsSource = Array.isArray(display.rows) ? display.rows : [];
+    var maxColumns = typeof (options === null || options === void 0 ? void 0 : options.maxColumns) === 'number'
+        ? Math.max(options.maxColumns, 0)
+        : display.columns.length;
+    var maxRows = typeof (options === null || options === void 0 ? void 0 : options.maxRows) === 'number'
+        ? Math.max(options.maxRows, 0)
+        : rowsSource.length;
+    var columns = maxColumns ? display.columns.slice(0, maxColumns) : [];
+    var rows = maxRows ? rowsSource.slice(0, maxRows).map(function (row) {
+        var next = {};
+        columns.forEach(function (column) {
+            next[column] = row === null || row === void 0 ? void 0 : row[column];
+        });
+        return next;
+    }) : [];
+    return __assign(__assign({}, display), { columns: columns, rows: rows, truncated: display.truncated || display.columns.length > maxColumns || rowsSource.length > maxRows });
+}
+function formatDisplayTableMarkdown(display) {
+    if (!display || !Array.isArray(display.columns) || !display.columns.length) {
+        return '';
+    }
+    var header = "| ".concat(display.columns.join(' | '), " |");
+    var separator = "| ".concat(display.columns.map(function () { return '---'; }).join(' | '), " |");
+    var rows = (display.rows || []).map(function (row) {
+        var cells = display.columns.map(function (column) { return escapeMarkdownCell(row === null || row === void 0 ? void 0 : row[column]); });
+        return "| ".concat(cells.join(' | '), " |");
+    });
+    return __spreadArray([header, separator], __read(rows), false).join('\n').trim();
+}
+function escapeMarkdownCell(value) {
+    var raw = value === null || value === undefined ? '' : String(value);
+    return raw.replace(/\|/g, '\\|').replace(/\r?\n/g, ' ').trim();
+}
+function isEmptyDisplayValue(value) {
+    if (value === null || value === undefined) {
+        return true;
+    }
+    if (typeof value === 'string') {
+        return !value.trim();
+    }
+    if (Array.isArray(value)) {
+        return value.length === 0;
+    }
+    return false;
+}
+function isDisplayObjectLike(value) {
+    if (value === null || value === undefined) {
+        return false;
+    }
+    if (value instanceof Date) {
+        return false;
+    }
+    if (isMongoObjectId(value)) {
+        return false;
+    }
+    return typeof value === 'object';
+}
 function ensureAssistantReadAccess(context, permissionView, collection) {
     return __awaiter(this, void 0, void 0, function () {
         var idUser, user, isSuperAdmin, normalizedPermission, normalizedCollection;
@@ -1131,7 +1875,7 @@ function resolveAssistantDatabaseName(database, mongoConfig) {
 }
 function normalizeAssistantFindOptions(options) {
     var normalized = options || {};
-    var projection = normalized.projection && Object.keys(normalized.projection).length ? normalized.projection : undefined;
+    var projection = sanitizeAssistantProjection(normalized.projection);
     var sort = normalized.sort && Object.keys(normalized.sort).length ? normalized.sort : undefined;
     var limit = typeof normalized.limit === 'number'
         ? Math.min(Math.max(normalized.limit, 0), AI_ASSISTANT_MONGO_MAX_LIMIT)
@@ -1147,6 +1891,33 @@ function normalizeAssistantFindOptions(options) {
         includeTotal: normalized.includeTotal === true
     };
 }
+function sanitizeAssistantProjection(projection) {
+    if (!projection || typeof projection !== 'object') {
+        return undefined;
+    }
+    var keys = Object.keys(projection);
+    if (!keys.length) {
+        return undefined;
+    }
+    var hasInclude = false;
+    var hasExclude = false;
+    keys.forEach(function (key) {
+        var value = projection[key];
+        if (value === 0 || value === false) {
+            hasExclude = true;
+        }
+        else if (value === 1 || value === true) {
+            hasInclude = true;
+        }
+    });
+    if (hasInclude && !hasExclude) {
+        var onlyIds = keys.every(function (key) { return isAssistantIdField(key); });
+        if (onlyIds) {
+            return undefined;
+        }
+    }
+    return projection;
+}
 function normalizeAssistantAggregatePipeline(pipeline) {
     if (!Array.isArray(pipeline)) {
         return [];
@@ -1635,7 +2406,7 @@ var CodexWorkerBootstrapError = /** @class */ (function (_super) {
 }(Error));
 function runCodexInWorkerThread(prompt, runOptions, config) {
     return __awaiter(this, void 0, void 0, function () {
-        var codexClient, workerPath, codexClient, error_1, codexClient;
+        var codexClient, workerPath, codexClient, error_3, codexClient;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
@@ -1655,11 +2426,11 @@ function runCodexInWorkerThread(prompt, runOptions, config) {
                     return [4 /*yield*/, runCodexInWorkerThreadInternal(workerPath, prompt, runOptions, config)];
                 case 6: return [2 /*return*/, _a.sent()];
                 case 7:
-                    error_1 = _a.sent();
-                    if (!(error_1 instanceof CodexWorkerBootstrapError)) {
-                        throw error_1;
+                    error_3 = _a.sent();
+                    if (!(error_3 instanceof CodexWorkerBootstrapError)) {
+                        throw error_3;
                     }
-                    console.error('Codex worker bootstrap failed, falling back to in-process run.', error_1);
+                    console.error('Codex worker bootstrap failed, falling back to in-process run.', error_3);
                     codexClient = getAssistantCodexClient();
                     return [4 /*yield*/, codexClient.run(prompt, runOptions)];
                 case 8: return [2 /*return*/, _a.sent()];
@@ -1696,7 +2467,7 @@ function runCodexInWorkerThreadInternal(workerPath, prompt, runOptions, config)
                     timeoutMs = ((sanitizedOptions === null || sanitizedOptions === void 0 ? void 0 : sanitizedOptions.timeoutMs) || resolveCodexTimeoutMs()) + 15000;
                     timeoutController = new AbortController();
                     timeoutPromise = (function () { return __awaiter(_this, void 0, void 0, function () {
-                        var error_2;
+                        var error_4;
                         return __generator(this, function (_a) {
                             switch (_a.label) {
                                 case 0:
@@ -1706,11 +2477,11 @@ function runCodexInWorkerThreadInternal(workerPath, prompt, runOptions, config)
                                     _a.sent();
                                     return [2 /*return*/, { type: 'timeout' }];
                                 case 2:
-                                    error_2 = _a.sent();
-                                    if ((error_2 === null || error_2 === void 0 ? void 0 : error_2.name) === 'AbortError') {
+                                    error_4 = _a.sent();
+                                    if ((error_4 === null || error_4 === void 0 ? void 0 : error_4.name) === 'AbortError') {
                                         return [2 /*return*/, { type: 'aborted' }];
                                     }
-                                    throw error_2;
+                                    throw error_4;
                                 case 3: return [2 /*return*/];
                             }
                         });
@@ -2068,7 +2839,7 @@ function sanitizeAssistantResponse(value) {
     if (!raw) {
         return 'I could not generate a response. Please try again.';
     }
-    var withoutBlocks = raw.replace(/```[\\s\\S]*?```/g, '').replace(/`([^`]+)`/g, '$1').trim();
+    var withoutBlocks = raw.replace(/```[\s\S]*?```/g, '').replace(/`([^`]+)`/g, '$1').trim();
     var stripEstimated = function (line) { return line.replace(/\bEstimated (human )?hours:\s*.*$/i, '').trimEnd(); };
     var isTentativeQueryLine = function (line) {
         var normalized = line.trim().replace(/^[-*•]+\s*/, '');