@cognigy/rest-api-client 2025.15.1 → 2025.17.0

package/dist/esm/shared/charts/descriptors/knowledgeSearch/searchExtractOutput.js

@@ -4,6 +4,7 @@ import { createNodeDescriptor } from "../../createNodeDescriptor";
 import { GO_TO } from "../logic";
 import { writeLLMDebugLogs } from "../nlu/generativeSlotFiller/prompt";
 import { randomUUID } from 'crypto';
+import { isOpenAIChatPrompt } from "../../../generativeAI/getPrompt";
 import { InternalServerError } from "../../../errors";
 /**
  * Returns the simplified english name for a language given a language code
@@ -547,7 +548,7 @@ export const SEARCH_EXTRACT_OUTPUT = createNodeDescriptor({
     },
     tags: ["ai", "knowledgeSearch", "knowledge", "search"],
     function: (knowledgeSearchParams) => __awaiter(void 0, void 0, void 0, function* () {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
         const { cognigy, config, nodeId } = knowledgeSearchParams;
         const { input, api } = cognigy;
         const { topK, searchString, searchStoreLocation, searchStoreLocationContextKey, searchStoreLocationInputKey, searchSourceTags, searchSourceTagsFilterOp, temperature, maxTokens, topP, presencePenalty, frequencyPenalty, useStop, stop, storeLocation, contextKey, inputKey, timeout, timeoutMessage, outputFallback, outputMode, mode, errorHandling, errorHandlingGotoTarget, streamStopTokens, followUpDetection, debugLogTokenCount, debugLogRequestAndCompletion } = config;
@@ -574,53 +575,24 @@ export const SEARCH_EXTRACT_OUTPUT = createNodeDescriptor({
         // check if follow up detection is active and if yes, handle accordingly
         // this is "context aware search"
         if (followUpDetection === "transcript") {
-            let prompt;
-            let lastRoundTrip;
-            // this is a fallback in case the node was created before this function was added and followUpDetectionSteps is undefined
-            followUpDetectionSteps = followUpDetectionSteps || 2;
             // check whether we're in an flow execution that's not the first
             // as it doesn't make sense to check for follow ups in the first execution
             if (input.execution > 1) {
+                // this is a fallback in case the node was created before this function was added and followUpDetectionSteps is undefined
+                followUpDetectionSteps = followUpDetectionSteps || 2;
                 // always remember the last thing the user said (needed later)
-                lastRoundTrip = (_b = cognigy
-                    .lastConversationEntries) === null || _b === void 0 ? void 0 : _b.slice(1, followUpDetectionSteps + 1).reverse().map(entry => "- " + (entry.source === "user" ? "USER: " : "BOT: ") + entry.text).join("\n");
-                // if follow up detection is set to 2 or more, we use the conversation transcript
-                // as reference. Start at the second entry, because the first one is the current
-                const recentConversation = (_c = cognigy
-                    .lastConversationEntries) === null || _c === void 0 ? void 0 : _c.slice(1, followUpDetectionSteps + 1).reverse().map(entry => "- " + (entry.source === "user" ? "USER: " : "BOT: ") + entry.text).join("\n");
-                prompt = `Below is the transcript of a conversation:
-${recentConversation}
-USER: ${searchString}
-Does the last USER input refer to the conversation before?
-Answer with "true" or "false". Answer:`;
-                let promptResponse;
-                // set the detailed results to true to get the token usage
-                const returnDetailedResults = true;
+                const chatHistory = (_b = cognigy
+                    .lastConversationEntries) === null || _b === void 0 ? void 0 : _b.slice(0, followUpDetectionSteps + 1).reverse();
                 try {
-                    const firstFollowUpResponse = yield api.runGenerativeAIPrompt({ prompt, detailedResults: returnDetailedResults }, "answerExtraction");
-                    promptResponse = firstFollowUpResponse.result;
+                    const promptData = {
+                        // set the detailed results to true to get the token usage
+                        detailedResults: true
+                    };
+                    const rephrasedUserQueryResponse = yield api.runGenerativeAIPromptForUseCase(promptData, "answerExtraction", "contextAwareUserQueryRephrasing", getContextAwareUserQueryRephrasingPromptParser(chatHistory));
+                    const promptResponse = rephrasedUserQueryResponse.result;
                     // if we're in adminconsole, process debugging options
-                    writeLLMDebugLogs("Search Extract Output Follow Up Detection", prompt, firstFollowUpResponse, debugLogTokenCount, false, cognigy);
-                    // check if LLM thinks the input was a follow up
-                    if (promptResponse === null || promptResponse === void 0 ? void 0 : promptResponse.toLowerCase().includes("true")) {
-                        prompt = `You are tasked to rewrite a question based on a context, so that the question is clearer.
-
-Example:
-Context: 
-USER: Where is Germany?
-BOT: Germany is in Europe.
-Question: Is that a continent?
-New: Is Europe a continent?
-
-Task: 
-Context:
-${lastRoundTrip}
-Question: ${searchString}
-New: `;
-                        const secondFollowUpResponse = yield api.runGenerativeAIPrompt({ prompt, detailedResults: returnDetailedResults }, "answerExtraction");
-                        promptResponse = secondFollowUpResponse.result;
-                        // if we're in adminconsole, process debugging options
-                        writeLLMDebugLogs("Search Extract Output Follow Up Detection 2", prompt, secondFollowUpResponse, debugLogTokenCount, false, cognigy);
+                    writeLLMDebugLogs("Search Extract Output Follow Up Detection", prompt, rephrasedUserQueryResponse, debugLogTokenCount, false, cognigy);
+                    if ((promptResponse === null || promptResponse === void 0 ? void 0 : promptResponse.toLowerCase()) !== "false") {
                         // the actual search string to now use is the rewritten question
                         actualSearchString = promptResponse;
                         api.logDebugMessage(`UI__DEBUG_MODE__SEO__MESSAGE '${actualSearchString}'`);
@@ -634,7 +606,7 @@ New: `;
         let knowledgeSearchResponseData;
         // handle errors from external services, depending on the settings
         const handleServiceError = (error) => __awaiter(void 0, void 0, void 0, function* () {
-            var _m;
+            var _l;
             const compactError = {
                 message: (error === null || error === void 0 ? void 0 : error.message) || error,
             };
@@ -670,7 +642,7 @@ New: `;
                     isSnapshotError: !!(metadata === null || metadata === void 0 ? void 0 : metadata.snapshotId),
                 });
             }
-            if ((_m = error === null || error === void 0 ? void 0 : error.originalErrorDetails) === null || _m === void 0 ? void 0 : _m.code) {
+            if ((_l = error === null || error === void 0 ? void 0 : error.originalErrorDetails) === null || _l === void 0 ? void 0 : _l.code) {
                 compactError["code"] = error.originalErrorDetails.code;
             }
             let searchStoreDataWithError = {
@@ -743,7 +715,7 @@ New: `;
         // Perform knowledge search
         try {
             // Set understood to true so that the interaction doesn't look false in our analytics
-            (_d = api.setAnalyticsData) === null || _d === void 0 ? void 0 : _d.call(api, "understood", "true");
+            (_c = api.setAnalyticsData) === null || _c === void 0 ? void 0 : _c.call(api, "understood", "true");
             input.understood = true;
             const knowledgeSearchResponse = yield api.knowledgeSearch(data);
             writeLLMDebugLogs("Search Extract Output Embeddings Call", data.query, undefined, debugLogTokenCount, false, cognigy);
@@ -776,7 +748,7 @@ New: `;
         }
         // #endregion 1 Perform Search
         // #region 2 Perform Answer Extraction
-        let documents = (_e = knowledgeSearchResponseData === null || knowledgeSearchResponseData === void 0 ? void 0 : knowledgeSearchResponseData.topK) === null || _e === void 0 ? void 0 : _e.map(result => result === null || result === void 0 ? void 0 : result.text).join(' ');
+        let documents = (_d = knowledgeSearchResponseData === null || knowledgeSearchResponseData === void 0 ? void 0 : knowledgeSearchResponseData.topK) === null || _d === void 0 ? void 0 : _d.map(result => result === null || result === void 0 ? void 0 : result.text).join(' ');
         const replacedUserInput = input.text + (actualSearchString !== input.text ? ` possibly meaning "${actualSearchString}"` : "");
         prompt = prompt.replace(/@userInput/g, replacedUserInput);
         prompt = prompt.replace(/@foundDocuments/g, documents);
@@ -981,7 +953,7 @@ New: `;
                                                 {
                                                     "separator": true,
                                                     "type": "TextBlock",
-                                                    "text": (_f = knowledgeSearchResponseData === null || knowledgeSearchResponseData === void 0 ? void 0 : knowledgeSearchResponseData.topK) === null || _f === void 0 ? void 0 : _f[0].text,
+                                                    "text": (_e = knowledgeSearchResponseData === null || knowledgeSearchResponseData === void 0 ? void 0 : knowledgeSearchResponseData.topK) === null || _e === void 0 ? void 0 : _e[0].text,
                                                     "wrap": true,
                                                     "spacing": "Padding"
                                                 }
@@ -1002,7 +974,7 @@ New: `;
                     "version": "1.6"
                 };
                 // @ts-ignore
-                if ((_j = (_h = (_g = knowledgeSearchResponseData === null || knowledgeSearchResponseData === void 0 ? void 0 : knowledgeSearchResponseData.topK) === null || _g === void 0 ? void 0 : _g[0]) === null || _h === void 0 ? void 0 : _h.chunkMetaData) === null || _j === void 0 ? void 0 : _j.url) {
+                if ((_h = (_g = (_f = knowledgeSearchResponseData === null || knowledgeSearchResponseData === void 0 ? void 0 : knowledgeSearchResponseData.topK) === null || _f === void 0 ? void 0 : _f[0]) === null || _g === void 0 ? void 0 : _g.chunkMetaData) === null || _h === void 0 ? void 0 : _h.url) {
                     ADAPTIVE_CARD_RESULT.body[2].items[0].columns[1].items.push({
                         "type": "ActionSet",
                         "actions": [
@@ -1010,7 +982,7 @@ New: `;
                                 "type": "Action.OpenUrl",
                                 "title": "Open Source",
                                 // @ts-ignore
-                                "url": (_k = knowledgeSearchResponseData === null || knowledgeSearchResponseData === void 0 ? void 0 : knowledgeSearchResponseData.topK) === null || _k === void 0 ? void 0 : _k[0].chunkMetaData.url
+                                "url": (_j = knowledgeSearchResponseData === null || knowledgeSearchResponseData === void 0 ? void 0 : knowledgeSearchResponseData.topK) === null || _j === void 0 ? void 0 : _j[0].chunkMetaData.url
                             }
                         ],
                         "separator": true
@@ -1040,7 +1012,7 @@ New: `;
                                 yield api.output(promptResponse, null);
                             }
                             else if (mainPromptResponse.finishReason) {
-                                (_l = api.output) === null || _l === void 0 ? void 0 : _l.call(api, "", {
+                                (_k = api.output) === null || _k === void 0 ? void 0 : _k.call(api, "", {
                                     _cognigy: {
                                         _preventTranscript: true,
                                         _messageId,
@@ -1065,4 +1037,30 @@ New: `;
         }
     })
 });
+/**
+ * Parses the prompt for the context-aware user query rephrasing.
+ * It replaces the "@@chatHistory" variable with the chat history messages.
+ * It replaces the "@@userQuery" variable with the last user message.
+ *
+ * @param chatHistory - The chat history to be used for context.
+ * @return A function that takes a raw prompt and returns the modified prompt.
+ */
+export function getContextAwareUserQueryRephrasingPromptParser(chatHistory) {
+    return (rawPrompt) => {
+        if (isOpenAIChatPrompt(rawPrompt)) {
+            const modifiedPrompt = [...rawPrompt];
+            for (const message of chatHistory) {
+                const role = message.source === "user" ? "user" : "assistant";
+                modifiedPrompt.push({
+                    role,
+                    content: message.text
+                });
+            }
+            return modifiedPrompt;
+        }
+        else {
+            throw new InternalServerError(`Invalid prompt type for context-aware user query rephrasing. Expected a chat prompt.`);
+        }
+    };
+}
 //# sourceMappingURL=searchExtractOutput.js.map

