@exulu/backend 4.0.0 → 4.1.0

package/dist/index.cjs

@@ -18648,6 +18648,45 @@ When a tool execution is not approved by the user, do not retry it unless explic
   };
 };
 
+// src/utils/agent-glossary.ts
+init_cjs_shims();
+function extractGlossaryFromAgentTools(tools) {
+  if (!Array.isArray(tools)) return [];
+  const searchTool = tools.find((t) => t?.id === "agentic_context_search");
+  const entry = searchTool?.config?.find((c) => c?.name === "vocabulary");
+  if (entry === void 0 || entry.variable === void 0 || entry.variable === null || entry.variable === "") {
+    return [];
+  }
+  try {
+    const parsed = typeof entry.variable === "string" ? JSON.parse(entry.variable) : entry.variable;
+    const glossary = parsed?.glossary;
+    if (!Array.isArray(glossary)) return [];
+    return glossary.filter(
+      (g) => !!g && typeof g.term === "string" && typeof g.meaning === "string" && g.term.trim().length > 0
+    );
+  } catch (err) {
+    console.warn(
+      "[EXULU] Failed to parse the agentic_context_search vocabulary config while building agent instructions.",
+      err
+    );
+    return [];
+  }
+}
+function formatGlossaryBlock(glossary) {
+  if (!glossary.length) return "";
+  const lines = glossary.map((g) => `${g.term} : ${g.meaning}`).join("\n");
+  return `The organization's documents and internal terminology use the following abbreviations/terms:
+${lines}`;
+}
+function withGlossary(baseInstructions, tools) {
+  const instructions = baseInstructions ?? "";
+  const block = formatGlossaryBlock(extractGlossaryFromAgentTools(tools));
+  if (!block) return instructions;
+  return instructions ? `${block}
+
+${instructions}` : block;
+}
+
 // src/exulu/agent-as-tool.ts
 var createAgentTool = async (instance2, contexts) => {
   const agent = await exuluApp.get().agent(instance2);
@@ -18706,7 +18745,7 @@ var createAgentTool = async (instance2, contexts) => {
       const response = await generateSync({
         agent,
         contexts,
-        instructions: agent.instructions,
+        instructions: withGlossary(agent.instructions, agent.tools),
         prompt: "The user has asked the following question: " + prompt + " and the following information is available: " + information,
         languageModel: resolved.languageModel,
         user,
@@ -21734,7 +21773,7 @@ var recallService = {
       );
       const { text } = await (0, import_ai8.generateText)({
         model: resolved.languageModel,
-        system: agent.instructions || void 0,
+        system: withGlossary(agent.instructions, agent.tools) || void 0,
         prompt: `${prompt.content}
 
 ---
@@ -26527,9 +26566,12 @@ var createExpressRoutes = async (app, tools, contexts, config, evals, tracer) =>
         }
         const approvedTools = req.body.approvedTools ? typeof req.body.approvedTools === "string" ? JSON.parse(req.body.approvedTools) : req.body.approvedTools : [];
         const customInstructions = req.body.customInstructions ? typeof req.body.customInstructions === "string" ? req.body.customInstructions : JSON.stringify(req.body.customInstructions) : "";
-        const instructions = customInstructions ? `${agent.instructions}
+        const instructions = withGlossary(
+          customInstructions ? `${agent.instructions}
 
-${customInstructions}` : agent.instructions;
+${customInstructions}` : agent.instructions,
+          agent.tools
+        );
         if (headers.session) markStreamActive(headers.session);
         const turnStartedAt = Date.now();
         let result;
@@ -26665,9 +26707,12 @@ ${customInstructions}` : agent.instructions;
         return;
       } else {
         const customInstructions = req.body.customInstructions ? typeof req.body.customInstructions === "string" ? req.body.customInstructions : JSON.stringify(req.body.customInstructions) : "";
-        const instructions = customInstructions ? `${agent.instructions}
+        const instructions = withGlossary(
+          customInstructions ? `${agent.instructions}
 
-${customInstructions}` : agent.instructions;
+${customInstructions}` : agent.instructions,
+          agent.tools
+        );
         let response;
         try {
           response = await generateSync({

package/dist/index.js

@@ -9036,6 +9036,44 @@ When a tool execution is not approved by the user, do not retry it unless explic
   };
 };
 
+// src/utils/agent-glossary.ts
+function extractGlossaryFromAgentTools(tools) {
+  if (!Array.isArray(tools)) return [];
+  const searchTool = tools.find((t) => t?.id === "agentic_context_search");
+  const entry = searchTool?.config?.find((c) => c?.name === "vocabulary");
+  if (entry === void 0 || entry.variable === void 0 || entry.variable === null || entry.variable === "") {
+    return [];
+  }
+  try {
+    const parsed = typeof entry.variable === "string" ? JSON.parse(entry.variable) : entry.variable;
+    const glossary = parsed?.glossary;
+    if (!Array.isArray(glossary)) return [];
+    return glossary.filter(
+      (g) => !!g && typeof g.term === "string" && typeof g.meaning === "string" && g.term.trim().length > 0
+    );
+  } catch (err) {
+    console.warn(
+      "[EXULU] Failed to parse the agentic_context_search vocabulary config while building agent instructions.",
+      err
+    );
+    return [];
+  }
+}
+function formatGlossaryBlock(glossary) {
+  if (!glossary.length) return "";
+  const lines = glossary.map((g) => `${g.term} : ${g.meaning}`).join("\n");
+  return `The organization's documents and internal terminology use the following abbreviations/terms:
+${lines}`;
+}
+function withGlossary(baseInstructions, tools) {
+  const instructions = baseInstructions ?? "";
+  const block = formatGlossaryBlock(extractGlossaryFromAgentTools(tools));
+  if (!block) return instructions;
+  return instructions ? `${block}
+
+${instructions}` : block;
+}
+
 // src/exulu/agent-as-tool.ts
 var createAgentTool = async (instance, contexts) => {
   const agent = await exuluApp.get().agent(instance);
@@ -9094,7 +9132,7 @@ var createAgentTool = async (instance, contexts) => {
       const response = await generateSync({
         agent,
         contexts,
-        instructions: agent.instructions,
+        instructions: withGlossary(agent.instructions, agent.tools),
         prompt: "The user has asked the following question: " + prompt + " and the following information is available: " + information,
         languageModel: resolved.languageModel,
         user,
@@ -12081,7 +12119,7 @@ var recallService = {
       );
       const { text } = await generateText4({
         model: resolved.languageModel,
-        system: agent.instructions || void 0,
+        system: withGlossary(agent.instructions, agent.tools) || void 0,
         prompt: `${prompt.content}
 
 ---
@@ -16798,9 +16836,12 @@ var createExpressRoutes = async (app, tools, contexts, config, evals, tracer) =>
         }
         const approvedTools = req.body.approvedTools ? typeof req.body.approvedTools === "string" ? JSON.parse(req.body.approvedTools) : req.body.approvedTools : [];
         const customInstructions = req.body.customInstructions ? typeof req.body.customInstructions === "string" ? req.body.customInstructions : JSON.stringify(req.body.customInstructions) : "";
-        const instructions = customInstructions ? `${agent.instructions}
+        const instructions = withGlossary(
+          customInstructions ? `${agent.instructions}
 
-${customInstructions}` : agent.instructions;
+${customInstructions}` : agent.instructions,
+          agent.tools
+        );
         if (headers.session) markStreamActive(headers.session);
         const turnStartedAt = Date.now();
         let result;
@@ -16936,9 +16977,12 @@ ${customInstructions}` : agent.instructions;
         return;
       } else {
         const customInstructions = req.body.customInstructions ? typeof req.body.customInstructions === "string" ? req.body.customInstructions : JSON.stringify(req.body.customInstructions) : "";
-        const instructions = customInstructions ? `${agent.instructions}
+        const instructions = withGlossary(
+          customInstructions ? `${agent.instructions}
 
-${customInstructions}` : agent.instructions;
+${customInstructions}` : agent.instructions,
+          agent.tools
+        );
         let response;
         try {
           response = await generateSync({

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@exulu/backend",
   "author": "Qventu B.V.",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "main": "./dist/index.js",
   "private": false,
   "publishConfig": {