@cognigy/rest-api-client 2025.21.0 → 2025.23.0

package/CHANGELOG.md

@@ -1,8 +1,23 @@
+# 2025.23.0
+Released: November 11th, 2025 
+
+Released state of package up to date with Cognigy.AI v2025.23.0 
+
+# 2025.22.0
+Released: October 28th, 2025 
+
+Released state of package up to date with Cognigy.AI v2025.22.0 
+
 # 2025.21.0
 Released: October 14th, 2025 
 
 Released state of package up to date with Cognigy.AI v2025.21.0 
 
+# 2025.20.0
+Released: October 02nd, 2025 
+
+Released state of package up to date with Cognigy.AI v2025.20.0 
+
 # 2025.19.0
 Released: September 16th, 2025 
 

package/build/apigroups/SimulationAPIGroup_2_0.js

@@ -35,6 +35,10 @@ function SimulationAPIGroup_2_0(instance) {
             var { simulationReference } = _a, args = __rest(_a, ["simulationReference"]);
             return (0, GenericAPIFn_1.GenericAPIFn)(`/testing/beta/simulations/${simulationReference}/schedule`, "POST", self)(args, options);
         },
+        cloneSimulation: (_a, options) => {
+            var { simulationReference } = _a, args = __rest(_a, ["simulationReference"]);
+            return (0, GenericAPIFn_1.GenericAPIFn)(`/testing/beta/simulations/${simulationReference}/clone`, "POST", self)(args, options);
+        },
         indexSimulationRunBatches: (args, options) => (0, GenericAPIFn_1.GenericAPIFn)(`/testing/beta/simulations/batches?${(0, query_1.stringifyQuery)(args)}`, "GET", self)(undefined, options),
         getAllSimulationRunBatches: (_a, options) => {
             var { simulationReference } = _a, args = __rest(_a, ["simulationReference"]);
@@ -59,7 +63,8 @@ function SimulationAPIGroup_2_0(instance) {
         getPersonaOptions: (args, options) => (0, GenericAPIFn_1.GenericAPIFn)("/testing/beta/personas/options", "POST", self)(args, options),
         generatePersona: (args, options) => (0, GenericAPIFn_1.GenericAPIFn)("/testing/beta/personas/generate", "POST", self)(args, options),
         regeneratePersonaField: (args, options) => (0, GenericAPIFn_1.GenericAPIFn)("/testing/beta/personas/regenerate-field", "POST", self)(args, options),
-        generateBulkPersona: (args, options) => (0, GenericAPIFn_1.GenericAPIFn)("/testing/beta/personas/generate-bulk", "POST", self)(args, options)
+        generateBulkPersona: (args, options) => (0, GenericAPIFn_1.GenericAPIFn)("/testing/beta/personas/generate-bulk", "POST", self)(args, options),
+        generatePersonaFromTranscript: (args, options) => (0, GenericAPIFn_1.GenericAPIFn)("/testing/beta/personas/from-transcript", "POST", self)(args, options)
     };
 }
 exports.SimulationAPIGroup_2_0 = SimulationAPIGroup_2_0;

package/build/shared/charts/descriptors/analytics/trackGoal.js

@@ -4,7 +4,7 @@ exports.TRACK_GOAL = void 0;
 /* Custom modules */
 const createNodeDescriptor_1 = require("../../createNodeDescriptor");
 /* Npm modules */
