@cognigy/rest-api-client 2025.25.0 → 2026.2.0-rc1

package/dist/esm/shared/charts/descriptors/service/agentTools/sendEmailTool.js

@@ -64,6 +64,31 @@ export const SEND_EMAIL_TOOL = createNodeDescriptor({
                 maxLength: 255,
             },
         },
+        {
+            key: "cc",
+            type: "cognigyText",
+            label: "UI__NODE_EDITOR__SMTP__EMAIL_NOTIFICATION__CC__LABEL",
+            description: "UI__NODE_EDITOR__SMTP__EMAIL_NOTIFICATION__CC__DESCRIPTION",
+        },
+        {
+            key: "bcc",
+            type: "cognigyText",
+            label: "UI__NODE_EDITOR__SMTP__EMAIL_NOTIFICATION__BCC__LABEL",
+            description: "UI__NODE_EDITOR__SMTP__EMAIL_NOTIFICATION__BCC__DESCRIPTION",
+        },
+        {
+            key: "priority",
+            type: "select",
+            label: "UI__NODE_EDITOR__SMTP__EMAIL_NOTIFICATION__PRIORITY__LABEL",
+            defaultValue: "normal",
+            params: {
+                options: [
+                    { label: "UI__NODE_EDITOR__SMTP__EMAIL_NOTIFICATION__PRIORITY__HIGH__LABEL", value: "high" },
+                    { label: "UI__NODE_EDITOR__SMTP__EMAIL_NOTIFICATION__PRIORITY__NORMAL__LABEL", value: "normal" },
+                    { label: "UI__NODE_EDITOR__SMTP__EMAIL_NOTIFICATION__PRIORITY__LOW__LABEL", value: "low" }
+                ]
+            }
+        },
         {
             key: "parameters",
             label: "UI__NODE_EDITOR__SERVICE__AI_AGENT_TOOL__FIELDS__PARAMETERS__LABEL",
@@ -113,6 +138,9 @@ export const SEND_EMAIL_TOOL = createNodeDescriptor({
             label: "UI__NODE_EDITOR__SERVICE__AI_AGENT_JOB__SECTIONS__ADVANCED__LABEL",
             defaultCollapsed: true,
             fields: [
+                "cc",
+                "bcc",
+                "priority",
                 "condition"
             ]
         },
@@ -132,7 +160,7 @@ export const SEND_EMAIL_TOOL = createNodeDescriptor({
     function: ({ cognigy, config, nodeId, nodeType, organisationId, projectId, childConfigs }) => __awaiter(void 0, void 0, void 0, function* () {
         var _a, _b, _c, _d, _e, _f, _g;
         const { api, context, input } = cognigy;
-        const { debugMessage, recipient, } = config;
+        const { debugMessage, recipient, cc, bcc, priority, } = config;
         const sessionState = yield 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;
@@ -150,14 +178,15 @@ export const SEND_EMAIL_TOOL = createNodeDescriptor({
                             recipient,
                             subject,
                             message,
-                            cc: "",
-                            bcc: "",
-                            priority: "normal",
+                            cc: cc || "",
+                            bcc: bcc || "",
+                            priority: priority || "normal",
                             async: false,
                             storeLocation: "none",
                             inputKey: "",
                             contextKey: "",
                             stopOnError: false,
+                            senderName: "",
                         },
                         nodeId,
                         nodeType,

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

@@ -10,8 +10,9 @@ import { createSystemMessage, getCognigyBrandMessage } from "./helpers/createSys
 import { generateSearchPrompt } from "./helpers/generateSearchPrompt";
 import { getUserMemory } from "./helpers/getUserMemory";
 import { createToolDefinitions } from "./helpers/createToolDefinitions";
+import { parseMcpHeaders } from "./helpers/parseMcpHeaders";
 import { TranscriptEntryType, TranscriptRole } from "../../../../interfaces/transcripts/transcripts";
-export const AI_AGENT_TOOLS_WHITELIST = ["aiAgentJobDefault", "aiAgentJobTool", "aiAgentJobMCPTool", "knowledgeTool", "handoverToAiAgentTool", "sendEmailTool"];
+export const AI_AGENT_TOOLS_WHITELIST = ["aiAgentJobDefault", "aiAgentJobTool", "aiAgentJobMCPTool", "knowledgeTool", "handoverToAiAgentTool", "handoverToHumanAgentTool", "sendEmailTool", "executeWorkflowTool"];
 export const AI_AGENT_JOB = createNodeDescriptor({
     type: "aiAgentJob",
     defaultLabel: "AI Agent",
@@ -913,7 +914,7 @@ 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, _22, _23, _24;
+        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, _24, _25, _26, _27;
         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, useTextAlternativeForLLM, advancedLogging, loggingWebhookUrl, loggingCustomData, conditionForLogging, logErrorToSystem, storeErrorInInput, errorHandling, errorHandlingGotoTarget, errorMessage, debugConfig, debugLogTokenCount, debugLogSystemPrompt, debugLogToolDefinitions, debugResult, debugLogLLMLatency, storeLocation, contextKey, inputKey, streamStoreCopyInInput, streamStopTokens, processImages, transcriptImageHandling, loggingHeaders, sessionParams } = config;
         try {
@@ -963,7 +964,7 @@ export const AI_AGENT_JOB = createNodeDescriptor({
                     throw new Error(`[VG2] Error on AI Agent Job node. Error message: ${error.message}`);
                 }
             }
-            const _25 = profile, { profileId, accepted_gdpr, prevent_data_collection, privacy_policy } = _25, cleanedProfile = __rest(_25, ["profileId", "accepted_gdpr", "prevent_data_collection", "privacy_policy"]);
+            const _28 = profile, { profileId, accepted_gdpr, prevent_data_collection, privacy_policy } = _28, cleanedProfile = __rest(_28, ["profileId", "accepted_gdpr", "prevent_data_collection", "privacy_policy"]);
             const userMemory = getUserMemory(memoryType, selectedProfileFields, aiAgent, cleanedProfile);
             /**
              *  ----- Knowledge Search Section -----
@@ -1290,13 +1291,15 @@ export const AI_AGENT_JOB = createNodeDescriptor({
                         break;
                     }
                 }
+                let mcpHeaders = (_7 = toolChild === null || toolChild === void 0 ? void 0 : toolChild.config) === null || _7 === void 0 ? void 0 : _7.mcpHeaders;
                 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;
+                    mcpHeaders = yield parseMcpHeaders((_8 = toolChild === null || toolChild === void 0 ? void 0 : toolChild.config) === null || _8 === void 0 ? void 0 : _8.mcpHeaders, api);
                 }
                 if (mainToolCall.function.name !== "retrieve_knowledge" && toolChild === undefined) {
-                    (_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");
+                    (_9 = api.logDebugError) === null || _9 === void 0 ? void 0 : _9.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({
@@ -1304,22 +1307,24 @@ export const AI_AGENT_JOB = createNodeDescriptor({
                             flow: flowReferenceId,
                             node: nodeId,
                         } }, (isMcpToolCall && {
-                        mcpServerUrl: (_8 = toolChild === null || toolChild === void 0 ? void 0 : toolChild.config) === null || _8 === void 0 ? void 0 : _8.mcpServerUrl,
-                        mcpHeaders: (_9 = toolChild === null || toolChild === void 0 ? void 0 : toolChild.config) === null || _9 === void 0 ? void 0 : _9.mcpHeaders,
-                        timeout: (_10 = toolChild === null || toolChild === void 0 ? void 0 : toolChild.config) === null || _10 === void 0 ? void 0 : _10.timeout,
+                        mcpServerUrl: (_10 = toolChild === null || toolChild === void 0 ? void 0 : toolChild.config) === null || _10 === void 0 ? void 0 : _10.mcpServerUrl,
+                        mcpHeaders,
+                        timeout: (_11 = toolChild === null || toolChild === void 0 ? void 0 : toolChild.config) === null || _11 === void 0 ? void 0 : _11.timeout,
                         mcpToolNode: toolChild === null || toolChild === void 0 ? void 0 : toolChild.id,
+                        authType: (_12 = toolChild === null || toolChild === void 0 ? void 0 : toolChild.config) === null || _12 === void 0 ? void 0 : _12.authType,
+                        oAuth2Connection: (_13 = toolChild === null || toolChild === void 0 ? void 0 : toolChild.config) === null || _13 === void 0 ? void 0 : _13.oAuth2Connection,
                     })), { 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({}, (_12 = (_11 = input.aiAgent) === null || _11 === void 0 ? void 0 : _11.toolArgs) !== null && _12 !== void 0 ? _12 : {}), mainToolCall.function.arguments) });
+                    input.aiAgent = Object.assign(Object.assign({}, input.aiAgent), { toolArgs: Object.assign(Object.assign({}, (_15 = (_14 = input.aiAgent) === null || _14 === void 0 ? void 0 : _14.toolArgs) !== null && _15 !== void 0 ? _15 : {}), mainToolCall.function.arguments) });
                 }
                 // Debug Message for Tool Calls, configured in the Tool Node
-                if ((_13 = toolChild === null || toolChild === void 0 ? void 0 : toolChild.config) === null || _13 === void 0 ? void 0 : _13.debugMessage) {
+                if ((_16 = toolChild === null || toolChild === void 0 ? void 0 : toolChild.config) === null || _16 === void 0 ? void 0 : _16.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 = ((_14 = mainToolCall === null || mainToolCall === void 0 ? void 0 : mainToolCall.function) === null || _14 === void 0 ? void 0 : _14.arguments) && Object.keys(mainToolCall.function.arguments);
+                    const slots = ((_17 = mainToolCall === null || mainToolCall === void 0 ? void 0 : mainToolCall.function) === null || _17 === void 0 ? void 0 : _17.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) {
@@ -1334,7 +1339,7 @@ export const AI_AGENT_JOB = createNodeDescriptor({
                             messageLines.push(`- ${slot}: ${slotValueAsString}`);
                         });
                     }
-                    (_15 = api.logDebugMessage) === null || _15 === void 0 ? void 0 : _15.call(api, messageLines.join("\n"), "UI__DEBUG_MODE__AI_AGENT_JOB__TOOL_CALL__DEBUG_MESSAGE__HEADER");
+                    (_18 = api.logDebugMessage) === null || _18 === void 0 ? void 0 : _18.call(api, messageLines.join("\n"), "UI__DEBUG_MODE__AI_AGENT_JOB__TOOL_CALL__DEBUG_MESSAGE__HEADER");
                 }
                 if (toolChild) {
                     api.setNextNode(toolChild.id);
@@ -1359,11 +1364,11 @@ export const AI_AGENT_JOB = createNodeDescriptor({
             }
             // Optionally output the result immediately
             if (llmResult.result && outputImmediately && !llmPromptOptions.stream) {
-                yield ((_16 = api.output) === null || _16 === void 0 ? void 0 : _16.call(api, llmResult.result, {}));
+                yield ((_19 = api.output) === null || _19 === void 0 ? void 0 : _19.call(api, llmResult.result, {}));
             }
             else if (llmResult.finishReason && llmPromptOptions.stream) {
                 // send the finishReason as last output for a stream
-                (_17 = api.output) === null || _17 === void 0 ? void 0 : _17.call(api, "", {
+                (_20 = api.output) === null || _20 === void 0 ? void 0 : _20.call(api, "", {
                     _cognigy: {
                         _preventTranscript: true,
                         _messageId,
@@ -1386,7 +1391,7 @@ export const AI_AGENT_JOB = createNodeDescriptor({
             }
             // Add response to Cognigy Input/Context for further usage
             if (storeLocation === "context") {
-                (_18 = api.addToContext) === null || _18 === void 0 ? void 0 : _18.call(api, contextKey, llmResult, "simple");
+                (_21 = api.addToContext) === null || _21 === void 0 ? void 0 : _21.call(api, contextKey, llmResult, "simple");
             }
             else if (storeLocation === "input") {
                 api.addToInput(inputKey, llmResult);
@@ -1399,14 +1404,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) || ((_19 = error.originalErrorDetails) === null || _19 === void 0 ? void 0 : _19.message),
+                message: (error === null || error === void 0 ? void 0 : error.message) || ((_22 = error.originalErrorDetails) === null || _22 === void 0 ? void 0 : _22.message),
             };
-            (_20 = api.emitEvent) === null || _20 === void 0 ? void 0 : _20.call(api, "nodeError", { nodeId, flowId: flowReferenceId, errorMessage: error });
+            (_23 = api.emitEvent) === null || _23 === void 0 ? void 0 : _23.call(api, "nodeError", { nodeId, flowId: flowReferenceId, errorMessage: error });
             if (logErrorToSystem) {
-                (_21 = api.log) === null || _21 === void 0 ? void 0 : _21.call(api, "error", JSON.stringify(errorDetails));
+                (_24 = api.log) === null || _24 === void 0 ? void 0 : _24.call(api, "error", JSON.stringify(errorDetails));
             }
             if (errorHandling !== "stop") {
-                (_22 = api.logDebugError) === null || _22 === void 0 ? void 0 : _22.call(api, errorDetails.message + (errorDetails.code ? ` (error code: ${errorDetails.code})` : ""), errorDetails.name);
+                (_25 = api.logDebugError) === null || _25 === void 0 ? void 0 : _25.call(api, errorDetails.message + (errorDetails.code ? ` (error code: ${errorDetails.code})` : ""), errorDetails.name);
             }
             if (storeErrorInInput) {
                 input.aiAgent = input.aiAgent || {};
@@ -1415,7 +1420,7 @@ export const AI_AGENT_JOB = createNodeDescriptor({
             if (errorHandling === "continue") {
                 // output the timeout message
                 if (errorMessage) {
-                    yield ((_23 = api.output) === null || _23 === void 0 ? void 0 : _23.call(api, errorMessage, null));
+                    yield ((_26 = api.output) === null || _26 === void 0 ? void 0 : _26.call(api, errorMessage, null));
                 }
                 // Set default node as next node
                 const defaultChild = childConfigs.find(child => child.type === "aiAgentJobDefault");
@@ -1427,7 +1432,7 @@ export const AI_AGENT_JOB = createNodeDescriptor({
                 if (!errorHandlingGotoTarget) {
                     throw new Error("GoTo Target is required");
                 }
-                if (!((_24 = api.checkThink) === null || _24 === void 0 ? void 0 : _24.call(api, nodeId))) {
+                if (!((_27 = api.checkThink) === null || _27 === void 0 ? void 0 : _27.call(api, nodeId))) {
                     api.resetNextNodes();
                     yield api.executeFlow({
                         flowNode: {

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

@@ -1,6 +1,7 @@
 import { __awaiter } from "tslib";
 /* Custom modules */
 import { createNodeDescriptor } from "../../../createNodeDescriptor";
+import { parseMcpHeaders } from "./helpers/parseMcpHeaders";
 import { TranscriptEntryType, TranscriptRole, } from "../../../../interfaces/transcripts/transcripts";
 export const AI_AGENT_JOB_CALL_MCP_TOOL = createNodeDescriptor({
     type: "aiAgentJobCallMCPTool",
@@ -58,7 +59,7 @@ export const AI_AGENT_JOB_CALL_MCP_TOOL = createNodeDescriptor({
             label: "UI__NODE_EDITOR__SERVICE__AI_AGENT_CALL_MCP_TOOL__FIELDS__RESOLVE_IMMEDIATELY__LABEL",
             type: "toggle",
             description: "UI__NODE_EDITOR__SERVICE__AI_AGENT_CALL_MCP_TOOL__FIELDS__RESOLVE_IMMEDIATELY__DESCRIPTION",
-            defaultValue: false,
+            defaultValue: true,
         },
         {
             key: "debugToolResult",
@@ -92,7 +93,7 @@ export const AI_AGENT_JOB_CALL_MCP_TOOL = createNodeDescriptor({
     },
     tags: ["ai", "aiAgent"],
     function: ({ cognigy, config }) => __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, _l, _m, _o, _p;
         const { api } = cognigy;
         const { storeLocation, contextKey, inputKey, resolveImmediately, debugToolResult } = config;
         const sessionState = yield api.loadSessionState();
@@ -100,7 +101,8 @@ export const AI_AGENT_JOB_CALL_MCP_TOOL = createNodeDescriptor({
         const aiAgentJobNode = (_b = sessionState.lastToolCall) === null || _b === void 0 ? void 0 : _b.aiAgentJobNode;
         const mcpServerUrl = (_c = sessionState.lastToolCall) === null || _c === void 0 ? void 0 : _c.mcpServerUrl;
         const timeout = (_d = sessionState.lastToolCall) === null || _d === void 0 ? void 0 : _d.timeout;
-        const mcpHeaders = (_e = sessionState.lastToolCall) === null || _e === void 0 ? void 0 : _e.mcpHeaders;
+        // Use the helper function to parse MCP headers
+        const mcpHeaders = yield parseMcpHeaders((_e = sessionState.lastToolCall) === null || _e === void 0 ? void 0 : _e.mcpHeaders, api);
         if (!(toolCall === null || toolCall === void 0 ? void 0 : toolCall.id)) {
             (_f = api.logDebugError) === null || _f === void 0 ? void 0 : _f.call(api, "UI__DEBUG_MODE__AI_AGENT_ANSWER__ERROR__MESSAGE");
         }
@@ -114,10 +116,12 @@ export const AI_AGENT_JOB_CALL_MCP_TOOL = createNodeDescriptor({
                     toolArgs: toolCall.function.arguments,
                     timeout,
                     mcpHeaders: mcpHeaders !== null && mcpHeaders !== void 0 ? mcpHeaders : {},
+                    authType: (_h = (_g = sessionState.lastToolCall) === null || _g === void 0 ? void 0 : _g.authType) !== null && _h !== void 0 ? _h : "none",
+                    oAuth2Connection: (_j = sessionState.lastToolCall) === null || _j === void 0 ? void 0 : _j.oAuth2Connection,
                 });
                 fullResult = JSON.stringify(toolResult, null, 2);
                 if (debugToolResult) {
-                    (_g = api.logDebugMessage) === null || _g === void 0 ? void 0 : _g.call(api, `Tool <b>${(_h = toolCall === null || toolCall === void 0 ? void 0 : toolCall.function) === null || _h === void 0 ? void 0 : _h.name}</b> called successfully.<br><br><b>Result:</b><br>${fullResult}`);
+                    (_k = api.logDebugMessage) === null || _k === void 0 ? void 0 : _k.call(api, `Tool <b>${(_l = toolCall === null || toolCall === void 0 ? void 0 : toolCall.function) === null || _l === void 0 ? void 0 : _l.name}</b> called successfully.<br><br><b>Result:</b><br>${fullResult}`);
                 }
             }
             catch (error) {
@@ -127,11 +131,11 @@ export const AI_AGENT_JOB_CALL_MCP_TOOL = createNodeDescriptor({
                         message: error.message,
                     }
                     : error;
-                (_j = api.logDebugError) === null || _j === void 0 ? void 0 : _j.call(api, `Failed to execute MCP Tool ${(_k = toolCall === null || toolCall === void 0 ? void 0 : toolCall.function) === null || _k === void 0 ? void 0 : _k.name}:<br>${JSON.stringify(errorDetails, null, 2)}`);
+                (_m = api.logDebugError) === null || _m === void 0 ? void 0 : _m.call(api, `Failed to execute MCP Tool ${(_o = toolCall === null || toolCall === void 0 ? void 0 : toolCall.function) === null || _o === void 0 ? void 0 : _o.name}:<br>${JSON.stringify(errorDetails, null, 2)}`);
             }
             // Add result to Cognigy Input/Context for further usage
             if (storeLocation === "context") {
-                (_l = api.addToContext) === null || _l === void 0 ? void 0 : _l.call(api, contextKey, toolResult, "simple");
+                (_p = api.addToContext) === null || _p === void 0 ? void 0 : _p.call(api, contextKey, toolResult, "simple");
             }
             else if (storeLocation === "input") {
                 api.addToInput(inputKey, toolResult);

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

@@ -1,5 +1,15 @@
 /* Custom modules */
 import { createNodeDescriptor } from "../../../createNodeDescriptor";
+export const AI_AGENT_MCP_TOOL_CONNECTION_OAUTH2 = {
+    type: "mcp_oauth2",
+    label: "UI__NODE_EDITOR__MCP_OAUTH2_CONNECTION__LABEL",
+    fields: [
+        { fieldName: "oAuth2Url", label: "UI__CONNECTION_EDITOR__FIELD_OAUTH2_URL" },
+        { fieldName: "oAuth2ClientId", label: "UI__CONNECTION_EDITOR__FIELD_CLIENT_ID" },
+        { fieldName: "oAuth2ClientSecret", label: "UI__CONNECTION_EDITOR__FIELD_CLIENT_SECRET" },
+        { fieldName: "oAuth2Scope", label: "UI__CONNECTION_EDITOR__FIELD_SCOPE" }
+    ]
+};
 export const AI_AGENT_JOB_MCP_TOOL = createNodeDescriptor({
     type: "aiAgentJobMCPTool",
     defaultLabel: "MCP Tool",
@@ -167,8 +177,53 @@ export const AI_AGENT_JOB_MCP_TOOL = createNodeDescriptor({
             description: "UI__NODE_EDITOR__SERVICE__AI_AGENT_MCP_TOOL__FIELDS__HEADERS__DESCRIPTION",
             defaultValue: "{}",
         },
+        {
+            key: "oAuth2Connection",
+            type: "connection",
+            label: "UI__NODE_EDITOR__SERVICE__AI_AGENT_MCP_TOOL__FIELDS__OAUTH2_CONNECTION__LABEL",
+            params: {
+                connectionType: AI_AGENT_MCP_TOOL_CONNECTION_OAUTH2.type
+            },
+            condition: {
+                key: "authType",
+                value: "oAuth2"
+            }
+        },
+        {
+            key: "authType",
+            type: "select",
+            label: "UI__NODE_EDITOR__SERVICE__AI_AGENT_MCP_TOOL__FIELDS__AUTH_TYPE__LABEL",
+            description: "UI__NODE_EDITOR__SERVICE__AI_AGENT_MCP_TOOL__FIELDS__AUTH_TYPE__DESCRIPTION",
+            defaultValue: "none",
+            params: {
+                required: true,
+                options: [
+                    {
+                        label: "UI__NODE_EDITOR__SERVICE__AI_AGENT_MCP_TOOL__FIELDS__AUTH_TYPE__OPTIONS__NONE__LABEL",
+                        value: "none"
+                    },
+                    {
+                        label: "UI__NODE_EDITOR__SERVICE__AI_AGENT_MCP_TOOL__FIELDS__AUTH_TYPE__OPTIONS__OAUTH2__LABEL",
+                        value: "oAuth2"
+                    }
+                ]
+            },
+            resetOption: {
+                lookupValue: "none",
+                fieldsToReset: ["oAuth2Connection"]
+            }
+        },
     ],
     sections: [
+        {
+            key: "auth",
+            label: "UI__NODE_EDITOR__SERVICE__AI_AGENT_MCP_TOOL__SECTIONS__AUTHENTICATION__LABEL",
+            defaultCollapsed: true,
+            fields: [
+                "authType",
+                "oAuth2Connection"
+            ]
+        },
         {
             key: "debugging",
             label: "UI__NODE_EDITOR__SERVICE__AI_AGENT_JOB__SECTIONS__DEBUG_SETTINGS__LABEL",
@@ -188,6 +243,7 @@ export const AI_AGENT_JOB_MCP_TOOL = createNodeDescriptor({
         { type: "field", key: "mcpWarning" },
         { type: "field", key: "mcpServerUrl" },
         { type: "field", key: "timeout" },
+        { type: "section", key: "auth" },
         { type: "section", key: "debugging" },
         { type: "section", key: "advanced" },
     ],

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

@@ -1,5 +1,6 @@
 import { __awaiter } from "tslib";
 import { validateToolId } from "./createSystemMessage";
+import { parseMcpHeaders } from "./parseMcpHeaders";
 /**
  * Creates the tool definitions for the AI Agent Job and LLM Prompt v2 Nodes
  * @param childConfigs Child node configurations
@@ -43,7 +44,8 @@ export const createToolDefinitions = (childConfigs, api, useStrict) => __awaiter
             const cacheTools = child.config.cacheTools;
             const sendDebug = child.config.debugMessageFetchedTools;
             const toolFilter = child.config.toolFilter;
-            const mcpHeaders = child.config.mcpHeaders;
+            // Parse mcpHeaders values if present and resolve any Cognigy script expressions
+            const mcpHeaders = yield parseMcpHeaders(child.config.mcpHeaders, api);
             let mcpTools = null;
             let fetchedFromCache = null;
             try {
@@ -52,6 +54,13 @@ export const createToolDefinitions = (childConfigs, api, useStrict) => __awaiter
                     timeout,
                     cacheTools,
                     mcpHeaders,
+                    authType: child.config.authType,
+                    oAuth2Connection: child.config.authType === "oAuth2" ? {
+                        oAuth2Url: child.config.oAuth2Connection.oAuth2Url,
+                        oAuth2ClientId: child.config.oAuth2Connection.oAuth2ClientId,
+                        oAuth2ClientSecret: child.config.oAuth2Connection.oAuth2ClientSecret,
+                        oAuth2Scope: child.config.oAuth2Connection.oAuth2Scope,
+                    } : undefined,
                 });
                 mcpTools = fetched.tools;
                 fetchedFromCache = fetched.fromCache;

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

@@ -0,0 +1,25 @@
+import { __awaiter } from "tslib";
+/**
+ * Parses MCP headers by resolving any Cognigy script expressions in string values
+ * @param mcpHeaders - The headers object to parse
+ * @param api - The Cognigy API instance for parsing script text
+ * @returns The parsed headers object
+ */
+export function parseMcpHeaders(mcpHeaders, api) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!mcpHeaders || typeof mcpHeaders !== "object") {
+            return {};
+        }
+        const parsedMcpHeaders = {};
+        for (const [key, value] of Object.entries(mcpHeaders)) {
+            if (typeof value === "string") {
+                parsedMcpHeaders[key] = yield api.parseCognigyScriptText(value);
+            }
+            else {
+                parsedMcpHeaders[key] = value;
+            }
+        }
+        return parsedMcpHeaders;
+    });
+}
+//# sourceMappingURL=parseMcpHeaders.js.map

package/dist/esm/shared/charts/descriptors/service/aiAgentV2.js

@@ -0,0 +1,87 @@
+import { __awaiter } from "tslib";
+/* Custom Modules */
+import { createNodeDescriptor } from "../../createNodeDescriptor";
+/**
+ * This is a prototype!
+ */
+export const AI_AGENT_V2 = createNodeDescriptor({
+    type: "aiAgentV2",
+    defaultLabel: "AI Agent V2",
+    summary: "AI Agent V2",
+    fields: [
+        {
+            key: "agentId",
+            type: "cognigyText",
+            label: " ",
+            params: {
+                required: true,
+            }
+        },
+        {
+            key: "apiKeyAuthKeyConnection",
+            type: "connection",
+            label: "apiKey",
+            params: {
+                connectionType: "http_apiKeyAuthKey"
+            },
+        }
+    ],
+    tags: ["ai"],
+    function: ({ cognigy, config }) => __awaiter(void 0, void 0, void 0, function* () {
+        var _a;
+        const { api, input } = cognigy;
+        const agentId = config.agentId;
+        const apiKey = (_a = config.apiKeyAuthKeyConnection) === null || _a === void 0 ? void 0 : _a.authApiKey;
+        const text = input.text || '';
+        if (!apiKey) {
+            throw new Error("Unable to execute request. No api key provided.");
+        }
+        if (!agentId) {
+            throw new Error("Unable to execute request. No agent ID provided.");
+        }
+        const transcript = yield api.getTranscript({ limit: 50 });
+        // TODO: temp hack, convertTranscript() from ll-providers package
+        const formattedTranscript = transcript
+            // keep only entries that actually have text
+            .filter(entry => (entry === null || entry === void 0 ? void 0 : entry.payload) && typeof entry.payload.text === "string")
+            .map(entry => {
+            // map to OpenAI-style role strings
+            const role = entry.role === "user"
+                ? "user"
+                : entry.role === "assistant"
+                    ? "assistant"
+                    : "system";
+            const text = entry.payload.text;
+            return `${role}: ${text}`;
+        })
+            .join("\n");
+        const resp = yield api.sendAiAgentV2Turn({
+            agentReferenceId: agentId,
+            userInput: text,
+            conversationHistory: formattedTranscript,
+            openaiApiKey: apiKey,
+        });
+        if (resp.response && typeof resp.response === 'string') {
+            api.output(resp.response, {
+                _cognigy: {
+                    _preventTranscript: true
+                }
+            });
+            const transcriptContent = {
+                role: "assistant",
+                type: "output",
+                source: "assistant",
+                payload: {
+                    text: resp.response,
+                    data: {},
+                }
+            };
+            yield api.addTranscriptStep(transcriptContent);
+        }
+        if (resp.toolCalls && Array.isArray(resp.toolCalls)) {
+            input.toolCalls = resp.toolCalls;
+        }
+        return;
+    })
+});
+//# sourceMappingURL=aiAgentV2.js.map

package/dist/esm/shared/charts/descriptors/service/handoverV2.js

@@ -4,7 +4,7 @@ import { createNodeDescriptor } from "../../createNodeDescriptor";
 import { COGNIGY_LIVE_AGENT_DESCRIPTOR_FIELDS } from "../../../constants";
 export const HANDOVER_V2 = createNodeDescriptor({
     type: "handoverToAgent",
-    defaultLabel: "Handover to Agent",
+    defaultLabel: "Handover to Human Agent",
     summary: "UI__NODE_EDITOR__SERVICE__HANDOVER_TO_AGENT__SUMMARY",
     appearance: {
         showIcon: false

package/dist/esm/shared/charts/descriptors/service/httpRequest.js

@@ -522,6 +522,9 @@ export const HTTP_REQUEST = createNodeDescriptor({
         type: "text",
     },
     tags: ["service", "get", "post", "put", "patch"],
+    mocking: {
+        defaultMockCode: `input.httprequest = {response: "Mock response"};`
+    },
     function: (httpRequestParams) => __awaiter(void 0, void 0, void 0, function* () {
         const { cognigy, config } = httpRequestParams;
         const { api } = cognigy;

package/dist/esm/shared/charts/descriptors/service/index.js

@@ -30,9 +30,13 @@ export { AI_AGENT_HANDOVER } from "./aiAgent/aiAgentHandover";
 export { AI_AGENT_JOB_CALL_MCP_TOOL } from "./aiAgent/aiAgentJobCallMCPTool";
 export { KNOWLEDGE_TOOL } from "./agentTools/knowledgeTool";
 export { HANDOVER_TO_AI_AGENT_TOOL } from "./agentTools/handoverToAiAgentTool";
+export { HANDOVER_TO_HUMAN_AGENT_TOOL } from "./agentTools/handoverToHumanAgentTool";
 export { SEND_EMAIL_TOOL } from "./agentTools/sendEmailTool";
+export { EXECUTE_WORKFLOW_TOOL } from "./agentTools/executeWorkflowTool";
 export { LOAD_AI_AGENT } from "./aiAgent/loadAiAgent";
+export { AI_AGENT_MCP_TOOL_CONNECTION_OAUTH2 } from "./aiAgent/aiAgentJobMCPTool";
 export { LIVE_AGENT_CONNECTION, RINGCENTRAL_ENGAGE_CONNECTION, CHATWOOT_CONNECTION, EIGHT_BY_EIGHT_CONNECTION, GENESYS_CLOUD_CONNECTION, GENESYS_CLOUD_CONNECTION_OM, STORM_CONNECTION } from "./handoverConnections";
 export { NICECXONEAAH_AUTHENTICATION_CONNECTION } from "./niceCXOneAAHAuthenticationConnection";
 export { AIOPS_CENTER_WEBHOOKS_CONNECTION } from "./aiOpsCenterConnection";
+export { AI_AGENT_V2 } from "./aiAgentV2";
 //# sourceMappingURL=index.js.map