@peopl-health/nexus 5.68.3 → 5.69.0-dev.12295

package/lib/clinical/helpers/dateAnchorHelper.js

@@ -1,12 +1,18 @@
-const { getCurrentMexicoDateTime, getMexicoDayLabels } = require('../../utils/dateUtils');
+const { getCurrentMexicoDateTime, getMexicoDayLabels, getMexicoUpcomingDayLabels } = require('../../utils/dateUtils');
 
 const ANCHOR_SPAN_DAYS = 7;
+const UPCOMING_SPAN_DAYS = 14;
 
 function buildDateAnchor() {
   const at = Date.now();
   const labels = getMexicoDayLabels({ days: ANCHOR_SPAN_DAYS, at });
   const week = labels.map((label, i) => (i === labels.length - 1 ? `${label} (hoy)` : label));
-  return `${getCurrentMexicoDateTime(at)}\nLos últimos siete días: ${week.join('; ')}.`;
+  const upcoming = getMexicoUpcomingDayLabels({ days: UPCOMING_SPAN_DAYS, at });
+  return [
+    getCurrentMexicoDateTime(at),
+    `Los últimos siete días: ${week.join('; ')}.`,
+    `Los próximos días: ${upcoming.join('; ')}.`,
+  ].join('\n');
 }
 
 module.exports = { buildDateAnchor };

package/lib/clinical/services/outreachSweepService.js

@@ -5,6 +5,7 @@ const { Symptoms_ID } = require('../../config/airtableConfig');
 const { getMessages } = require('../../services/messageService');
 const { DEFAULT_TIMEZONE, isWithinHourWindow } = require('../../utils/scheduleUtils');
 const { logger } = require('../../utils/logger');
+const { botIsPaused } = require('../../helpers/pausedThreadHelper');
 const { PATIENT_CONTACT_WINDOW } = require('./contingencyDispatchService');
 const { hasPendingReminderForPatient } = require('./clinicalAirtableService');
 
@@ -48,9 +49,20 @@ const AUDIT = {
   turnId: 'seguimiento_turn_id',
 };
 
+const UNDELIVERED_STATUSES = ['failed', 'undelivered'];
+const CONTACT_SENT = {
+  from_me: true,
+  origin: { $nin: ['instruction', 'system'] },
+  $or: [
+    { 'statusInfo.status': { $nin: UNDELIVERED_STATUSES } },
+    { 'statusInfo.recoveryTemplateSid': { $ne: null }, 'statusInfo.recoverySentAt': null },
+  ],
+};
+
 const RECENT_OUTBOUND_HOURS = 24;
 const COLLIDING_REMINDER_MINUTES = 24 * 60;
 const INACTIVITY_DAYS = 7;
+const MAX_SILENCE_DAYS = 30;
 const TRIAGE_PROTECTION_START_MINUTE = (7 * 60) + 30;
 const TRIAGE_PROTECTION_END_MINUTE = 11 * 60;
 
