@peopl-health/nexus 3.7.3 → 3.8.0

package/lib/services/promptComposerService.js

@@ -0,0 +1,94 @@
+const { Config_ID } = require('../config/airtableConfig');
+
+const { logger } = require('../utils/logger');
+const MapCache = require('../utils/MapCache');
+
+const { getRecordByFilter } = require('./airtableService');
+
+const SNIPPET_TYPE_ORDER = ['safety', 'persona', 'context', 'clinical', 'instructions'];
+const CACHE_TTL = 5 * 60 * 1000;
+
+const promptCache = new MapCache({ maxSize: 50, ttl: CACHE_TTL });
+const snippetCache = new MapCache({ maxSize: 200, ttl: CACHE_TTL });
+
+async function fetchBasePrompt(promptId) {
+  const cacheKey = `prompt:${promptId}`;
+  const cached = promptCache.get(cacheKey);
+  if (cached) return cached;
+
+  const records = await getRecordByFilter(Config_ID, 'responses', `{prompt_id} = "${promptId}"`);
+  const record = records?.[0] || null;
+  if (record) promptCache.set(cacheKey, record);
+  return record;
+}
+
+async function fetchSnippets(promptId) {
+  const cacheKey = `snippets:${promptId}`;
+  const cached = snippetCache.get(cacheKey);
+  if (cached) return cached;
+
+  try {
+    const records = await getRecordByFilter(
+      Config_ID,
+      'context_snippets',
+      `FIND("${promptId}", ARRAYJOIN({prompts}))`,
+    );
+    const snippets = records || [];
+    snippetCache.set(cacheKey, snippets);
+    return snippets;
+  } catch (error) {
+    logger.warn('[promptComposer] Failed to fetch snippets, continuing without them', {
+      promptId, error: error.message,
+    });
+    return [];
+  }
+}
+
+function sortSnippets(snippets) {
+  return [...snippets].sort((a, b) => {
+    const aIndex = SNIPPET_TYPE_ORDER.indexOf(a.type || '');
+    const bIndex = SNIPPET_TYPE_ORDER.indexOf(b.type || '');
+    return (aIndex === -1 ? 999 : aIndex) - (bIndex === -1 ? 999 : bIndex);
+  });
+}
+
+function applyVariables(text, variables) {
+  if (!variables || !text) return text || '';
+  return text.replace(/\{\{(\w+)\}\}/g, (_, key) => variables[key] ?? '');
+}
+
+async function composePrompt({ promptId, variables = null, status = null }) {
+  const baseRecord = await fetchBasePrompt(promptId);
+  let baseContent = baseRecord?.content || '';
+
+  const snippets = await fetchSnippets(promptId);
+  const activeSnippets = status
+    ? snippets.filter(s => !s.status || s.status === status)
+    : snippets;
+
+  const sorted = sortSnippets(activeSnippets);
+  const snippetIds = sorted.map(s => s.snippet_id || s.name || 'unknown');
+
+  if (sorted.length > 0) {
+    const snippetTexts = sorted.map(s => s.content).filter(Boolean);
+    baseContent = [baseContent, ...snippetTexts].join('\n\n');
+  }
+
+  const resolvedPrompt = applyVariables(baseContent, variables);
+
+  logger.debug('[promptComposer] Prompt composed', {
+    promptId,
+    snippetCount: sorted.length,
+    snippetIds,
+    resolvedLength: resolvedPrompt.length,
+  });
+
+  return { resolvedPrompt, snippetIds };
+}
+
+function clearCache() {
+  promptCache.clear();
+  snippetCache.clear();
+}
+
+module.exports = { composePrompt, clearCache, _test: { applyVariables, sortSnippets } };

package/package.json

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