@resolveio/server-lib 22.3.70 → 22.3.72

package/methods/ai-terminal.d.ts

@@ -149,6 +149,7 @@ type AssistantMongoDirective = {
     payload: Record<string, any> | null;
     cleaned: string;
     rawLine: string;
+    metadata?: Record<string, any>;
 };
 type AssistantRequestType = 'data' | 'navigation' | 'feature_info' | 'bug_issue' | 'mixed' | 'unknown';
 type AssistantRequestTypeSource = 'heuristic' | 'planner' | 'merged';

package/methods/ai-terminal.js

@@ -1901,7 +1901,7 @@ function executeAiAssistantCodexRun(payload, context) {
                     insertResult = _d.sent();
                     assistantMessageId = (insertResult === null || insertResult === void 0 ? void 0 : insertResult._id) || (insertResult === null || insertResult === void 0 ? void 0 : insertResult.insertedId);
                     enqueueAssistantCodexRun(function () { return __awaiter(_this, void 0, void 0, function () {
-                        var runStart, fastModeEnabled, alwaysAllowProbeEnabled, plannerEnabled, runBudgetMs, assistantMongoMaxTimeMs, assistantSystemPrompt, runDeadlineMs, steps, recordStep, progressTracker, streamProgress, remainingRunBudgetMs, hasRunBudget, applyCodexStageBudget, assistantContent, toolResult, assistantDebug, directiveSource, requestClassification, dataQuestion, lastDirective, heuristicDirectivePrecomputed, usedDeterministicHeuristicFastPath, requestedTimeGrain, requestedBreakdownDimensions, enforceDatedDirective, enforceGroupedDirective, datedDirectiveRetryUsed, datedDirectiveResolved, toolResponseDebug, toolError, toolTelemetry, termHints, collectionHints, fieldHints, schemaHints, methodHints, publicationHints, collectionTokenization, collectionRanking, collectionSelection, collectionOverride, collectionNames, plannerUsed, plannerSkipReason, plannerOutput, plannerRaw, timingBreakdown, codexUsage, accumulateCodexUsage, contextRoute, contextMode, hintSeed, termExpansion, hintText, baseTokens, expandedTokens, baseWeights, expandedWeights, dbName, db, surfaceHints, _a, allowedRoutes, rankedAllowedRoutes, routeHints, appCollectionHints, rankedCollectionHints, rankedCollections, hintCollections, schemaHintCollections, assistantContext, hasDeterministicHeuristicFastPath, prompt_1, workspaceRoot, codexConfig, runOptions, plannerRunOptions, shouldRunPlanner, plannerBudgetAvailable, plannerPrompt, plannerStart, _b, preferListDirective, directiveStyleHint, directivePromptMode, responseText, directiveText, directive, heuristicDirectiveFastPath, directivePrompt, directiveStart, forcedDirective, _c, initialStart, extractedDirective, error_2, directivePrompt, forcedStart, forcedDirective, _d, strictDirectivePrompt, strictStart, strictDirectiveText, strictDirective, strictDirectiveIsDated, shouldUseStrictDirective, _e, guardDirectivePrompt, guardStart, guardDirectiveText, guardDirective, _f, groupedDirectivePrompt, groupedStart, groupedDirectiveText, groupedDirective, _g, heuristicDirective, requestedCollection, allowCollectionOverride, cleanedResponseText, deniedModuleByIntent, permissionLabel, effectiveDirective, rankedCollections_1, directiveHintsBase_1, buildToolRequestForDirective, executionDirective, probeFieldHints, aggregateProbeDisabled, probeEnabled, probeBudgetAllowed, probeDirective, probeRequest, probeStart, probeResponse, _h, probeDurationMs, probeRowCount, probeRewrite, probeError_1, probeDurationMs, probeErrorMessage, toolRequest, requestedToolCollection, toolStart, toolResponse, _j, toolDurationMs, toolPayload, resolvedToolCollection, zeroRowResult, followupCodexEnabled, skipFollowupCodex, followupPrompt, followupStart, followupText, _k, error_3, errorMessage, existingFinal, error_4, runBudgetExceeded, includeToolExecutionTelemetry, toolExecutionTelemetry, finishedAt, finalNow, finishedAt, codexMs, draftingMs, finalMetadata, finalUsage, usageClientId, usageError_1, finalAssistantDoc, setPayload, finalizeError_1, failedAt, fallbackContent, failureMetadata, persistError_1, _l;
+                        var runStart, fastModeEnabled, alwaysAllowProbeEnabled, plannerEnabled, runBudgetMs, assistantMongoMaxTimeMs, assistantSystemPrompt, runDeadlineMs, steps, recordStep, requestClassification, dataQuestion, progressTracker, streamProgress, remainingRunBudgetMs, hasRunBudget, applyCodexStageBudget, assistantContent, toolResult, assistantDebug, directiveSource, lastDirective, heuristicDirectivePrecomputed, usedDeterministicHeuristicFastPath, requestedTimeGrain, requestedBreakdownDimensions, enforceDatedDirective, enforceGroupedDirective, datedDirectiveRetryUsed, datedDirectiveResolved, toolResponseDebug, toolError, toolTelemetry, termHints, collectionHints, fieldHints, schemaHints, methodHints, publicationHints, collectionTokenization, collectionRanking, collectionSelection, collectionOverride, collectionNames, plannerUsed, plannerSkipReason, plannerOutput, plannerRaw, timingBreakdown, codexUsage, accumulateCodexUsage, contextRoute, contextMode, hintSeed, termExpansion, hintText, baseTokens, expandedTokens, baseWeights, expandedWeights, dbName, db, surfaceHints, _a, allowedRoutes, rankedAllowedRoutes, routeHints, appCollectionHints, rankedCollectionHints, rankedCollections, hintCollections, schemaHintCollections, assistantContext, hasDeterministicHeuristicFastPath, prompt_1, workspaceRoot, codexConfig, runOptions, plannerRunOptions, shouldRunPlanner, plannerBudgetAvailable, plannerPrompt, plannerStart, _b, preferListDirective, directiveStyleHint, directivePromptMode, responseText, directiveText, directive, heuristicDirectiveFastPath, directivePrompt, directiveStart, forcedDirective, _c, initialStart, extractedDirective, error_2, directivePrompt, forcedStart, forcedDirective, _d, strictDirectivePrompt, strictStart, strictDirectiveText, strictDirective, strictDirectiveIsDated, shouldUseStrictDirective, _e, guardDirectivePrompt, guardStart, guardDirectiveText, guardDirective, _f, groupedDirectivePrompt, groupedStart, groupedDirectiveText, groupedDirective, _g, heuristicDirective, requestedCollection, allowCollectionOverride, cleanedResponseText, deniedModuleByIntent, permissionLabel, effectiveDirective, effectiveDirectiveMetadata, directiveAcknowledgementText, directiveProgressMessages, deterministicDataIntentDirective, rankedCollections_1, directiveHintsBase_1, buildToolRequestForDirective, executionDirective, probeFieldHints, aggregateProbeDisabled, probeEnabled, probeBudgetAllowed, probeDirective, probeRequest, probeStart, probeResponse, _h, probeDurationMs, probeRowCount, probeRewrite, probeError_1, probeDurationMs, probeErrorMessage, toolRequest, requestedToolCollection, toolStart, toolResponse, _j, toolDurationMs, toolPayload, resolvedToolCollection, zeroRowResult, followupCodexEnabled, skipFollowupCodex, followupPrompt, followupStart, followupText, _k, error_3, errorMessage, existingFinal, error_4, runBudgetExceeded, includeToolExecutionTelemetry, toolExecutionTelemetry, finishedAt, finalNow, finishedAt, codexMs, draftingMs, finalMetadata, finalUsage, usageClientId, usageError_1, finalAssistantDoc, setPayload, finalizeError_1, failedAt, fallbackContent, failureMetadata, persistError_1, _l;
                         var _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12, _13, _14, _15, _16, _17, _18, _19, _20, _21;
                         return __generator(this, function (_22) {
                             switch (_22.label) {
@@ -1941,8 +1941,10 @@ function executeAiAssistantCodexRun(payload, context) {
                                             details: details
                                         });
                                     };
+                                    requestClassification = classifyAssistantRequestType(message);
+                                    dataQuestion = requestClassification.dataQuestion;
                                     progressTracker = createAssistantProgressTracker(assistantMessageId, initialProgress);
-                                    streamProgress = createAssistantStreamProgressHandler(progressTracker);
+                                    streamProgress = createAssistantStreamProgressHandler(progressTracker, function () { return dataQuestion; });
                                     remainingRunBudgetMs = function () {
                                         if (!runDeadlineMs) {
                                             return null;
@@ -1977,8 +1979,6 @@ function executeAiAssistantCodexRun(payload, context) {
                                     toolResult = null;
                                     assistantDebug = null;
                                     directiveSource = 'none';
-                                    requestClassification = classifyAssistantRequestType(message);
-                                    dataQuestion = requestClassification.dataQuestion;
                                     lastDirective = null;
                                     heuristicDirectivePrecomputed = null;
                                     usedDeterministicHeuristicFastPath = false;
@@ -2609,6 +2609,22 @@ function executeAiAssistantCodexRun(payload, context) {
                                     if (!((directive === null || directive === void 0 ? void 0 : directive.payload) && AI_ASSISTANT_TOOL_MAX_STEPS > 0)) return [3 /*break*/, 66];
                                     effectiveDirective = collectionOverride
                                         ? __assign(__assign({}, directive), { payload: __assign(__assign({}, (directive.payload || {})), { collection: collectionOverride.to }) }) : directive;
+                                    effectiveDirectiveMetadata = effectiveDirective.metadata && typeof effectiveDirective.metadata === 'object'
+                                        ? effectiveDirective.metadata
+                                        : {};
+                                    directiveAcknowledgementText = normalizeOptionalString(effectiveDirectiveMetadata.acknowledgementText);
+                                    directiveProgressMessages = Array.isArray(effectiveDirectiveMetadata.progress)
+                                        ? effectiveDirectiveMetadata.progress.map(function (entry) { return normalizeOptionalString(entry); }).filter(Boolean)
+                                        : [];
+                                    deterministicDataIntentDirective = isAssistantAppDataIntentHeuristicDirective(effectiveDirective);
+                                    if (deterministicDataIntentDirective) {
+                                        toolTelemetry.intentId = normalizeOptionalString(effectiveDirectiveMetadata.intentId) || undefined;
+                                        toolTelemetry.recipeUsed = normalizeOptionalString(effectiveDirectiveMetadata.recipeUsed) || undefined;
+                                        toolTelemetry.acknowledgementText = directiveAcknowledgementText || undefined;
+                                        if (!collectionOverride) {
+                                            toolTelemetry.overrideBlockedReason = 'deterministic_data_intent_preserved_collection';
+                                        }
+                                    }
                                     rankedCollections_1 = Array.isArray(collectionRanking === null || collectionRanking === void 0 ? void 0 : collectionRanking.ranked)
                                         ? collectionRanking.ranked
                                             .map(function (entry) { return normalizeOptionalString(entry === null || entry === void 0 ? void 0 : entry.name); })
@@ -2628,9 +2644,18 @@ function executeAiAssistantCodexRun(payload, context) {
                                             deadlineMs: runDeadlineMs || undefined,
                                             maxTimeMS: assistantMongoMaxTimeMs
                                         };
+                                        if (isAssistantAppDataIntentHeuristicDirective(value)) {
+                                            request.__assistantRetryState = __assign(__assign({}, (request.__assistantRetryState || {})), { disableCrossCollectionRetry: true, rootCollection: normalizeOptionalString(request.collection) || undefined });
+                                        }
                                         return request;
                                     };
-                                    progressTracker.push('Grabbing Data');
+                                    if (directiveAcknowledgementText) {
+                                        progressTracker.push(directiveAcknowledgementText);
+                                    }
+                                    else {
+                                        progressTracker.push(deterministicDataIntentDirective ? 'Pulling the requested data' : 'Grabbing Data');
+                                    }
+                                    directiveProgressMessages.slice(0, 2).forEach(function (messageText) { return progressTracker.push(messageText); });
                                     executionDirective = effectiveDirective;
                                     probeFieldHints = [];
                                     _22.label = 39;
@@ -2648,7 +2673,9 @@ function executeAiAssistantCodexRun(payload, context) {
                                     };
                                     return [3 /*break*/, 63];
                                 case 40:
-                                    aggregateProbeDisabled = executionDirective.type === 'aggregate' && !alwaysAllowProbeEnabled;
+                                    aggregateProbeDisabled = executionDirective.type === 'aggregate'
+                                        && !alwaysAllowProbeEnabled
+                                        && !isAssistantAppDataIntentHeuristicDirective(executionDirective);
                                     probeEnabled = AI_ASSISTANT_TOOL_MAX_STEPS > 1 && !aggregateProbeDisabled;
                                     probeBudgetAllowed = alwaysAllowProbeEnabled
                                         || hasRunBudget('Grabbing Data: probe', AI_ASSISTANT_MONGO_MIN_STAGE_BUDGET_MS);
@@ -6010,6 +6037,10 @@ function buildAssistantToolExecutionTelemetrySnapshot(telemetry) {
         mode: (telemetry === null || telemetry === void 0 ? void 0 : telemetry.mode) || 'single_step',
         always_allow_probe: (telemetry === null || telemetry === void 0 ? void 0 : telemetry.alwaysAllowProbe) === true,
         permission_denied: (telemetry === null || telemetry === void 0 ? void 0 : telemetry.permissionDenied) === true ? true : undefined,
+        intentId: normalizeOptionalString(telemetry === null || telemetry === void 0 ? void 0 : telemetry.intentId) || undefined,
+        acknowledgementText: normalizeOptionalString(telemetry === null || telemetry === void 0 ? void 0 : telemetry.acknowledgementText) || undefined,
+        recipeUsed: normalizeOptionalString(telemetry === null || telemetry === void 0 ? void 0 : telemetry.recipeUsed) || undefined,
+        overrideBlockedReason: normalizeOptionalString(telemetry === null || telemetry === void 0 ? void 0 : telemetry.overrideBlockedReason) || undefined,
         probe: probe ? {
             attempted: probe.attempted === true,
             succeeded: probe.succeeded === true ? true : undefined,
@@ -6650,15 +6681,253 @@ function isAssistantSchemaHoursHeuristicDirective(directive) {
     var rawLine = normalizeOptionalString(directive === null || directive === void 0 ? void 0 : directive.rawLine).toLowerCase();
     return rawLine.includes('heuristic_agg(schema-hours-user-time)');
 }
+function isAssistantAppDataIntentHeuristicDirective(directive) {
+    var rawLine = normalizeOptionalString(directive === null || directive === void 0 ? void 0 : directive.rawLine).toLowerCase();
+    return rawLine.includes('heuristic_agg(app-data-intent:') || rawLine.includes('heuristic_read(app-data-intent:');
+}
+function scoreAssistantAppDataIntent(messageText, intent) {
+    if ((intent.excludeTerms || []).some(function (term) { return containsAssistantHeuristicTerm(messageText, term); })) {
+        return 0;
+    }
+    return (intent.terms || []).reduce(function (score, term) {
+        if (!containsAssistantHeuristicTerm(messageText, term)) {
+            return score;
+        }
+        return score + (term.includes(' ') ? 4 : 1);
+    }, 0);
+}
+function selectAssistantAppDataIntent(message, collectionNames, appId) {
+    var text = normalizeOptionalString(message).toLowerCase();
+    if (!text) {
+        return null;
+    }
+    var availableNames = new Set((Array.isArray(collectionNames) ? collectionNames : []).map(function (value) { return normalizeOptionalString(value); }).filter(Boolean));
+    var profile = resolveAssistantAppHeuristicProfile(appId);
+    var selected = null;
+    profile.dataIntents.forEach(function (intent) {
+        if (!(intent === null || intent === void 0 ? void 0 : intent.id) || !intent.collection) {
+            return;
+        }
+        if (availableNames.size && !availableNames.has(intent.collection)) {
+            return;
+        }
+        var score = scoreAssistantAppDataIntent(text, intent);
+        if (score <= 0) {
+            return;
+        }
+        if (!selected || score > selected.score) {
+            selected = { intent: intent, score: score };
+        }
+    });
+    return selected ? selected.intent : null;
+}
+function extractAssistantDataIntentCustomerText(message) {
+    var value = normalizeOptionalString(message);
+    if (!value) {
+        return '';
+    }
+    value = value.replace(/\b(summarize|summary|show|list|give|pull|find|tell|me|about|of|the|a|an|and|amount|quantity|qty|total|totals|for|to|them|their|by)\b/gi, ' ');
+    value = value.replace(/\b(work\s*orders?|wos?|jobs?|invoices?|invoice|billed|billing|revenue|charged|chemicals?|chemical|sent|shipped|shipment|shipments|delivered|planned|inventory|on\s+hand|stock|this\s+year|ytd|year\s+to\s+date|current\s+year)\b/gi, ' ');
+    value = value.replace(/\b(last|past|current|completed|reviewed|closed)\b/gi, ' ');
+    value = value.replace(/[^a-z0-9&.' -]+/gi, ' ');
+    return normalizeOptionalString(value.replace(/\s+/g, ' '));
+}
+function resolveAssistantDataIntentDateWindow(message) {
+    var text = normalizeOptionalString(message).toLowerCase();
+    if (!/\b(this\s+year|ytd|year\s+to\s+date|current\s+year)\b/.test(text)) {
+        return {};
+    }
+    var now = new Date();
+    var year = now.getUTCFullYear();
+    return {
+        start: new Date(Date.UTC(year, 0, 1, 0, 0, 0, 0)).toISOString(),
+        end: new Date(Date.UTC(year, now.getUTCMonth(), now.getUTCDate(), 23, 59, 59, 999)).toISOString(),
+        year: year
+    };
+}
+function buildAssistantDataIntentAcknowledgement(intent, customerText, dateWindow) {
+    var customer = customerText || 'the requested customer';
+    var yearText = dateWindow.year ? " for ".concat(dateWindow.year) : '';
+    if (intent.id === 'snf_job_chemical_shipments') {
+        return "I understand you want a summary of chemicals sent to ".concat(customer, " jobs").concat(yearText, ". Let me pull the work-order shipment data for you.");
+    }
+    if (intent.id === 'snf_invoice_chemical_quantities') {
+        return "I understand you want invoice and billed chemical details for ".concat(customer).concat(yearText, ". Let me pull the invoice data for you.");
+    }
+    if (intent.id === 'snf_planned_job_chemicals') {
+        return "I understand you want planned chemicals for ".concat(customer, " jobs").concat(yearText, ". Let me pull the job setup data for you.");
+    }
+    return 'I understand the data you want. Let me pull the matching records for you.';
+}
+function buildAssistantDataIntentMatchStage(customerText, dateField, dateWindow, customerPaths) {
+    var _a;
+    var and = [];
+    if (customerText) {
+        and.push({
+            $or: customerPaths.map(function (path) {
+                var _a;
+                return (_a = {},
+                    _a[path] = {
+                        $regex: customerText,
+                        $options: 'i'
+                    },
+                    _a);
+            })
+        });
+    }
+    if (dateField && dateWindow.start && dateWindow.end) {
+        and.push((_a = {},
+            _a[dateField] = {
+                $gte: dateWindow.start,
+                $lte: dateWindow.end
+            },
+            _a));
+    }
+    return and.length ? { $match: { $and: and } } : { $match: {} };
+}
+function buildAssistantAppDataIntentDirective(message, collectionNames, appId) {
+    if (collectionNames === void 0) { collectionNames = []; }
+    var intent = selectAssistantAppDataIntent(message, collectionNames, appId);
+    if (!intent) {
+        return null;
+    }
+    var customerText = extractAssistantDataIntentCustomerText(message);
+    var dateWindow = resolveAssistantDataIntentDateWindow(message);
+    var acknowledgementText = buildAssistantDataIntentAcknowledgement(intent, customerText, dateWindow);
+    var progress = intent.progress.map(function (entry) {
+        return entry
+            .replace(/\{\{customer\}\}/g, customerText || 'the requested customer')
+            .replace(/\{\{year\}\}/g, dateWindow.year ? String(dateWindow.year) : 'the requested date range');
+    });
+    var metadata = {
+        intentId: intent.id,
+        recipeUsed: intent.id,
+        acknowledgementText: acknowledgementText,
+        progress: progress,
+        assumptions: intent.assumptions,
+        fallbackCollections: intent.fallbackCollections
+    };
+    var basePayload = function (pipeline) { return ({
+        collection: intent.collection,
+        permissionView: intent.permissionView || resolveDefaultAssistantPermissionView(intent.collection),
+        pipeline: pipeline,
+        options: {
+            allowDiskUse: true,
+            limit: 20
+        }
+    }); };
+    if (intent.id === 'snf_job_chemical_shipments') {
+        var pipeline = [
+            buildAssistantDataIntentMatchStage(customerText, intent.dateField || 'date_completed', dateWindow, ['customer', 'job.customer']),
+            { $match: { status: { $in: ['Completed', 'Reviewed', 'Closed'] } } },
+            { $unwind: '$chemicals' },
+            { $match: { 'chemicals.shipped.quantity': { $gt: 0 } } },
+            {
+                $group: {
+                    _id: {
+                        id_job: '$job.id_job',
+                        job: '$job.job',
+                        chemical: '$chemicals.chemical',
+                        unit: '$chemicals.unit'
+                    },
+                    qty_sent: { $sum: '$chemicals.shipped.quantity' },
+                    work_order_ids: { $addToSet: '$_id' }
+                }
+            },
+            {
+                $project: {
+                    _id: 0,
+                    id_job: '$_id.id_job',
+                    job: '$_id.job',
+                    chemical: '$_id.chemical',
+                    unit: '$_id.unit',
+                    qty_sent: 1,
+                    work_order_count: { $size: '$work_order_ids' }
+                }
+            },
+            { $sort: { qty_sent: -1, job: 1, chemical: 1 } }
+        ];
+        return { type: 'aggregate', payload: basePayload(pipeline), cleaned: '', rawLine: "HEURISTIC_AGG(app-data-intent:".concat(intent.id, ")"), metadata: metadata };
+    }
+    if (intent.id === 'snf_invoice_chemical_quantities') {
+        var pipeline = [
+            buildAssistantDataIntentMatchStage(customerText, intent.dateField || 'date_created', dateWindow, ['customer', 'job.customer']),
+            { $unwind: '$items_chemicals' },
+            {
+                $group: {
+                    _id: {
+                        id_job: '$id_job',
+                        job: '$job',
+                        chemical: '$items_chemicals.chemical',
+                        unit: '$items_chemicals.unit'
+                    },
+                    quantity: { $sum: '$items_chemicals.quantity' },
+                    price_total: { $sum: '$items_chemicals.price_total' },
+                    invoice_ids: { $addToSet: '$_id' }
+                }
+            },
+            {
+                $project: {
+                    _id: 0,
+                    id_job: '$_id.id_job',
+                    job: '$_id.job',
+                    chemical: '$_id.chemical',
+                    unit: '$_id.unit',
+                    quantity: 1,
+                    price_total: 1,
+                    invoice_count: { $size: '$invoice_ids' }
+                }
+            },
+            { $sort: { price_total: -1, quantity: -1, job: 1 } }
+        ];
+        return { type: 'aggregate', payload: basePayload(pipeline), cleaned: '', rawLine: "HEURISTIC_AGG(app-data-intent:".concat(intent.id, ")"), metadata: metadata };
+    }
+    if (intent.id === 'snf_planned_job_chemicals') {
+        var pipeline = [
+            buildAssistantDataIntentMatchStage(customerText, intent.dateField || 'date_job_created', dateWindow, ['customer', 'jca.customer']),
+            { $unwind: '$planned_chemicals' },
+            {
+                $group: {
+                    _id: {
+                        id_job: '$_id',
+                        job: '$job',
+                        chemical: '$planned_chemicals.chemical',
+                        unit: '$planned_chemicals.unit'
+                    },
+                    planned_quantity: { $sum: '$planned_chemicals.quantity' }
+                }
+            },
+            {
+                $project: {
+                    _id: 0,
+                    id_job: '$_id.id_job',
+                    job: '$_id.job',
+                    chemical: '$_id.chemical',
+                    unit: '$_id.unit',
+                    planned_quantity: 1
+                }
+            },
+            { $sort: { planned_quantity: -1, job: 1 } }
+        ];
+        return { type: 'aggregate', payload: basePayload(pipeline), cleaned: '', rawLine: "HEURISTIC_AGG(app-data-intent:".concat(intent.id, ")"), metadata: metadata };
+    }
+    return null;
+}
 function isAssistantDeterministicHeuristicDirective(directive) {
-    return isAssistantSchemaHoursHeuristicDirective(directive);
+    return isAssistantSchemaHoursHeuristicDirective(directive)
+        || isAssistantAppDataIntentHeuristicDirective(directive);
 }
 function buildAssistantHeuristicDirective(message, collectionHints, collectionNames, appId) {
     if (collectionNames === void 0) { collectionNames = []; }
     if (!normalizeOptionalString(message)) {
         return null;
     }
-    void collectionNames;
+    var appDataIntentDirective = resolveAssistantDeterministicHeuristicEnabled(AI_ASSISTANT_HEURISTIC_ID_APP_DATA_INTENT, appId)
+        ? buildAssistantAppDataIntentDirective(message, collectionNames, appId)
+        : null;
+    if (appDataIntentDirective) {
+        return appDataIntentDirective;
+    }
     var schemaHoursDirective = resolveAssistantDeterministicHeuristicEnabled(AI_ASSISTANT_HEURISTIC_ID_SCHEMA_HOURS_USER_TIME, appId)
         ? buildAssistantGenericHoursDirective(message, collectionHints, appId)
         : null;
@@ -7346,6 +7615,8 @@ function buildAssistantToolResultPayload(directive, toolResponse, requestMessage
     var verification = (toolResponse === null || toolResponse === void 0 ? void 0 : toolResponse.verification) && typeof toolResponse.verification === 'object'
         ? toolResponse.verification
         : undefined;
+    var directiveMetadata = directive.metadata && typeof directive.metadata === 'object' ? directive.metadata : {};
+    var mergedDebug = __assign(__assign(__assign(__assign(__assign({}, ((toolResponse === null || toolResponse === void 0 ? void 0 : toolResponse.debug) && typeof toolResponse.debug === 'object' ? toolResponse.debug : {})), (normalizeOptionalString(directiveMetadata.intentId) ? { intentId: normalizeOptionalString(directiveMetadata.intentId) } : {})), (normalizeOptionalString(directiveMetadata.acknowledgementText) ? { acknowledgementText: normalizeOptionalString(directiveMetadata.acknowledgementText) } : {})), (normalizeOptionalString(directiveMetadata.recipeUsed) ? { recipeUsed: normalizeOptionalString(directiveMetadata.recipeUsed) } : {})), (Array.isArray(directiveMetadata.assumptions) && directiveMetadata.assumptions.length ? { assumptions: directiveMetadata.assumptions } : {}));
     var result = {
         type: directive.type === 'aggregate' ? 'mongo_agg' : 'mongo_read',
         input: directivePayload,
@@ -7357,7 +7628,7 @@ function buildAssistantToolResultPayload(directive, toolResponse, requestMessage
             columns: responseDisplay.columns,
             truncated: responseDisplay.truncated,
             verification: verification,
-            debug: (toolResponse === null || toolResponse === void 0 ? void 0 : toolResponse.debug) && typeof toolResponse.debug === 'object' ? toolResponse.debug : undefined
+            debug: Object.keys(mergedDebug).length ? mergedDebug : undefined
         }
     };
     return {
@@ -7541,9 +7812,13 @@ function buildAssistantToolFallbackResponse(result) {
     var _a, _b;
     var rowCount = Math.max(0, Number(result.output.rowCount || 0));
     var source = normalizeOptionalString(result.output.collection);
+    var debug = result.output.debug && typeof result.output.debug === 'object' ? result.output.debug : {};
+    var intentId = normalizeOptionalString(debug.intentId);
     var lines = rowCount > 0
         ? ["I found ".concat(rowCount === 1 ? '1 matching row' : "".concat(rowCount, " matching rows")).concat(source ? " from ".concat(source) : '', ".")]
-        : ["The query ran successfully".concat(source ? " against ".concat(source) : '', ", but no matching rows were returned.")];
+        : [intentId
+                ? "I checked the ".concat(source || 'selected', " data for that request, but I did not find matching rows for the filters I used.")
+                : "I checked the data".concat(source ? " in ".concat(source) : '', ", but no matching rows were returned.")];
     if (source) {
         lines.push("- Source: ".concat(source));
     }
@@ -7551,6 +7826,22 @@ function buildAssistantToolFallbackResponse(result) {
     if (typeof result.output.total === 'number') {
         lines.push("- Total: ".concat(result.output.total));
     }
+    if (rowCount <= 0) {
+        var assumptions = Array.isArray(debug.assumptions)
+            ? debug.assumptions.map(function (entry) { return normalizeOptionalString(entry); }).filter(Boolean)
+            : [];
+        if (assumptions.length) {
+            lines.push("- Assumptions: ".concat(assumptions.slice(0, 3).join('; ')));
+        }
+        if (intentId === 'snf_job_chemical_shipments') {
+            lines.push('- I treated "sent" as shipped chemical quantity from completed/reviewed/closed work orders.');
+            lines.push('- If you meant billed quantities or dollars, ask for invoiced/billed chemicals instead.');
+        }
+        else if (intentId === 'snf_invoice_chemical_quantities') {
+            lines.push('- I treated the request as billed invoice chemical quantities and invoice totals.');
+            lines.push('- If you meant field shipments, ask for chemicals shipped/sent on work orders.');
+        }
+    }
     var leadSummary = buildAssistantDisplayLeadSummary(result.output.display);
     if (leadSummary) {
         lines.push('');
@@ -8096,11 +8387,29 @@ function deriveAssistantStreamStatus(event) {
     }
     return null;
 }
-function createAssistantStreamProgressHandler(progressTracker) {
+function normalizeAssistantStreamProgressStatus(status, dataMode) {
+    if (dataMode === void 0) { dataMode = false; }
+    var trimmed = normalizeOptionalString(status);
+    if (!trimmed || !dataMode) {
+        return trimmed;
+    }
+    var normalized = trimmed.toLowerCase();
+    if (normalized === 'planning') {
+        return 'Understanding your request';
+    }
+    if (normalized === 'drafting response') {
+        return 'Preparing the summary';
+    }
+    if (normalized === 'searching files' || normalized === 'finding files' || normalized === 'opening files' || normalized === 'scanning files') {
+        return 'Checking available data';
+    }
+    return trimmed;
+}
+function createAssistantStreamProgressHandler(progressTracker, isDataMode) {
     var lastStatus = '';
     var lastSentAt = 0;
     return function (status) {
-        var trimmed = normalizeOptionalString(status);
+        var trimmed = normalizeAssistantStreamProgressStatus(status, (isDataMode === null || isDataMode === void 0 ? void 0 : isDataMode()) === true);
         if (!trimmed) {
             return;
         }
@@ -15255,6 +15564,7 @@ function mergeAssistantHintValues() {
     return result;
 }
 var AI_ASSISTANT_HEURISTIC_ID_SCHEMA_HOURS_USER_TIME = 'schema_hours_user_time';
+var AI_ASSISTANT_HEURISTIC_ID_APP_DATA_INTENT = 'app_data_intent';
 var AI_ASSISTANT_DEFAULT_ENABLED_DETERMINISTIC_HEURISTICS = new Set();
 var aiAssistantAppHeuristicRegistryCache = null;
 var aiAssistantAppHeuristicRegistryWarningKey = '';
@@ -15263,6 +15573,7 @@ function createAssistantEmptyHeuristicProfile() {
         aliases: {},
         aliasOptions: {},
         collectionTermHints: [],
+        dataIntents: [],
         enabledDeterministicHeuristics: new Set(),
         disabledDeterministicHeuristics: new Set()
     };
@@ -15281,6 +15592,21 @@ function cloneAssistantHeuristicProfile(profile) {
                 collections: mergeAssistantHintValues((entry === null || entry === void 0 ? void 0 : entry.collections) || [])
             }); })
             : [],
+        dataIntents: Array.isArray(profile === null || profile === void 0 ? void 0 : profile.dataIntents)
+            ? profile.dataIntents.map(function (entry) { return ({
+                id: normalizeOptionalString(entry === null || entry === void 0 ? void 0 : entry.id),
+                terms: mergeAssistantHintValues((entry === null || entry === void 0 ? void 0 : entry.terms) || []).map(function (term) { return term.toLowerCase(); }),
+                excludeTerms: mergeAssistantHintValues((entry === null || entry === void 0 ? void 0 : entry.excludeTerms) || []).map(function (term) { return term.toLowerCase(); }),
+                collection: normalizeOptionalString(entry === null || entry === void 0 ? void 0 : entry.collection),
+                permissionView: normalizeOptionalString(entry === null || entry === void 0 ? void 0 : entry.permissionView) || undefined,
+                dateField: normalizeOptionalString(entry === null || entry === void 0 ? void 0 : entry.dateField) || undefined,
+                quantityField: normalizeOptionalString(entry === null || entry === void 0 ? void 0 : entry.quantityField) || undefined,
+                metricField: normalizeOptionalString(entry === null || entry === void 0 ? void 0 : entry.metricField) || undefined,
+                fallbackCollections: mergeAssistantHintValues((entry === null || entry === void 0 ? void 0 : entry.fallbackCollections) || []),
+                progress: mergeAssistantHintValues((entry === null || entry === void 0 ? void 0 : entry.progress) || []),
+                assumptions: mergeAssistantHintValues((entry === null || entry === void 0 ? void 0 : entry.assumptions) || [])
+            }); }).filter(function (entry) { return !!entry.id && !!entry.collection; })
+            : [],
         enabledDeterministicHeuristics: new Set(Array.from((profile === null || profile === void 0 ? void 0 : profile.enabledDeterministicHeuristics) || [])),
         disabledDeterministicHeuristics: new Set(Array.from((profile === null || profile === void 0 ? void 0 : profile.disabledDeterministicHeuristics) || [])),
         displayDateFormat: profile === null || profile === void 0 ? void 0 : profile.displayDateFormat
@@ -15308,6 +15634,7 @@ function mergeAssistantHeuristicProfiles(base, override) {
         merged.aliasOptions[normalizedKey] = values;
     });
     merged.collectionTermHints = __spreadArray(__spreadArray([], __read(merged.collectionTermHints), false), __read((Array.isArray(override.collectionTermHints) ? override.collectionTermHints : [])), false);
+    merged.dataIntents = __spreadArray(__spreadArray([], __read(merged.dataIntents), false), __read((Array.isArray(override.dataIntents) ? override.dataIntents : [])), false);
     Array.from(override.enabledDeterministicHeuristics || []).forEach(function (value) { return merged.enabledDeterministicHeuristics.add(value); });
     Array.from(override.disabledDeterministicHeuristics || []).forEach(function (value) { return merged.disabledDeterministicHeuristics.add(value); });
     if (override.displayDateFormat) {
@@ -15390,6 +15717,35 @@ function normalizeAssistantCollectionTermHints(value) {
     });
     return hints;
 }
+function normalizeAssistantAppDataIntents(value) {
+    var entries = Array.isArray(value) ? value : [];
+    var intents = [];
+    entries.forEach(function (entry) {
+        if (!entry || typeof entry !== 'object' || Array.isArray(entry)) {
+            return;
+        }
+        var id = normalizeOptionalString(entry.id || entry.intent_id || entry.intentId);
+        var collection = normalizeOptionalString(entry.collection || entry.primary_collection || entry.primaryCollection);
+        var terms = normalizeAssistantHeuristicStringList(entry.terms || entry.trigger_terms || entry.triggerTerms || entry.phrases || []).map(function (term) { return term.toLowerCase(); });
+        if (!id || !collection || !terms.length) {
+            return;
+        }
+        intents.push({
+            id: id,
+            terms: terms,
+            excludeTerms: normalizeAssistantHeuristicStringList(entry.exclude_terms || entry.excludeTerms || []).map(function (term) { return term.toLowerCase(); }),
+            collection: collection,
+            permissionView: normalizeOptionalString(entry.permission_view || entry.permissionView) || undefined,
+            dateField: normalizeOptionalString(entry.date_field || entry.dateField) || undefined,
+            quantityField: normalizeOptionalString(entry.quantity_field || entry.quantityField || entry.metric_field || entry.metricField) || undefined,
+            metricField: normalizeOptionalString(entry.metric_field || entry.metricField) || undefined,
+            fallbackCollections: normalizeAssistantHeuristicStringList(entry.fallback_collections || entry.fallbackCollections || []),
+            progress: mergeAssistantHintValues(Array.isArray(entry.progress) ? entry.progress : []),
+            assumptions: mergeAssistantHintValues(Array.isArray(entry.assumptions) ? entry.assumptions : [])
+        });
+    });
+    return intents;
+}
 function normalizeAssistantAppHeuristicProfile(value) {
     var profile = createAssistantEmptyHeuristicProfile();
     if (!value || typeof value !== 'object' || Array.isArray(value)) {
@@ -15412,6 +15768,9 @@ function normalizeAssistantAppHeuristicProfile(value) {
         || value.collectionTermHints
         || value.term_hints
         || value.termHints);
+    profile.dataIntents = normalizeAssistantAppDataIntents(value.data_intents
+        || value.dataIntents
+        || value.intents);
     profile.displayDateFormat = normalizeAssistantDisplayDateFormat(value.display_date_format
         || value.displayDateFormat
         || value.date_display_format
@@ -15458,6 +15817,7 @@ function normalizeAssistantAppHeuristicRegistry(value) {
     if (Object.keys(standaloneProfile.aliases).length
         || Object.keys(standaloneProfile.aliasOptions).length
         || standaloneProfile.collectionTermHints.length
+        || standaloneProfile.dataIntents.length
         || standaloneProfile.enabledDeterministicHeuristics.size
         || standaloneProfile.disabledDeterministicHeuristics.size
         || normalizeOptionalString(standaloneProfile.appId)) {
@@ -15893,6 +16253,9 @@ function resolveCollectionOverrideWithContext(params) {
             && !isAssistantCollectionInHintFamilies(requested, [routePreferred])) {
             var routePreferredName = normalizeAssistantCollectionOverrideName(routePreferred);
             var requestedIsWorkOrder = isAssistantWorkOrderCollectionOverrideCandidate(requested);
+            if (shouldPreserveAssistantJobDomainCollectionForRoute(params.message, permissionView, routePreferredName, requested)) {
+                return null;
+            }
             if (!(routePreferredName === 'orders' && requestedIsWorkOrder && hasAssistantWorkOrderAliasTerms(params.message))) {
                 return {
                     from: requested,
@@ -15992,6 +16355,27 @@ function resolveCollectionOverrideWithContext(params) {
 function resolveCollectionOverrideWithContextForTesting(params) {
     return resolveCollectionOverrideWithContext(params);
 }
+function shouldPreserveAssistantJobDomainCollectionForRoute(message, permissionView, routePreferredName, requestedCollection) {
+    var route = normalizeOptionalString(permissionView).toLowerCase();
+    var requested = normalizeAssistantCollectionOverrideName(requestedCollection);
+    if (!route || routePreferredName !== 'jobs') {
+        return false;
+    }
+    if (!/\/(?:customer-info\/jobs|job\/list|jobs?)(?:\/|$)/.test(route)) {
+        return false;
+    }
+    var text = normalizeOptionalString(message).toLowerCase();
+    if (!text || !/\b(job|jobs|work\s*orders?|wos?)\b/.test(text)) {
+        return false;
+    }
+    if (requested === 'work-order-dynamics') {
+        return /\b(chemical|chemicals|sent|shipped|shipment|delivered|work\s*orders?|wos?)\b/.test(text);
+    }
+    if (requested === 'invoices') {
+        return /\b(invoice|invoices|billed|billing|revenue|charged|dollars?)\b/.test(text);
+    }
+    return requested === 'jobs';
+}
 function isAssistantWorkOrderCollectionOverrideCandidate(value) {
     var normalized = normalizeAssistantCollectionOverrideName(value);
     return normalized === 'work-order-dynamics'