@@ -226,6 +238,7 @@ async function rejectionReason(candidate, {
 } = {}) {
   const opsReason = opsOptedOut(candidate, { now });
   if (opsReason) return opsReason;
+  if (await botIsPaused(candidate.code, { label: '[outreachSweep]' })) return 'bot_paused';
   if (!includePreviouslySwept) {
     const sweptReason = priorSweepReason(candidate);
     if (sweptReason) return sweptReason;
@@ -236,7 +249,7 @@ async function rejectionReason(candidate, {
     const recentOutbound = await getMessages(
       {
         numero: candidate.code,
-        from_me: true,
+        ...CONTACT_SENT,
         createdAt: { $gt: since },
         ...(mode === 'monday_triage_recovery' && candidate.triageContentSid
           ? { content_sid: { $ne: candidate.triageContentSid } }
@@ -257,11 +270,13 @@ async function rejectionReason(candidate, {
       if (!await mondayTriageStillPending(candidate)) return 'triage_no_longer_pending';
     } else if (cadence === 'daily') {
       const inactiveSince = moment.tz(now, DEFAULT_TIMEZONE).subtract(INACTIVITY_DAYS, 'days').toDate();
-      const recentInbound = await getMessages(
-        { numero: candidate.code, from_me: false, createdAt: { $gte: inactiveSince } },
-        { sort: { createdAt: -1 }, limit: 1 },
+      const silentSince = moment.tz(now, DEFAULT_TIMEZONE).subtract(MAX_SILENCE_DAYS, 'days').toDate();
+      const [lastInbound] = await getMessages(
+        { numero: candidate.code, from_me: false, createdAt: { $gte: silentSince } },
+        { select: { createdAt: 1 }, sort: { createdAt: -1 }, limit: 1 },
       );
-      if (recentInbound?.length) return 'patient_active_within_inactivity_window';
+      if (!lastInbound) return 'patient_silent_beyond_max_window';
+      if (new Date(lastInbound.createdAt) >= inactiveSince) return 'patient_active_within_inactivity_window';
 
       const lastTriageAt = candidate?.brief?.lastTriageAt;
       if (lastTriageAt && moment.tz(lastTriageAt, DEFAULT_TIMEZONE).isSameOrAfter(inactiveSince)) {
@@ -271,7 +286,7 @@ async function rejectionReason(candidate, {
       const recentOutreach = await getMessages(
         {
           numero: candidate.code,
-          from_me: true,
+          ...CONTACT_SENT,
           triggeredBy: { $regex: '^(?:seguimiento:|followup_)' },
           createdAt: { $gte: inactiveSince },
         },
@@ -283,7 +298,7 @@ async function rejectionReason(candidate, {
       const lastTwoOutreaches = await getMessages(
         {
           numero: candidate.code,
-          from_me: true,
+          ...CONTACT_SENT,
           triggeredBy: { $regex: '^(?:seguimiento:|followup_)' },
           createdAt: { $gte: unansweredSince },
         },
@@ -320,7 +335,7 @@ async function routineOutreachCollisionReason(code, { now = new Date() } = {}) {
       { sort: { createdAt: -1 }, limit: 1 },
     ),
     getMessages(
-      { numero: code, from_me: true, createdAt: { $gte: today } },
+      { numero: code, ...CONTACT_SENT, createdAt: { $gte: today } },
       { sort: { createdAt: -1 }, limit: 1 },
     ),
   ]);
@@ -331,7 +346,7 @@ async function routineOutreachCollisionReason(code, { now = new Date() } = {}) {
 
 async function enrichBrief(candidate) {
   const [lastInbound] = await getMessages({ numero: candidate.code, from_me: false }, { sort: { createdAt: -1 }, limit: 1 });
-  const [lastOutbound] = await getMessages({ numero: candidate.code, from_me: true }, { sort: { createdAt: -1 }, limit: 1 });
+  const [lastOutbound] = await getMessages({ numero: candidate.code, ...CONTACT_SENT }, { sort: { createdAt: -1 }, limit: 1 });
   const fmt = (doc) => (doc?.createdAt ? moment.tz(doc.createdAt, DEFAULT_TIMEZONE).format('YYYY-MM-DD HH:mm') : null);
   return {
     ...candidate.brief,

package/lib/core/NexusMessaging.js

@@ -20,6 +20,7 @@ const { isWithin24HourWindow } = require('../helpers/conversationWindowHelper');
 const { maskCaregiverLabel, remapCaregiverSender, replyContactFor } = require('../helpers/caregiverHelper');
 const { triggerTemplateRecovery } = require('../helpers/templateRecoveryHelper');
 const { prepareMessageMedia } = require('../helpers/mediaHelper');
+const { botIsPaused } = require('../helpers/pausedThreadHelper');
 const { acquireSendClaim, completeSendClaim, releaseSendClaim } = require('../helpers/sendClaimHelper');
 
 const { createMessagingProvider } = require('../adapters/registry');
@@ -490,6 +491,10 @@ class NexusMessaging {
         logger.info('[NexusMessaging] proactive send cancelled — patient became active', { code: messageData.code });
         return { success: false, messageId: null, status: 'patient_active', delivered: false, deferred: false };
       }
+      if (await botIsPaused(messageData.code, { label: '[NexusMessaging]' })) {
+        logger.info('[NexusMessaging] proactive send cancelled — bot paused by the team', { code: messageData.code });
+        return { success: false, messageId: null, status: 'bot_paused', delivered: false, deferred: false };
+      }
     }
     if (!this.provider) throw new Error('No provider initialized');
 
@@ -1027,6 +1032,9 @@ class NexusMessaging {
     if (delivery?.status === 'patient_active') {
       return { decision: 'skipped', rationale: 'la paciente escribió durante la decisión', holdReason: 'patient_active', nextCheckAt: null, draft: null, accepted: false, delivered: false, deferred: false, deliveryStatus: 'patient_active', turnId: runResult.turnId || null, traceId: runResult.traceId || null };
     }
+    if (delivery?.status === 'bot_paused') {
+      return { decision: 'skipped', rationale: 'el equipo pausó el bot durante la decisión', holdReason: 'bot_paused', nextCheckAt: null, draft: null, accepted: false, delivered: false, deferred: false, deliveryStatus: 'bot_paused', turnId: runResult.turnId || null, traceId: runResult.traceId || null };
+    }
     const accepted = Boolean(runResult.output) && delivery?.success === true && delivery?.deferred !== true;
     const delivered = ['delivered', 'read'].includes(String(delivery?.status || '').toLowerCase());
     if (!dryRun && (decision.decision === 'write') !== accepted) {

package/lib/utils/dateUtils.js

@@ -6,13 +6,20 @@ const nowInMexico = (at) => moment(at).tz(MEXICO_TZ).locale('es');
 
 const getCurrentMexicoDateTime = (at) => nowInMexico(at).format(MEXICO_STAMP);
 
+const dayLabel = (day, now) => (day.year() === now.year() ? day.format('dddd D [de] MMMM') : day.format('dddd D [de] MMMM [de] YYYY'));
+
 const getMexicoDayLabels = ({ days, at }) => {
   const now = nowInMexico(at);
   const labels = [];
-  for (let back = days - 1; back >= 0; back -= 1) {
-    const at = now.clone().subtract(back, 'days');
-    labels.push(at.year() === now.year() ? at.format('dddd D [de] MMMM') : at.format('dddd D [de] MMMM [de] YYYY'));
-  }
+  for (let back = days - 1; back >= 0; back -= 1) labels.push(dayLabel(now.clone().subtract(back, 'days'), now));
+  return labels;
+};
+
+// The days after today, nearest first; today itself is not included.
+const getMexicoUpcomingDayLabels = ({ days, at }) => {
+  const now = nowInMexico(at);
+  const labels = [];
+  for (let ahead = 1; ahead <= days; ahead += 1) labels.push(dayLabel(now.clone().add(ahead, 'days'), now));
   return labels;
 };
 
@@ -83,6 +90,7 @@ module.exports = {
   addWorkingMinutes,
   getCurrentMexicoDateTime,
   getMexicoDayLabels,
+  getMexicoUpcomingDayLabels,
   parseDate,
   toIsoInstant,
   ageInYears,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peopl-health/nexus",
-  "version": "5.68.3",
+  "version": "5.69.0-dev.12295",
   "description": "Core messaging and assistant library for WhatsApp communication platforms",
   "keywords": [
     "whatsapp",