@peopl-health/nexus 6.0.0-dev.683 → 6.0.0-dev.702

package/lib/clinical/services/divergenceService.js

@@ -8,12 +8,15 @@ const { runClinicalAgent } = require('./clinicalAgentService');
 
 async function runDivergence({ request, connection, trace, actualMessage }) {
   let post;
+  const startedAt = Date.now();
   try {
     post = await runClinicalAgent(request, connection);
+    logger.debug('[divergence] oracle responded', { runId: request.runId, status: post.status, durationMs: Date.now() - startedAt });
     if (post.status !== 200) {
       return { ok: false, status: post.status, response: post.body };
     }
   } catch (error) {
+    logger.debug('[divergence] oracle errored', { runId: request.runId, error: error.message, durationMs: Date.now() - startedAt });
     return { ok: false, status: 503, response: { error: error.message } };
   }
   const expected = post.body?.run?.sessions?.[0]?.turns?.[0] || {};
@@ -30,12 +33,22 @@ async function runDivergence({ request, connection, trace, actualMessage }) {
 }
 
 async function diverge({ shadow, runId }) {
+  const code = shadow?.context?.patientCode;
   const inputs = shadow?.context?.divergenceInputs;
-  if (!inputs) return null;
-  if (!shadow.result?.completed) return null;
+  if (!inputs) {
+    logger.debug('[divergence] skip: no inputs', { runId, code });
+    return null;
+  }
+  if (!shadow.result?.completed) {
+    logger.debug('[divergence] skip: shadow incomplete', { runId, code });
+    return null;
+  }
 
   const { enabled, baseUrl, timeoutMs } = await divergenceConfig.getOracleConnection();
-  if (!enabled || !baseUrl) return null;
+  if (!enabled || !baseUrl) {
+    logger.debug('[divergence] skip: oracle off', { runId, code });
+    return null;
+  }
 
   const request = {
     runId,
@@ -45,6 +58,7 @@ async function diverge({ shadow, runId }) {
     enabledTools: inputs.toolIds || [],
     additionalInstructions: inputs.additionalInstructions || null,
   };
+  logger.debug('[divergence] oracle request', { runId, code, model: request.model, inputLen: request.input.length, tools: request.enabledTools.length });
 
   const connection = {
     baseUrl,
@@ -57,8 +71,10 @@ async function diverge({ shadow, runId }) {
   });
 
   if (report.ok) {
+    logger.debug('[divergence] classified', { runId, code, result: report.result, emergency: !!report.isEmergencyReview });
     try {
       await getDivergenceModel().record({ shadow, request, report });
+      logger.debug('[divergence] persisted', { runId, code });
     } catch (error) {
       logger.warn('[divergence] persist failed', { runId, error: error.message });
     }

package/lib/clinical/services/shadowService.js

@@ -15,10 +15,14 @@ async function runShadowTurn({
   resolveAssistant,
   executeLLM,
 }) {
-  if (!shouldContinue()) return null;
+  if (!shouldContinue()) {
+    logger.debug('[shadow] superseded pre-run', { code: thread?.code, runId });
+    return null;
+  }
   if (!runId) throw new Error('runShadowTurn requires a runId');
 
   const code = thread.code;
+  logger.debug('[shadow] start', { code, runId, sessionId });
   const shadowThread = cloneShadowThread(thread);
   const shadowAssistant = resolveAssistant(shadowThread);
 
@@ -28,9 +32,11 @@ async function runShadowTurn({
     toolRuntimeContext: context, shadow: true, shouldContinue, additionalInstructions,
   };
 
+  const startedAt = Date.now();
   const result = await runInShadowScope(() =>
     executeLLM(shadowThread, shadowAssistant, runOptions, message),
   );
+  logger.debug('[shadow] done', { code, runId, completed: !!result?.completed, steps: context.trace?.steps?.length || 0, durationMs: Date.now() - startedAt });
 
   return { turnId: runId, context, result };
 }
@@ -40,7 +46,10 @@ function forkShadowTurn({
 }) {
   Promise.resolve()
     .then(() => {
-      if (!isShadowEnabled()) return null;
+      if (!isShadowEnabled()) {
+        logger.debug('[shadow] disabled', { code: thread?.code });
+        return null;
+      }
       return runShadowTurn({
         thread,
         message,

package/package.json

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