@peopl-health/nexus 3.1.5 → 3.2.0

package/lib/core/NexusMessaging.js

@@ -483,6 +483,8 @@ class NexusMessaging {
       const result = await this._processMessages(from, () => replyAssistant(from, body));
       const response = typeof result === 'string' ? result : result?.output;
       const tools_executed = typeof result === 'object' ? result?.tools_executed : undefined;
+      const prompt = typeof result === 'object' ? result?.prompt : undefined;
+      const response_id = typeof result === 'object' ? result?.response_id : undefined;
 
       if (response) {
         await this.sendMessage({
@@ -490,7 +492,9 @@ class NexusMessaging {
           body: response,
           processed: true,
           origin: 'assistant',
-          tools_executed
+          tools_executed,
+          prompt,
+          response_id
         });
       }
     } catch (error) {
@@ -550,6 +554,8 @@ class NexusMessaging {
       const result = await this._processMessages(from, () => replyAssistant(from, fallbackMessage));
       const response = typeof result === 'string' ? result : result?.output;
       const tools_executed = typeof result === 'object' ? result?.tools_executed : undefined;
+      const prompt = typeof result === 'object' ? result?.prompt : undefined;
+      const response_id = typeof result === 'object' ? result?.response_id : undefined;
 
       if (response) {
         await this.sendMessage({
@@ -557,7 +563,9 @@ class NexusMessaging {
           body: response,
           processed: true,
           origin: 'assistant',
-          tools_executed
+          tools_executed,
+          prompt,
+          response_id
         });
       }
     } catch (error) {
@@ -728,6 +736,8 @@ class NexusMessaging {
       
       const botResponse = typeof result === 'string' ? result : result?.output;
       const tools_executed = typeof result === 'object' ? result?.tools_executed : undefined;
+      const prompt = typeof result === 'object' ? result?.prompt : undefined;
+      const response_id = typeof result === 'object' ? result?.response_id : undefined;
 
       if (typingInterval) {
         clearInterval(typingInterval);
@@ -741,7 +751,9 @@ class NexusMessaging {
           body: botResponse,
           processed: true,
           origin: 'assistant',
-          tools_executed
+          tools_executed,
+          prompt,
+          response_id
         });
       }
       

package/lib/helpers/messageHelper.js

@@ -59,11 +59,17 @@ async function getLastMessages(code) {
   }
 }
 
-async function getLastNMessages(code, n) {
+// Create a variable to use as a chackpoint
+async function getLastNMessages(code, n, before=null) {
   try {
-    const lastMessages = await Message.find({ numero: code })
+    const query = { numero: code };
+
+    if (before) query.createdAt = { $lte: before };
+
+    const lastMessages = await Message.find(query)
       .sort({ createdAt: -1 })
-      .limit(n);
+      .limit(n)
+      .lean();
 
     if (!lastMessages || lastMessages.length === 0) {
       logger.info(`[getLastNMessages] No messages found for code: ${code ? `${code.substring(0, 3)}***${code.slice(-4)}` : 'unknown'}, limit: ${n}`);

package/lib/models/messageModel.js

@@ -73,7 +73,9 @@ const messageSchema = new mongoose.Schema({
     errorCode: { type: String, default: null },
     errorMessage: { type: String, default: null },
     updatedAt: { type: Date, default: null }
-  }
+  },
+  prompt: { type: Object, default: null },
+  response_id: { type: String, default: null }
 }, { timestamps: true });
 
 messageSchema.index({ numero: 1, createdAt: -1 });

package/lib/models/threadModel.js

@@ -12,6 +12,7 @@ const threadSchema = new mongoose.Schema({
   active: { type: Boolean, default: true },
   stopped: { type: Boolean, default: false },
   review: { type: Boolean, default: false },
+  version: { type: Number, default: null },
   nextSid: { type: [String], default: [] }
 }, { timestamps: true });
 

package/lib/providers/OpenAIResponsesProvider.js

@@ -175,10 +175,12 @@ class OpenAIResponsesProvider {
    */
   async executeRun({ thread, assistant, tools = [], config = {} }) {
     const { conversationId, assistantId } = this._normalizeThread(thread);
+    const promptVersion = thread?.version || null;
     
     logger.info('[OpenAIResponsesProvider] Starting run', {
       conversationId,
-      assistantId
+      assistantId,
+      promptVersion
     });
 
     try {
@@ -199,7 +201,7 @@ class OpenAIResponsesProvider {
       logger.info('[OpenAIResponsesProvider] Context built', {
         conversationId,
         assistantId,
-        lastContext: context[-1] || null
+        context
       });
 
       const filter = thread.code ? { code: thread.code, active: true } : null;
@@ -219,6 +221,7 @@ class OpenAIResponsesProvider {
         tools,
         context,
         promptVariables,
+        promptVersion,
         assistant,
         ...config
       });
@@ -275,7 +278,8 @@ class OpenAIResponsesProvider {
     model,
     assistant,
     toolMetadata,
-    promptVariables = null,
+    promptVersion = null,
+    promptVariables = null
   } = {}) {
     try {
       const id = this._ensurethreadId(threadId);
@@ -286,9 +290,9 @@ class OpenAIResponsesProvider {
       
       input = input.filter(item => item.type !== 'function_call' && item.type !== 'function_call_output');
 
-      const promptConfig = promptVariables 
-        ? { id: assistantId, variables: promptVariables }
-        : { id: assistantId };
+      const promptConfig = { id: assistantId };
+      if (promptVariables) promptConfig.variables = promptVariables;
+      if (promptVersion) promptConfig.version = String(promptVersion);
       logger.info('[OpenAIResponsesProvider] Prompt config', { promptConfig });
 
       const makeAPICall = (inputData) => retryWithBackoff(() => 

package/lib/services/assistantServiceCore.js

@@ -158,7 +158,9 @@ const replyAssistantCore = async (code, message_ = null, thread_ = null, runOpti
     const finalThread = thread;
 
     const messagesStart = Date.now();
-    const lastMessage = await getLastNMessages(code, 1);
+    const beforeCheckpoint = message_?.createdAt ? 
+      (message_.createdAt.$date ? new Date(message_.createdAt.$date) : message_.createdAt) : null;
+    const lastMessage = await getLastNMessages(code, 1, beforeCheckpoint);
     timings.get_messages_ms = Date.now() - messagesStart;
     
     if (!lastMessage || lastMessage.length === 0 || lastMessage[0].from_me) {
@@ -232,6 +234,8 @@ const replyAssistantCore = async (code, message_ = null, thread_ = null, runOpti
     timings.total_ms = Date.now() - startTotal;
     
     const { output: rawOutput, completed, retries, predictionTimeMs, tools_executed } = runResult;
+    const prompt = runResult.run?.prompt || null;
+    const response_id = runResult.run?.id || null;
     
     const output = sanitizeOutput(rawOutput);
     if (rawOutput !== output) {
@@ -269,7 +273,7 @@ const replyAssistantCore = async (code, message_ = null, thread_ = null, runOpti
       }).catch(err => logger.error('[replyAssistantCore] Failed to store metrics', { error: err.message }));
     }
 
-    return { output, tools_executed };
+    return { output, tools_executed, prompt, response_id };
   } catch (error) {
     logger.error('[replyAssistantCore] Error in reply', { 
       error: error.message,

package/lib/storage/MongoStorage.js

@@ -157,6 +157,8 @@ class MongoStorage {
       raw: messageData.raw || null,
       origin: messageData.origin || 'whatsapp_platform',
       tools_executed: messageData.tools_executed,
+      prompt: messageData.prompt || null,
+      response_id: messageData.response_id || null,
       statusInfo
     };
   }

package/package.json

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

package/MIGRATION_GUIDE.md

@@ -1,80 +0,0 @@
-# Migration Guide
-
-This guide summarizes changes introduced in the current Nexus library refresh to help you migrate quickly with minimal breakage.
-
-## TL;DR
-- Twilio remains first‑class; Baileys is supported for messaging but not for templates/flows (returns clear errors).
-- Message sends accept both `to` (preferred) and legacy `code` (normalized internally).
-- Templates and flows are supported through Twilio Content API; provider is auto‑injected into template controllers on `Nexus.initialize()` when Twilio is active.
-- New event bus + middleware model; existing handlers continue to work.
-- Storage adapter registry; use built‑in `mongo`/`noop` or plug your own adapter or instance.
-- Interactive/flows now have a provider‑agnostic API with Twilio mapping and event‑driven routing.
-- Assistant registry with optional override for `getAssistantById`.
-
-## Messaging API
-- BREAKING (soft): Prefer `to` over `code` in `sendMessage`. Legacy `code` is still accepted and normalized internally.
-
-Before:
-```js
-await nexus.sendMessage({ code: 'whatsapp:+521555...', message: 'Hi' });
-```
-After (preferred):
-```js
-await nexus.sendMessage({ code: '+521555...', message: 'Hi' });
-```
-
-## Templates & Flows (Twilio)
-- Twilio provider now implements content operations: `listTemplates`, `getTemplate`, `createTemplate`, `deleteTemplate`, `submitForApproval`, `checkApprovalStatus`.
-- On `Nexus.initialize()` with Twilio, the provider is auto‑injected into template controllers — default routes under `/api/template` work immediately.
-- Baileys: content/template operations are not supported; a clear error is thrown if called.
-
-## Interactive & Flows (Provider‑agnostic)
-- New helper APIs:
-  - `registerFlow(id, spec)`, `sendInteractive(nexus, { to, id | spec, variables })`.
-  - Twilio: spec is converted to Content API payload and sent; if `spec.contentSid` is provided, it is used directly.
-  - Baileys: currently unsupported.
-- Event‑driven routing:
-  - `registerInteractiveHandler(match, handler)` and `attachInteractiveRouter(nexus)`; handlers are called when interactive messages are received.
-
-## Middleware & Events
-- New event bus on `NexusMessaging`: subscribe to `*:received` and `*:handled` (message, media, interactive, command, keyword, flow).
-- New middleware: `nexus.getMessaging().use(type?, async (msg, nexus, next) => { ... })`.
-- Existing `setHandlers` and `onMessage`/`onInteractive`/etc. continue to work.
-
-## Storage
-- Storage is now pluggable via a registry:
-  - Built‑ins: `mongo` (default), `noop`.
-  - Register your adapter: `registerStorage('src', MyStorageClass)` then `storage: 'src'`.
-  - Or pass an instance: `storage: new MyStorageClass()`.
-- If the adapter has `connect()`, Nexus calls it automatically.
-- Controllers that rely on your Mongo models can continue to do so — no change required.
-
-## Assistants
-- Register assistant classes at init:
-```js
-await nexus.initialize({
-  provider: 'twilio',
-  llm: 'openai', llmConfig: { apiKey: process.env.OPENAI_API_KEY },
-  assistants: {
-    registry: { SUPPORT: SupportAssistantClass, SALES: SalesAssistantClass },
-    getAssistantById: (id, thread) => null // optional override
-  }
-});
-```
-- An internal override for `getAssistantById` is supported; if provided, it is tried first, then fallback to registry.
-
-## Utilities & Fixes
-- Utils index corrected to export existing files: `{ DefaultLLMProvider, MessageParser, logger }`.
-- Default OpenAI import fixed for CommonJS: `const OpenAI = require('openai');`.
-- Message model helpers unified; `LegacyMessage` references replaced with `Message` and a new exported `insertMessage`.
-- Types `declare module` now matches package name: `@peopl-health/nexus`.
-
-## Routes
-- Built‑in route bundles remain available and importable via `setupDefaultRoutes(app)` or per‑group via `routes` + `createRouter()`.
-
-## Testing
-- If your environment restricts forking, run Jest in‑band: `jest --runInBand`.
-
-## Notes
-- Twilio approvals data shape varies by account/region. The provider looks up `content.links` and falls back to the documented REST path; data is normalized where possible.
-- Baileys: templates/flows remain unsupported; messaging and media send/receive are supported.