@peopl-health/nexus 5.45.0-dev.7136 → 5.45.0-dev.7144

package/lib/controllers/patientController.js

@@ -6,6 +6,7 @@ const { isAllowedUrl, redactDirectIdentifiers } = require('../utils/sanitizerUti
 const { getPatientInformation, updatePatientInformation, logPatientChange } = require('../services/patientService');
 const { getTriageHistory } = require('../services/triageHistoryService');
 const { getCarePlanHistory } = require('../services/carePlanHistoryService');
+const { getEscalationContext } = require('../services/escalationContextService');
 const { getPatientTasks, updatePatientTask } = require('../services/patientTaskService');
 const {
   getRecommendationCarousels,
@@ -241,10 +242,25 @@ const logPatientChangeController = async (req, res) => {
   }
 };
 
+const getPatientEscalationContextController = async (req, res) => {
+  try {
+    const context = await getEscalationContext({ code: req.params.code });
+    res.status(200).json({ success: true, context });
+  } catch (error) {
+    logger.error('Error fetching patient escalation context:', {
+      error: redactDirectIdentifiers(String(error.message || '')),
+      stack: redactDirectIdentifiers(String(error.stack || '')),
+      code: redactDirectIdentifiers(String(req.params?.code || '')),
+    });
+    res.status(error.statusCode || 500).json({ success: false, error: error.message });
+  }
+};
+
 module.exports = {
   getPatientInfoController,
   getPatientTriageInfoController,
   getPatientCarePlanController,
+  getPatientEscalationContextController,
   getPatientTasksController,
   getPatientRecommendationCarouselsController,
   getPatientRecommendationCarouselImageController,

package/lib/routes/index.js

@@ -70,6 +70,7 @@ const patientRouteDefinitions = {
   'GET /:code': 'getPatientInfoController',
   'GET /triage/:code': 'getPatientTriageInfoController',
   'GET /careplan/:code': 'getPatientCarePlanController',
+  'GET /escalation-context/:code': 'getPatientEscalationContextController',
   'GET /tasks/:code': 'getPatientTasksController',
   'PATCH /:code': 'updatePatientController',
   'PATCH /tasks/:code/:kind/:recordId': 'updatePatientTaskController',
@@ -214,6 +215,7 @@ const builtInControllers = {
   getPatientInfoController: patientController.getPatientInfoController,
   getPatientTriageInfoController: patientController.getPatientTriageInfoController,
   getPatientCarePlanController: patientController.getPatientCarePlanController,
+  getPatientEscalationContextController: patientController.getPatientEscalationContextController,
   getPatientTasksController: patientController.getPatientTasksController,
   getPatientRecommendationCarouselsController: patientController.getPatientRecommendationCarouselsController,
   getPatientRecommendationCarouselImageController: patientController.getPatientRecommendationCarouselImageController,

package/lib/services/escalationContextService.js

@@ -0,0 +1,81 @@
+const { isoDay } = require('../utils/dateUtils');
+const { logger } = require('../utils/logger');
+const { PATIENT_CODE, redactDirectIdentifiers } = require('../utils/sanitizerUtils');
+const { withTimeout } = require('../utils/timeoutUtils');
+const { ensureWhatsAppFormat } = require('../helpers/twilioHelper');
+const { assembleHistory } = require('../clinical/services/patientHistoryService');
+const { DefaultMemoryManager } = require('../clinical/memory/DefaultMemoryManager');
+
+const { getCarePlanHistory } = require('./carePlanHistoryService');
+const { getPatientInformation } = require('./patientService');
+const { getTriageHistory } = require('./triageHistoryService');
+
+const SECTION_TIMEOUT_MS = 10000;
+const TRIAGE_WINDOW_DAYS = 30;
+const CARE_PLAN_LIMIT = 5;
+const HISTORY_SCOPE = ['closed_cases_90d', 'recurrence_patterns', 'recent_medications', 'patient_reported_procedures'];
+
+const httpError = (statusCode, message) => Object.assign(new Error(message), { statusCode });
+
+function sectionReaders(code, now) {
+  const memoryManager = new DefaultMemoryManager();
+  const triageStart = isoDay(new Date(now - TRIAGE_WINDOW_DAYS * 86400000).toISOString());
+  return {
+    agentContext: () => memoryManager.getClinicalData(code),
+    conversation: () => memoryManager.buildContext({ thread: { code } }),
+    triages: () => getTriageHistory({ code, startDate: triageStart }),
+    carePlan: () => getCarePlanHistory({ code, limit: CARE_PLAN_LIMIT }),
+    history: () => assembleHistory(code, { scope: HISTORY_SCOPE }),
+  };
+}
+
+async function getEscalationContext({ code, now = Date.now(), timeoutMs = SECTION_TIMEOUT_MS } = {}) {
+  const patientCode = ensureWhatsAppFormat(String(code ?? '').trim());
+  if (!PATIENT_CODE.test(patientCode)) throw httpError(400, 'A valid WhatsApp ID is required');
+
+  const patient = await withTimeout(getPatientInformation(patientCode), timeoutMs, 'patient lookup');
+  if (!patient) throw httpError(404, 'Patient not found');
+
+  const readers = sectionReaders(patientCode, now);
+  const names = Object.keys(readers);
+  const outcomes = await Promise.allSettled(names.map((name) => withTimeout(readers[name](), timeoutMs, name)));
+
+  const context = { patientCode, asOf: new Date(now).toISOString(), degradedSections: [] };
+  outcomes.forEach((outcome, index) => {
+    const name = names[index];
+    if (outcome.status === 'fulfilled' && outcome.value != null) {
+      context[name] = outcome.value;
+      return;
+    }
+    context[name] = null;
+    context.degradedSections.push(name);
+    if (outcome.status === 'rejected') {
+      logger.error('[escalationContextService] Section reader failed', {
+        code: patientCode,
+        section: name,
+        error: redactDirectIdentifiers(String(outcome.reason?.message ?? outcome.reason)),
+        stack: redactDirectIdentifiers(String(outcome.reason?.stack ?? '')),
+      });
+    }
+  });
+
+  if (context.conversation) {
+    context.conversation = context.conversation
+      .filter((item) => item.type === 'message')
+      .map(({ role, content }) => ({ role, content }));
+  }
+  if (context.triages) {
+    if (context.triages.pagination?.hasNext) context.degradedSections.push('triages');
+    context.triages = context.triages.records;
+  }
+  if (context.carePlan) {
+    const { records, pagination = null, currentState = null } = context.carePlan;
+    const { degradedSections: carePlanDegraded = [], ...state } = currentState || {};
+    context.carePlan = { records, pagination, currentState: currentState ? state : null };
+    for (const section of carePlanDegraded) context.degradedSections.push(`carePlan.${section}`);
+  }
+
+  return context;
+}
+
+module.exports = { getEscalationContext };

package/lib/utils/sanitizerUtils.js

@@ -149,6 +149,7 @@ function redactDirectIdentifiers(value) {
 }
 
 module.exports = {
+  PATIENT_CODE,
   decodeUnicodeEscapes,
   decodeUnicodeEscapesDeep,
   collectStringsDeep,

package/package.json

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