@resolveio/server-lib 22.1.0 → 22.1.1

package/methods/ai-terminal.js

@@ -109,18 +109,21 @@ exports.loadAiTerminalMethods = loadAiTerminalMethods;
 exports.executeAiAssistantMongoRead = executeAiAssistantMongoRead;
 exports.executeAiAssistantMongoAggregate = executeAiAssistantMongoAggregate;
 exports.extractAssistantMongoDirective = extractAssistantMongoDirective;
+exports.buildAssistantInvoiceCustomerLabelExpr = buildAssistantInvoiceCustomerLabelExpr;
 exports.buildAssistantDatedPivotDisplay = buildAssistantDatedPivotDisplay;
 exports.normalizeIdsForTargetField = normalizeIdsForTargetField;
 exports.serializeMongoValue = serializeMongoValue;
 exports.flattenForTable = flattenForTable;
 exports.buildDisplayTable = buildDisplayTable;
 exports.formatDisplayTableMarkdown = formatDisplayTableMarkdown;
+exports.resolveAssistantReadDisplayMaxRows = resolveAssistantReadDisplayMaxRows;
 exports.normalizeAssistantNowExprPlaceholders = normalizeAssistantNowExprPlaceholders;
 exports.rewriteMatchExpressionsToExpr = rewriteMatchExpressionsToExpr;
 exports.normalizeAssistantMonthlyCalendarWindowPipeline = normalizeAssistantMonthlyCalendarWindowPipeline;
 exports.stripQueryFieldPathsDeep = stripQueryFieldPathsDeep;
 exports.stripScopedFieldsFromPipeline = stripScopedFieldsFromPipeline;
 exports.rewriteEmbeddedMatchObjects = rewriteEmbeddedMatchObjects;
+exports.resolveAssistantCollectionOverride = resolveAssistantCollectionOverride;
 exports.collectUserViewPermissions = collectUserViewPermissions;
 exports.userHasInvoiceAccess = userHasInvoiceAccess;
 exports.resolveAssistantUserAccessTier = resolveAssistantUserAccessTier;
@@ -389,6 +392,11 @@ var AI_ASSISTANT_TERM_SYNONYMS = [
         pattern: /\btruck\s+treating\s+jobs?\b/i,
         expansions: ['truck treating deliveries', 'truck-treating-deliveries', 'truck treating route events']
     },