-const uuid_1 = require("uuid");
+const crypto = require("crypto");
 /**
  * Node name: 'trackGoal'
  *
@@ -58,7 +58,7 @@ exports.TRACK_GOAL = (0, createNodeDescriptor_1.createNodeDescriptor)({
         }
         // Create a new cycle id if there is a start step
         if (hasStartStep) {
-            cycleId = (0, uuid_1.v4)();
+            cycleId = crypto.randomUUID();
             activeCycleIds[goalId] = cycleId;
             const sessionStateAnalyticsUpdate = Object.assign(Object.assign({}, sessionState.analytics), { goalCycleIds: activeCycleIds });
             api.setSessionState("analytics", sessionStateAnalyticsUpdate);

package/build/shared/charts/descriptors/connectionNodes/generativeAIProviders/azureOpenAIProviderOauth2Connection.js

@@ -8,7 +8,9 @@ exports.AZURE_OPEN_AI_OAUTH2_PROVIDER_CONNECTION = {
         { fieldName: "clientId", label: "UI__CONNECTION_EDITOR__FIELD_CLIENT_ID" },
         { fieldName: "clientSecret", label: "UI__CONNECTION_EDITOR__FIELD_CLIENT_SECRET" },
         { fieldName: "oauthUrl", label: "UI__CONNECTION_EDITOR__FIELD_OAUTH2_URL" },
-        { fieldName: "scope", label: "UI__CONNECTION_EDITOR__FIELD_SCOPE" }
+        { fieldName: "scope", label: "UI__CONNECTION_EDITOR__FIELD_SCOPE" },
+        { fieldName: "additionalHeaderName", label: "UI__CONNECTION_EDITOR__FIELD_OAUTH2_ADDITIONAL_HEADER_NAME", required: false },
+        { fieldName: "additionalHeaderValue", label: "UI__CONNECTION_EDITOR__FIELD_OAUTH2_ADDITIONAL_HEADER_VALUE", required: false }
     ]
 };
 //# sourceMappingURL=azureOpenAIProviderOauth2Connection.js.map

package/build/shared/charts/descriptors/index.js

@@ -149,6 +149,7 @@ if (process.env.DISABLE_FEATURE_TRANSCRIPT_MANAGER !== "true") {
     nodes.push(service_1.AI_AGENT_JOB_MCP_TOOL);
     nodes.push(service_1.AI_AGENT_JOB_CALL_MCP_TOOL);
     nodes.push(service_1.AI_AGENT_TOOL_ANSWER);
+    nodes.push(service_1.KNOWLEDGE_TOOL);
     nodes.push(service_1.AI_AGENT_HANDOVER);
     nodes.push(service_1.LOAD_AI_AGENT);
 }

package/build/shared/charts/descriptors/knowledgeSearch/searchExtractOutput.js

@@ -23,8 +23,8 @@ const getLanguageName = (languageCode) => {
     // remove the "region" part from language codes (e.g. en-US becomes en, the -US gets stripped)
     const languageOnly = languageCode.split('-')[0];
     // our runtimes support this, but it's not reflected in every project's typings!
-    // this flag is used to reset a breaking-change behavior (returning "flamish" instead of "dutch (belgium)") to its former behavior 
-    // @ts-ignore 
+    // this flag is used to reset a breaking-change behavior (returning "flamish" instead of "dutch (belgium)") to its former behavior
+    // @ts-ignore
     const languageName = (new Intl.DisplayNames(["en-US"], { type: "language", languageDisplay: "standard", fallback: 'none' }).of(languageOnly));
     return languageName;
 };
@@ -656,7 +656,7 @@ exports.SEARCH_EXTRACT_OUTPUT = (0, createNodeDescriptor_1.createNodeDescriptor)
             // add error to context or input
             switch (searchStoreLocation) {
                 case "context":
-                    // @ts-ignore	
+                    // @ts-ignore
                     api.addToContext(searchStoreLocationContextKey, searchStoreDataWithError, "simple");
                     break;
                 default:
@@ -738,7 +738,7 @@ exports.SEARCH_EXTRACT_OUTPUT = (0, createNodeDescriptor_1.createNodeDescriptor)
         // Save result
         switch (searchStoreLocation) {
             case "context":
-                // @ts-ignore	
+                // @ts-ignore
                 api.addToContext(searchStoreLocationContextKey, knowledgeSearchResponseData, "simple");
                 break;
             case "default":
@@ -767,7 +767,7 @@ exports.SEARCH_EXTRACT_OUTPUT = (0, createNodeDescriptor_1.createNodeDescriptor)
         if (documents && (mode !== "s")) {
             // check if we received streamed output at all
             let streamedOutput = false;
-            const isStreamingChannel = input.channel === "webchat3" || input.channel === "adminconsole";
+            const isStreamingChannel = input.endpointType === "webchat3" || input.channel === "adminconsole";
             const _messageId = (0, crypto_1.randomUUID)();
             const promptData = {
                 prompt,

package/build/shared/charts/descriptors/service/GPTPrompt.js

@@ -4,7 +4,7 @@ exports.GPT_PROMPT = void 0;
 /* Custom modules */
 const createNodeDescriptor_1 = require("../../createNodeDescriptor");
 const logic_1 = require("../logic");
-const uuid_1 = require("uuid");
+const crypto = require("crypto");
 const prompt_1 = require("../nlu/generativeSlotFiller/prompt");
 const errors_1 = require("../../../errors");
 const transcripts_1 = require("../../../interfaces/transcripts/transcripts");
