@peopl-health/nexus 5.71.9 → 5.71.10

package/lib/clinical/services/clinicalExtractionService.js

@@ -78,11 +78,18 @@ async function extractClinicalMentions({ text, turnId, code, provider, detectedT
     const { datosClinicos, contextGaps } = await loadPatientContext(code);
     const vagueWords = await getVagueEntityWords();
 
-    const { result, durationMs } = await withTiming(() => provider.runStructured({
-      presetId,
-      input: [{ role: 'user', content: buildExtractorInput(text, detectedTags, curatedRows, template, { priorTurns, patientContext: datosClinicos }) }],
-      metadata: { extractor: 'clinical-mention', turnId },
-    }));
+    let timed;
+    try {
+      timed = await withTiming(() => provider.runStructured({
+        presetId,
+        input: [{ role: 'user', content: buildExtractorInput(text, detectedTags, curatedRows, template, { priorTurns, patientContext: datosClinicos }) }],
+        metadata: { extractor: 'clinical-mention', turnId },
+      }));
+    } catch (err) {
+      logger.error('[clinicalExtraction] extractor provider unavailable; returning deterministic safety flags only', { turnId, error: err?.message });
+      return { completed: false, unavailable: Boolean(patterns?.length), clinicalMentions: [], safetyFlags: [...flags], safetyFlagSources: sources() };
+    }
+    const { result, durationMs } = timed;
     trace?.addSubCall({ response: result, durationMs, presetId });
 
     if (result?.status && result.status !== 'completed') throw new Error(`clinical extraction incomplete: status=${result.status}`);

package/lib/clinical/tools/extractClinicalInfoTool.js

@@ -38,6 +38,8 @@ function nonClinicalRequestSchema() {
 }
 
 const MAX_CONTEXT_TURNS = 6;
+const EXTRACTOR_UNAVAILABLE = 'extractor_unavailable';
+const ESCALATION_WHILE_UNAVAILABLE = 'described in the patient\'s words and graded on the symptom itself; never mention the extractor or a technical failure, to the patient or the team.';
 
 const definition = {
   name: 'extractClinicalInfo',
@@ -239,13 +241,19 @@ async function handler(args, context = {}) {
     });
   }
 
+  if (!intakeCompleted && extraction.unavailable && !safetyFlags.length && !detectedTags.includes('symptom')) {
+    return degradedIntake(trace);
+  }
+
   if (!intakeCompleted) {
     return JSON.stringify({
       success: false,
       error: 'clinical_intake_incomplete',
       data: {
         safety_flags_received: safetyFlags,
-        recovery: 'Retry extractClinicalInfo with the complete patient message and all applicable supported tags.',
+        recovery: extraction.unavailable
+          ? `The clinical extractor is unavailable and a retry will not succeed. Send what the message reports to the team with reportMedicalEscalation (reportCrisis for a crisis), ${ESCALATION_WHILE_UNAVAILABLE}`
+          : 'Retry extractClinicalInfo with the complete patient message and all applicable supported tags.',
       },
     });
   }
@@ -312,6 +320,10 @@ async function declareNonClinical({ declaredRequest, rawMessage, intakeSource, p
     });
   }
 
+  if (check?.unavailable && !safetyFlags.length) {
+    return degradedIntake(trace, { non_clinical_request: declaredRequest });
+  }
+
   trace?.setSignals?.({ clinicalIntakeCompleted: false, clinicalMentions: [], safetyFlags });
   const supported = [...SUPPORTED_TAGS].sort();
   const reason = found
@@ -325,6 +337,20 @@ async function declareNonClinical({ declaredRequest, rawMessage, intakeSource, p
   });
 }
 
+function degradedIntake(trace, data = {}) {
+  trace?.setSignals?.({ clinicalIntakeCompleted: true, clinicalIntakeDegraded: EXTRACTOR_UNAVAILABLE, clinicalMentions: [], safetyFlags: [] });
+  return JSON.stringify({
+    success: true,
+    data: {
+      ...data,
+      degraded: true,
+      degraded_reasons: [EXTRACTOR_UNAVAILABLE],
+      clinical_facts: [],
+      agent_hint: `The clinical extractor is unavailable, so nothing from this message was recorded as clinical information. Do not call extractClinicalInfo again this turn. A new or worsening symptom goes to the team with reportMedicalEscalation, ${ESCALATION_WHILE_UNAVAILABLE} Anything else gets a reply only.`,
+    },
+  });
+}
+
 async function scanSafetyFlags(text) {
   try {
     const patterns = await getSafetyFlagPatterns();

package/lib/utils/retryUtils.js

@@ -53,6 +53,7 @@ function isAbortError(error) {
 function isRetryableError(error) {
   if (!error) return false;
   if (isAbortError(error)) return false;
+  if (error.code === 'insufficient_quota') return false;
 
   const status = error?.status;
   const code = error?.code;

package/package.json

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