package/dist/esm/shared/charts/descriptors/logic/if/if.js

@@ -53,13 +53,13 @@ export const IF = createNodeDescriptor({
         switch (type) {
             case "rule":
                 {
-                    isConditionTrue = api.evaluateRule(rule);
+                    isConditionTrue = yield api.evaluateRule(rule);
                 }
                 break;
             case "condition":
             default:
                 {
-                    isConditionTrue = api.parseCognigyScriptCondition(condition);
+                    isConditionTrue = yield api.parseCognigyScriptCondition(condition);
                 }
                 break;
         }

package/dist/esm/shared/charts/descriptors/logic/switch/switch.js

@@ -188,32 +188,41 @@ export const SWITCH = createNodeDescriptor({
              * by mistake, then CS has already been parsed,
              * causing the parser return empty string.
              */
-            parsedOperator = (_a = api.parseCognigyScriptText(`{{${operator}}}`)) !== null && _a !== void 0 ? _a : operator;
+            parsedOperator = (_a = (yield api.parseCognigyScriptText(`{{${operator}}}`))) !== null && _a !== void 0 ? _a : operator;
             if (parsedOperator === "") {
                 parsedOperator = operator;
             }
         }
-        const matchedCase = children === null || children === void 0 ? void 0 : children.find((child) => {
-            var _a, _b;
-            if (child.type !== "case") {
-                return;
+        let matchedCase = undefined;
+        if (children) {
+            for (const child of children) {
+                if (child.type !== "case") {
+                    continue;
+                }
+                const check = () => __awaiter(void 0, void 0, void 0, function* () {
+                    var _b, _c;
+                    if (useStrict) {
+                        return (yield api.parseCognigyScriptText(`${(_b = child.config.case.value) === null || _b === void 0 ? void 0 : _b.trim()}`)) === parsedOperator;
+                    }
+                    else {
+                        /**
+                         * We cast the case
+                         * and the operator to strings to avoid issues
+                         * where e.g. the case contains a string but the
+                         * operator is a number. We do not support switching on
+                         * objects
+                         */
+                        const parsedCognigyScriptText = `${yield api.parseCognigyScriptText(`${(_c = child.config.case.value) === null || _c === void 0 ? void 0 : _c.trim()}`)}`;
+                        const parsedOperatorString = `${parsedOperator}`;
+                        return parsedCognigyScriptText === parsedOperatorString;
+                    }
+                });
+                if (yield check()) {
+                    matchedCase = child;
+                    break;
+                }
             }
-            if (useStrict) {
-                return api.parseCognigyScriptText(`${(_a = child.config.case.value) === null || _a === void 0 ? void 0 : _a.trim()}`) === parsedOperator;
-            }
-            else {
-                /**
-                 * We cast the case
-                 * and the operator to strings to avoid issues
-                 * where e.g. the case contains a string but the
-                 * operator is a number. We do not support switching on
-                 * objects
-                 */
-                const parsedCognigyScriptText = `${api.parseCognigyScriptText(`${(_b = child.config.case.value) === null || _b === void 0 ? void 0 : _b.trim()}`)}`;
-                const parsedOperatorString = `${parsedOperator}`;
-                return parsedCognigyScriptText === parsedOperatorString;
-            }
-        });
+        }
         if (matchedCase) {
             api.setNextNode(matchedCase.id);
             return;

package/dist/esm/shared/charts/descriptors/message/question/question.js

@@ -1897,7 +1897,7 @@ DO NOT talk about other topics. Do not offer general assistance.`,
         // set input.result, so we can use it for validation
         input.result = result;
         // Verify that answer is valid based on some other conditions defined in the function
-        const isValid = validateQuestionAnswer(cognigy, config);
+        const isValid = yield validateQuestionAnswer(cognigy, config);
         if (!isValid) {
             input.result = null;
         }
@@ -2055,7 +2055,7 @@ DO NOT talk about other topics. Do not offer general assistance.`,
         // if a result location was specified, try to get the result from that location 
         // if the location returns a falsey value, the answer is invalid
         if (resultLocation && result) {
-            result = api.parseCognigyScriptResultLocation(resultLocation);
+            result = yield api.parseCognigyScriptResultLocation(resultLocation);
             // If we want detailed results, augment the result object accordingly
             if (storeDetailedResults && result !== null && result !== undefined) {
                 result = {
@@ -2408,7 +2408,7 @@ DO NOT talk about other topics. Do not offer general assistance.`,
             // #region 5.2.3 Reprompt
             // check if there is an extra condition defined for reprompts and check whether it was truthy
             if (sayReprompt && repromptCondition) {
-                const repromptConditionResult = !!api.parseCognigyScriptCondition(repromptCondition);
+                const repromptConditionResult = !!(yield api.parseCognigyScriptCondition(repromptCondition));
                 !repromptConditionResult && api.logDebugMessage(`UI__DEBUG_MODE__QUESTION__MESSAGE_6`, "Skipping Reprompt Message");
                 sayReprompt = repromptConditionResult;
             }

package/dist/esm/shared/charts/descriptors/message/question/utils/validateQuestionAnswer.js

@@ -1,10 +1,11 @@
-export const validateQuestionAnswer = (cognigy, config) => {
+import { __awaiter } from "tslib";
+export const validateQuestionAnswer = (cognigy, config) => __awaiter(void 0, void 0, void 0, function* () {
     const { additionalValidation, escalateIntentsAction, escalateIntentsThreshold, escalateIntentsValidIntents } = config;
     const { input, api } = cognigy;
     let isValid = true;
     // check if there is an extra condition defined and check whether it was truthy
     if (additionalValidation) {
-        const additionalValidationResult = !!api.parseCognigyScriptCondition(additionalValidation);
+        const additionalValidationResult = !!(yield api.parseCognigyScriptCondition(additionalValidation));
         !additionalValidationResult && api.logDebugMessage(`UI__DEBUG_MODE__QUESTION__MESSAGE_7`, "Invalid Answer");
         isValid = additionalValidationResult;
     }
@@ -16,5 +17,5 @@ export const validateQuestionAnswer = (cognigy, config) => {
         }
     }
     return isValid;
-};
+});
 //# sourceMappingURL=validateQuestionAnswer.js.map

package/dist/esm/shared/charts/descriptors/nlu/generativeSlotFiller/prompt.js

@@ -151,6 +151,10 @@ export const writeLLMDebugLogs = (label, prompt, response, debugLogTokenCount, d
                     completionTokenMessage = ` (${completionTokens} Tokens)`;
                 }
             }
+            let promptString = prompt;
+            if (typeof prompt != "string") {
+                promptString = promptToString(prompt);
+            }
             let inputLabelKey = "UI__DEBUG_MODE__LLM_PROMPT__FULL_REQUEST__REQUEST";
             let headerKey = "UI__DEBUG_MODE__LLM_PROMPT__FULL_REQUEST__HEADER";
             if (nodeType === "llmPromptV2") {
@@ -158,7 +162,7 @@ export const writeLLMDebugLogs = (label, prompt, response, debugLogTokenCount, d
                 headerKey = "UI__DEBUG_MODE__LLM_PROMPT__FULL_REQUEST__HEADER_WITH_SYSTEM_PROMPT";
             }
             ;
-            api.logDebugMessage(`${inputLabelKey}${requestTokenMessage}:<br>${prompt}<br><br>UI__DEBUG_MODE__LLM_PROMPT__FULL_REQUEST__COMPLETION${completionTokenMessage}:<br>${responseOutputFormatted}`, headerKey);
+            api.logDebugMessage(`${inputLabelKey}${requestTokenMessage}:<br>${promptString}<br><br>UI__DEBUG_MODE__LLM_PROMPT__FULL_REQUEST__COMPLETION${completionTokenMessage}:<br>${responseOutputFormatted}`, headerKey);
         }
         catch (err) { }
     }
@@ -198,4 +202,28 @@ export const convertChatToPrompt = (chat) => {
     prompt += "assistant: ";
     return prompt;
 };
+/**
+ * Converts a TALLPrompts object into a string representation.
+ * @param prompt The prompt to convert to a string
+ * @returns The string representation of the prompt
+ */
+export function promptToString(prompt) {
+    if ("prompt" in prompt) {
+        // TCompletionPrompt
+        return prompt.prompt;
+    }
+    else if ("messages" in prompt) {
+        // TChatPrompt
+        return prompt.messages
+            .map((msg) => `[${msg.role}] ${msg.content}`)
+            .join("\n");
+    }
+    else if (Array.isArray(prompt)) {
+        // OpenAIChatMessage[]
+        return prompt
+            .map((msg) => `[${msg.role}] ${msg.content}`)
+            .join("\n");
+    }
+    return "";
+}
 //# sourceMappingURL=prompt.js.map

package/dist/esm/shared/charts/descriptors/service/aiAgent/aiAgentJob.js

@@ -10,6 +10,7 @@ import { generateSearchPrompt } from "./helpers/generateSearchPrompt";
 import { getUserMemory } from "./helpers/getUserMemory";
 import { createToolDefinitions } from "./helpers/createToolDefinitions";
 import { TranscriptEntryType, TranscriptRole } from "../../../../interfaces/transcripts/transcripts";
+export const AI_AGENT_TOOLS_WHITELIST = ["aiAgentJobDefault", "aiAgentJobTool", "aiAgentJobMCPTool"];
 export const AI_AGENT_JOB = createNodeDescriptor({
     type: "aiAgentJob",
     defaultLabel: "AI Agent",
@@ -18,7 +19,7 @@ export const AI_AGENT_JOB = createNodeDescriptor({
         collapsable: true,
         placement: {
             children: {
-                whitelist: ["aiAgentJobDefault", "aiAgentJobTool", "aiAgentJobMCPTool"],
+                whitelist: AI_AGENT_TOOLS_WHITELIST,
             },
         },
     },
@@ -407,6 +408,13 @@ export const AI_AGENT_JOB = createNodeDescriptor({
                 step: 0.1
             }
         },
+        {
+            key: "useTextAlternativeForLLM",
+            label: "UI__NODE_EDITOR__SERVICE__AI_AGENT_JOB__FIELDS__INCLUDE_ALL_OUTPUT_TYPES__LABEL",
+            type: "toggle",
+            description: "UI__NODE_EDITOR__SERVICE__AI_AGENT_JOB__FIELDS__INCLUDE_ALL_OUTPUT_TYPES__DESCRIPTION",
+            defaultValue: true,
+        },
         {
             key: "logErrorToSystem",
             label: "UI__NODE_EDITOR__SERVICE__AI_AGENT_JOB__FIELDS__LOG_TO_SYSTEM__LABEL",
@@ -802,6 +810,7 @@ export const AI_AGENT_JOB = createNodeDescriptor({
                 "timeoutInMs",
                 "maxTokens",
                 "temperature",
+                "useTextAlternativeForLLM",
             ],
         },
         {
@@ -847,9 +856,9 @@ export const AI_AGENT_JOB = createNodeDescriptor({
     ],
     tags: ["ai", "aiAgent"],
     function: ({ cognigy, config, childConfigs, nodeId }) => __awaiter(void 0, void 0, void 0, function* () {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12, _13, _14, _15, _16, _17, _18, _19, _20, _21;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12, _13, _14, _15, _16, _17, _18, _19, _20, _21, _22, _23;
         const { api, context, input, profile, flowReferenceId } = cognigy;
-        const { aiAgent, llmProviderReferenceId, name: jobName, description: jobDescription, instructions: jobInstructions, outputImmediately, toolChoice, useStrict, memoryType, selectedProfileFields, memoryContextInjection, knowledgeSearchBehavior, knowledgeSearchTags, knowledgeSearchTagsFilterOp, knowledgeSearchAiAgentKnowledge, knowledgeSearchJobKnowledge, knowledgeSearchJobStore, knowledgeSearchGenerateSearchPrompt, knowledgeSearchTopK, timeoutInMs, maxTokens, temperature, logErrorToSystem, storeErrorInInput, errorHandling, errorHandlingGotoTarget, errorMessage, debugConfig, debugLogTokenCount, debugLogSystemPrompt, debugLogToolDefinitions, debugResult, debugLogLLMLatency, storeLocation, contextKey, inputKey, streamStoreCopyInInput, streamStopTokens, processImages, transcriptImageHandling, sessionParams } = config;
+        const { aiAgent, llmProviderReferenceId, name: jobName, description: jobDescription, instructions: jobInstructions, outputImmediately, toolChoice, useStrict, memoryType, selectedProfileFields, memoryContextInjection, knowledgeSearchBehavior, knowledgeSearchTags, knowledgeSearchTagsFilterOp, knowledgeSearchAiAgentKnowledge, knowledgeSearchJobKnowledge, knowledgeSearchJobStore, knowledgeSearchGenerateSearchPrompt, knowledgeSearchTopK, timeoutInMs, maxTokens, temperature, useTextAlternativeForLLM, logErrorToSystem, storeErrorInInput, errorHandling, errorHandlingGotoTarget, errorMessage, debugConfig, debugLogTokenCount, debugLogSystemPrompt, debugLogToolDefinitions, debugResult, debugLogLLMLatency, storeLocation, contextKey, inputKey, streamStoreCopyInInput, streamStopTokens, processImages, transcriptImageHandling, sessionParams } = config;
         try {
             if (!aiAgent) {
                 throw new Error("Could not resolve AI Agent reference in AI Agent Node");
@@ -897,7 +906,7 @@ export const AI_AGENT_JOB = createNodeDescriptor({
                     throw new Error(`[VG2] Error on AI Agent Job node. Error message: ${error.message}`);
                 }
             }
-            const _22 = profile, { profileId, accepted_gdpr, prevent_data_collection, privacy_policy } = _22, cleanedProfile = __rest(_22, ["profileId", "accepted_gdpr", "prevent_data_collection", "privacy_policy"]);
+            const _24 = profile, { profileId, accepted_gdpr, prevent_data_collection, privacy_policy } = _24, cleanedProfile = __rest(_24, ["profileId", "accepted_gdpr", "prevent_data_collection", "privacy_policy"]);
             const userMemory = getUserMemory(memoryType, selectedProfileFields, aiAgent, cleanedProfile);
             /**
              *  ----- Knowledge Search Section -----
@@ -1127,7 +1136,8 @@ export const AI_AGENT_JOB = createNodeDescriptor({
             const transcript = yield api.getTranscript({
                 limit: 50,
                 rolesWhiteList: [TranscriptRole.USER, TranscriptRole.ASSISTANT, TranscriptRole.TOOL],
-                excludeDataOnlyMessagesFilter: [TranscriptRole.ASSISTANT]
+                excludeDataOnlyMessagesFilter: [TranscriptRole.ASSISTANT],
+                useTextAlternativeForLLM,
             });
             // For knowledgeSearch "always", we enhance the user input with the knowledge search response data
             if (knowledgeSearchBehavior === "always" &&
@@ -1212,14 +1222,20 @@ export const AI_AGENT_JOB = createNodeDescriptor({
                 const mainToolCall = llmResult.toolCalls[0];
                 let isMcpToolCall = false;
                 // Find the child node with the toolId of the tool call
-                let toolChild = childConfigs.find(child => { var _a, _b; return child.type === "aiAgentJobTool" && ((_a = child.config) === null || _a === void 0 ? void 0 : _a.toolId) && api.parseCognigyScriptText((_b = child.config) === null || _b === void 0 ? void 0 : _b.toolId) === mainToolCall.function.name; });
+                let toolChild = undefined;
+                for (const child of childConfigs) {
+                    if (child.type === "aiAgentJobTool" && ((_5 = child.config) === null || _5 === void 0 ? void 0 : _5.toolId) && (yield api.parseCognigyScriptText((_6 = child.config) === null || _6 === void 0 ? void 0 : _6.toolId)) === mainToolCall.function.name) {
+                        toolChild = child;
+                        break;
+                    }
+                }
                 if (!toolChild && toolMap.has(mainToolCall.function.name)) {
                     // If the tool call is from an MCP tool, set the next node to the corresponding child node
                     toolChild = childConfigs.find(child => child.id === toolMap.get(mainToolCall.function.name));
                     isMcpToolCall = true;
                 }
                 if (mainToolCall.function.name !== "retrieve_knowledge" && toolChild === undefined) {
-                    (_5 = api.logDebugError) === null || _5 === void 0 ? void 0 : _5.call(api, `UI__DEBUG_MODE__AI_AGENT_JOB__TOOL_CALL__ERROR__BODY <b>${mainToolCall.function.name}</b>`, "UI__DEBUG_MODE__AI_AGENT_JOB__TOOL_CALL__ERROR__HEADER");
+                    (_7 = api.logDebugError) === null || _7 === void 0 ? void 0 : _7.call(api, `UI__DEBUG_MODE__AI_AGENT_JOB__TOOL_CALL__ERROR__BODY <b>${mainToolCall.function.name}</b>`, "UI__DEBUG_MODE__AI_AGENT_JOB__TOOL_CALL__ERROR__HEADER");
                 }
                 // Add last tool call to session state for loading it from Tool Answer Node
                 api.updateSessionStateValues({
@@ -1227,21 +1243,21 @@ export const AI_AGENT_JOB = createNodeDescriptor({
                             flow: flowReferenceId,
                             node: nodeId,
                         } }, (isMcpToolCall && {
-                        mcpServerUrl: (_6 = toolChild === null || toolChild === void 0 ? void 0 : toolChild.config) === null || _6 === void 0 ? void 0 : _6.mcpServerUrl,
-                        timeout: (_7 = toolChild === null || toolChild === void 0 ? void 0 : toolChild.config) === null || _7 === void 0 ? void 0 : _7.timeout,
+                        mcpServerUrl: (_8 = toolChild === null || toolChild === void 0 ? void 0 : toolChild.config) === null || _8 === void 0 ? void 0 : _8.mcpServerUrl,
+                        timeout: (_9 = toolChild === null || toolChild === void 0 ? void 0 : toolChild.config) === null || _9 === void 0 ? void 0 : _9.timeout,
                         mcpToolNode: toolChild === null || toolChild === void 0 ? void 0 : toolChild.id,
                     })), { toolCall: mainToolCall }),
                 });
                 // if there are any parameters/arguments, add them to the input slots
                 if (mainToolCall.function.arguments) {
-                    input.aiAgent = Object.assign(Object.assign({}, input.aiAgent), { toolArgs: Object.assign(Object.assign({}, (_9 = (_8 = input.aiAgent) === null || _8 === void 0 ? void 0 : _8.toolArgs) !== null && _9 !== void 0 ? _9 : {}), mainToolCall.function.arguments) });
+                    input.aiAgent = Object.assign(Object.assign({}, input.aiAgent), { toolArgs: Object.assign(Object.assign({}, (_11 = (_10 = input.aiAgent) === null || _10 === void 0 ? void 0 : _10.toolArgs) !== null && _11 !== void 0 ? _11 : {}), mainToolCall.function.arguments) });
                 }
                 // Debug Message for Tool Calls, configured in the Tool Node
-                if ((_10 = toolChild === null || toolChild === void 0 ? void 0 : toolChild.config) === null || _10 === void 0 ? void 0 : _10.debugMessage) {
-                    const toolId = isMcpToolCall ? mainToolCall.function.name : api.parseCognigyScriptText(toolChild.config.toolId);
+                if ((_12 = toolChild === null || toolChild === void 0 ? void 0 : toolChild.config) === null || _12 === void 0 ? void 0 : _12.debugMessage) {
+                    const toolId = isMcpToolCall ? mainToolCall.function.name : yield api.parseCognigyScriptText(toolChild.config.toolId);
                     const messageLines = [`<b>UI__DEBUG_MODE__AI_AGENT_JOB__TOOL_CALL__DEBUG_MESSAGE__HEADER:</b> ${toolId}`];
                     // Arguments / Parameters Slots
-                    const slots = ((_11 = mainToolCall === null || mainToolCall === void 0 ? void 0 : mainToolCall.function) === null || _11 === void 0 ? void 0 : _11.arguments) && Object.keys(mainToolCall.function.arguments);
+                    const slots = ((_13 = mainToolCall === null || mainToolCall === void 0 ? void 0 : mainToolCall.function) === null || _13 === void 0 ? void 0 : _13.arguments) && Object.keys(mainToolCall.function.arguments);
                     const hasSlots = slots && slots.length > 0;
                     messageLines.push(`<b>UI__DEBUG_MODE__AI_AGENT_JOB__TOOL_CALL__DEBUG_MESSAGE__SLOTS</b>${hasSlots ? "" : " -"}`);
                     if (hasSlots) {
@@ -1256,7 +1272,7 @@ export const AI_AGENT_JOB = createNodeDescriptor({
                             messageLines.push(`- ${slot}: ${slotValueAsString}`);
                         });
                     }
-                    (_12 = api.logDebugMessage) === null || _12 === void 0 ? void 0 : _12.call(api, messageLines.join("\n"), "UI__DEBUG_MODE__AI_AGENT_JOB__TOOL_CALL__DEBUG_MESSAGE__HEADER");
+                    (_14 = api.logDebugMessage) === null || _14 === void 0 ? void 0 : _14.call(api, messageLines.join("\n"), "UI__DEBUG_MODE__AI_AGENT_JOB__TOOL_CALL__DEBUG_MESSAGE__HEADER");
                 }
                 if (toolChild) {
                     api.setNextNode(toolChild.id);
@@ -1281,11 +1297,11 @@ export const AI_AGENT_JOB = createNodeDescriptor({
             }
             // Optionally output the result immediately
             if (llmResult.result && outputImmediately && !llmPromptOptions.stream) {
-                yield ((_13 = api.output) === null || _13 === void 0 ? void 0 : _13.call(api, llmResult.result, {}));
+                yield ((_15 = api.output) === null || _15 === void 0 ? void 0 : _15.call(api, llmResult.result, {}));
             }
             else if (llmResult.finishReason && llmPromptOptions.stream) {
                 // send the finishReason as last output for a stream
-                (_14 = api.output) === null || _14 === void 0 ? void 0 : _14.call(api, "", {
+                (_16 = api.output) === null || _16 === void 0 ? void 0 : _16.call(api, "", {
                     _cognigy: {
                         _preventTranscript: true,
                         _messageId,
@@ -1308,7 +1324,7 @@ export const AI_AGENT_JOB = createNodeDescriptor({
             }
             // Add response to Cognigy Input/Context for further usage
             if (storeLocation === "context") {
-                (_15 = api.addToContext) === null || _15 === void 0 ? void 0 : _15.call(api, contextKey, llmResult, "simple");
+                (_17 = api.addToContext) === null || _17 === void 0 ? void 0 : _17.call(api, contextKey, llmResult, "simple");
             }
             else if (storeLocation === "input") {
                 api.addToInput(inputKey, llmResult);
@@ -1321,14 +1337,14 @@ export const AI_AGENT_JOB = createNodeDescriptor({
             const errorDetails = {
                 name: (error === null || error === void 0 ? void 0 : error.name) || "Error",
                 code: (error === null || error === void 0 ? void 0 : error.code) || (error === null || error === void 0 ? void 0 : error.httpStatusCode),
-                message: (error === null || error === void 0 ? void 0 : error.message) || ((_16 = error.originalErrorDetails) === null || _16 === void 0 ? void 0 : _16.message),
+                message: (error === null || error === void 0 ? void 0 : error.message) || ((_18 = error.originalErrorDetails) === null || _18 === void 0 ? void 0 : _18.message),
             };
-            (_17 = api.emitEvent) === null || _17 === void 0 ? void 0 : _17.call(api, "nodeError", { nodeId, flowId: flowReferenceId, errorMessage: error });
+            (_19 = api.emitEvent) === null || _19 === void 0 ? void 0 : _19.call(api, "nodeError", { nodeId, flowId: flowReferenceId, errorMessage: error });
             if (logErrorToSystem) {
-                (_18 = api.log) === null || _18 === void 0 ? void 0 : _18.call(api, "error", JSON.stringify(errorDetails));
+                (_20 = api.log) === null || _20 === void 0 ? void 0 : _20.call(api, "error", JSON.stringify(errorDetails));
             }
             if (errorHandling !== "stop") {
-                (_19 = api.logDebugError) === null || _19 === void 0 ? void 0 : _19.call(api, errorDetails.message + (errorDetails.code ? ` (error code: ${errorDetails.code})` : ""), errorDetails.name);
+                (_21 = api.logDebugError) === null || _21 === void 0 ? void 0 : _21.call(api, errorDetails.message + (errorDetails.code ? ` (error code: ${errorDetails.code})` : ""), errorDetails.name);
             }
             if (storeErrorInInput) {
                 input.aiAgent = input.aiAgent || {};
@@ -1337,7 +1353,7 @@ export const AI_AGENT_JOB = createNodeDescriptor({
             if (errorHandling === "continue") {
                 // output the timeout message
                 if (errorMessage) {
-                    yield ((_20 = api.output) === null || _20 === void 0 ? void 0 : _20.call(api, errorMessage, null));
+                    yield ((_22 = api.output) === null || _22 === void 0 ? void 0 : _22.call(api, errorMessage, null));
                 }
                 // Set default node as next node
                 const defaultChild = childConfigs.find(child => child.type === "aiAgentJobDefault");
@@ -1349,7 +1365,7 @@ export const AI_AGENT_JOB = createNodeDescriptor({
                 if (!errorHandlingGotoTarget) {
                     throw new Error("GoTo Target is required");
                 }
-                if (!((_21 = api.checkThink) === null || _21 === void 0 ? void 0 : _21.call(api, nodeId))) {
+                if (!((_23 = api.checkThink) === null || _23 === void 0 ? void 0 : _23.call(api, nodeId))) {
                     api.resetNextNodes();
                     yield api.executeFlow({
                         flowNode: {

package/dist/esm/shared/charts/descriptors/service/aiAgent/helpers/createToolDefinitions.js

@@ -34,11 +34,11 @@ export const createToolDefinitions = (childConfigs, api, useStrict) => __awaiter
         }
         const toolId = child.config.toolId;
         if ((child.type === "aiAgentJobTool" || child.type === "llmPromptTool") &&
-            (!child.config.condition || !!api.parseCognigyScriptCondition(child.config.condition))) {
+            (!child.config.condition || !!(yield api.parseCognigyScriptCondition(child.config.condition)))) {
             if (!toolId) {
                 throw new Error(`Tool ID is missing in Tool Node configuration.`);
             }
-            const parsedToolId = api.parseCognigyScriptText(toolId);
+            const parsedToolId = yield api.parseCognigyScriptText(toolId);
             if (!validateToolId(parsedToolId)) {
                 throw new Error(`Tool ID ${parsedToolId} is not valid. Please use only alphanumeric characters, dashes and underscores.`);
             }
@@ -51,7 +51,7 @@ export const createToolDefinitions = (childConfigs, api, useStrict) => __awaiter
                 type: "function",
                 function: {
                     name: parsedToolId,
-                    description: api.parseCognigyScriptText(child.config.description),
+                    description: yield api.parseCognigyScriptText(child.config.description),
                 },
             };
             if (useStrict) {
@@ -63,7 +63,7 @@ export const createToolDefinitions = (childConfigs, api, useStrict) => __awaiter
             tools.push(tool);
         }
         if ((child.type === "aiAgentJobMCPTool" || child.type === "llmPromptMCPTool") &&
-            (!child.config.condition || !!api.parseCognigyScriptCondition(child.config.condition))) {
+            (!child.config.condition || !!(yield api.parseCognigyScriptCondition(child.config.condition)))) {
             if (!child.config.mcpServerUrl) {
                 throw new Error(`MCP Server URL is missing in Tool Node configuration.`);
             }