@@ -621,7 +621,7 @@ exports.GPT_PROMPT = (0, createNodeDescriptor_1.createNodeDescriptor)({
             // add error to context or input
             switch (storeLocation) {
                 case "context":
-                    // @ts-ignore	
+                    // @ts-ignore
                     api.addToContext(contextKey, errorResponse, "simple");
                     break;
                 default:
@@ -659,8 +659,8 @@ exports.GPT_PROMPT = (0, createNodeDescriptor_1.createNodeDescriptor)({
             }
         };
         try {
-            const isStreamingChannel = input.channel === "webchat3" || input.channel === "adminconsole";
-            const _messageId = (0, uuid_1.v4)();
+            const isStreamingChannel = input.endpointType === "webchat3" || input.channel === "adminconsole";
+            const _messageId = crypto.randomUUID();
             const data = {
                 prompt,
                 temperature,

package/build/shared/charts/descriptors/service/agentTools/knowledgeTool.js

@@ -0,0 +1,340 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KNOWLEDGE_TOOL = void 0;
+/* Custom modules */
+const createNodeDescriptor_1 = require("../../../createNodeDescriptor");
+const transcripts_1 = require("../../../../interfaces/transcripts/transcripts");
+exports.KNOWLEDGE_TOOL = (0, createNodeDescriptor_1.createNodeDescriptor)({
+    type: "knowledgeTool",
+    defaultLabel: "Knowledge Tool",
+    parentType: ["aiAgentJob", "llmPromptV2"],
+    constraints: {
+        editable: true,
+        deletable: true,
+        collapsable: true,
+        creatable: true,
+        movable: true,
+        placement: {
+            predecessor: {
+                whitelist: []
+            }
+        },
+        childFlowCreatable: false
+    },
+    behavior: {
+        stopping: true
+    },
+    preview: {
+        type: "text",
+        key: "toolId"
+    },
+    fields: [
+        {
+            key: "knowledgeStoreId",
+            label: "UI__NODE_EDITOR__SERVICE__AI_AGENT_KNOWLEDGE_TOOL__FIELDS__KNOWLEDGE_STORE__LABEL",
+            type: "knowledgeStoreSelect",
+        },
+        {
+            key: "toolId",
+            label: "UI__NODE_EDITOR__SERVICE__AI_AGENT_TOOL__FIELDS__TOOL_ID__LABEL",
+            description: "UI__NODE_EDITOR__SERVICE__AI_AGENT_TOOL__FIELDS__TOOL_ID__DESCRIPTION",
+            type: "cognigyLLMText",
+            defaultValue: "retrieve_knowledge_and_data",
+            params: {
+                required: true,
+                rows: 1,
+                multiline: false,
+                maxLength: 64,
+            }
+        },
+        {
+            key: "description",
+            label: "UI__NODE_EDITOR__SERVICE__AI_AGENT_TOOL__FIELDS__DESCRIPTION__LABEL",
+            description: "UI__NODE_EDITOR__SERVICE__AI_AGENT_TOOL__FIELDS__DESCRIPTION__DESCRIPTION",
+            type: "cognigyLLMText",
+            defaultValue: "Find the answer to general prompts or questions searching the attached data sources. It focuses exclusively on a knowledge search and does not execute tasks like small talk, calculations, or script running.",
+            params: {
+                required: true,
+                rows: 5,
+                multiline: true
+            }
+        },
+        {
+            key: "parameters",
+            label: "UI__NODE_EDITOR__SERVICE__AI_AGENT_TOOL__FIELDS__PARAMETERS__LABEL",
+            description: "UI__NODE_EDITOR__SERVICE__AI_AGENT_TOOL__FIELDS__PARAMETERS__DESCRIPTION",
+            type: "toolParameters",
+            defaultValue: `{
+	"type": "object",
+	"properties": {
+		"generated_prompt": {
+			"type": "string",
+			"description": "Generated question including the context of the conversation (I want to know...)."
+		},
+		"generated_buffer_phrase": {
+			"type": "string",
+			"description": "A generated delay or stalling phrase. Consider the context. Adapt to your speech style and language."
+		},
+	},
+	"required": ["generated_prompt", "generated_buffer_phrase"],
+	"additionalProperties": false
+}`,
+            params: {
+                required: false,
+            },
+        },
+        {
+            key: "debugMessage",
+            type: "toggle",
+            label: "UI__NODE_EDITOR__SERVICE__AI_AGENT_TOOL__FIELDS__DEBUG_MESSAGE__LABEL",
+            description: "UI__NODE_EDITOR__SERVICE__AI_AGENT_TOOL__FIELDS__DEBUG_MESSAGE__DESCRIPTION",
+            defaultValue: true,
+        },
+        {
+            key: "condition",
+            label: "UI__NODE_EDITOR__SERVICE__AI_AGENT_TOOL__FIELDS__CONDITION__LABEL",
+            description: "UI__NODE_EDITOR__SERVICE__AI_AGENT_TOOL__FIELDS__CONDITION__DESCRIPTION",
+            type: "cognigyText",
+            defaultValue: "",
+        },
+        {
+            key: "topK",
+            type: "slider",
+            label: "UI__NODE_EDITOR__KNOWLEDGE_SEARCH__TOP_K__LABEL",
+            description: "UI__NODE_EDITOR__KNOWLEDGE_SEARCH__TOP_K__DESCRIPTION",
+            defaultValue: 5,
+            params: {
+                min: 1,
+                max: 10
+            }
+        },
+        {
+            key: "storeLocation",
+            type: "select",
+            label: "UI__NODE_EDITOR__SERVICE__AI_AGENT_KNOWLEDGE_TOOL__FIELDS__STORE_LOCATION__LABEL",
+            params: {
+                options: [
+                    {
+                        label: "UI__NODE_EDITOR__SERVICE__AI_AGENT_KNOWLEDGE_TOOL__FIELDS__STORE_LOCATION__OPTIONS__NONE__LABEL",
+                        value: "none"
+                    },
+                    {
+                        label: "UI__NODE_EDITOR__SERVICE__AI_AGENT_KNOWLEDGE_TOOL__FIELDS__STORE_LOCATION__OPTIONS__INPUT__LABEL",
+                        value: "input"
+                    },
+                    {
+                        label: "UI__NODE_EDITOR__SERVICE__AI_AGENT_KNOWLEDGE_TOOL__FIELDS__STORE_LOCATION__OPTIONS__CONTEXT__LABEL",
+                        value: "context"
+                    }
+                ],
+            },
+            defaultValue: "none"
+        },
+        {
+            key: "storeLocationInputKey",
+            type: "cognigyText",
+            label: "UI__NODE_EDITOR__KNOWLEDGE_SEARCH__INPUT_KEY__LABEL",
+            description: "UI__NODE_EDITOR__KNOWLEDGE_SEARCH__INPUT_KEY__DESCRIPTION",
+            defaultValue: "knowledgeSearch",
+            condition: {
+                key: "storeLocation",
+                value: "input"
+            }
+        },
+        {
+            key: "storeLocationContextKey",
+            type: "cognigyText",
+            label: "UI__NODE_EDITOR__KNOWLEDGE_SEARCH__CONTEXT_KEY__LABEL",
+            description: "UI__NODE_EDITOR__KNOWLEDGE_SEARCH__CONTEXT_KEY__DESCRIPTION",
+            defaultValue: "knowledgeSearch",
+            condition: {
+                key: "storeLocation",
+                value: "context"
+            }
+        },
+        {
+            key: "sourceTags",
+            type: "knowledgeSourceTags",
+            label: "UI__NODE_EDITOR__KNOWLEDGE_SEARCH__SOURCE_TAGS__LABEL",
+            description: "UI__NODE_EDITOR__KNOWLEDGE_SEARCH__SOURCE_TAGS__DESCRIPTION",
+            params: {
+                tagLimit: 5
+            }
+        },
+        {
+            key: "sourceTagsFilterOp",
+            type: "select",
+            label: "UI__NODE_EDITOR__KNOWLEDGE_SEARCH__SOURCE_TAGS_FILTER_OP__LABEL",
+            description: "UI__NODE_EDITOR__SEARCH_EXTRACT_OUTPUT__FIELDS__SOURCE_TAGS_FILTER_OP__DESCRIPTION",
+            defaultValue: "and",
+            params: {
+                options: [
+                    {
+                        label: "UI__NODE_EDITOR__SEARCH_EXTRACT_OUTPUT__FIELDS__SOURCE_TAGS_FILTER_OP__OPTIONS__AND__LABEL",
+                        value: "and"
+                    },
+                    {
+                        label: "UI__NODE_EDITOR__SEARCH_EXTRACT_OUTPUT__FIELDS__SOURCE_TAGS_FILTER_OP__OPTIONS__OR__LABEL",
+                        value: "or"
+                    },
+                ]
+            }
+        },
+    ],
+    sections: [
+        {
+            key: "debugging",
+            label: "UI__NODE_EDITOR__SERVICE__AI_AGENT_JOB__SECTIONS__DEBUG_SETTINGS__LABEL",
+            defaultCollapsed: true,
+            fields: [
+                "debugMessage",
+            ],
+        },
+        {
+            key: "advanced",
+            label: "UI__NODE_EDITOR__SERVICE__AI_AGENT_JOB__SECTIONS__ADVANCED__LABEL",
+            defaultCollapsed: true,
+            fields: [
+                "topK",
+                "storeLocation",
+                "storeLocationInputKey",
+                "storeLocationContextKey",
+                "sourceTags",
+                "sourceTagsFilterOp",
+                "condition",
+            ],
+        },
+    ],
+    form: [
+        { type: "field", key: "knowledgeStoreId" },
+        { type: "field", key: "toolId" },
+        { type: "field", key: "description" },
+        { type: "section", key: "debugging" },
+        { type: "section", key: "advanced" },
+    ],
+    appearance: {
+        color: "white",
+        textColor: "#252525",
+        variant: "mini",
+    },
+    function: async ({ cognigy, config, nodeId: thisNodeId }) => {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
+        const { api, context, input } = cognigy;
+        const { knowledgeStoreId, debugMessage, topK, storeLocation, storeLocationInputKey, storeLocationContextKey, sourceTags, sourceTagsFilterOp, } = config;
+        const sessionState = await api.loadSessionState();
+        const toolCall = (_a = sessionState.lastToolCall) === null || _a === void 0 ? void 0 : _a.toolCall;
+        const aiAgentJobNode = (_b = sessionState.lastToolCall) === null || _b === void 0 ? void 0 : _b.aiAgentJobNode;
+        if (!(toolCall === null || toolCall === void 0 ? void 0 : toolCall.id)) {
+            (_c = api.logDebugError) === null || _c === void 0 ? void 0 : _c.call(api, "UI__DEBUG_MODE__AI_AGENT_ANSWER__ERROR__MESSAGE");
+        }
+        if (toolCall && aiAgentJobNode && knowledgeStoreId && (input.text || ((_e = (_d = toolCall === null || toolCall === void 0 ? void 0 : toolCall.function) === null || _d === void 0 ? void 0 : _d.arguments) === null || _e === void 0 ? void 0 : _e.generated_prompt))) {
+            if (!((_f = api.checkThink) === null || _f === void 0 ? void 0 : _f.call(api, thisNodeId))) {
+                let query = ((_h = (_g = toolCall === null || toolCall === void 0 ? void 0 : toolCall.function) === null || _g === void 0 ? void 0 : _g.arguments) === null || _h === void 0 ? void 0 : _h.generated_prompt) || input.text;
+                const data = {
+                    language: input.language,
+                    query,
+                    topK,
+                    traceId: input.traceId,
+                    disableSensitiveLogging: false,
+                    knowledgeStoreIds: [knowledgeStoreId],
+                };
+                const generated_buffer_phrase = (_k = (_j = toolCall === null || toolCall === void 0 ? void 0 : toolCall.function) === null || _j === void 0 ? void 0 : _j.arguments) === null || _k === void 0 ? void 0 : _k.generated_buffer_phrase;
+                if (generated_buffer_phrase) {
+                    // output the generated buffer phrase. Don't add it to the transcript, else the LLM will repeat it next time.
+                    await ((_l = api.output) === null || _l === void 0 ? void 0 : _l.call(api, generated_buffer_phrase, {
+                        _cognigy: {
+                            _preventTranscript: true
+                        }
+                    }));
+                }
+                if (sourceTags && sourceTags.length > 0) {
+                    // convert each knowledgeSourceTag to a string
+                    sourceTags.forEach((tag, index) => {
+                        sourceTags[index] = tag.toString();
+                    });
+                    data.tagsData = {
+                        tags: sourceTags,
+                        op: sourceTagsFilterOp
+                    };
+                }
+                const knowledgeSearchResponse = await api.knowledgeSearch(data);
+                // Handle possible response errors
+                if ((knowledgeSearchResponse === null || knowledgeSearchResponse === void 0 ? void 0 : knowledgeSearchResponse.status) !== "success") {
+                    const errorMessage = (knowledgeSearchResponse === null || knowledgeSearchResponse === void 0 ? void 0 : knowledgeSearchResponse.error) || "empty";
+                    throw new Error(`Error while performing knowledge search. Remote returned error: ${errorMessage}`);
+                }
+                // Store full response data in input or context
+                if (storeLocation === "input" && storeLocationInputKey) {
+                    input[storeLocationInputKey] = knowledgeSearchResponse;
+                }
+                else if (storeLocation === "context" && storeLocationContextKey) {
+                    context[storeLocationContextKey] = knowledgeSearchResponse;
+                }
+                const knowledgeSearchResponseData = knowledgeSearchResponse.data;
+                // Optional Debug Message of Knowledge Search Results
+                if (debugMessage) {
+                    const messageLines = [];
+                    if (query) {
+                        messageLines.push(`\n<b>UI__DEBUG_MODE__AI_AGENT_JOB__KNOWLEDGE_SEARCH__SEARCH_PROMPT</b> ${query}`);
+                    }
+                    if ((_m = knowledgeSearchResponseData === null || knowledgeSearchResponseData === void 0 ? void 0 : knowledgeSearchResponseData.topK) === null || _m === void 0 ? void 0 : _m.length) {
+                        knowledgeSearchResponseData === null || knowledgeSearchResponseData === void 0 ? void 0 : knowledgeSearchResponseData.topK.forEach((result, index) => {
+                            var _a;
+                            messageLines.push(`\nTop ${index + 1}:`);
+                            messageLines.push(`Distance: ${result.distance}`);
+                            messageLines.push(`Source Name: ${(_a = result.sourceMetaData) === null || _a === void 0 ? void 0 : _a.sourceName}`);
+                            messageLines.push(`Text: ${result.text}`);
+                        });
+                    }
+                    else {
+                        messageLines.push("UI__DEBUG_MODE__AI_AGENT_JOB__KNOWLEDGE_SEARCH__NO_RESULTS");
+                    }
+                    (_o = api.logDebugMessage) === null || _o === void 0 ? void 0 : _o.call(api, messageLines.join("\n"), "UI__DEBUG_MODE__AI_AGENT_JOB__KNOWLEDGE_SEARCH__HEADER");
+                }
+                const { flow, node } = aiAgentJobNode;
+                if (flow && node) {
+                    // Add Tool Call Message to Transcript
+                    const toolCallTranscriptStep = {
+                        role: transcripts_1.TranscriptRole.ASSISTANT,
+                        type: transcripts_1.TranscriptEntryType.TOOL_CALL,
+                        source: "system",
+                        payload: {
+                            name: toolCall.function.name,
+                            id: toolCall.id,
+                            input: toolCall.function.arguments,
+                        }
+                    };
+                    await api.addTranscriptStep(toolCallTranscriptStep);
+                    // Add Tool Answer Message to Transcript
+                    const toolAnswer = {
+                        role: transcripts_1.TranscriptRole.TOOL,
+                        type: transcripts_1.TranscriptEntryType.TOOL_ANSWER,
+                        source: "system",
+                        payload: {
+                            toolCallId: toolCall.id,
+                            name: toolCall.function.name,
+                            content: `We have this context as answer from the knowledge source:\n${JSON.stringify(knowledgeSearchResponseData)}`,
+                        }
+                    };
+                    await api.addTranscriptStep(toolAnswer);
+                    api.resetNextNodes();
+                    // remove the call from the session state, because the call has been answered
+                    api.updateSessionStateValues({
+                        lastToolCall: undefined
+                    });
+                    await api.executeFlow({
+                        flowNode: {
+                            flow,
+                            node,
+                        },
+                        absorbContext: true,
+                    });
+                }
+            }
+            else {
+                throw new Error("Infinite Loop Detected");
+            }
+        }
+    }
+});
+//# sourceMappingURL=knowledgeTool.js.map

package/build/shared/charts/descriptors/service/aiAgent/aiAgentJob.js

@@ -12,6 +12,8 @@ var __rest = (this && this.__rest) || function (s, e) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AI_AGENT_JOB = exports.AI_AGENT_TOOLS_WHITELIST = void 0;
+/* Npm modules */
+const crypto = require("crypto");
 /* Custom modules */
 const createNodeDescriptor_1 = require("../../../createNodeDescriptor");
 const setSessionConfig_mapper_1 = require("../../voice/mappers/setSessionConfig.mapper");
@@ -21,9 +23,8 @@ const createSystemMessage_1 = require("./helpers/createSystemMessage");
 const generateSearchPrompt_1 = require("./helpers/generateSearchPrompt");
 const getUserMemory_1 = require("./helpers/getUserMemory");
 const createToolDefinitions_1 = require("./helpers/createToolDefinitions");
-const uuid_1 = require("uuid");
 const transcripts_1 = require("../../../../interfaces/transcripts/transcripts");
-exports.AI_AGENT_TOOLS_WHITELIST = ["aiAgentJobDefault", "aiAgentJobTool", "aiAgentJobMCPTool"];
+exports.AI_AGENT_TOOLS_WHITELIST = ["aiAgentJobDefault", "aiAgentJobTool", "aiAgentJobMCPTool", "knowledgeTool"];
 exports.AI_AGENT_JOB = (0, createNodeDescriptor_1.createNodeDescriptor)({
     type: "aiAgentJob",
     defaultLabel: "AI Agent",
@@ -1207,6 +1208,7 @@ exports.AI_AGENT_JOB = (0, createNodeDescriptor_1.createNodeDescriptor)({
                 rolesWhiteList: [transcripts_1.TranscriptRole.USER, transcripts_1.TranscriptRole.ASSISTANT, transcripts_1.TranscriptRole.TOOL],
                 excludeDataOnlyMessagesFilter: [transcripts_1.TranscriptRole.ASSISTANT],
                 useTextAlternativeForLLM,
+                excludeUserEventMessages: true,
             });
             // For knowledgeSearch "always", we enhance the user input with the knowledge search response data
             if (knowledgeSearchBehavior === "always" &&
@@ -1218,8 +1220,8 @@ exports.AI_AGENT_JOB = (0, createNodeDescriptor_1.createNodeDescriptor)({
                 const enhancedInput = `## Knowledge Source Context\nAdditional Context from the knowledge source: \n${JSON.stringify(knowledgeSearchResponseData)}\n\n\n${((_z = userInput === null || userInput === void 0 ? void 0 : userInput.payload) === null || _z === void 0 ? void 0 : _z.text) || input.text}`;
                 transcript[transcript.length - 1].payload.text = enhancedInput;
             }
-            const isStreamingChannel = input.channel === "webchat3" || input.channel === "adminconsole";
-            const _messageId = (0, uuid_1.v4)();
+            const isStreamingChannel = input.endpointType === "webchat3" || input.channel === "adminconsole";
+            const _messageId = crypto.randomUUID();
             const enableAdvancedLogging = advancedLogging && loggingWebhookUrl && (conditionForLogging === "" || !!conditionForLogging);
             const llmPromptOptions = Object.assign(Object.assign(Object.assign({ prompt: "", chat: systemMessage, 
                 // Temp fix to override the transcript if needed
@@ -1296,7 +1298,7 @@ exports.AI_AGENT_JOB = (0, createNodeDescriptor_1.createNodeDescriptor)({
                 // Find the child node with the toolId of the tool call
                 let toolChild = undefined;
                 for (const child of childConfigs) {
-                    if (child.type === "aiAgentJobTool" && ((_5 = child.config) === null || _5 === void 0 ? void 0 : _5.toolId) && await api.parseCognigyScriptText((_6 = child.config) === null || _6 === void 0 ? void 0 : _6.toolId) === mainToolCall.function.name) {
+                    if (!["aiAgentJobDefault", "aiAgentJobMCPTool"].includes(child.type) && ((_5 = child.config) === null || _5 === void 0 ? void 0 : _5.toolId) && await api.parseCognigyScriptText((_6 = child.config) === null || _6 === void 0 ? void 0 : _6.toolId) === mainToolCall.function.name) {
                         toolChild = child;
                         break;
                     }

package/build/shared/charts/descriptors/service/aiAgent/helpers/createToolDefinitions.js

@@ -35,35 +35,6 @@ const createToolDefinitions = async (childConfigs, api, useStrict) => {
             continue;
         }
         const toolId = child.config.toolId;
-        if ((child.type === "aiAgentJobTool" || child.type === "llmPromptTool") &&
-            (!child.config.condition || !!await api.parseCognigyScriptCondition(child.config.condition))) {
-            if (!toolId) {
-                throw new Error(`Tool ID is missing in Tool Node configuration.`);
-            }
-            const parsedToolId = await api.parseCognigyScriptText(toolId);
-            if (!(0, createSystemMessage_1.validateToolId)(parsedToolId)) {
-                throw new Error(`Tool ID ${parsedToolId} is not valid. Please use only alphanumeric characters, dashes and underscores.`);
-            }
-            if (toolIds.includes(parsedToolId)) {
-                throw new Error(`Tool ID ${parsedToolId} is not unique. Please ensure each tool has a unique id.`);
-            }
-            toolIds.push(parsedToolId);
-            toolNames.push(parsedToolId);
-            const tool = {
-                type: "function",
-                function: {
-                    name: parsedToolId,
-                    description: await api.parseCognigyScriptText(child.config.description),
-                },
-            };
-            if (useStrict) {
-                tool.function.strict = true;
-            }
-            if (child.config.useParameters) {
-                tool.function.parameters = child.config.parameters;
-            }
-            tools.push(tool);
-        }
         if ((child.type === "aiAgentJobMCPTool" || child.type === "llmPromptMCPTool") &&
             (!child.config.condition || !!await api.parseCognigyScriptCondition(child.config.condition))) {
             if (!child.config.mcpServerUrl) {
@@ -76,13 +47,16 @@ const createToolDefinitions = async (childConfigs, api, useStrict) => {
             const toolFilter = child.config.toolFilter;
             const mcpHeaders = child.config.mcpHeaders;
             let mcpTools = null;
+            let fetchedFromCache = null;
             try {
-                mcpTools = await api.fetchMcpTools({
+                const fetched = await api.fetchMcpTools({
                     mcpServerUrl,
                     timeout,
                     cacheTools,
                     mcpHeaders,
                 });
+                mcpTools = fetched.tools;
+                fetchedFromCache = fetched.fromCache;
             }
             catch (error) {
                 const errorDetails = error instanceof Error
@@ -95,11 +69,12 @@ const createToolDefinitions = async (childConfigs, api, useStrict) => {
             }
             if (mcpTools) {
                 if (sendDebug) {
+                    const sourceLabel = fetchedFromCache ? "from cache" : "from MCP server";
                     if (mcpTools.length === 0) {
-                        (_b = api.logDebugMessage) === null || _b === void 0 ? void 0 : _b.call(api, `No tools fetched from MCP Tool "${child.config.name}".`, "MCP Tool");
+                        (_b = api.logDebugMessage) === null || _b === void 0 ? void 0 : _b.call(api, `No tools fetched from MCP Tool "${child.config.name}" (${sourceLabel}).`, "MCP Tool");
                     }
                     if (mcpTools.length > 0) {
-                        const messageLines = [`Fetched tools from MCP Tool "${child.config.name}"`];
+                        const messageLines = [`Fetched tools from MCP Tool "${child.config.name}" (${sourceLabel})`];
                         mcpTools.forEach((tool) => {
                             messageLines.push(`<br>- <b>${tool.name}</b>: ${tool.description}`);
                             if (child.config.debugMessageParameters && tool.inputSchema) {
@@ -164,6 +139,34 @@ const createToolDefinitions = async (childConfigs, api, useStrict) => {
                 tools.push(...structuredMcpTools);
             }
         }
+        if (!["llmPromptMCPTool", "aiAgentJobMCPTool"].includes(child.type) && (!child.config.condition || !!await api.parseCognigyScriptCondition(child.config.condition))) {
+            if (!toolId) {
+                throw new Error(`Tool ID is missing in Tool Node configuration.`);
+            }
+            const parsedToolId = await api.parseCognigyScriptText(toolId);
+            if (!(0, createSystemMessage_1.validateToolId)(parsedToolId)) {
+                throw new Error(`Tool ID ${parsedToolId} is not valid. Please use only alphanumeric characters, dashes and underscores.`);
+            }
+            if (toolIds.includes(parsedToolId)) {
+                throw new Error(`Tool ID ${parsedToolId} is not unique. Please ensure each tool has a unique id.`);
+            }
+            toolIds.push(parsedToolId);
+            toolNames.push(parsedToolId);
+            const tool = {
+                type: "function",
+                function: {
+                    name: parsedToolId,
+                    description: await api.parseCognigyScriptText(child.config.description),
+                },
+            };
+            if (useStrict) {
+                tool.function.strict = true;
+            }
+            if (child.config.useParameters) {
+                tool.function.parameters = child.config.parameters;
+            }
+            tools.push(tool);
+        }
     }
     ;
     return {