+    {
+        label: 'active clients',
+        pattern: /\b(?:how\s+many\s+)?active\s+(?:clients?|customers?)\b/i,
+        expansions: ['customers', 'clients', 'customer status', 'client status']
+    },
     {
         label: 'blend tickets',
         pattern: /\bblend(?:ing)?\s+tickets?\b/i,
@@ -2318,10 +2326,10 @@ function executeAiAssistantReportBuilderAggregate(payload, context) {
 }
 function executeAiAssistantMongoRead(payload, context) {
     return __awaiter(this, void 0, void 0, function () {
-        var input, rawCollection, dbName, db, collectionResolution, collection, bridgeCollection, schemaFields, _a, user, isSuperAdmin, customerId, fallbackMeta, baseQuery, stripped, userId, normalizedClient, shouldScopeByClient, _b, strippedClient, clientScopedQuery, scopedQuery, normalized, findOptions, documents, executedQuery, probeDocs, dateFallback, fallbackQuery, fallbackDocs, expanded, fallbackDocs, nameFallback, fallbackDocs, _c, chemicalLookup, fallbackDocs, queryFields, _d, aliases, rewrittenQuery, fallbackDocs, _e, idLookup, fallbackDocs, baseCollection, fallbackPayload, fallbackResult, existingFallbacks, nameFields, dateFields, diagnostics, queryNoName, _f, queryNoDate, _g, _h, _j, _k, allCollections, base, alt, altCount, _l, total, sanitizedDocuments, requestedFields, missingFields, _m, projectionAliases, expandedProjection, refreshedDocs, includeIds, fieldAliases, displayDocs, idLookupDisplay, priorityFields, display;
-        var _o, _p;
-        return __generator(this, function (_q) {
-            switch (_q.label) {
+        var input, rawCollection, dbName, db, collectionResolution, collection, bridgeCollection, schemaFields, _a, user, isSuperAdmin, customerId, fallbackMeta, baseQuery, stripped, userId, normalizedClient, shouldScopeByClient, _b, strippedClient, clientScopedQuery, scopedQuery, normalized, findOptions, documents, executedQuery, probeDocs, dateFallback, fallbackQuery, fallbackDocs, expanded, fallbackDocs, nameFallback, fallbackDocs, _c, chemicalLookup, fallbackDocs, queryFields, _d, aliases, rewrittenQuery, fallbackDocs, _e, activeFallback, fallbackDocs, _f, idLookup, fallbackDocs, baseCollection, fallbackPayload, fallbackResult, existingFallbacks, nameFields, dateFields, diagnostics, queryNoName, _g, queryNoDate, _h, _j, _k, _l, allCollections, base, alt, altCount, _m, total, sanitizedDocuments, requestedFields, missingFields, _o, projectionAliases, expandedProjection, refreshedDocs, includeIds, fieldAliases, displayDocs, idLookupDisplay, priorityFields, displayMaxRows, display;
+        var _p, _q;
+        return __generator(this, function (_r) {
+            switch (_r.label) {
                 case 0:
                     input = payload || {};
                     rawCollection = normalizeOptionalString(input.collection);
@@ -2332,22 +2340,22 @@ function executeAiAssistantMongoRead(payload, context) {
                     db = resolveio_server_app_1.ResolveIOServer.getMongoConnection().db(dbName);
                     return [4 /*yield*/, resolveAssistantCollectionName(db, dbName, rawCollection)];
                 case 1:
-                    collectionResolution = _q.sent();
+                    collectionResolution = _r.sent();
                     collection = collectionResolution.name || rawCollection;
                     return [4 /*yield*/, resolveAssistantReportBuilderBridgeCollection(collection, db, dbName)];
                 case 2:
-                    bridgeCollection = _q.sent();
+                    bridgeCollection = _r.sent();
                     if (bridgeCollection.fallbackFrom) {
                         collection = bridgeCollection.collection;
                     }
                     schemaFields = getCollectionSchemaFieldNames(collection);
                     return [4 /*yield*/, ensureAssistantReadAccess(context, input.permissionView, collection)];
                 case 3:
-                    _a = _q.sent(), user = _a.user, isSuperAdmin = _a.isSuperAdmin;
+                    _a = _r.sent(), user = _a.user, isSuperAdmin = _a.isSuperAdmin;
                     if (!isSuperAdmin && AI_ASSISTANT_BLOCKED_COLLECTIONS.has(collection)) {
                         throw new Error('AI assistant report builder bridge: Access denied.');
                     }
-                    customerId = normalizeOptionalString((_o = user === null || user === void 0 ? void 0 : user.other) === null || _o === void 0 ? void 0 : _o.id_customer);
+                    customerId = normalizeOptionalString((_p = user === null || user === void 0 ? void 0 : user.other) === null || _p === void 0 ? void 0 : _p.id_customer);
                     fallbackMeta = {};
                     if (bridgeCollection.fallbackFrom) {
                         fallbackMeta.reportBuilderBridge = {
@@ -2379,11 +2387,11 @@ function executeAiAssistantMongoRead(payload, context) {
                     if (!(!isSuperAdmin && normalizedClient)) return [3 /*break*/, 5];
                     return [4 /*yield*/, collectionHasClientIndex(db, dbName, collection)];
                 case 4:
-                    _b = _q.sent();
+                    _b = _r.sent();
                     return [3 /*break*/, 6];
                 case 5:
                     _b = false;
-                    _q.label = 6;
+                    _r.label = 6;
                 case 6:
                     shouldScopeByClient = _b;
                     if (!isSuperAdmin && shouldScopeByClient) {
@@ -2403,7 +2411,7 @@ function executeAiAssistantMongoRead(payload, context) {
                     findOptions = __assign(__assign({}, normalized.findOptions), { readPreference: AI_ASSISTANT_READ_PREFERENCE });
                     return [4 /*yield*/, db.collection(collection).find(scopedQuery, findOptions).toArray()];
                 case 7:
-                    documents = _q.sent();
+                    documents = _r.sent();
                     executedQuery = scopedQuery;
                     probeDocs = null;
                     if (!!documents.length) return [3 /*break*/, 9];
@@ -2413,13 +2421,13 @@ function executeAiAssistantMongoRead(payload, context) {
                     fallbackMeta.dateField = __assign(__assign({}, dateFallback), { attempted: true, used: false });
                     return [4 /*yield*/, db.collection(collection).find(fallbackQuery, findOptions).toArray()];
                 case 8:
-                    fallbackDocs = _q.sent();
+                    fallbackDocs = _r.sent();
                     if (fallbackDocs.length) {
                         documents = fallbackDocs;
                         executedQuery = fallbackQuery;
                         fallbackMeta.dateField.used = true;
                     }
-                    _q.label = 9;
+                    _r.label = 9;
                 case 9:
                     if (!!documents.length) return [3 /*break*/, 11];
                     expanded = expandQueryDateFallbacks(executedQuery, schemaFields);
@@ -2431,13 +2439,13 @@ function executeAiAssistantMongoRead(payload, context) {
                     };
                     return [4 /*yield*/, db.collection(collection).find(expanded.query, findOptions).toArray()];
                 case 10:
-                    fallbackDocs = _q.sent();
+                    fallbackDocs = _r.sent();
                     if (fallbackDocs.length) {
                         documents = fallbackDocs;
                         executedQuery = expanded.query;
                         fallbackMeta.dateFieldsExpanded.used = true;
                     }
-                    _q.label = 11;
+                    _r.label = 11;
                 case 11:
                     if (!!documents.length) return [3 /*break*/, 13];
                     nameFallback = resolveReadNameMatchFallback(executedQuery);
@@ -2450,13 +2458,13 @@ function executeAiAssistantMongoRead(payload, context) {
                     };
                     return [4 /*yield*/, db.collection(collection).find(nameFallback.query, findOptions).toArray()];
                 case 12:
-                    fallbackDocs = _q.sent();
+                    fallbackDocs = _r.sent();
                     if (fallbackDocs.length) {
                         documents = fallbackDocs;
                         executedQuery = nameFallback.query;
                         fallbackMeta.nameMatch.used = true;
                     }
-                    _q.label = 13;
+                    _r.label = 13;
                 case 13:
                     if (!!documents.length) return [3 /*break*/, 18];
                     _c = probeDocs;
@@ -2470,8 +2478,8 @@ function executeAiAssistantMongoRead(payload, context) {
                             includeClientScope: shouldScopeByClient
                         })];
                 case 14:
-                    _c = (_q.sent());
-                    _q.label = 15;
+                    _c = (_r.sent());
+                    _r.label = 15;
                 case 15:
                     probeDocs = _c;
                     return [4 /*yield*/, applyChemicalNameLookupFallbackToQuery({
@@ -2484,18 +2492,18 @@ function executeAiAssistantMongoRead(payload, context) {
                             probeDocs: probeDocs || undefined
                         })];
                 case 16:
-                    chemicalLookup = _q.sent();
+                    chemicalLookup = _r.sent();
                     if (!chemicalLookup) return [3 /*break*/, 18];
                     fallbackMeta.chemicalLookup = __assign(__assign({}, chemicalLookup.meta), { attempted: true, used: false });
                     return [4 /*yield*/, db.collection(collection).find(chemicalLookup.query, findOptions).toArray()];
                 case 17:
-                    fallbackDocs = _q.sent();
+                    fallbackDocs = _r.sent();
                     if (fallbackDocs.length) {
                         documents = fallbackDocs;
                         executedQuery = chemicalLookup.query;
                         fallbackMeta.chemicalLookup.used = true;
                     }
-                    _q.label = 18;
+                    _r.label = 18;
                 case 18:
                     if (!!documents.length) return [3 /*break*/, 22];
                     queryFields = extractQueryFieldPaths(executedQuery).filter(function (field) { return !isAssistantIdField(field); });
@@ -2511,8 +2519,8 @@ function executeAiAssistantMongoRead(payload, context) {
                             includeClientScope: shouldScopeByClient
                         })];
                 case 19:
-                    _d = (_q.sent());
-                    _q.label = 20;
+                    _d = (_r.sent());
+                    _r.label = 20;
                 case 20:
                     probeDocs = _d;
                     if (!probeDocs.length) return [3 /*break*/, 22];
@@ -2530,15 +2538,15 @@ function executeAiAssistantMongoRead(payload, context) {
                     }, executedQuery);
                     return [4 /*yield*/, db.collection(collection).find(rewrittenQuery, findOptions).toArray()];
                 case 21:
-                    fallbackDocs = _q.sent();
+                    fallbackDocs = _r.sent();
                     if (fallbackDocs.length) {
                         documents = fallbackDocs;
                         executedQuery = rewrittenQuery;
                         fallbackMeta.queryFieldAliases.used = true;
                     }
-                    _q.label = 22;
+                    _r.label = 22;
                 case 22:
-                    if (!!documents.length) return [3 /*break*/, 27];
+                    if (!!documents.length) return [3 /*break*/, 26];
                     _e = probeDocs;
                     if (_e) return [3 /*break*/, 24];
                     return [4 /*yield*/, fetchAssistantProbeDocs({
@@ -2550,10 +2558,44 @@ function executeAiAssistantMongoRead(payload, context) {
                             includeClientScope: shouldScopeByClient
                         })];
                 case 23:
-                    _e = (_q.sent());
-                    _q.label = 24;
+                    _e = (_r.sent());
+                    _r.label = 24;
                 case 24:
                     probeDocs = _e;
+                    activeFallback = resolveReadActiveStatusFallback(executedQuery, probeDocs || []);
+                    if (!activeFallback) return [3 /*break*/, 26];
+                    fallbackMeta.activeStatus = {
+                        fields: activeFallback.fields,
+                        attempted: true,
+                        used: false,
+                        reason: 'active_fields_missing_in_collection'
+                    };
+                    return [4 /*yield*/, db.collection(collection).find(activeFallback.query, findOptions).toArray()];
+                case 25:
+                    fallbackDocs = _r.sent();
+                    if (fallbackDocs.length) {
+                        documents = fallbackDocs;
+                        executedQuery = activeFallback.query;
+                        fallbackMeta.activeStatus.used = true;
+                    }
+                    _r.label = 26;
+                case 26:
+                    if (!!documents.length) return [3 /*break*/, 31];
+                    _f = probeDocs;
+                    if (_f) return [3 /*break*/, 28];
+                    return [4 /*yield*/, fetchAssistantProbeDocs({
+                            db: db,
+                            collection: collection,
+                            idClient: normalizedClient,
+                            idCustomer: customerId,
+                            isSuperAdmin: isSuperAdmin,
+                            includeClientScope: shouldScopeByClient
+                        })];
+                case 27:
+                    _f = (_r.sent());
+                    _r.label = 28;
+                case 28:
+                    probeDocs = _f;
                     return [4 /*yield*/, applyIdLookupFallbackToQuery({
                             query: executedQuery,
                             db: db,
@@ -2563,29 +2605,29 @@ function executeAiAssistantMongoRead(payload, context) {
                             isSuperAdmin: isSuperAdmin,
                             probeDocs: probeDocs || undefined
                         })];
-                case 25:
-                    idLookup = _q.sent();
-                    if (!idLookup) return [3 /*break*/, 27];
+                case 29:
+                    idLookup = _r.sent();
+                    if (!idLookup) return [3 /*break*/, 31];
                     fallbackMeta.idLookup = __assign(__assign({}, idLookup.meta), { attempted: true, used: false });
                     return [4 /*yield*/, db.collection(collection).find(idLookup.query, findOptions).toArray()];
-                case 26:
-                    fallbackDocs = _q.sent();
+                case 30:
+                    fallbackDocs = _r.sent();
                     if (fallbackDocs.length) {
                         documents = fallbackDocs;
                         executedQuery = idLookup.query;
                         fallbackMeta.idLookup.used = true;
                     }
-                    _q.label = 27;
-                case 27:
-                    if (!!documents.length) return [3 /*break*/, 30];
+                    _r.label = 31;
+                case 31:
+                    if (!!documents.length) return [3 /*break*/, 34];
                     return [4 /*yield*/, resolveBaseCollectionFromReport(db, dbName, collection)];
-                case 28:
-                    baseCollection = _q.sent();
-                    if (!(baseCollection && baseCollection !== collection)) return [3 /*break*/, 30];
+                case 32:
+                    baseCollection = _r.sent();
+                    if (!(baseCollection && baseCollection !== collection)) return [3 /*break*/, 34];
                     fallbackPayload = __assign(__assign({}, input), { collection: baseCollection });
                     return [4 /*yield*/, executeAiAssistantMongoRead(fallbackPayload, context)];
-                case 29:
-                    fallbackResult = _q.sent();
+                case 33:
+                    fallbackResult = _r.sent();
                     if (Array.isArray(fallbackResult === null || fallbackResult === void 0 ? void 0 : fallbackResult.documents) && fallbackResult.documents.length) {
                         if (isSuperAdmin && (fallbackResult === null || fallbackResult === void 0 ? void 0 : fallbackResult.debug) && typeof fallbackResult.debug === 'object') {
                             existingFallbacks = fallbackResult.debug.fallbacks && typeof fallbackResult.debug.fallbacks === 'object'
@@ -2602,9 +2644,9 @@ function executeAiAssistantMongoRead(payload, context) {
                     if (isSuperAdmin) {
                         fallbackMeta.reportFallback = { from: collection, to: baseCollection, attempted: true, used: false };
                     }
-                    _q.label = 30;
-                case 30:
-                    if (!(!documents.length && isSuperAdmin)) return [3 /*break*/, 47];
+                    _r.label = 34;
+                case 34:
+                    if (!(!documents.length && isSuperAdmin)) return [3 /*break*/, 51];
                     nameFields = collectMatchFieldsByCondition(executedQuery, function (field, condition) { return isRegexMatchCondition(condition)
                         || (typeof condition === 'string' && shouldApplyAssistantNameRegex(field)); });
                     dateFields = collectMatchFieldsByCondition(executedQuery, function (_field, condition) { return isDateCondition(condition); });
@@ -2612,36 +2654,36 @@ function executeAiAssistantMongoRead(payload, context) {
                         nameFields: nameFields.length ? nameFields : undefined,
                         dateFields: dateFields.length ? dateFields : undefined
                     };
-                    _q.label = 31;
-                case 31:
-                    _q.trys.push([31, 36, , 37]);
-                    if (!nameFields.length) return [3 /*break*/, 33];
+                    _r.label = 35;
+                case 35:
+                    _r.trys.push([35, 40, , 41]);
+                    if (!nameFields.length) return [3 /*break*/, 37];
                     queryNoName = stripMatchFields(executedQuery, nameFields);
-                    _f = diagnostics;
+                    _g = diagnostics;
                     return [4 /*yield*/, db.collection(collection).countDocuments(queryNoName, {
                             readPreference: AI_ASSISTANT_READ_PREFERENCE
                         })];
-                case 32:
-                    _f.recentCount = _q.sent();
-                    _q.label = 33;
-                case 33:
-                    if (!dateFields.length) return [3 /*break*/, 35];
+                case 36:
+                    _g.recentCount = _r.sent();
+                    _r.label = 37;
+                case 37:
+                    if (!dateFields.length) return [3 /*break*/, 39];
                     queryNoDate = stripMatchFields(executedQuery, dateFields);
-                    _g = diagnostics;
+                    _h = diagnostics;
                     return [4 /*yield*/, db.collection(collection).countDocuments(queryNoDate, {
                             readPreference: AI_ASSISTANT_READ_PREFERENCE
                         })];
-                case 34:
-                    _g.nameMatchCount = _q.sent();
-                    _q.label = 35;
-                case 35: return [3 /*break*/, 37];
-                case 36:
-                    _h = _q.sent();
-                    return [3 /*break*/, 37];
-                case 37:
-                    _q.trys.push([37, 40, , 41]);
-                    _j = probeDocs;
-                    if (_j) return [3 /*break*/, 39];
+                case 38:
+                    _h.nameMatchCount = _r.sent();
+                    _r.label = 39;
+                case 39: return [3 /*break*/, 41];
+                case 40:
+                    _j = _r.sent();
+                    return [3 /*break*/, 41];
+                case 41:
+                    _r.trys.push([41, 44, , 45]);
+                    _k = probeDocs;
+                    if (_k) return [3 /*break*/, 43];
                     return [4 /*yield*/, fetchAssistantProbeDocs({
                             db: db,
                             collection: collection,
@@ -2650,56 +2692,56 @@ function executeAiAssistantMongoRead(payload, context) {
                             isSuperAdmin: isSuperAdmin,
                             includeClientScope: shouldScopeByClient
                         })];
-                case 38:
-                    _j = (_q.sent());
-                    _q.label = 39;
-                case 39:
-                    probeDocs = _j;
+                case 42:
+                    _k = (_r.sent());
+                    _r.label = 43;
+                case 43:
+                    probeDocs = _k;
                     if (probeDocs.length && nameFields.length) {
                         diagnostics.chemicalIdDetected = detectChemicalIdFromProbe(probeDocs, nameFields);
                     }
-                    return [3 /*break*/, 41];
-                case 40:
-                    _k = _q.sent();
-                    return [3 /*break*/, 41];
-                case 41:
-                    _q.trys.push([41, 45, , 46]);
+                    return [3 /*break*/, 45];
+                case 44:
+                    _l = _r.sent();
+                    return [3 /*break*/, 45];
+                case 45:
+                    _r.trys.push([45, 49, , 50]);
                     return [4 /*yield*/, listAssistantCollections(db, dbName)];
-                case 42:
-                    allCollections = _q.sent();
+                case 46:
+                    allCollections = _r.sent();
                     base = stripVersionSuffix(collection.startsWith('report-') ? collection.slice('report-'.length) : collection);
                     alt = collection.startsWith('report-') ? base : "report-".concat(base);
-                    if (!(alt && alt !== collection && allCollections.includes(alt))) return [3 /*break*/, 44];
+                    if (!(alt && alt !== collection && allCollections.includes(alt))) return [3 /*break*/, 48];
                     return [4 /*yield*/, db.collection(alt).countDocuments({}, { readPreference: AI_ASSISTANT_READ_PREFERENCE })];
-                case 43:
-                    altCount = _q.sent();
+                case 47:
+                    altCount = _r.sent();
                     diagnostics.alternateCollection = alt;
                     diagnostics.alternateCollectionCount = altCount;
-                    _q.label = 44;
-                case 44: return [3 /*break*/, 46];
-                case 45:
-                    _l = _q.sent();
-                    return [3 /*break*/, 46];
-                case 46:
+                    _r.label = 48;
+                case 48: return [3 /*break*/, 50];
+                case 49:
+                    _m = _r.sent();
+                    return [3 /*break*/, 50];
+                case 50:
                     fallbackMeta.zeroDiagnostics = diagnostics;
-                    _q.label = 47;
-                case 47:
+                    _r.label = 51;
+                case 51:
                     total = null;
-                    if (!normalized.includeTotal) return [3 /*break*/, 49];
+                    if (!normalized.includeTotal) return [3 /*break*/, 53];
                     return [4 /*yield*/, db.collection(collection).countDocuments(executedQuery, { readPreference: AI_ASSISTANT_READ_PREFERENCE })];
-                case 48:
-                    total = _q.sent();
-                    _q.label = 49;
-                case 49:
+                case 52:
+                    total = _r.sent();
+                    _r.label = 53;
+                case 53:
                     sanitizedDocuments = isSuperAdmin
                         ? documents
                         : documents.map(function (doc) { return redactSensitiveFields((0, common_1.deepCopy)(doc)); });
                     requestedFields = resolveProjectionRequestedFields(findOptions.projection);
-                    if (!(sanitizedDocuments.length && requestedFields.length)) return [3 /*break*/, 53];
+                    if (!(sanitizedDocuments.length && requestedFields.length)) return [3 /*break*/, 57];
                     missingFields = requestedFields.filter(function (field) { return !hasNonEmptyValue(sanitizedDocuments, field, { treatObjectLikeAsEmpty: true }); });
-                    if (!missingFields.length) return [3 /*break*/, 53];
-                    _m = probeDocs;
-                    if (_m) return [3 /*break*/, 51];
+                    if (!missingFields.length) return [3 /*break*/, 57];
+                    _o = probeDocs;
+                    if (_o) return [3 /*break*/, 55];
                     return [4 /*yield*/, fetchAssistantProbeDocs({
                             db: db,
                             collection: collection,
@@ -2708,26 +2750,26 @@ function executeAiAssistantMongoRead(payload, context) {
                             isSuperAdmin: isSuperAdmin,
                             includeClientScope: shouldScopeByClient
                         })];
-                case 50:
-                    _m = (_q.sent());
-                    _q.label = 51;
-                case 51:
-                    probeDocs = _m;
-                    if (!probeDocs.length) return [3 /*break*/, 53];
+                case 54:
+                    _o = (_r.sent());
+                    _r.label = 55;
+                case 55:
+                    probeDocs = _o;
+                    if (!probeDocs.length) return [3 /*break*/, 57];
                     projectionAliases = resolveFieldAliases(probeDocs, missingFields, schemaFields);
-                    if (!Object.keys(projectionAliases).length) return [3 /*break*/, 53];
+                    if (!Object.keys(projectionAliases).length) return [3 /*break*/, 57];
                     fallbackMeta.projectionAliases = {
                         aliases: projectionAliases,
                         attempted: true,
                         used: false
                     };
                     expandedProjection = expandProjectionWithAliases(findOptions.projection, projectionAliases);
-                    if (!(expandedProjection && expandedProjection !== findOptions.projection)) return [3 /*break*/, 53];
+                    if (!(expandedProjection && expandedProjection !== findOptions.projection)) return [3 /*break*/, 57];
                     findOptions = __assign(__assign({}, findOptions), { projection: expandedProjection });
                     normalized.findOptions.projection = expandedProjection;
                     return [4 /*yield*/, db.collection(collection).find(executedQuery, findOptions).toArray()];
-                case 52:
-                    refreshedDocs = _q.sent();
+                case 56:
+                    refreshedDocs = _r.sent();
                     if (refreshedDocs.length) {
                         documents = refreshedDocs;
                         sanitizedDocuments = isSuperAdmin
@@ -2735,9 +2777,9 @@ function executeAiAssistantMongoRead(payload, context) {
                             : refreshedDocs.map(function (doc) { return redactSensitiveFields((0, common_1.deepCopy)(doc)); });
                         fallbackMeta.projectionAliases.used = true;
                     }
-                    _q.label = 53;
-                case 53:
-                    includeIds = ((_p = input.options) === null || _p === void 0 ? void 0 : _p.includeIds) === true;
+                    _r.label = 57;
+                case 57:
+                    includeIds = ((_q = input.options) === null || _q === void 0 ? void 0 : _q.includeIds) === true;
                     fieldAliases = resolveFieldAliases(sanitizedDocuments, requestedFields, schemaFields);
                     displayDocs = Object.keys(fieldAliases).length
                         ? applyFieldAliasesForDisplay(sanitizedDocuments, fieldAliases)
@@ -2751,8 +2793,8 @@ function executeAiAssistantMongoRead(payload, context) {
                             idCustomer: customerId,
                             isSuperAdmin: isSuperAdmin
                         })];
-                case 54:
-                    idLookupDisplay = _q.sent();
+                case 58:
+                    idLookupDisplay = _r.sent();
                     if (idLookupDisplay === null || idLookupDisplay === void 0 ? void 0 : idLookupDisplay.docs) {
                         displayDocs = idLookupDisplay.docs;
                     }
@@ -2761,10 +2803,11 @@ function executeAiAssistantMongoRead(payload, context) {
                     }
                     priorityFields = requestedFields.length
                         ? __spreadArray(__spreadArray([], __read(requestedFields), false), __read(AI_ASSISTANT_DISPLAY_PRIORITY_FIELDS), false) : AI_ASSISTANT_DISPLAY_PRIORITY_FIELDS;
+                    displayMaxRows = resolveAssistantReadDisplayMaxRows(normalized.findOptions.limit, sanitizedDocuments.length);
                     display = buildDisplayTable(displayDocs, {
                         includeIds: includeIds,
                         maxColumns: AI_ASSISTANT_DISPLAY_MAX_COLUMNS,
-                        maxRows: normalized.findOptions.limit,
+                        maxRows: displayMaxRows,
                         priorityFields: priorityFields,
                         includeGroupFromId: false
                     });
@@ -4212,30 +4255,81 @@ function resolveAssistantRevenueByTimeRequest(text, scope) {
         amount: Math.min(Math.max((0, common_1.round)(amount), 1), 400)
     };
 }
+function buildAssistantTrimmedStringExpr(value) {
+    return {
+        $trim: {
+            input: {
+                $convert: {
+                    input: value,
+                    to: 'string',
+                    onError: '',
+                    onNull: ''
+                }
+            }
+        }
+    };
+}
+function buildAssistantInvoiceCustomerLabelExpr() {
+    return {
+        $let: {
+            vars: {
+                customer_name: buildAssistantTrimmedStringExpr('$customer_name'),
+                customer_fullname: buildAssistantTrimmedStringExpr('$customer.fullname'),
+                customer_nested_name: buildAssistantTrimmedStringExpr('$customer.name'),
+                customer_scalar: buildAssistantTrimmedStringExpr('$customer'),
+                client_name: buildAssistantTrimmedStringExpr('$client_name'),
+                client_fullname: buildAssistantTrimmedStringExpr('$client.fullname'),
+                client_nested_name: buildAssistantTrimmedStringExpr('$client.name'),
+                client_scalar: buildAssistantTrimmedStringExpr('$client'),
+                id_customer: buildAssistantTrimmedStringExpr('$id_customer'),
+                id_client: buildAssistantTrimmedStringExpr('$id_client')
+            },
+            in: {
+                $switch: {
+                    branches: [
+                        { case: { $gt: [{ $strLenCP: '$$customer_name' }, 0] }, then: '$$customer_name' },
+                        { case: { $gt: [{ $strLenCP: '$$customer_fullname' }, 0] }, then: '$$customer_fullname' },
+                        { case: { $gt: [{ $strLenCP: '$$customer_nested_name' }, 0] }, then: '$$customer_nested_name' },
+                        { case: { $gt: [{ $strLenCP: '$$customer_scalar' }, 0] }, then: '$$customer_scalar' },
+                        { case: { $gt: [{ $strLenCP: '$$client_name' }, 0] }, then: '$$client_name' },
+                        { case: { $gt: [{ $strLenCP: '$$client_fullname' }, 0] }, then: '$$client_fullname' },
+                        { case: { $gt: [{ $strLenCP: '$$client_nested_name' }, 0] }, then: '$$client_nested_name' },
+                        { case: { $gt: [{ $strLenCP: '$$client_scalar' }, 0] }, then: '$$client_scalar' },
+                        { case: { $gt: [{ $strLenCP: '$$id_customer' }, 0] }, then: '$$id_customer' },
+                        { case: { $gt: [{ $strLenCP: '$$id_client' }, 0] }, then: '$$id_client' }
+                    ],
+                    default: 'Unknown Customer'
+                }
+            }
+        }
+    };
+}
+function resolveAssistantRevenueByTimePipelineLimit(request, scope) {
+    var amount = Math.min(Math.max((0, common_1.round)(request.amount), 1), 400);
+    if (scope !== 'by_customer') {
+        return Math.min(Math.max(amount * 2, 20), 200);
+    }
+    // Customer breakdowns need much higher pre-pivot row coverage so each customer appears.
+    var perBucketTargets = {
+        day: 120,
+        week: 220,
+        month: 350,
+        quarter: 450,
+        year: 600
+    };
+    var perBucketTarget = perBucketTargets[request.grain] || 300;
+    return Math.min(Math.max(amount * perBucketTarget, 400), 5000);
+}
 function buildAssistantInvoiceRevenueByTimePipeline(request, scope) {
     var _a, _b, _c;
     if (scope === void 0) { scope = 'overall'; }
     var grain = request.grain;
     var amount = Math.min(Math.max((0, common_1.round)(request.amount), 1), 400);
     var byCustomer = scope === 'by_customer';
+    var limit = resolveAssistantRevenueByTimePipelineLimit(request, scope);
     var effectiveDateExpr = { $ifNull: ['$date_paid', { $ifNull: ['$date_invoiced', '$createdAt'] }] };
     var effectiveTotalExpr = { $ifNull: ['$paid_total', '$grand_total'] };
-    var customerExpr = {
-        $ifNull: [
-            '$customer_name',
-            {
-                $ifNull: [
-                    '$customer.fullname',
-                    {
-                        $ifNull: [
-                            '$customer.name',
-                            { $ifNull: [{ $toString: '$id_customer' }, 'Unknown Customer'] }
-                        ]
-                    }
-                ]
-            }
-        ]
-    };
+    var customerExpr = buildAssistantInvoiceCustomerLabelExpr();
     var startDateExpr = grain === 'quarter'
         ? { $dateSubtract: { startDate: '$$NOW', unit: 'month', amount: amount * 3 } }
         : { $dateSubtract: { startDate: '$$NOW', unit: grain, amount: amount } };
@@ -4267,7 +4361,7 @@ function buildAssistantInvoiceRevenueByTimePipeline(request, scope) {
                 $project: __assign(__assign({ _id: 0 }, (byCustomer ? { customer: '$_id.customer' } : {})), { quarter: { $concat: [{ $toString: '$_id.year' }, '-Q', { $toString: '$_id.quarter' }] }, total_revenue: 1 })
             },
             { $sort: byCustomer ? { customer: 1, quarter: 1 } : { quarter: 1 } },
-            { $limit: Math.min(Math.max(amount * (byCustomer ? 50 : 2), byCustomer ? 120 : 20), byCustomer ? 500 : 200) }
+            { $limit: limit }
         ], false);
     }
     if (grain === 'year') {
@@ -4284,7 +4378,7 @@ function buildAssistantInvoiceRevenueByTimePipeline(request, scope) {
                 $project: __assign(__assign({ _id: 0 }, (byCustomer ? { customer: '$_id.customer' } : {})), { year: '$_id.year', total_revenue: 1 })
             },
             { $sort: byCustomer ? { customer: 1, year: 1 } : { year: 1 } },
-            { $limit: Math.min(Math.max(amount * (byCustomer ? 50 : 2), byCustomer ? 120 : 20), byCustomer ? 500 : 200) }
+            { $limit: limit }
         ], false);
     }
     var bucketField = grain;
@@ -4314,7 +4408,7 @@ function buildAssistantInvoiceRevenueByTimePipeline(request, scope) {
             }, _a.total_revenue = 1, _a))
         },
         { $sort: byCustomer ? (_b = { customer: 1 }, _b[bucketField] = 1, _b) : (_c = {}, _c[bucketField] = 1, _c) },
-        { $limit: Math.min(Math.max(amount * (byCustomer ? 50 : 2), byCustomer ? 120 : 20), byCustomer ? 500 : 200) }
+        { $limit: limit }
     ], false);
 }
 function isAssistantRevenueByTimeHeuristicDirective(directive) {
@@ -4325,8 +4419,18 @@ function isAssistantBlendRedUltraLiftHeuristicDirective(directive) {
     var rawLine = normalizeOptionalString(directive === null || directive === void 0 ? void 0 : directive.rawLine).toLowerCase();
     return rawLine.includes('heuristic_agg(blend-red-ultra-lift)');
 }
+function isAssistantActiveClientsHeuristicDirective(directive) {
+    var rawLine = normalizeOptionalString(directive === null || directive === void 0 ? void 0 : directive.rawLine).toLowerCase();
+    return rawLine.includes('heuristic_read(active-clients-count)');
+}
+function isAssistantInvoiceTopCustomersHeuristicDirective(directive) {
+    var rawLine = normalizeOptionalString(directive === null || directive === void 0 ? void 0 : directive.rawLine).toLowerCase();
+    return rawLine.includes('heuristic_agg(invoice-top-customers)');
+}
 function isAssistantDeterministicHeuristicDirective(directive) {
     return isAssistantRevenueByTimeHeuristicDirective(directive)
+        || isAssistantActiveClientsHeuristicDirective(directive)
+        || isAssistantInvoiceTopCustomersHeuristicDirective(directive)
         || isAssistantBlendRedUltraLiftHeuristicDirective(directive);
 }
 function buildAssistantHeuristicDirective(message, collectionHints) {
@@ -4334,14 +4438,58 @@ function buildAssistantHeuristicDirective(message, collectionHints) {
     if (!text) {
         return null;
     }
+    if (/\bhow\s+many\b.*\bactive\b.*\b(clients?|customers?)\b/.test(text)
+        || /\bactive\b.*\b(clients?|customers?)\b.*\bhow\s+many\b/.test(text)) {
+        var mergedHints = mergeAssistantHintValues(collectionHints, resolveAssistantDefaultCollectionHints(message));
+        var customerCollection = mergedHints.includes('customers')
+            ? 'customers'
+            : (mergedHints.includes('clients') ? 'clients' : 'customers');
+        return {
+            type: 'read',
+            payload: {
+                collection: customerCollection,
+                permissionView: '/client/list',
+                query: {
+                    $or: [
+                        { status: { $regex: '^active$', $options: 'i' } },
+                        { state: { $regex: '^active$', $options: 'i' } },
+                        { active: true },
+                        { is_active: true },
+                        { enabled: true },
+                        { is_enabled: true }
+                    ]
+                },
+                options: {
+                    projection: {
+                        status: 1,
+                        state: 1,
+                        active: 1,
+                        is_active: 1,
+                        enabled: 1,
+                        is_enabled: 1
+                    },
+                    limit: 0,
+                    includeTotal: true
+                }
+            },
+            cleaned: '',
+            rawLine: 'HEURISTIC_READ(active-clients-count)'
+        };
+    }
     var revenueByCustomerTime = resolveAssistantRevenueByTimeRequest(text, 'by_customer');
     if (revenueByCustomerTime) {
+        var customerLimit = resolveAssistantRevenueByTimePipelineLimit(revenueByCustomerTime, 'by_customer');
         return {
             type: 'aggregate',
             payload: {
                 collection: 'invoices',
                 permissionView: '/invoice/list',
-                pipeline: buildAssistantInvoiceRevenueByTimePipeline(revenueByCustomerTime, 'by_customer')
+                pipeline: buildAssistantInvoiceRevenueByTimePipeline(revenueByCustomerTime, 'by_customer'),
+                options: {
+                    allowDiskUse: true,
+                    export: true,
+                    limit: customerLimit
+                }
             },
             cleaned: '',
             rawLine: "HEURISTIC_AGG(invoice-revenue-time-customer-".concat(revenueByCustomerTime.grain, ")")
@@ -4513,7 +4661,7 @@ function buildAssistantHeuristicDirective(message, collectionHints) {
                 pipeline: [
                     {
                         $addFields: {
-                            effective_date: { $ifNull: ['$date_paid', '$date_invoiced', '$createdAt'] },
+                            effective_date: { $ifNull: ['$date_paid', { $ifNull: ['$date_invoiced', '$createdAt'] }] },
                             effective_total: { $ifNull: ['$paid_total', '$grand_total'] }
                         }
                     },
@@ -4527,7 +4675,7 @@ function buildAssistantHeuristicDirective(message, collectionHints) {
                     },
                     {
                         $group: {
-                            _id: { $ifNull: ['$customer', { $ifNull: ['$id_customer', 'Unknown'] }] },
+                            _id: buildAssistantInvoiceCustomerLabelExpr(),
                             invoice_total: { $sum: { $ifNull: ['$effective_total', 0] } },
                             invoice_count: { $sum: 1 }
                         }
@@ -5284,18 +5432,20 @@ function buildAssistantToolResultPayload(directive, toolResponse, requestMessage
     };
 }
 function resolveAssistantToolResultResponseMaxRows(directive, directivePayload, rowCount) {
-    var _a;
+    var _a, _b;
     if (directive.type !== 'aggregate') {
         return AI_ASSISTANT_DISPLAY_PREVIEW_MAX_ROWS;
     }
-    var requestedLimit = typeof ((_a = directivePayload === null || directivePayload === void 0 ? void 0 : directivePayload.options) === null || _a === void 0 ? void 0 : _a.limit) === 'number'
-        ? Math.min(Math.max((0, common_1.round)(directivePayload.options.limit), 0), AI_ASSISTANT_MONGO_MAX_LIMIT)
+    var exportMode = ((_a = directivePayload === null || directivePayload === void 0 ? void 0 : directivePayload.options) === null || _a === void 0 ? void 0 : _a.export) === true;
+    var maxRows = exportMode ? AI_ASSISTANT_MONGO_EXPORT_MAX_LIMIT : AI_ASSISTANT_MONGO_MAX_LIMIT;
+    var requestedLimit = typeof ((_b = directivePayload === null || directivePayload === void 0 ? void 0 : directivePayload.options) === null || _b === void 0 ? void 0 : _b.limit) === 'number'
+        ? Math.min(Math.max((0, common_1.round)(directivePayload.options.limit), 0), maxRows)
         : 0;
     if (requestedLimit > 0) {
         return requestedLimit;
     }
     if (typeof rowCount === 'number' && rowCount > 0) {
-        return Math.min(rowCount, AI_ASSISTANT_MONGO_MAX_LIMIT);
+        return Math.min(rowCount, maxRows);
     }
     return AI_ASSISTANT_DISPLAY_PREVIEW_MAX_ROWS;
 }
@@ -7614,20 +7764,26 @@ function isAssistantMarkdownTableRowLine(line) {
     return /^\|.*\|$/.test(trimmed);
 }
 function ensureAssistantMinimumDisplayColumns(display) {
+    var _a;
     if (!display || !Array.isArray(display.columns) || display.columns.length !== 1) {
         return display;
     }
     var primary = display.columns[0] || 'Result';
-    var rows = Array.isArray(display.rows)
-        ? display.rows.map(function (row) {
-            var next = __assign({}, (row || {}));
-            if (!Object.prototype.hasOwnProperty.call(next, 'Details')) {
-                next.Details = '';
-            }
-            return next;
-        })
-        : [];
-    return __assign(__assign({}, display), { columns: [primary, 'Details'], rows: rows });
+    var rows = Array.isArray(display.rows) ? display.rows : [];
+    if (!rows.length) {
+        return display;
+    }
+    var labels = rows
+        .map(function (row) { return normalizeOptionalString((row || {})[primary]) || 'Unknown'; })
+        .filter(Boolean);
+    var uniqueLabels = Array.from(new Set(labels));
+    if (uniqueLabels.length !== 1) {
+        return display;
+    }
+    var totalCount = typeof display.rowCount === 'number' && display.rowCount > 0
+        ? display.rowCount
+        : rows.length;
+    return __assign(__assign({}, display), { columns: [primary, 'Count'], rows: [(_a = {}, _a[primary] = uniqueLabels[0], _a.Count = totalCount, _a)], rowCount: 1, truncated: false });
 }
 function applyAssistantDisplayTableToResponse(value, display) {
     if (!display || !Array.isArray(display.rows)) {
@@ -7636,14 +7792,24 @@ function applyAssistantDisplayTableToResponse(value, display) {
     var normalizedDisplay = ensureAssistantMinimumDisplayColumns(display);
     if (!display.rows.length) {
         var cleaned_1 = stripAssistantMarkdownTables(value);
-        var tableDisplay = Array.isArray(normalizedDisplay.columns) && normalizedDisplay.columns.length
-            ? __assign(__assign({}, normalizedDisplay), { rows: [] }) : {
-            columns: ['Result', 'Details'],
-            rows: [{ Result: 'No matching rows', Details: '' }],
-            rowCount: normalizedDisplay.rowCount || 0,
-            truncated: false,
-            includeIds: false
-        };
+        var rowCount = typeof normalizedDisplay.rowCount === 'number' && normalizedDisplay.rowCount > 0
+            ? normalizedDisplay.rowCount
+            : 0;
+        var tableDisplay = rowCount > 0
+            ? {
+                columns: ['Metric', 'Value'],
+                rows: [{ Metric: 'Rows matched', Value: rowCount }],
+                rowCount: 1,
+                truncated: false,
+                includeIds: false
+            }
+            : {
+                columns: ['Result', 'Details'],
+                rows: [{ Result: 'No matching rows', Details: '' }],
+                rowCount: 0,
+                truncated: false,
+                includeIds: false
+            };
         var emptyTable = formatDisplayTableMarkdown(tableDisplay);
         if (!emptyTable) {
             return cleaned_1 || value;
@@ -7750,6 +7916,15 @@ function resolveAssistantDatabaseName(database, mongoConfig) {
     }
     return dbName;
 }
+function resolveAssistantReadDisplayMaxRows(limit, rowCount) {
+    if (typeof limit === 'number' && Number.isFinite(limit) && limit > 0) {
+        return Math.max((0, common_1.round)(limit), 1);
+    }
+    if (typeof rowCount === 'number' && Number.isFinite(rowCount) && rowCount > 0) {
+        return Math.min(Math.max((0, common_1.round)(rowCount), 1), AI_ASSISTANT_DISPLAY_PREVIEW_MAX_ROWS);
+    }
+    return AI_ASSISTANT_DISPLAY_PREVIEW_MAX_ROWS;
+}
 function normalizeAssistantFindOptions(options) {
     var normalized = options || {};
     var exportMode = normalized.export === true;
@@ -9924,6 +10099,67 @@ function isDateCondition(value) {
     }
     return false;
 }
+function isAssistantActiveFieldPath(field) {
+    var normalized = normalizeOptionalString(field).toLowerCase();
+    if (!normalized) {
+        return false;
+    }
+    var leaf = normalized.split('.').pop() || normalized;
+    return ['status', 'state', 'active', 'is_active', 'isactive', 'enabled', 'is_enabled', 'isenabled'].includes(leaf);
+}
+function isAssistantActiveCondition(value) {
+    if (typeof value === 'boolean') {
+        return value === true;
+    }
+    if (typeof value === 'string') {
+        return /^active$/i.test(value.trim());
+    }
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return false;
+    }
+    var regexValue = value.$regex;
+    if (regexValue instanceof RegExp) {
+        return /active/i.test(regexValue.source);
+    }
+    if (typeof regexValue === 'string' && /active/i.test(regexValue)) {
+        return true;
+    }
+    var eqValue = value.$eq;
+    if (typeof eqValue === 'boolean' && eqValue === true) {
+        return true;
+    }
+    if (typeof eqValue === 'string' && /^active$/i.test(eqValue.trim())) {
+        return true;
+    }
+    var inValues = Array.isArray(value.$in) ? value.$in : [];
+    if (inValues.some(function (entry) { return (typeof entry === 'boolean' && entry === true)
+        || (typeof entry === 'string' && /^active$/i.test(entry.trim())); })) {
+        return true;
+    }
+    return false;
+}
+function collectAssistantActiveMatchFields(query) {
+    var fields = collectMatchFieldsByCondition(query, function (field, condition) { return isAssistantActiveFieldPath(field) && isAssistantActiveCondition(condition); });
+    return Array.from(new Set(fields));
+}
+function resolveReadActiveStatusFallback(query, probeDocs) {
+    var fields = collectAssistantActiveMatchFields(query);
+    if (!fields.length || !Array.isArray(probeDocs) || !probeDocs.length) {
+        return null;
+    }
+    var hasAnyFieldData = fields.some(function (field) { return hasNonEmptyValue(probeDocs, field, { treatObjectLikeAsEmpty: true }); });
+    if (hasAnyFieldData) {
+        return null;
+    }
+    var stripped = stripQueryFieldPathsDeepWithMeta(query, fields);
+    if (!stripped.changed || !stripped.value || typeof stripped.value !== 'object') {
+        return null;
+    }
+    return {
+        query: stripped.value,
+        fields: fields
+    };
+}
 function isChemicalFieldPath(field) {
     var normalized = normalizeOptionalString(field).toLowerCase();
     return normalized.includes('chemical');
@@ -11172,6 +11408,10 @@ function resolveAssistantDefaultCollectionHints(message) {
     if (/\bcustomers?\b/.test(text)) {
         push('customers');
     }
+    if (/\bclients?\b/.test(text)) {
+        push('customers');
+        push('clients');
+    }
     return hints;
 }
 function buildCollectionRankingDebugFromTokens(tokens, collectionNames, max) {
@@ -11342,6 +11582,36 @@ function pickPreferredCollectionCandidate(ranked) {
     }
     return top;
 }
+function normalizeAssistantCollectionOverrideName(value) {
+    var normalized = normalizeOptionalString(value).toLowerCase();
+    if (!normalized) {
+        return '';
+    }
+    var withoutReportPrefix = normalized.startsWith('report-')
+        ? normalized.slice('report-'.length)
+        : normalized;
+    return stripVersionSuffix(withoutReportPrefix);
+}
+function isAssistantGenericCollectionName(value) {
+    var normalized = normalizeAssistantCollectionOverrideName(value);
+    if (!normalized) {
+        return false;
+    }
+    return !normalized.includes('-') && !normalized.includes('_');
+}
+function isAssistantCollectionRefinementOf(currentCollection, genericCollection) {
+    var current = normalizeAssistantCollectionOverrideName(currentCollection);
+    var generic = normalizeAssistantCollectionOverrideName(genericCollection);
+    if (!current || !generic || current === generic) {
+        return false;
+    }
+    return current.startsWith("".concat(generic, "-"))
+        || current.endsWith("-".concat(generic))
+        || current.includes("-".concat(generic, "-"))
+        || current.startsWith("".concat(generic, "_"))
+        || current.endsWith("_".concat(generic))
+        || current.includes("_".concat(generic, "_"));
+}
 function resolveAssistantCollectionOverride(collectionRanking, currentCollection) {
     var _a, _b;
     var ranked = Array.isArray(collectionRanking === null || collectionRanking === void 0 ? void 0 : collectionRanking.ranked) ? collectionRanking === null || collectionRanking === void 0 ? void 0 : collectionRanking.ranked : [];
@@ -11366,6 +11636,11 @@ function resolveAssistantCollectionOverride(collectionRanking, currentCollection
         return null;
     }
     var currentScore = (_b = (_a = ranked.find(function (entry) { return entry.name === current; })) === null || _a === void 0 ? void 0 : _a.score) !== null && _b !== void 0 ? _b : 0;
+    if (currentScore >= AI_ASSISTANT_COLLECTION_OVERRIDE_MIN_SCORE
+        && isAssistantGenericCollectionName(top.name)
+        && isAssistantCollectionRefinementOf(current, top.name)) {
+        return null;
+    }
     var scoreGap = top.score - currentScore;
     var currentIsVersion = isVersionCollectionName(current);
     var topIsVersion = isVersionCollectionName(top.name);
@@ -11442,7 +11717,10 @@ var AI_ASSISTANT_BRIDGE_COLLECTION_ALIASES = {
     reportchemicalblends: 'chemical-blends',
     blend: 'chemical-blends',
     blends: 'chemical-blends',
-    invoice: 'invoices'
+    invoice: 'invoices',
+    client: 'customers',
+    clients: 'customers',
+    customer: 'customers'
 };
 var AI_ASSISTANT_DIRECT_COLLECTION_FALLBACK_ALLOWLIST = new Set([
     'work-order-dynamics',
@@ -14374,6 +14652,44 @@ function normalizeAssistantRoutes(value) {
         return "".concat(canonical).concat(suffix);
     });
 }
+function stripAssistantEmptyMarkdownTableRows(value) {
+    var lines = String(value || '').split('\n');
+    var output = [];
+    var index = 0;
+    while (index < lines.length) {
+        var header = String(lines[index] || '').trim();
+        var separator = String(lines[index + 1] || '').trim();
+        var isTableHeader = /^\|.+\|$/.test(header);
+        var isTableSeparator = /^\|?\s*:?-{3,}:?\s*(\|\s*:?-{3,}:?\s*)+\|?\s*$/.test(separator);
+        if (!isTableHeader || !isTableSeparator) {
+            output.push(lines[index]);
+            index += 1;
+            continue;
+        }
+        var tableStart = output.length;
+        output.push(lines[index]);
+        output.push(lines[index + 1]);
+        index += 2;
+        var keptRows = 0;
+        while (index < lines.length) {
+            var line = String(lines[index] || '');
+            if (!line.trim() || !line.includes('|')) {
+                break;
+            }
+            var cells = line.split('|').map(function (cell) { return cell.trim(); }).filter(Boolean);
+            var hasContent = cells.some(function (cell) { return cell !== '-' && cell !== '---'; });
+            if (hasContent) {
+                output.push(line);
+                keptRows += 1;
+            }
+            index += 1;
+        }
+        if (keptRows === 0) {
+            output.splice(tableStart, 2);
+        }
+    }
+    return output.join('\n').replace(/\n{3,}/g, '\n\n').trim();
+}
 function sanitizeAssistantResponse(value) {
     var raw = normalizeOptionalString(value);
     if (!raw) {
@@ -14435,7 +14751,8 @@ function sanitizeAssistantResponse(value) {
     if (!cleaned) {
         return 'I can’t share code, but I can point you to files or explain behavior at a high level.';
     }
-    var normalizedCurrency = normalizeAssistantCurrencyText(cleaned);
+    var tableCleaned = stripAssistantEmptyMarkdownTableRows(cleaned);
+    var normalizedCurrency = normalizeAssistantCurrencyText(tableCleaned || cleaned);
     return normalizeAssistantRoutes(normalizedCurrency);
 }
 function evaluateAssistantGuardrails(message) {