@resolveio/server-lib 22.0.17 → 22.0.19

package/methods/ai-terminal.js

@@ -116,6 +116,7 @@ exports.buildDisplayTable = buildDisplayTable;
 exports.formatDisplayTableMarkdown = formatDisplayTableMarkdown;
 exports.normalizeAssistantNowExprPlaceholders = normalizeAssistantNowExprPlaceholders;
 exports.rewriteMatchExpressionsToExpr = rewriteMatchExpressionsToExpr;
+exports.normalizeAssistantMonthlyCalendarWindowPipeline = normalizeAssistantMonthlyCalendarWindowPipeline;
 exports.stripQueryFieldPathsDeep = stripQueryFieldPathsDeep;
 exports.stripScopedFieldsFromPipeline = stripScopedFieldsFromPipeline;
 exports.rewriteEmbeddedMatchObjects = rewriteEmbeddedMatchObjects;
@@ -408,6 +409,7 @@ var AI_ASSISTANT_REPORT_BUILDER_EXPERT_PLAYBOOK = [
     '- Use collection joins/lookups when selected fields live across related collections.',
     '- If multiple arrays are selected, link them by shared identifiers (_id or id_<x>) so rows are aligned and not duplicated by cartesian expansion.',
     '- For relative dates, include an upper bound <= $$NOW unless user explicitly asks for future ranges.',
+    '- For time-based trends over "last/past N" periods, use full completed calendar-period bounds in UTC aligned to the requested grain (day/week/month/quarter/year) unless the user explicitly asks for period-to-date.',
     '- For invoice revenue, prefer paid_total fallback grand_total and paid/closed states when applicable.',
     '',
     '6) Reliability fallback sequence when result is empty.',
@@ -497,6 +499,7 @@ var AI_ASSISTANT_SYSTEM_PROMPT = [
     '- Do not use /report/* routes as permissionView for data directives; use a module route that matches the collection.',
     '- For revenue/sales/billing questions, use invoices and sum paid_total (fallback to grand_total) with date_paid and Paid/Closed status when available.',
     '- For revenue answers, always state the metric/date basis used (paid_total/date_paid vs grand_total/date_invoice). If tool verification warns about ambiguity or partial months, call that out before totals.',
+    '- For time-based "last/past N" breakdowns, use full completed calendar-period windows in UTC aligned to the requested grain (day/week/month/quarter/year) by default, and present concrete start/end dates.',
     '- For relative date ranges (last/past/recent), include an upper bound <= $$NOW unless the user specifies a future end date.',
     '- Keep queries minimal, read-only, and avoid user/credential data unless the user is a super admin.',
     '- Assume you are not a super admin unless explicitly told otherwise.',
@@ -512,6 +515,7 @@ var AI_ASSISTANT_SYSTEM_PROMPT = [
     '- If the user explicitly asks for IDs, set options.includeIds: true.',
     '- 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).',
+    '- Never show internal placeholders like $$NOW in user-facing text; always use concrete dates.',
     '',
     AI_ASSISTANT_REPORT_BUILDER_EXPERT_PLAYBOOK
 ].join('\n');
@@ -3147,7 +3151,7 @@ function executeAiAssistantMongoAggregate(payload, context) {
 }
 function verifyAssistantAggregateReliability(params) {
     return __awaiter(this, void 0, void 0, function () {
-        var collection, collectionBase, monthKey, amountKey, baseMap, groupIndex, groupPaths, dateField, mergedMatch, dateFieldsInMatch, baseMatchNoDate, primaryDateCondition, verifyPipeline, verifyDocs, _a, verifyMap, comparedMonths, paidCloserCount, grandCloserCount, sumPaidDiffPct, sumGrandDiffPct, maxPaidDiffPct, maxGrandDiffPct, sumPaidGrandGapPct, highVarianceMonths, checks, warnings, avgPaidDiffPct, avgGrandDiffPct, avgPaidGrandGapPct, baselineMetric, rollingWindow, rollingWindowBounds, verificationWindow, rollingStart, rollingEnd, fullMonthStart, fullMonthEndExclusive, normalizedMetric, bounds, fullMonthMatch, fullMonthDocs, fullMonthMap, fullMonthDiff, _b, alternateDateField, alternateDateCondition, bounds, alternateMatch, alternateDocs, alternateMap, alternateDiff, _c;
+        var collection, collectionBase, monthKey, amountKey, baseMap, groupIndex, groupPaths, dateField, mergedMatch, dateFieldsInMatch, baseMatchNoDate, primaryDateCondition, verifyPipeline, verifyDocs, _a, verifyMap, comparedMonths, paidCloserCount, grandCloserCount, sumPaidDiffPct, sumGrandDiffPct, maxPaidDiffPct, maxGrandDiffPct, sumPaidGrandGapPct, highVarianceMonths, checks, warnings, avgPaidDiffPct, avgGrandDiffPct, avgPaidGrandGapPct, baselineMetric, rollingWindow, fullMonthWindow, rollingWindowBounds, fullMonthWindowBounds, verificationWindow, rollingStart, rollingEnd, fullMonthStart, fullMonthEndExclusive, fullMonthStart, fullMonthEndExclusive, fullMonthEndInclusiveDate, fullMonthEnd, normalizedMetric, bounds, fullMonthMatch, fullMonthDocs, fullMonthMap, fullMonthDiff, _b, alternateDateField, alternateDateCondition, bounds, bounds, alternateMatch, alternateDocs, alternateMap, alternateDiff, _c;
         var _d, _e;
         var _f;
         return __generator(this, function (_g) {
@@ -3225,9 +3229,8 @@ function verifyAssistantAggregateReliability(params) {
                         comparedMonths += 1;
                         var paidDiff = Math.abs(value - match.paid);
                         var grandDiff = Math.abs(value - match.grand);
-                        var denom = Math.max(Math.abs(value), 1);
-                        var paidPct = paidDiff / denom;
-                        var grandPct = grandDiff / denom;
+                        var paidPct = computeAssistantRelativeDiffPct(value, match.paid);
+                        var grandPct = computeAssistantRelativeDiffPct(value, match.grand);
                         sumPaidDiffPct += paidPct;
                         sumGrandDiffPct += grandPct;
                         maxPaidDiffPct = Math.max(maxPaidDiffPct, paidPct);
@@ -3238,7 +3241,7 @@ function verifyAssistantAggregateReliability(params) {
                         else if (grandDiff < paidDiff) {
                             grandCloserCount += 1;
                         }
-                        var gapPct = Math.abs(match.paid - match.grand) / Math.max(Math.abs(match.grand), 1);
+                        var gapPct = computeAssistantRelativeDiffPct(match.paid, match.grand);
                         sumPaidGrandGapPct += gapPct;
                         if (Math.min(paidPct, grandPct) >= AI_ASSISTANT_REVENUE_VERIFY_DIFF_WARN_THRESHOLD) {
                             highVarianceMonths.push(month);
@@ -3288,7 +3291,9 @@ function verifyAssistantAggregateReliability(params) {
                         }
                     }
                     rollingWindow = detectAssistantRollingMonthWindow(params.pipeline || []);
+                    fullMonthWindow = detectAssistantFullMonthWindow(params.pipeline || []);
                     rollingWindowBounds = null;
+                    fullMonthWindowBounds = null;
                     verificationWindow = null;
                     if ((rollingWindow === null || rollingWindow === void 0 ? void 0 : rollingWindow.months) && (rollingWindow === null || rollingWindow === void 0 ? void 0 : rollingWindow.upperNow)) {
                         rollingWindowBounds = resolveAssistantRollingWindowBounds(rollingWindow.months);
@@ -3312,6 +3317,27 @@ function verifyAssistantAggregateReliability(params) {
                         });
                         warnings.push("Date window is rolling (".concat(rollingStart, " to ").concat(rollingEnd, " UTC; last ").concat(rollingWindow.months, " months), so first/current months may be partial."));
                     }
+                    else if ((fullMonthWindow === null || fullMonthWindow === void 0 ? void 0 : fullMonthWindow.months) && (fullMonthWindow === null || fullMonthWindow === void 0 ? void 0 : fullMonthWindow.upperMonthStart)) {
+                        fullMonthWindowBounds = resolveAssistantRollingWindowBounds(fullMonthWindow.months);
+                        fullMonthStart = formatAssistantIsoDateOnly(fullMonthWindowBounds.startOfWindow);
+                        fullMonthEndExclusive = formatAssistantIsoDateOnly(fullMonthWindowBounds.startOfCurrentMonth);
+                        fullMonthEndInclusiveDate = new Date(fullMonthWindowBounds.startOfCurrentMonth);
+                        fullMonthEndInclusiveDate.setUTCDate(fullMonthEndInclusiveDate.getUTCDate() - 1);
+                        fullMonthEnd = formatAssistantIsoDateOnly(fullMonthEndInclusiveDate);
+                        verificationWindow = {
+                            type: 'full_month_last_n_months',
+                            months: fullMonthWindow.months,
+                            startDate: fullMonthStart,
+                            endDate: fullMonthEnd,
+                            endDateExclusive: fullMonthEndExclusive,
+                            timezone: 'UTC'
+                        };
+                        checks.push({
+                            name: 'Date window shape',
+                            status: 'pass',
+                            details: "Query uses full-month calendar bounds (".concat(fullMonthStart, " to ").concat(fullMonthEnd, " UTC; last ").concat(fullMonthWindow.months, " full months).")
+                        });
+                    }
                     else {
                         checks.push({
                             name: 'Date window shape',
@@ -3345,7 +3371,7 @@ function verifyAssistantAggregateReliability(params) {
                             ? "Compared ".concat(fullMonthDiff.comparedMonths, " month(s); avg diff ").concat((0, common_1.round)(fullMonthDiff.avgDiffPct * 100, 2), "%.")
                             : 'No overlapping months for full-month cross-check.'
                     });
-                    if (fullMonthDiff.comparedMonths && fullMonthDiff.avgDiffPct >= AI_ASSISTANT_REVENUE_VERIFY_DIFF_WARN_THRESHOLD) {
+                    if (fullMonthDiff.comparedMonths >= 2 && fullMonthDiff.avgDiffPct >= AI_ASSISTANT_REVENUE_VERIFY_DIFF_WARN_THRESHOLD) {
                         warnings.push("Rolling-window totals differ from full-month totals by ".concat((0, common_1.round)(fullMonthDiff.avgDiffPct * 100, 2), "% on average."));
                     }
                     if (!fullMonthDiff.comparedMonths) {
@@ -3376,6 +3402,13 @@ function verifyAssistantAggregateReliability(params) {
                             $lte: bounds.now
                         };
                     }
+                    else if ((fullMonthWindow === null || fullMonthWindow === void 0 ? void 0 : fullMonthWindow.months) && (fullMonthWindow === null || fullMonthWindow === void 0 ? void 0 : fullMonthWindow.upperMonthStart) && fullMonthWindowBounds) {
+                        bounds = fullMonthWindowBounds;
+                        alternateDateCondition = {
+                            $gte: bounds.startOfWindow,
+                            $lt: bounds.startOfCurrentMonth
+                        };
+                    }
                     else if (primaryDateCondition && typeof primaryDateCondition === 'object') {
                         alternateDateCondition = primaryDateCondition;
                     }
@@ -3398,7 +3431,7 @@ function verifyAssistantAggregateReliability(params) {
                             ? "Compared ".concat(alternateDiff.comparedMonths, " month(s); avg diff ").concat((0, common_1.round)(alternateDiff.avgDiffPct * 100, 2), "%.")
                             : 'No overlapping months for alternate date-field cross-check.'
                     });
-                    if (alternateDiff.comparedMonths && alternateDiff.avgDiffPct >= AI_ASSISTANT_REVENUE_VERIFY_DIFF_WARN_THRESHOLD) {
+                    if (alternateDiff.comparedMonths >= 2 && alternateDiff.avgDiffPct >= AI_ASSISTANT_REVENUE_VERIFY_DIFF_WARN_THRESHOLD) {
                         warnings.push("Switching from ".concat(dateField, " to ").concat(alternateDateField, " changes monthly totals by ").concat((0, common_1.round)(alternateDiff.avgDiffPct * 100, 2), "% on average."));
                     }
                     return [3 /*break*/, 12];
@@ -3536,22 +3569,23 @@ function mergeAssistantPreGroupMatchStages(pipeline, groupIndex) {
     return { $and: matches };
 }
 function detectAssistantRollingMonthWindow(pipeline) {
-    var raw = JSON.stringify(Array.isArray(pipeline) ? pipeline : []);
-    if (!raw) {
-        return null;
-    }
-    var amountMatch = raw.match(/"\$dateSubtract":\{"startDate":"\$\$NOW","unit":"month","amount":([0-9]+)\}/);
-    if (!amountMatch) {
+    var detected = detectAssistantMonthWindowFromPipeline(pipeline);
+    if (!detected || detected.mode !== 'rolling') {
         return null;
     }
-    var months = Number(amountMatch[1]);
-    if (!Number.isFinite(months) || months < 1) {
+    return {
+        months: detected.months,
+        upperNow: true
+    };
+}
+function detectAssistantFullMonthWindow(pipeline) {
+    var detected = detectAssistantMonthWindowFromPipeline(pipeline);
+    if (!detected || detected.mode !== 'full_month') {
         return null;
     }
-    var nowCount = (raw.match(/\$\$NOW/g) || []).length;
     return {
-        months: months,
-        upperNow: nowCount >= 2
+        months: detected.months,
+        upperMonthStart: true
     };
 }
 function buildAssistantMonthlyRevenueVerificationPipeline(match, dateField) {
@@ -3622,6 +3656,12 @@ function mapAssistantMetricByMonth(source, metric) {
     });
     return mapped;
 }
+function computeAssistantRelativeDiffPct(baseValue, compareValue) {
+    var left = Number.isFinite(baseValue) ? baseValue : 0;
+    var right = Number.isFinite(compareValue) ? compareValue : 0;
+    var denom = Math.max(Math.abs(left), Math.abs(right), 1);
+    return Math.abs(left - right) / denom;
+}
 function compareAssistantMonthlyValueMaps(base, compare) {
     var comparedMonths = 0;
     var sumDiffPct = 0;
@@ -3631,7 +3671,7 @@ function compareAssistantMonthlyValueMaps(base, compare) {
         if (typeof compareValue !== 'number') {
             return;
         }
-        var diffPct = Math.abs(baseValue - compareValue) / Math.max(Math.abs(baseValue), 1);
+        var diffPct = computeAssistantRelativeDiffPct(baseValue, compareValue);
         comparedMonths += 1;
         sumDiffPct += diffPct;
         maxDiffPct = Math.max(maxDiffPct, diffPct);
@@ -3888,7 +3928,7 @@ function buildAssistantCodexToolFollowupPrompt(message, attachmentText, historyT
     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 REPORT_BUILDER_* directive. Output plain Markdown. Summarize first, then include a Markdown table. If the Tool Result includes Verification warnings, explicitly include them and call out the metric/date basis used.';
+    var instruction = '\n\nInstruction:\nNow answer the user. Do NOT output another REPORT_BUILDER_* directive. Output plain Markdown. Summarize first, then include a Markdown table. If the Tool Result includes Verification warnings, explicitly include them and call out the metric/date basis used. Include explicit UTC date boundaries and never show placeholders like $$NOW.';
     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) {
@@ -3939,8 +3979,18 @@ function applyAssistantDatedReportWindow(value, toolResult) {
     if (!startDate || !endDate) {
         return content || value || '';
     }
+    var mode = normalizeOptionalString(window === null || window === void 0 ? void 0 : window.mode).toLowerCase();
     var months = normalizeOptionalNumber(window === null || window === void 0 ? void 0 : window.months);
-    var monthsText = months && months > 0 ? "; rolling last ".concat((0, common_1.round)(months), " month").concat((0, common_1.round)(months) === 1 ? '' : 's') : '';
+    var monthsText = '';
+    if (months && months > 0) {
+        var count = (0, common_1.round)(months);
+        if (mode === 'full_month') {
+            monthsText = "; last ".concat(count, " full month").concat(count === 1 ? '' : 's');
+        }
+        else if (mode === 'rolling') {
+            monthsText = "; rolling last ".concat(count, " month").concat(count === 1 ? '' : 's');
+        }
+    }
     var line = "Report date range (UTC): ".concat(startDate, " to ").concat(endDate).concat(monthsText, ".");
     var normalizedLower = String(content || '').toLowerCase();
     if (normalizedLower.includes(startDate.toLowerCase()) && normalizedLower.includes(endDate.toLowerCase())) {
@@ -3958,10 +4008,19 @@ function resolveAssistantDatedReportWindow(toolResult) {
     var verificationStart = normalizeOptionalString(verificationWindow === null || verificationWindow === void 0 ? void 0 : verificationWindow.startDate);
     var verificationEnd = normalizeOptionalString(verificationWindow === null || verificationWindow === void 0 ? void 0 : verificationWindow.endDate);
     if (verificationStart && verificationEnd) {
+        var verificationType = normalizeOptionalString(verificationWindow === null || verificationWindow === void 0 ? void 0 : verificationWindow.type).toLowerCase();
+        var mode = void 0;
+        if (verificationType.includes('full_month')) {
+            mode = 'full_month';
+        }
+        else if (verificationType.includes('rolling')) {
+            mode = 'rolling';
+        }
         return {
             startDate: verificationStart,
             endDate: verificationEnd,
-            months: normalizeOptionalNumber(verificationWindow === null || verificationWindow === void 0 ? void 0 : verificationWindow.months) || undefined
+            months: normalizeOptionalNumber(verificationWindow === null || verificationWindow === void 0 ? void 0 : verificationWindow.months) || undefined,
+            mode: mode
         };
     }
     var pipelineCandidates = [
@@ -3975,6 +4034,22 @@ function resolveAssistantDatedReportWindow(toolResult) {
             if (!Array.isArray(candidate)) {
                 continue;
             }
+            var fullMonthWindow = detectAssistantFullMonthWindow(candidate);
+            if ((fullMonthWindow === null || fullMonthWindow === void 0 ? void 0 : fullMonthWindow.months) && (fullMonthWindow === null || fullMonthWindow === void 0 ? void 0 : fullMonthWindow.upperMonthStart)) {
+                var bounds_1 = resolveAssistantRollingWindowBounds(fullMonthWindow.months);
+                var startDate_1 = formatAssistantIsoDateOnly(bounds_1.startOfWindow);
+                var endDateValue = new Date(bounds_1.startOfCurrentMonth);
+                endDateValue.setUTCDate(endDateValue.getUTCDate() - 1);
+                var endDate_1 = formatAssistantIsoDateOnly(endDateValue);
+                if (startDate_1 && endDate_1) {
+                    return {
+                        startDate: startDate_1,
+                        endDate: endDate_1,
+                        months: fullMonthWindow.months,
+                        mode: 'full_month'
+                    };
+                }
+            }
             var rollingWindow = detectAssistantRollingMonthWindow(candidate);
             if (!(rollingWindow === null || rollingWindow === void 0 ? void 0 : rollingWindow.months) || !(rollingWindow === null || rollingWindow === void 0 ? void 0 : rollingWindow.upperNow)) {
                 continue;
@@ -3988,7 +4063,8 @@ function resolveAssistantDatedReportWindow(toolResult) {
             return {
                 startDate: startDate,
                 endDate: endDate,
-                months: rollingWindow.months
+                months: rollingWindow.months,
+                mode: 'rolling'
             };
         }
     }
@@ -4193,7 +4269,7 @@ function buildAssistantToolErrorMessage(error) {
     if (normalized.includes('invalid character for a variable name') && (normalized.includes('now-') || normalized.includes('now+'))) {
         return 'The query used an unsupported relative date token. Please retry and I will normalize the date expression.';
     }
-    if (normalized.includes('unrecognized argument to $datesubtract: date') || normalized.includes('unrecognized argument to $dateadd: date')) {
+    if (normalized.includes('unrecognized argument to $datesubtract:') || normalized.includes('unrecognized argument to $dateadd:')) {
         return 'The data query failed because of an invalid date expression argument. Please retry; date arithmetic arguments are now normalized automatically.';
     }
     if (normalized.includes('report builder bridge') && normalized.includes('not configured')) {
@@ -5923,9 +5999,13 @@ function isAssistantMarkdownTableRowLine(line) {
     return /^\|.*\|$/.test(trimmed);
 }
 function applyAssistantDisplayTableToResponse(value, display) {
-    if (!display || !Array.isArray(display.rows) || !display.rows.length) {
+    if (!display || !Array.isArray(display.rows)) {
         return value;
     }
+    if (!display.rows.length) {
+        // Remove any model-generated placeholder table when tool data has no rows.
+        return stripAssistantMarkdownTables(value);
+    }
     var table = formatDisplayTableMarkdown(display);
     if (!table) {
         return value;
@@ -6204,6 +6284,45 @@ function normalizeAssistantDateArithmeticArgs(expression) {
         if (Object.prototype.hasOwnProperty.call(nextArgs, 'start')) {
             delete nextArgs.start;
         }
+        var allowedKeys = new Set(['startDate', 'unit', 'amount', 'timezone']);
+        var unknownKeys = Object.keys(nextArgs).filter(function (key) { return !allowedKeys.has(key); });
+        if (!Object.prototype.hasOwnProperty.call(nextArgs, 'startDate')) {
+            var startCandidateKey = unknownKeys.find(function (key) {
+                var candidate = nextArgs[key];
+                if (candidate instanceof Date) {
+                    return true;
+                }
+                if (typeof candidate === 'string') {
+                    return candidate.startsWith('$$') || candidate.startsWith('$');
+                }
+                if (candidate && typeof candidate === 'object' && !Array.isArray(candidate)) {
+                    return Object.keys(candidate).some(function (op) { return op.startsWith('$'); });
+                }
+                return false;
+            });
+            if (startCandidateKey) {
+                nextArgs.startDate = nextArgs[startCandidateKey];
+                delete nextArgs[startCandidateKey];
+            }
+        }
+        if (!Object.prototype.hasOwnProperty.call(nextArgs, 'amount')) {
+            var amountCandidateKey = Object.keys(nextArgs).find(function (key) {
+                if (allowedKeys.has(key)) {
+                    return false;
+                }
+                var candidate = nextArgs[key];
+                return typeof candidate === 'number' && Number.isFinite(candidate);
+            });
+            if (amountCandidateKey) {
+                nextArgs.amount = nextArgs[amountCandidateKey];
+                delete nextArgs[amountCandidateKey];
+            }
+        }
+        Object.keys(nextArgs).forEach(function (key) {
+            if (!allowedKeys.has(key)) {
+                delete nextArgs[key];
+            }
+        });
         expression[operator] = nextArgs;
     };
     normalizeOperatorArgs('$dateAdd');
@@ -6237,10 +6356,8 @@ function isAssistantDateArithmeticArgumentError(error) {
     if (!message) {
         return false;
     }
-    return message.includes('unrecognized argument to $datesubtract: date')
-        || message.includes('unrecognized argument to $dateadd: date')
-        || message.includes('unrecognized argument to $datesubtract: start')
-        || message.includes('unrecognized argument to $dateadd: start');
+    return message.includes('unrecognized argument to $datesubtract:')
+        || message.includes('unrecognized argument to $dateadd:');
 }
 function didAssistantValueChange(before, after) {
     try {
@@ -6344,7 +6461,7 @@ function rewriteMatchExpressionsToExpr(match) {
     return rewriteValue(match);
 }
 function buildInvoiceStatusRegex(value) {
-    var normalized = String(value || '').toLowerCase();
+    var normalized = normalizeOptionalString(value).toLowerCase();
     if (!normalized) {
         return null;
     }
@@ -6354,6 +6471,31 @@ function buildInvoiceStatusRegex(value) {
     }
     return /paid|closed/i;
 }
+function buildInvoiceStatusRegexFromValue(value) {
+    if (typeof value === 'string') {
+        return buildInvoiceStatusRegex(value);
+    }
+    if (Array.isArray(value)) {
+        var normalizedValues = value
+            .filter(function (entry) { return typeof entry === 'string'; })
+            .map(function (entry) { return normalizeOptionalString(entry); })
+            .filter(Boolean);
+        if (!normalizedValues.length) {
+            return null;
+        }
+        return buildInvoiceStatusRegex(normalizedValues.join(' '));
+    }
+    if (value && typeof value === 'object' && !Array.isArray(value)) {
+        var keys = Object.keys(value);
+        if (keys.length === 1 && typeof value.$eq === 'string') {
+            return buildInvoiceStatusRegex(value.$eq);
+        }
+        if (keys.length === 1 && Array.isArray(value.$in)) {
+            return buildInvoiceStatusRegexFromValue(value.$in);
+        }
+    }
+    return null;
+}
 function normalizeInvoiceStatusMatch(match) {
     var rewriteValue = function (value) {
         if (Array.isArray(value)) {
@@ -6370,8 +6512,8 @@ function normalizeInvoiceStatusMatch(match) {
                 return;
             }
             var field = key.split('.').pop() || key;
-            if (field === 'status' && typeof entry === 'string') {
-                var regex = buildInvoiceStatusRegex(entry);
+            if (field === 'status' || field === 'state') {
+                var regex = buildInvoiceStatusRegexFromValue(entry);
                 if (regex) {
                     result[key] = regex;
                     return;
@@ -6387,12 +6529,299 @@ function normalizeInvoiceStatusMatch(match) {
     };
     return rewriteValue(match);
 }
+function extractAssistantFieldPathFromOperand(value) {
+    if (typeof value !== 'string') {
+        return '';
+    }
+    if (!value.startsWith('$') || value.startsWith('$$')) {
+        return '';
+    }
+    return value.slice(1);
+}
+function createAssistantNowMonthStartExpr() {
+    return {
+        $dateTrunc: {
+            date: '$$NOW',
+            unit: 'month'
+        }
+    };
+}
+function isAssistantNowMonthStartExpr(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return false;
+    }
+    var dateTrunc = value.$dateTrunc;
+    if (!dateTrunc || typeof dateTrunc !== 'object' || Array.isArray(dateTrunc)) {
+        return false;
+    }
+    if (dateTrunc.date !== '$$NOW') {
+        return false;
+    }
+    return normalizeOptionalString(dateTrunc.unit).toLowerCase() === 'month';
+}
+function extractAssistantMonthLowerBound(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return null;
+    }
+    var dateSubtract = value.$dateSubtract;
+    if (!dateSubtract || typeof dateSubtract !== 'object' || Array.isArray(dateSubtract)) {
+        return null;
+    }
+    var unit = normalizeOptionalString(dateSubtract.unit).toLowerCase();
+    var months = normalizeOptionalNumber(dateSubtract.amount);
+    if (unit !== 'month' || !months || months < 1) {
+        return null;
+    }
+    if (dateSubtract.startDate === '$$NOW') {
+        return { months: (0, common_1.round)(months), mode: 'rolling' };
+    }
+    if (isAssistantNowMonthStartExpr(dateSubtract.startDate)) {
+        return { months: (0, common_1.round)(months), mode: 'full_month' };
+    }
+    return null;
+}
+function flattenAssistantExprClauses(expr) {
+    if (!expr || typeof expr !== 'object' || Array.isArray(expr)) {
+        return [];
+    }
+    if (Array.isArray(expr.$and)) {
+        return expr.$and;
+    }
+    return [expr];
+}
+function detectAssistantMonthWindowInExpr(expr, allowedDateFields) {
+    var e_12, _a;
+    var clauses = flattenAssistantExprClauses(expr);
+    if (!clauses.length) {
+        return null;
+    }
+    var lowerClauses = [];
+    var upperClauses = [];
+    clauses.forEach(function (clause, index) {
+        if (!clause || typeof clause !== 'object' || Array.isArray(clause)) {
+            return;
+        }
+        var keys = Object.keys(clause);
+        if (keys.length !== 1) {
+            return;
+        }
+        var operator = keys[0];
+        if (!['$gte', '$gt', '$lte', '$lt'].includes(operator)) {
+            return;
+        }
+        var operands = clause[operator];
+        if (!Array.isArray(operands) || operands.length !== 2) {
+            return;
+        }
+        var field = extractAssistantFieldPathFromOperand(operands[0]);
+        if (!field) {
+            return;
+        }
+        if ((allowedDateFields === null || allowedDateFields === void 0 ? void 0 : allowedDateFields.size) && !allowedDateFields.has(field)) {
+            return;
+        }
+        if (operator === '$gte' || operator === '$gt') {
+            var lowerBound = extractAssistantMonthLowerBound(operands[1]);
+            if (!lowerBound) {
+                return;
+            }
+            lowerClauses.push({
+                index: index,
+                field: field,
+                months: lowerBound.months,
+                mode: lowerBound.mode
+            });
+            return;
+        }
+        if (operands[1] === '$$NOW') {
+            upperClauses.push({ index: index, field: field, mode: 'rolling' });
+            return;
+        }
+        if (isAssistantNowMonthStartExpr(operands[1])) {
+            upperClauses.push({ index: index, field: field, mode: 'full_month' });
+        }
+    });
+    var _loop_6 = function (lower) {
+        var upper = upperClauses.find(function (candidate) { return (candidate.field === lower.field
+            && candidate.mode === lower.mode); });
+        if (!upper) {
+            return "continue";
+        }
+        return { value: {
+                field: lower.field,
+                months: lower.months,
+                mode: lower.mode,
+                lowerIndex: lower.index,
+                upperIndex: upper.index,
+                clauses: clauses
+            } };
+    };
+    try {
+        for (var lowerClauses_1 = __values(lowerClauses), lowerClauses_1_1 = lowerClauses_1.next(); !lowerClauses_1_1.done; lowerClauses_1_1 = lowerClauses_1.next()) {
+            var lower = lowerClauses_1_1.value;
+            var state_4 = _loop_6(lower);
+            if (typeof state_4 === "object")
+                return state_4.value;
+        }
+    }
+    catch (e_12_1) { e_12 = { error: e_12_1 }; }
+    finally {
+        try {
+            if (lowerClauses_1_1 && !lowerClauses_1_1.done && (_a = lowerClauses_1.return)) _a.call(lowerClauses_1);
+        }
+        finally { if (e_12) throw e_12.error; }
+    }
+    return null;
+}
+function isAssistantMonthDateFormat(format) {
+    var normalized = normalizeOptionalString(format);
+    if (!normalized) {
+        return false;
+    }
+    if (!/%m/.test(normalized)) {
+        return false;
+    }
+    return !/(%d|%j|%H|%I|%M|%S|%U|%V|%W|%w)/.test(normalized);
+}
+function collectAssistantMonthlyGroupDateFields(value, output) {
+    if (Array.isArray(value)) {
+        value.forEach(function (entry) { return collectAssistantMonthlyGroupDateFields(entry, output); });
+        return;
+    }
+    if (!value || typeof value !== 'object') {
+        return;
+    }
+    var dateToString = value.$dateToString;
+    if (dateToString && typeof dateToString === 'object' && !Array.isArray(dateToString)) {
+        var format = normalizeOptionalString(dateToString.format);
+        var field = extractAssistantFieldPathFromOperand(dateToString.date);
+        if (field && isAssistantMonthDateFormat(format)) {
+            output.add(field);
+        }
+    }
+    var dateTrunc = value.$dateTrunc;
+    if (dateTrunc && typeof dateTrunc === 'object' && !Array.isArray(dateTrunc)) {
+        var unit = normalizeOptionalString(dateTrunc.unit).toLowerCase();
+        var field = extractAssistantFieldPathFromOperand(dateTrunc.date);
+        if (field && unit === 'month') {
+            output.add(field);
+        }
+    }
+    var monthExpr = value.$month;
+    if (monthExpr !== undefined) {
+        var field = extractAssistantFieldPathFromOperand(monthExpr);
+        if (field) {
+            output.add(field);
+        }
+    }
+    Object.keys(value).forEach(function (key) {
+        collectAssistantMonthlyGroupDateFields(value[key], output);
+    });
+}
+function resolveAssistantMonthlyGroupDateFields(pipeline) {
+    var fields = new Set();
+    var groupIndex = findAggregateGroupIndex(pipeline);
+    if (groupIndex === -1) {
+        return fields;
+    }
+    var groupStage = pipeline[groupIndex];
+    if (!groupStage || typeof groupStage !== 'object' || !groupStage.$group || typeof groupStage.$group !== 'object') {
+        return fields;
+    }
+    collectAssistantMonthlyGroupDateFields(groupStage.$group, fields);
+    return fields;
+}
+function detectAssistantMonthWindowFromPipeline(pipeline) {
+    var e_13, _a;
+    var _b;
+    var monthlyFields = resolveAssistantMonthlyGroupDateFields(pipeline);
+    var scanMatch = function (match) {
+        if (!match || typeof match !== 'object' || Array.isArray(match)) {
+            return null;
+        }
+        if (!match.$expr || typeof match.$expr !== 'object') {
+            return null;
+        }
+        return detectAssistantMonthWindowInExpr(match.$expr, monthlyFields);
+    };
+    try {
+        for (var _c = __values((pipeline || [])), _d = _c.next(); !_d.done; _d = _c.next()) {
+            var stage = _d.value;
+            if (!stage || typeof stage !== 'object') {
+                continue;
+            }
+            var directMatch = scanMatch(stage.$match);
+            if (directMatch) {
+                return directMatch;
+            }
+            var geoNearMatch = scanMatch((_b = stage.$geoNear) === null || _b === void 0 ? void 0 : _b.query);
+            if (geoNearMatch) {
+                return geoNearMatch;
+            }
+        }
+    }
+    catch (e_13_1) { e_13 = { error: e_13_1 }; }
+    finally {
+        try {
+            if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
+        }
+        finally { if (e_13) throw e_13.error; }
+    }
+    return null;
+}
+function normalizeAssistantMonthlyCalendarWindowPipeline(pipeline) {
+    var monthlyFields = resolveAssistantMonthlyGroupDateFields(pipeline);
+    if (!monthlyFields.size) {
+        return pipeline;
+    }
+    return (pipeline || []).map(function (stage) {
+        if (!stage || typeof stage !== 'object' || Array.isArray(stage)) {
+            return stage;
+        }
+        var rewriteMatch = function (match) {
+            if (!match || typeof match !== 'object' || Array.isArray(match) || !match.$expr) {
+                return match;
+            }
+            var detection = detectAssistantMonthWindowInExpr(match.$expr, monthlyFields);
+            if (!detection || detection.mode !== 'rolling') {
+                return match;
+            }
+            var nextClauses = detection.clauses.filter(function (_entry, index) { return (index !== detection.lowerIndex && index !== detection.upperIndex); });
+            nextClauses.push({
+                $gte: [
+                    "$".concat(detection.field),
+                    {
+                        $dateSubtract: {
+                            startDate: createAssistantNowMonthStartExpr(),
+                            unit: 'month',
+                            amount: detection.months
+                        }
+                    }
+                ]
+            }, {
+                $lt: [
+                    "$".concat(detection.field),
+                    createAssistantNowMonthStartExpr()
+                ]
+            });
+            return __assign(__assign({}, match), { $expr: nextClauses.length === 1 ? nextClauses[0] : { $and: nextClauses } });
+        };
+        var next = __assign({}, stage);
+        if (next.$match && typeof next.$match === 'object') {
+            next.$match = rewriteMatch(next.$match);
+        }
+        if (next.$geoNear && typeof next.$geoNear === 'object' && next.$geoNear.query) {
+            next.$geoNear = __assign(__assign({}, next.$geoNear), { query: rewriteMatch(next.$geoNear.query) });
+        }
+        return next;
+    });
+}
 function normalizeAssistantAggregatePipeline(pipeline, collection) {
     if (!Array.isArray(pipeline)) {
         return [];
     }
     var isInvoiceCollection = ['invoice', 'invoices', 'invoice-versions'].includes(String(collection || '').toLowerCase());
-    return pipeline
+    var normalizedPipeline = pipeline
         .filter(function (stage) { return stage && typeof stage === 'object' && !Array.isArray(stage); })
         .map(function (stage) {
         var next = __assign({}, stage);
@@ -6410,6 +6839,7 @@ function normalizeAssistantAggregatePipeline(pipeline, collection) {
         }
         return normalizeAssistantNowExprPlaceholdersDeep(next);
     });
+    return normalizeAssistantMonthlyCalendarWindowPipeline(normalizedPipeline);
 }
 function buildAssistantAggregatePipeline(query, pipeline) {
     var _a;
@@ -6538,7 +6968,7 @@ function matchContainsField(value, field) {
     });
 }
 function resolveAggregateCompletionFallback(pipeline) {
-    var e_12, _a;
+    var e_14, _a;
     if (!Array.isArray(pipeline)) {
         return null;
     }
@@ -6551,7 +6981,7 @@ function resolveAggregateCompletionFallback(pipeline) {
         }
         var addFields = stage.$addFields;
         try {
-            for (var _b = (e_12 = void 0, __values(Object.keys(addFields))), _c = _b.next(); !_c.done; _c = _b.next()) {
+            for (var _b = (e_14 = void 0, __values(Object.keys(addFields))), _c = _b.next(); !_c.done; _c = _b.next()) {
                 var key = _c.value;
                 if (!isCompletionFieldName(key)) {
                     continue;
@@ -6565,12 +6995,12 @@ function resolveAggregateCompletionFallback(pipeline) {
                 }
             }
         }
-        catch (e_12_1) { e_12 = { error: e_12_1 }; }
+        catch (e_14_1) { e_14 = { error: e_14_1 }; }
         finally {
             try {
                 if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
             }
-            finally { if (e_12) throw e_12.error; }
+            finally { if (e_14) throw e_14.error; }
         }
         if (candidateField) {
             break;
@@ -6726,7 +7156,7 @@ function buildCompletionFallbackSources(field) {
     ]);
 }
 function resolveAggregateCompletionExprFallback(pipeline) {
-    var e_13, _a;
+    var e_15, _a;
     if (!Array.isArray(pipeline)) {
         return null;
     }
@@ -6746,7 +7176,7 @@ function resolveAggregateCompletionExprFallback(pipeline) {
         }
         if (!candidateField) {
             try {
-                for (var _b = (e_13 = void 0, __values(Object.keys(matchStage))), _c = _b.next(); !_c.done; _c = _b.next()) {
+                for (var _b = (e_15 = void 0, __values(Object.keys(matchStage))), _c = _b.next(); !_c.done; _c = _b.next()) {
                     var key = _c.value;
                     if (key.startsWith('$')) {
                         continue;
@@ -6761,12 +7191,12 @@ function resolveAggregateCompletionExprFallback(pipeline) {
                     }
                 }
             }
-            catch (e_13_1) { e_13 = { error: e_13_1 }; }
+            catch (e_15_1) { e_15 = { error: e_15_1 }; }
             finally {
                 try {
                     if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
                 }
-                finally { if (e_13) throw e_13.error; }
+                finally { if (e_15) throw e_15.error; }
             }
         }
         if (!candidateField) {
@@ -6936,7 +7366,7 @@ function isRegexMatchCondition(value) {
     return false;
 }
 function findRegexMatchInMatchObject(match, prefix) {
-    var e_14, _a, e_15, _b;
+    var e_16, _a, e_17, _b;
     if (prefix === void 0) { prefix = ''; }
     if (Array.isArray(match)) {
         try {
@@ -6948,12 +7378,12 @@ function findRegexMatchInMatchObject(match, prefix) {
                 }
             }
         }
-        catch (e_14_1) { e_14 = { error: e_14_1 }; }
+        catch (e_16_1) { e_16 = { error: e_16_1 }; }
         finally {
             try {
                 if (match_1_1 && !match_1_1.done && (_a = match_1.return)) _a.call(match_1);
             }
-            finally { if (e_14) throw e_14.error; }
+            finally { if (e_16) throw e_16.error; }
         }
         return null;
     }
@@ -6984,12 +7414,12 @@ function findRegexMatchInMatchObject(match, prefix) {
             }
         }
     }
-    catch (e_15_1) { e_15 = { error: e_15_1 }; }
+    catch (e_17_1) { e_17 = { error: e_17_1 }; }
     finally {
         try {
             if (keys_2_1 && !keys_2_1.done && (_b = keys_2.return)) _b.call(keys_2);
         }
-        finally { if (e_15) throw e_15.error; }
+        finally { if (e_17) throw e_17.error; }
     }
     return null;
 }
@@ -7213,7 +7643,7 @@ function collectMatchFieldsByCondition(match, predicate, prefix) {
     return results;
 }
 function findMatchConditionForField(match, targetField, prefix) {
-    var e_16, _a, e_17, _b;
+    var e_18, _a, e_19, _b;
     if (prefix === void 0) { prefix = ''; }
     if (!match || typeof match !== 'object') {
         return undefined;
@@ -7228,12 +7658,12 @@ function findMatchConditionForField(match, targetField, prefix) {
                 }
             }
         }
-        catch (e_16_1) { e_16 = { error: e_16_1 }; }
+        catch (e_18_1) { e_18 = { error: e_18_1 }; }
         finally {
             try {
                 if (match_2_1 && !match_2_1.done && (_a = match_2.return)) _a.call(match_2);
             }
-            finally { if (e_16) throw e_16.error; }
+            finally { if (e_18) throw e_18.error; }
         }
         return undefined;
     }
@@ -7260,12 +7690,12 @@ function findMatchConditionForField(match, targetField, prefix) {
             }
         }
     }
-    catch (e_17_1) { e_17 = { error: e_17_1 }; }
+    catch (e_19_1) { e_19 = { error: e_19_1 }; }
     finally {
         try {
             if (_d && !_d.done && (_b = _c.return)) _b.call(_c);
         }
-        finally { if (e_17) throw e_17.error; }
+        finally { if (e_19) throw e_19.error; }
     }
     return undefined;
 }
@@ -7308,7 +7738,7 @@ function detectIdLikeValue(value) {
     return false;
 }
 function detectChemicalIdFromProbe(probeDocs, fields) {
-    var e_18, _a, e_19, _b;
+    var e_20, _a, e_21, _b;
     if (!Array.isArray(probeDocs) || !probeDocs.length) {
         return false;
     }
@@ -7320,7 +7750,7 @@ function detectChemicalIdFromProbe(probeDocs, fields) {
         for (var probeDocs_1 = __values(probeDocs), probeDocs_1_1 = probeDocs_1.next(); !probeDocs_1_1.done; probeDocs_1_1 = probeDocs_1.next()) {
             var doc = probeDocs_1_1.value;
             try {
-                for (var targets_1 = (e_19 = void 0, __values(targets)), targets_1_1 = targets_1.next(); !targets_1_1.done; targets_1_1 = targets_1.next()) {
+                for (var targets_1 = (e_21 = void 0, __values(targets)), targets_1_1 = targets_1.next(); !targets_1_1.done; targets_1_1 = targets_1.next()) {
                     var field = targets_1_1.value;
                     var value = getValueAtPath(doc, field);
                     if (Array.isArray(value)) {
@@ -7333,21 +7763,21 @@ function detectChemicalIdFromProbe(probeDocs, fields) {
                     }
                 }
             }
-            catch (e_19_1) { e_19 = { error: e_19_1 }; }
+            catch (e_21_1) { e_21 = { error: e_21_1 }; }
             finally {
                 try {
                     if (targets_1_1 && !targets_1_1.done && (_b = targets_1.return)) _b.call(targets_1);
                 }
-                finally { if (e_19) throw e_19.error; }
+                finally { if (e_21) throw e_21.error; }
             }
         }
     }
-    catch (e_18_1) { e_18 = { error: e_18_1 }; }
+    catch (e_20_1) { e_20 = { error: e_20_1 }; }
     finally {
         try {
             if (probeDocs_1_1 && !probeDocs_1_1.done && (_a = probeDocs_1.return)) _a.call(probeDocs_1);
         }
-        finally { if (e_18) throw e_18.error; }
+        finally { if (e_20) throw e_20.error; }
     }
     return false;
 }
@@ -7568,8 +7998,8 @@ function buildChemicalIdFieldCandidates(field) {
 }
 function applyChemicalNameLookupFallbackToQuery(params) {
     return __awaiter(this, void 0, void 0, function () {
-        var query, db, dbName, idClient, idCustomer, isSuperAdmin, probeDocs, chemicalFields, targetField, condition, regex, sampleDocs, collectionNames, candidates, _loop_6, candidates_2, candidates_2_1, candidate, state_4, e_20_1;
-        var e_20, _a;
+        var query, db, dbName, idClient, idCustomer, isSuperAdmin, probeDocs, chemicalFields, targetField, condition, regex, sampleDocs, collectionNames, candidates, _loop_7, candidates_2, candidates_2_1, candidate, state_5, e_22_1;
+        var e_22, _a;
         var _b;
         return __generator(this, function (_c) {
             switch (_c.label) {
@@ -7593,7 +8023,7 @@ function applyChemicalNameLookupFallbackToQuery(params) {
                 case 1:
                     collectionNames = _c.sent();
                     candidates = resolveIdLookupCandidates('chemical', collectionNames);
-                    _loop_6 = function (candidate) {
+                    _loop_7 = function (candidate) {
                         var candidateHasClientScope, _d, candidateProbe, lookup, idFields, baseMatch, orConditions, nextMatch;
                         return __generator(this, function (_e) {
                             switch (_e.label) {
@@ -7671,25 +8101,25 @@ function applyChemicalNameLookupFallbackToQuery(params) {
                 case 3:
                     if (!!candidates_2_1.done) return [3 /*break*/, 6];
                     candidate = candidates_2_1.value;
-                    return [5 /*yield**/, _loop_6(candidate)];
+                    return [5 /*yield**/, _loop_7(candidate)];
                 case 4:
-                    state_4 = _c.sent();
-                    if (typeof state_4 === "object")
-                        return [2 /*return*/, state_4.value];
+                    state_5 = _c.sent();
+                    if (typeof state_5 === "object")
+                        return [2 /*return*/, state_5.value];
                     _c.label = 5;
                 case 5:
                     candidates_2_1 = candidates_2.next();
                     return [3 /*break*/, 3];
                 case 6: return [3 /*break*/, 9];
                 case 7:
-                    e_20_1 = _c.sent();
-                    e_20 = { error: e_20_1 };
+                    e_22_1 = _c.sent();
+                    e_22 = { error: e_22_1 };
                     return [3 /*break*/, 9];
                 case 8:
                     try {
                         if (candidates_2_1 && !candidates_2_1.done && (_a = candidates_2.return)) _a.call(candidates_2);
                     }
-                    finally { if (e_20) throw e_20.error; }
+                    finally { if (e_22) throw e_22.error; }
                     return [7 /*endfinally*/];
                 case 9: return [2 /*return*/, null];
             }
@@ -7783,8 +8213,8 @@ function lookupIdsForNameMatch(params) {
 }
 function applyIdLookupFallbackToQuery(params) {
     return __awaiter(this, void 0, void 0, function () {
-        var query, db, dbName, idClient, idCustomer, isSuperAdmin, probeDocs, conditions, collectionNames, _a, conditions_1, conditions_1_1, condition, regex, baseToken, targetFieldType, nextValue, localNameField, candidates, candidates_3, candidates_3_1, candidate, candidateHasClientScope, _b, candidateProbe, lookup, targetFieldType, normalizedIds, idsForQuery, e_21_1, e_22_1;
-        var e_22, _c, e_21, _d;
+        var query, db, dbName, idClient, idCustomer, isSuperAdmin, probeDocs, conditions, collectionNames, _a, conditions_1, conditions_1_1, condition, regex, baseToken, targetFieldType, nextValue, localNameField, candidates, candidates_3, candidates_3_1, candidate, candidateHasClientScope, _b, candidateProbe, lookup, targetFieldType, normalizedIds, idsForQuery, e_23_1, e_24_1;
+        var e_24, _c, e_23, _d;
         var _e;
         return __generator(this, function (_f) {
             switch (_f.label) {
@@ -7854,7 +8284,7 @@ function applyIdLookupFallbackToQuery(params) {
                     _f.label = 5;
                 case 5:
                     _f.trys.push([5, 14, 15, 16]);
-                    candidates_3 = (e_21 = void 0, __values(candidates)), candidates_3_1 = candidates_3.next();
+                    candidates_3 = (e_23 = void 0, __values(candidates)), candidates_3_1 = candidates_3.next();
                     _f.label = 6;
                 case 6:
                     if (!!candidates_3_1.done) return [3 /*break*/, 13];
@@ -7921,28 +8351,28 @@ function applyIdLookupFallbackToQuery(params) {
                     return [3 /*break*/, 6];
                 case 13: return [3 /*break*/, 16];
                 case 14:
-                    e_21_1 = _f.sent();
-                    e_21 = { error: e_21_1 };
+                    e_23_1 = _f.sent();
+                    e_23 = { error: e_23_1 };
                     return [3 /*break*/, 16];
                 case 15:
                     try {
                         if (candidates_3_1 && !candidates_3_1.done && (_d = candidates_3.return)) _d.call(candidates_3);
                     }
-                    finally { if (e_21) throw e_21.error; }
+                    finally { if (e_23) throw e_23.error; }
                     return [7 /*endfinally*/];
                 case 16:
                     conditions_1_1 = conditions_1.next();
                     return [3 /*break*/, 4];
                 case 17: return [3 /*break*/, 20];
                 case 18:
-                    e_22_1 = _f.sent();
-                    e_22 = { error: e_22_1 };
+                    e_24_1 = _f.sent();
+                    e_24 = { error: e_24_1 };
                     return [3 /*break*/, 20];
                 case 19:
                     try {
                         if (conditions_1_1 && !conditions_1_1.done && (_c = conditions_1.return)) _c.call(conditions_1);
                     }
-                    finally { if (e_22) throw e_22.error; }
+                    finally { if (e_24) throw e_24.error; }
                     return [7 /*endfinally*/];
                 case 20: return [2 /*return*/, null];
             }
@@ -8794,7 +9224,7 @@ function resolveAssistantReportBuilderBridgeCollection(collection) {
     throw new Error('AI assistant report builder bridge: Collection is not configured for report builder.');
 }
 function findQueryDateField(query) {
-    var e_23, _a, e_24, _b;
+    var e_25, _a, e_26, _b;
     if (!query || typeof query !== 'object') {
         return null;
     }
@@ -8808,12 +9238,12 @@ function findQueryDateField(query) {
                 }
             }
         }
-        catch (e_23_1) { e_23 = { error: e_23_1 }; }
+        catch (e_25_1) { e_25 = { error: e_25_1 }; }
         finally {
             try {
                 if (query_1_1 && !query_1_1.done && (_a = query_1.return)) _a.call(query_1);
             }
-            finally { if (e_23) throw e_23.error; }
+            finally { if (e_25) throw e_25.error; }
         }
         return null;
     }
@@ -8832,12 +9262,12 @@ function findQueryDateField(query) {
             }
         }
     }
-    catch (e_24_1) { e_24 = { error: e_24_1 }; }
+    catch (e_26_1) { e_26 = { error: e_26_1 }; }
     finally {
         try {
             if (_d && !_d.done && (_b = _c.return)) _b.call(_c);
         }
-        finally { if (e_24) throw e_24.error; }
+        finally { if (e_26) throw e_26.error; }
     }
     return null;
 }
@@ -8993,7 +9423,7 @@ function expandAggregateDateMatchFallback(pipeline) {
     if (!Array.isArray(pipeline)) {
         return null;
     }
-    var _loop_7 = function (i) {
+    var _loop_8 = function (i) {
         var stage = pipeline[i];
         if (!stage || typeof stage !== 'object' || !stage.$match || typeof stage.$match !== 'object') {
             return "continue";
@@ -9041,9 +9471,9 @@ function expandAggregateDateMatchFallback(pipeline) {
         return { value: { pipeline: updated, fields: Array.from(addedFields) } };
     };
     for (var i = 0; i < pipeline.length; i += 1) {
-        var state_5 = _loop_7(i);
-        if (typeof state_5 === "object")
-            return state_5.value;
+        var state_6 = _loop_8(i);
+        if (typeof state_6 === "object")
+            return state_6.value;
     }
     return null;
 }
@@ -9059,7 +9489,7 @@ function resolveQueryDateFieldFallback(query) {
     return { from: dateField, to: fallback };
 }
 function containsForbiddenMongoOperators(value) {
-    var e_25, _a;
+    var e_27, _a;
     if (!value || typeof value !== 'object') {
         return false;
     }
@@ -9078,12 +9508,12 @@ function containsForbiddenMongoOperators(value) {
             }
         }
     }
-    catch (e_25_1) { e_25 = { error: e_25_1 }; }
+    catch (e_27_1) { e_27 = { error: e_27_1 }; }
     finally {
         try {
             if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
         }
-        finally { if (e_25) throw e_25.error; }
+        finally { if (e_27) throw e_27.error; }
     }
     return false;
 }
@@ -9518,8 +9948,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_26_1;
-        var _e, e_26, _f, _g;
+        var _a, _b, _c, _d, message, payload, status_1, e_28_1;
+        var _e, e_28, _f, _g;
         return __generator(this, function (_h) {
             switch (_h.label) {
                 case 0:
@@ -9546,8 +9976,8 @@ function waitForCodexWorkerMessage(worker, streamStatusHandler) {
                     return [3 /*break*/, 1];
                 case 4: return [3 /*break*/, 11];
                 case 5:
-                    e_26_1 = _h.sent();
-                    e_26 = { error: e_26_1 };
+                    e_28_1 = _h.sent();
+                    e_28 = { error: e_28_1 };
                     return [3 /*break*/, 11];
                 case 6:
                     _h.trys.push([6, , 9, 10]);
@@ -9558,7 +9988,7 @@ function waitForCodexWorkerMessage(worker, streamStatusHandler) {
                     _h.label = 8;
                 case 8: return [3 /*break*/, 10];
                 case 9:
-                    if (e_26) throw e_26.error;
+                    if (e_28) throw e_28.error;
                     return [7 /*endfinally*/];
                 case 10: return [7 /*endfinally*/];
                 case 11: throw new CodexWorkerBootstrapError('Codex worker exited before completing.');
@@ -10164,7 +10594,7 @@ function resolveAssistantPlannerEnabled() {
     return raw === undefined ? true : raw === true;
 }
 function resolveAssistantPlannerKnownRoutes() {
-    var e_27, _a;
+    var e_29, _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 unique = new Set();
@@ -10177,12 +10607,12 @@ function resolveAssistantPlannerKnownRoutes() {
             }
         }
     }
-    catch (e_27_1) { e_27 = { error: e_27_1 }; }
+    catch (e_29_1) { e_29 = { error: e_29_1 }; }
     finally {
         try {
             if (routes_1_1 && !routes_1_1.done && (_a = routes_1.return)) _a.call(routes_1);
         }
-        finally { if (e_27) throw e_27.error; }
+        finally { if (e_29) throw e_29.error; }
     }
     return Array.from(unique).slice(0, AI_ASSISTANT_PLANNER_MAX_ROUTES);
 }
@@ -10425,7 +10855,7 @@ function normalizeRouteMatchKey(value) {
     return normalizeRouteKey(value).toLowerCase();
 }
 function buildClientRouteIndex() {
-    var e_28, _a;
+    var e_30, _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();
@@ -10444,12 +10874,12 @@ function buildClientRouteIndex() {
             }
         }
     }
-    catch (e_28_1) { e_28 = { error: e_28_1 }; }
+    catch (e_30_1) { e_30 = { error: e_30_1 }; }
     finally {
         try {
             if (routes_2_1 && !routes_2_1.done && (_a = routes_2.return)) _a.call(routes_2);
         }
-        finally { if (e_28) throw e_28.error; }
+        finally { if (e_30) throw e_30.error; }
     }
     return { set: set, map: map, size: routes.length };
 }
@@ -10590,7 +11020,7 @@ function sanitizeAssistantResponse(value) {
     return normalizeAssistantRoutes(normalizedCurrency);
 }
 function evaluateAssistantGuardrails(message) {
-    var e_29, _a;
+    var e_31, _a;
     var normalized = String(message || '').toLowerCase();
     var patterns = [
         {
@@ -10636,12 +11066,12 @@ function evaluateAssistantGuardrails(message) {
             }
         }
     }
-    catch (e_29_1) { e_29 = { error: e_29_1 }; }
+    catch (e_31_1) { e_31 = { error: e_31_1 }; }
     finally {
         try {
             if (patterns_1_1 && !patterns_1_1.done && (_a = patterns_1.return)) _a.call(patterns_1);
         }
-        finally { if (e_29) throw e_29.error; }
+        finally { if (e_31) throw e_31.error; }
     }
     return null;
 }
@@ -10756,7 +11186,7 @@ function tokenizeArithmeticExpression(expression) {
     return tokens;
 }
 function evaluateArithmeticExpression(expression) {
-    var e_30, _a, e_31, _b;
+    var e_32, _a, e_33, _b;
     var tokens = tokenizeArithmeticExpression(expression);
     if (!tokens || !tokens.length) {
         return null;
@@ -10813,12 +11243,12 @@ function evaluateArithmeticExpression(expression) {
             prevToken = token;
         }
     }
-    catch (e_30_1) { e_30 = { error: e_30_1 }; }
+    catch (e_32_1) { e_32 = { error: e_32_1 }; }
     finally {
         try {
             if (tokens_1_1 && !tokens_1_1.done && (_a = tokens_1.return)) _a.call(tokens_1);
         }
-        finally { if (e_30) throw e_30.error; }
+        finally { if (e_32) throw e_32.error; }
     }
     while (ops.length) {
         var op = ops.pop();
@@ -10858,12 +11288,12 @@ function evaluateArithmeticExpression(expression) {
             stack.push(Number(token));
         }
     }
-    catch (e_31_1) { e_31 = { error: e_31_1 }; }
+    catch (e_33_1) { e_33 = { error: e_33_1 }; }
     finally {
         try {
             if (output_1_1 && !output_1_1.done && (_b = output_1.return)) _b.call(output_1);
         }
-        finally { if (e_31) throw e_31.error; }
+        finally { if (e_33) throw e_33.error; }
     }
     if (stack.length !== 1 || Number.isNaN(stack[0])) {
         return null;
@@ -11047,8 +11477,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_32_1;
-        var e_32, _b;
+        var limits, totalBytes, totalChars, chunks, cleaned, attachments_1, attachments_1_1, attachment, localPath, safe, stat, ext, name_1, type, readable, content, _a, e_34_1;
+        var e_34, _b;
         return __generator(this, function (_c) {
             switch (_c.label) {
                 case 0:
@@ -11127,14 +11557,14 @@ function readAttachmentContents(attachments) {
                     return [3 /*break*/, 2];
                 case 10: return [3 /*break*/, 13];
                 case 11:
-                    e_32_1 = _c.sent();
-                    e_32 = { error: e_32_1 };
+                    e_34_1 = _c.sent();
+                    e_34 = { error: e_34_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_32) throw e_32.error; }
+                    finally { if (e_34) throw e_34.error; }
                     return [7 /*endfinally*/];
                 case 13: return [2 /*return*/, {
                         promptText: chunks.length ? "\n\nAttachments:\n".concat(chunks.join('\n\n')) : '',
@@ -11375,7 +11805,7 @@ function estimateUsage(messages, responseText, model) {
     };
 }
 function evaluateGuardrails(message) {
-    var e_33, _a;
+    var e_35, _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.' },
@@ -11397,12 +11827,12 @@ function evaluateGuardrails(message) {
             }
         }
     }
-    catch (e_33_1) { e_33 = { error: e_33_1 }; }
+    catch (e_35_1) { e_35 = { error: e_35_1 }; }
     finally {
         try {
             if (patterns_2_1 && !patterns_2_1.done && (_a = patterns_2.return)) _a.call(patterns_2);
         }
-        finally { if (e_33) throw e_33.error; }
+        finally { if (e_35) throw e_35.error; }
     }
     return null;
 }