@peopl-health/nexus 5.44.0-dev.6241 → 5.44.0-dev.6258

package/lib/clinical/helpers/llmsHelper.js

@@ -13,7 +13,8 @@ const UNSUPPORTED_RESULT = {
   medical_analysis: 'NOT_MEDICAL',
   medical_relevance: false,
   has_table: false,
-  table_data: null
+  table_data: null,
+  measurements: null
 };
 
 const MIME_MAP = {
@@ -23,22 +24,35 @@ const MIME_MAP = {
 
 const SUPPORTED_MIMES = ['image/jpeg', 'image/png', 'image/gif', 'image/webp'];
 
-const ANALYSIS_MODEL = 'claude-sonnet-4-5-20250929';
+const CONFIDENCE_LEVELS = ['high', 'medium', 'low'];
+
+const DISPLAYED_NUMBER = /^-?\d+(?:[.,]\d+)?$/;
+
+const ANALYSIS_MODEL = 'claude-sonnet-5';
 const MAX_ANALYSIS_TOKENS = 4096;
 
-const ANALYSIS_PROMPT = `Eres un oncólogo clínico con experiencia. Recibirás una imagen que un paciente envió por WhatsApp. Puede ser una receta, un resultado de laboratorio, un estudio de imagen, una nota clínica, la caja de un medicamento, o algo sin relación médica.
+const ANALYSIS_PROMPT = `Eres un oncólogo clínico con experiencia. Recibirás una imagen que un paciente envió por WhatsApp. Puede ser una receta, un resultado de laboratorio, un estudio de imagen, una nota clínica, la pantalla de un aparato de medición casero, la caja de un medicamento, o algo sin relación médica.
 
 Responde ÚNICAMENTE con un objeto JSON, sin texto antes ni después y sin bloque de código, con esta forma exacta:
 
 {
-  "doc_type": "prescription" | "lab_result" | "imaging" | "clinical_note" | "other" | "not_medical",
+  "doc_type": "prescription" | "lab_result" | "imaging" | "clinical_note" | "device_reading" | "other" | "not_medical",
   "quality": "clear" | "unclear" | "incomplete",
   "medical_relevance": true | false,
   "transcription": "<todo el texto legible de la imagen, transcrito tal cual, incluida la letra manuscrita; si la imagen no tiene texto legible, describe en su lugar lo que se ve>",
+  "measurements": [{ "label": "<la etiqueta impresa junto al número: SYS, DIA, PUL, mg/dL, SpO2, °C...>", "value": "<el número tal cual>", "unit": "<la unidad impresa, o null>", "confidence": "high" | "medium" | "low" }] | null,
   "table_md": "<la tabla en markdown>" | null,
   "reading": "<tu lectura clínica, en el formato que corresponde al doc_type>"
 }
 
+Usa "doc_type": "device_reading" cuando la imagen sea la pantalla de un aparato de medición casero (tensiómetro, glucómetro, oxímetro, termómetro, báscula).
+
+Reglas para "measurements": inclúyelo solo cuando doc_type sea "device_reading"; en cualquier otro caso usa null.
+- Es una pantalla LCD de segmentos: los segmentos apagados se ven como sombras grises tenues. Cuenta únicamente los segmentos oscuros y bien contrastados.
+- Incluye una entrada por cada número que tenga una etiqueta impresa al lado. Copia la etiqueta tal como aparece en el aparato.
+- NUNCA conviertas en medición la hora, la fecha, el número de memoria ni el índice de usuario. Esos datos van en "transcription", no aquí.
+- Si no estás seguro de algún dígito, marca esa entrada con "confidence": "low". No adivines.
+
 Reglas para "table_md": inclúyela solo si la imagen contiene una verdadera tabla de filas y columnas. Transcríbela completa, conservando el orden de las columnas, todas las unidades y todos los rangos de referencia tal como aparecen. Verifica la alineación vertical de cada valor con el nombre de su parámetro antes de escribirlo. Si no hay tabla, usa null; nunca expliques por qué no la hay.
 
 Reglas para "reading" según "doc_type":
@@ -52,6 +66,7 @@ Reglas para "reading" según "doc_type":
   - hallazgos clave y anomalías; estructuras normales relevantes; medidas críticas si aplican
   3. Action Items:
   - estudios o proyecciones adicionales recomendadas; limitaciones de la evaluación
+- device_reading: escribe UNA sola línea que nombre el aparato y, si son legibles, la fecha y la hora que muestra la pantalla. NO repitas los valores medidos: esos ya van en "measurements". No los interpretes ni des recomendaciones; la lectura clínica la hace el agente. Ejemplo: "Tensiómetro digital de muñeca Neutek; la pantalla marca el 24/08 a las 5:54 PM."
 - clinical_note / other: resume la información clínica que contiene el documento.
 - not_medical: escribe exactamente NOT_MEDICAL.
 
@@ -109,6 +124,31 @@ const parseAnalysis = (text) => {
   }
 };
 
+const isText = (value) => typeof value === 'string' && value.trim() !== '';
+
+const toMeasurement = (entry) => {
+  if (!entry || typeof entry !== 'object') return null;
+  const { label, value, unit, confidence } = entry;
+  if (!isText(label)) return null;
+  if (unit !== null && unit !== undefined && typeof unit !== 'string') return null;
+
+  const displayed = String(value ?? '').trim();
+  if (!DISPLAYED_NUMBER.test(displayed)) return null;
+
+  return {
+    label: label.trim(),
+    value: displayed,
+    unit: isText(unit) ? unit.trim() : null,
+    confidence: CONFIDENCE_LEVELS.includes(confidence) ? confidence : 'low'
+  };
+};
+
+const toMeasurements = (raw) => {
+  if (!Array.isArray(raw) || !raw.length) return null;
+  const measurements = raw.map(toMeasurement);
+  return measurements.every(Boolean) ? measurements : null;
+};
+
 const toResult = (analysis, rawText) => {
   if (!analysis) return { ...UNSUPPORTED_RESULT, description: rawText, medical_analysis: '' };
 
@@ -116,12 +156,20 @@ const toResult = (analysis, rawText) => {
   const reading = typeof analysis.reading === 'string' ? analysis.reading.trim() : '';
   const transcription = typeof analysis.transcription === 'string' ? analysis.transcription.trim() : '';
 
+  const isDevice = analysis.doc_type === 'device_reading';
+  const measurements = isDevice ? toMeasurements(analysis.measurements) : null;
+
+  let medicalAnalysis = reading;
+  if (analysis.doc_type === 'not_medical') medicalAnalysis = 'NOT_MEDICAL';
+  else if (isDevice && !measurements) medicalAnalysis = 'QUALITY_INSUFFICIENT';
+
   return {
     description: transcription,
-    medical_analysis: analysis.doc_type === 'not_medical' ? 'NOT_MEDICAL' : reading,
+    medical_analysis: medicalAnalysis,
     medical_relevance: analysis.medical_relevance === true,
     has_table: table !== null,
-    table_data: table
+    table_data: table,
+    measurements
   };
 };
 

package/lib/helpers/processHelper.js

@@ -40,6 +40,16 @@ const processTextMessage = (reply) => {
   return [{ type: 'text', text: reply.body }];
 };
 
+const renderMeasurements = (measurements) => {
+  const values = measurements
+    .map(({ label, value, unit }) => [label, value, unit].filter(Boolean).join(' '))
+    .join(' - ');
+  const unsure = measurements.filter(({ confidence }) => confidence !== 'high').map(({ label }) => label);
+  const line = `Valores leídos en pantalla: ${values}.`;
+  if (!unsure.length) return line;
+  return `${line}\nLectura dudosa en ${unsure.join(', ')}: pídele al paciente que confirme ese número antes de darlo por bueno.`;
+};
+
 const processImageFileCore = async (fileName, reply) => {
   const messagesChat = [];
   const timings = { analysis_ms: 0, url_generation_ms: 0 };
@@ -62,6 +72,7 @@ const processImageFileCore = async (fileName, reply) => {
     timings.analysis_ms = analysisDuration;
     
     const invalidAnalysis = ['NOT_MEDICAL', 'QUALITY_INSUFFICIENT'];
+    const unusableAnalysis = invalidAnalysis.some(tag => imageAnalysis?.medical_analysis?.includes(tag));
 
     if (imageAnalysis?.medical_relevance && !isSticker) {
       const { result: presignedUrl, duration: urlDuration } = await withTracing(
@@ -74,11 +85,13 @@ const processImageFileCore = async (fileName, reply) => {
     }
 
     const parts = [];
+    if (!isSticker && !unusableAnalysis && imageAnalysis?.measurements?.length) {
+      parts.push(renderMeasurements(imageAnalysis.measurements));
+    }
     if (!isSticker && imageAnalysis?.has_table && imageAnalysis.table_data) {
       parts.push(imageAnalysis.table_data);
     }
-    if (!isSticker && imageAnalysis?.medical_analysis &&
-        !invalidAnalysis.some(tag => imageAnalysis.medical_analysis.includes(tag))) {
+    if (!isSticker && imageAnalysis?.medical_analysis && !unusableAnalysis) {
       parts.push(imageAnalysis.medical_analysis);
     }
 

package/package.json

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