@peopl-health/nexus 5.11.0-dev.1125 → 5.11.0-dev.1126

package/lib/clinical/AssistantProcessor.js

@@ -45,7 +45,11 @@ class AssistantProcessor {
 
     if (thread.isInCohort && !runOptions.toolRuntimeContext && runOptions.runId && thread.code) {
       try {
-        runOptions.toolRuntimeContext = new ToolRuntimeContext({ patientCode: thread.code, turnId: runOptions.runId });
+        runOptions.toolRuntimeContext = new ToolRuntimeContext({
+          patientCode: thread.code,
+          turnId: runOptions.runId,
+          shouldContinue: runOptions.shouldContinue,
+        });
       } catch (error) {
         logger.warn('[AssistantProcessor] turn will run untraced', { code: thread.code, error: error.message });
       }
@@ -83,7 +87,6 @@ class AssistantProcessor {
         outbound: output,
         completed: runResult?.completed,
         predictionTimeMs,
-        shouldContinue: runOptions.shouldContinue,
       });
     } catch (error) {
       logger.warn('[AssistantProcessor] trace not stored', {

package/lib/clinical/context/ToolRuntimeContext.js

@@ -8,6 +8,7 @@ class ToolRuntimeContext {
     repos = {},
     contextSource = null,
     shadow = false,
+    shouldContinue = null,
   } = {}) {
     if (typeof patientCode !== 'string' || !patientCode) {
       throw new Error('ToolRuntimeContext requires a non-empty patientCode');
@@ -22,6 +23,7 @@ class ToolRuntimeContext {
     this.patientCode = patientCode;
     this.turnId = turnId;
     this.sessionId = sessionId;
+    this.shouldContinue = shouldContinue;
     this.repos = repos;
     this.contextSource = contextSource;
     this.enabledSkills = [];
@@ -42,13 +44,17 @@ class ToolRuntimeContext {
     return toolData;
   }
 
-  async store({ outbound = null, completed = false, predictionTimeMs = null, shouldContinue = null } = {}) {
+  isLive() {
+    return typeof this.shouldContinue !== 'function' || this.shouldContinue();
+  }
+
+  async store({ outbound = null, completed = false, predictionTimeMs = null } = {}) {
     this.trace.setSignals({ activatedSkills: [...this.activatedSkills].sort() });
     this.trace.setOutbound(outbound);
-    this.trace.setStatus(completed ? 'completed' : 'incomplete');
+    const superseded = !this.isLive();
+    this.trace.setStatus(superseded ? 'superseded' : (completed ? 'completed' : 'incomplete'));
     this.trace.setTimings({ predictionTimeMs });
-    const superseded = shouldContinue && !shouldContinue();
-    if (!superseded) await this.trace.save();
+    await this.trace.save();
   }
 
   setSafetyArtifact(artifact) {

package/lib/clinical/services/clinicalAirtableService.js

@@ -21,16 +21,21 @@ const INTAKE_SOURCE_TO_AIRTABLE = {
   team_relay: 'doctor',
 };
 
-async function auditedWrite({ trace, code, table, write }) {
+async function auditedWrite({ trace, code, table, write, isLive = null }) {
   const entry = { table, at: new Date().toISOString(), ok: false };
-  try {
-    const result = await write();
-    entry.ok = true;
-    const record = Array.isArray(result) ? result[0] : result;
-    if (record?.id) entry.recordId = record.id;
-  } catch (err) {
-    entry.error = err?.message || String(err);
-    logger.error('[clinicalAirtableService] Airtable write failed', { table, code, error: entry.error });
+  if (isLive && !isLive()) {
+    entry.skipped = 'superseded';
+    logger.info('[clinicalAirtableService] Airtable write skipped — turn superseded', { table, code });
+  } else {
+    try {
+      const result = await write();
+      entry.ok = true;
+      const record = Array.isArray(result) ? result[0] : result;
+      if (record?.id) entry.recordId = record.id;
+    } catch (err) {
+      entry.error = err?.message || String(err);
+      logger.error('[clinicalAirtableService] Airtable write failed', { table, code, error: entry.error });
+    }
   }
   if (trace?.setSignals) {
     const existing = Array.isArray(trace.signals?.airtableWrites) ? trace.signals.airtableWrites : [];
@@ -92,10 +97,11 @@ async function recordEmergency({ code, trace, symptom, suspectedCondition = '',
   });
 }
 
-async function recordClinicalIntake({ code, trace, messageRaw, source = 'self' }) {
+async function recordClinicalIntake({ code, trace, messageRaw, source = 'self', isLive = null }) {
   return auditedWrite({
     trace,
     code,
+    isLive,
     table: 'intake',
     write: async () => {
       const patientId = await findIntakePatientRecordId(code);
@@ -110,12 +116,13 @@ async function recordClinicalIntake({ code, trace, messageRaw, source = 'self' }
   });
 }
 
-async function recordReminder({ code, trace, actionType, reminderId, reminderDateUtc, reminderType, description }) {
+async function recordReminder({ code, trace, actionType, reminderId, reminderDateUtc, reminderType, description, isLive = null }) {
   const type = REMINDER_TYPE_TO_AIRTABLE[reminderType] || reminderType;
   if (actionType === 'update') {
     return auditedWrite({
       trace,
       code,
+      isLive,
       table: 'reminder',
       write: async () => {
         const updated = await airtableService.updateRecordByFilter(
@@ -133,6 +140,7 @@ async function recordReminder({ code, trace, actionType, reminderId, reminderDat
   return auditedWrite({
     trace,
     code,
+    isLive,
     table: 'reminder',
     write: () => airtableService.addLinkedRecord(
       Monitoreo_ID,

package/lib/clinical/services/shadowService.js

@@ -27,7 +27,7 @@ async function runShadowTurn({
   const shadowAssistant = resolveAssistant(shadowThread);
 
   const context = new ToolRuntimeContext({
-    patientCode: code, turnId: runId, sessionId, shadow: true,
+    patientCode: code, turnId: runId, sessionId, shadow: true, shouldContinue,
   });
 
   const runOptions = {

package/lib/clinical/tools/extractClinicalInfoTool.js

@@ -153,6 +153,7 @@ async function handler(args, context = {}) {
       trace,
       messageRaw: intakeSummary,
       source: intakeSource,
+      isLive: runtime.isLive?.bind(runtime),
     });
   }
 

package/lib/clinical/tools/schedulePatientReminderTool.js

@@ -107,11 +107,18 @@ async function handler(args = {}, context = {}) {
     };
     trace.setSignals({ reminderIntents: [...existing, intent] });
 
+    const isLive = runtime.isLive?.bind(runtime);
+    const superseded = Boolean(isLive) && !isLive();
+
     if (runtime.patientCode) {
-      try {
-        await dispatchReminder({ intent, patientId: runtime.patientCode });
-      } catch (err) {
-        logger.warn('[schedulePatientReminder] reminder FHIR projection failed; ack unaffected', { turnId, error: err?.message });
+      if (superseded) {
+        logger.info('[schedulePatientReminder] reminder projection skipped — turn superseded', { turnId });
+      } else {
+        try {
+          await dispatchReminder({ intent, patientId: runtime.patientCode });
+        } catch (err) {
+          logger.warn('[schedulePatientReminder] reminder FHIR projection failed; ack unaffected', { turnId, error: err?.message });
+        }
       }
     }
 
@@ -124,6 +131,7 @@ async function handler(args = {}, context = {}) {
         reminderDateUtc: fireMoment.toISOString(),
         reminderType,
         description: storedDescription,
+        isLive,
       });
     }
 

package/package.json

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