@peopl-health/nexus 5.12.5 → 5.12.6

package/lib/clinical/providers/AnthropicProvider.js

@@ -208,7 +208,8 @@ class AnthropicProvider extends BaseLLMProvider {
             const turnContent = Array.isArray(lastUserTurn.content)
               ? lastUserTurn.content
               : [{ type: 'text', text: String(lastUserTurn.content ?? '') }];
-            lastUserTurn.content = [...turnContent, { type: 'text', text: DELIVERY_NUDGE }];
+            const alreadyNudged = turnContent.some(part => part?.type === 'text' && part.text === DELIVERY_NUDGE);
+            if (!alreadyNudged) lastUserTurn.content = [...turnContent, { type: 'text', text: DELIVERY_NUDGE }];
             // The nudge is a model call like any other: gate thinking on it so the per-iteration counter stays honest.
             prepThinking();
             const { result: { result: nudged, retries: nudgeRetries }, durationMs: nudgeDurationMs } = await withTiming(() => makeAPICall(currentMessages));

package/lib/clinical/providers/BaseLLMProvider.js

@@ -16,7 +16,12 @@ const CONVERSATION_CONTINUATION = '(continuar)';
 const NEGATIVE_GUIDANCE_MARKER = '**When NOT to call';
 const TERMINAL_DELIVERY_TOOLS = new Set(['DeliverPatientMessage']);
 const DELIVERY_NUDGE = 'sistema: el turno no puede cerrar sin un mensaje para el paciente. Llama ahora a DeliverPatientMessage con message_text en español. No repitas herramientas clínicas ya ejecutadas en este turno.';
-const MAX_DELIVERY_NUDGES = 1;
+const MAX_DELIVERY_NUDGES = 2;
+const DELIVERY_FALLBACK_MESSAGES = [
+  'Gracias por tu mensaje. Si necesitas apoyo, escríbeme cuando quieras.',
+  'Gracias por escribirme. Aquí estoy cuando necesites algo.',
+  'Recibí tu mensaje. Cuando quieras contarme más o pedir apoyo, escríbeme.',
+];
 
 function isSuperseded(shouldContinue) {
   return typeof shouldContinue === 'function' && !shouldContinue();
@@ -324,7 +329,13 @@ class BaseLLMProvider {
         const result = await this._executeConversation(config);
         // DeliverPatientMessage is the curated patient reply; prefer it over any model narration in the final response.
         const delivered = this._extractDeliveredMessage(config, result);
-        const extractedOutput = delivered?.trim() ? delivered : this._extractMessageOutput(result);
+        let extractedOutput = delivered?.trim() ? delivered : this._extractMessageOutput(result);
+
+        if (!delivered?.trim() && extractedOutput?.trim() && this._deliveryExpected(result)) {
+          logger.warn('[runConversation] Delivery tool offered but never committed — substituting safe fallback for raw narration', { attempt, suppressedLength: extractedOutput.length });
+          config?.assistant?.toolRuntimeContext?.trace?.setSignals?.({ deliveryFallbackUsed: true });
+          extractedOutput = this._deliveryFallbackMessage(config);
+        }
 
         if (extractedOutput?.trim()) {
           result.output_text = extractedOutput;
@@ -371,6 +382,19 @@ class BaseLLMProvider {
     return (toolsExecuted || []).some(t => TERMINAL_DELIVERY_TOOLS.has(t?.tool_name) && this._toolSucceeded(t));
   }
 
+  _deliveryExpected(result) {
+    return (result?.tool_ids || []).some(id => TERMINAL_DELIVERY_TOOLS.has(id));
+  }
+
+  _deliveryFallbackMessage(config) {
+    const key = String(config?.assistant?.toolRuntimeContext?.turnId
+      ?? config?.assistant?.toolRuntimeContext?.patientCode
+      ?? config?.threadId ?? '');
+    let hash = 0;
+    for (let i = 0; i < key.length; i++) hash = (hash * 31 + key.charCodeAt(i)) | 0;
+    return DELIVERY_FALLBACK_MESSAGES[Math.abs(hash) % DELIVERY_FALLBACK_MESSAGES.length];
+  }
+
   _isTerminalOnly(toolNames) {
     return toolNames.length > 0 && toolNames.every(name => TERMINAL_DELIVERY_TOOLS.has(name));
   }
@@ -531,6 +555,7 @@ module.exports = {
   CONVERSATION_CONTINUATION,
   DELIVERY_NUDGE,
   MAX_DELIVERY_NUDGES,
+  DELIVERY_FALLBACK_MESSAGES,
   TERMINAL_DELIVERY_TOOLS,
   isSuperseded,
 };

package/lib/clinical/tools/deliverPatientMessageTool.js

@@ -2,7 +2,7 @@ const { requireGatewayProvider } = require('../config/llmConfig');
 const { renderMessage } = require('../services/composerService');
 const { isComposerEnabled, isAgentSelfRenderEnabled } = require('../flags/composerFlags');
 
-const EMPTY_OUTBOUND_FALLBACK = 'Estoy revisando tu mensaje con detalle, te respondo en un momento.';
+const EMPTY_OUTBOUND_FALLBACK = 'Recibí tu mensaje. Si quieres contarme más o necesitas apoyo, escríbeme.';
 
 const definition = {
   name: 'DeliverPatientMessage',

package/package.json

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