@cognigy/rest-api-client 2025.23.0 → 2025.25.0

package/build/shared/interfaces/IOrganisation.js

@@ -60,6 +60,7 @@ exports.organisationDataSchema = {
         disabled: { type: "boolean" },
         name: { type: "string", minLength: 1, format: "resource-name" },
         businessUnitId: { type: "string" },
+        tenantId: { type: "string" },
         passwordPolicy: exports.organisationPasswordPolicySchema,
         quotaMaxChannelsPerProject: { type: "integer", minimum: 0 },
         quotaMaxMessagesPerDay: { type: "integer", minimum: 0 },

package/build/shared/interfaces/IProfile.js

@@ -8,6 +8,7 @@ const IEntityMeta_1 = require("./resources/IEntityMeta");
 ;
 exports.profileTypes = [
     "simulator",
+    "regular" // profiles that are not simulator. In db they will not have a type field for backward compatibility reasons.
 ];
 exports.profileDataSchema = {
     title: "profileDataSchema",

package/build/shared/interfaces/cxone/knowledgehub/CXoneKnowledgehubAPI.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=CXoneKnowledgehubAPI.js.map

package/build/shared/interfaces/resources/IAuditEvent.js

@@ -117,6 +117,7 @@ exports.actionTypes = [
     "loginFailed",
     "loginError",
     "unauthorized",
+    "disableCreditCardRedaction",
 ];
 exports.auditEventSchema = {
     title: "auditEventSchema",

package/build/shared/interfaces/resources/TRestChannelType.js

@@ -79,11 +79,11 @@ exports.restChannelDisplayNames = [
     },
     {
         channel: "niceCXOne",
-        displayName: "NICE CXone"
+        displayName: "NiCE CXone"
     },
     {
         channel: "niceCXOneAAH",
-        displayName: "NICE CXone AAH"
+        displayName: "NiCE CXone AAH"
     },
     {
         channel: "zoomContactCenter",

package/build/shared/interfaces/restAPI/simulation/simulationRun/ISimulationRunRest_2_0.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ESentimentTypeRest_2_0 = exports.SuccessCriterionType_2_0 = exports.ESuccessCriteriaTypeRest_2_0 = exports.ETurnTypeRest_2_0 = void 0;
+exports.ESimulationErrorCategoryRest_2_0 = exports.ESimulationStatusRest_2_0 = exports.ESentimentTypeRest_2_0 = exports.SuccessCriterionType_2_0 = exports.ESuccessCriteriaTypeRest_2_0 = exports.ETurnTypeRest_2_0 = void 0;
 var ETurnTypeRest_2_0;
 (function (ETurnTypeRest_2_0) {
     ETurnTypeRest_2_0["INPUT"] = "input";
@@ -21,4 +21,18 @@ var ESentimentTypeRest_2_0;
     ESentimentTypeRest_2_0["NEUTRAL"] = "NEUTRAL";
     ESentimentTypeRest_2_0["NEGATIVE"] = "NEGATIVE";
 })(ESentimentTypeRest_2_0 = exports.ESentimentTypeRest_2_0 || (exports.ESentimentTypeRest_2_0 = {}));
+var ESimulationStatusRest_2_0;
+(function (ESimulationStatusRest_2_0) {
+    ESimulationStatusRest_2_0["SUCCESS"] = "success";
+    ESimulationStatusRest_2_0["FAILED"] = "failed";
+    ESimulationStatusRest_2_0["ERROR"] = "error";
+})(ESimulationStatusRest_2_0 = exports.ESimulationStatusRest_2_0 || (exports.ESimulationStatusRest_2_0 = {}));
+var ESimulationErrorCategoryRest_2_0;
+(function (ESimulationErrorCategoryRest_2_0) {
+    ESimulationErrorCategoryRest_2_0["NONE"] = "none";
+    ESimulationErrorCategoryRest_2_0["AI_AGENT_TIMEOUT"] = "ai_agent_timeout";
+    ESimulationErrorCategoryRest_2_0["LLM_PROVIDER_ERROR"] = "llm_provider_error";
+    ESimulationErrorCategoryRest_2_0["AI_AGENT_ERROR"] = "ai_agent_error";
+    ESimulationErrorCategoryRest_2_0["UNKNOWN"] = "unknown";
+})(ESimulationErrorCategoryRest_2_0 = exports.ESimulationErrorCategoryRest_2_0 || (exports.ESimulationErrorCategoryRest_2_0 = {}));
 //# sourceMappingURL=ISimulationRunRest_2_0.js.map

package/build/shared/interfaces/restAPI/simulation/simulationRunBatch/ISimulationRunBatchRest_2_0.js

@@ -1,9 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SimulationRunBatchStatus = void 0;
+exports.SuccessCriterionTypeRest_2_0 = exports.SimulationRunBatchStatus = void 0;
 exports.SimulationRunBatchStatus = [
     "IN_PROGRESS",
     "COMPLETED",
     "FAILED"
 ];
+var SuccessCriterionTypeRest_2_0;
+(function (SuccessCriterionTypeRest_2_0) {
+    SuccessCriterionTypeRest_2_0["TEXT"] = "text";
+    SuccessCriterionTypeRest_2_0["GOAL_COMPLETED"] = "goalCompleted";
+})(SuccessCriterionTypeRest_2_0 = exports.SuccessCriterionTypeRest_2_0 || (exports.SuccessCriterionTypeRest_2_0 = {}));
 //# sourceMappingURL=ISimulationRunBatchRest_2_0.js.map

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

@@ -11,7 +11,7 @@ import { REGEX_SLOT_FILLER, EXECUTE_COGNIGY_NLU, ADD_LEXICON_KEYPHRASE, FUZZY_SE
 import { KNOWLEDGE_SEARCH, KNOWLEDGE_SEARCH_V2, SEARCH_EXTRACT_OUTPUT } from "./knowledgeSearch";
 import { CONTINUOUS_ASR, DTMF, HANG_UP, PLAY, TRANSFER_VOICE, SESSION_SPEECH_PARAMETERS, USER_INPUT_TIMEOUT, SEND_METADATA, BARGE_IN, MUTE_SPEECH_INPUT, } from "./voice";
 import { ACTIVATE_PROFILE, COMPLETE_GOAL, DEACTIVATE_PROFILE, DELETE_PROFILE, MERGE_PROFILE, UPDATE_PROFILE, ADD_MEMORY, BLIND_MODE, OVERWRITE_ANALYTICS, SET_RATING, REQUEST_RATING, TRACK_GOAL, } from "./analytics";
-import { HANDOVER, HANDOVER_V2, CHECK_AGENT_AVAILABILITY, HTTP_REQUEST, HTTP_CONNECTION_BASIC, HTTP_CONNECTION_APIKEYAUTHKEY, HTTP_CONNECTION_APIKEYXKEY, HTTP_CONNECTION_OAUTH2, JWT_SECRET_CONNECTION, TRIGGER_FUNCTION, ON_SCHEDULING_ERROR, ON_SCHEDULED, GPT_PROMPT, LLM_PROMPT_V2, LLM_PROMPT_DEFAULT, LLM_PROMPT_MCP_TOOL, LLM_PROMPT_TOOL, CLOSE_HANDOVER, HANDOVER_INACTIVITY_TIMER, GPT_CONVERSATION, GPT_CONVERSATION_SUMMARY, LLM_ENTITY_EXTRACT, AI_AGENT_JOB, AI_AGENT_JOB_DEFAULT, AI_AGENT_JOB_TOOL, AI_AGENT_JOB_MCP_TOOL, AI_AGENT_JOB_CALL_MCP_TOOL, AI_AGENT_TOOL_ANSWER, KNOWLEDGE_TOOL, AI_AGENT_HANDOVER, LIVE_AGENT_CONNECTION, RINGCENTRAL_ENGAGE_CONNECTION, CHATWOOT_CONNECTION, EIGHT_BY_EIGHT_CONNECTION, GENESYS_CLOUD_CONNECTION, GENESYS_CLOUD_CONNECTION_OM, LLM_MODERATE, NICECXONEAAH_AUTHENTICATION_CONNECTION, LOAD_AI_AGENT, AIOPS_CENTER_WEBHOOKS_CONNECTION } from "./service";
+import { HANDOVER, HANDOVER_V2, CHECK_AGENT_AVAILABILITY, HTTP_REQUEST, HTTP_CONNECTION_BASIC, HTTP_CONNECTION_APIKEYAUTHKEY, HTTP_CONNECTION_APIKEYXKEY, HTTP_CONNECTION_OAUTH2, JWT_SECRET_CONNECTION, TRIGGER_FUNCTION, ON_SCHEDULING_ERROR, ON_SCHEDULED, GPT_PROMPT, LLM_PROMPT_V2, LLM_PROMPT_DEFAULT, LLM_PROMPT_MCP_TOOL, LLM_PROMPT_TOOL, CLOSE_HANDOVER, HANDOVER_INACTIVITY_TIMER, GPT_CONVERSATION, GPT_CONVERSATION_SUMMARY, LLM_ENTITY_EXTRACT, AI_AGENT_JOB, AI_AGENT_JOB_DEFAULT, AI_AGENT_JOB_TOOL, AI_AGENT_JOB_MCP_TOOL, AI_AGENT_JOB_CALL_MCP_TOOL, AI_AGENT_TOOL_ANSWER, KNOWLEDGE_TOOL, HANDOVER_TO_AI_AGENT_TOOL, SEND_EMAIL_TOOL, AI_AGENT_HANDOVER, LIVE_AGENT_CONNECTION, RINGCENTRAL_ENGAGE_CONNECTION, CHATWOOT_CONNECTION, EIGHT_BY_EIGHT_CONNECTION, GENESYS_CLOUD_CONNECTION, GENESYS_CLOUD_CONNECTION_OM, LLM_MODERATE, NICECXONEAAH_AUTHENTICATION_CONNECTION, LOAD_AI_AGENT, AIOPS_CENTER_WEBHOOKS_CONNECTION, STORM_CONNECTION, } from "./service";
 import { INIT_APP_SESSION, GET_APP_SESSION_PIN, SET_HTML_APP_STATE, SET_ADAPTIVE_CARD_APP_STATE, } from "./apps";
 import { SET_IFRAME_TILE, SET_HTML_TILE, SEND_TILE_DATA, SET_SECURE_FORMS_TILE, SET_ADAPTIVE_CARD_TILE, SET_AGENT_ASSIST_GRID, NEXT_ACTION_ASSIST, SENTIMENT_ASSIST, TRANSCRIPT_ASSIST, IDENTITY_ASSIST, KNOWLEDGE_ASSIST, } from "./agentAssist";
 import { ASSIST_INFO } from "./liveAgent";
@@ -147,6 +147,8 @@ if (process.env.DISABLE_FEATURE_TRANSCRIPT_MANAGER !== "true") {
     nodes.push(AI_AGENT_JOB_CALL_MCP_TOOL);
     nodes.push(AI_AGENT_TOOL_ANSWER);
     nodes.push(KNOWLEDGE_TOOL);
+    nodes.push(HANDOVER_TO_AI_AGENT_TOOL);
+    nodes.push(SEND_EMAIL_TOOL);
     nodes.push(AI_AGENT_HANDOVER);
     nodes.push(LOAD_AI_AGENT);
 }
@@ -172,6 +174,7 @@ export const cognigyBasicModule = createExtension({
         GENESYS_CLOUD_CONNECTION_OM,
         NICECXONEAAH_AUTHENTICATION_CONNECTION,
         AIOPS_CENTER_WEBHOOKS_CONNECTION,
+        STORM_CONNECTION,
     ],
 });
 export { cognigyMongoDBModule } from "./connectionNodes/mongoDB";
@@ -185,4 +188,5 @@ export { cognigyGenerativeAIProviderModule } from "./connectionNodes/generativeA
 export { cognigySpeechProviderModule } from "./connectionNodes/speechProviders";
 export { cognigyTranslationProviderModule } from "./connectionNodes/translationProviders";
 export { cognigyDocumentParserProviderModule } from "./connectionNodes/documentParserProviders";
+export { niceCXoneKnowledgehubProviderModule } from "./service/cxone/knowledgehub/CXoneKnowledgehubProviderModule";
 //# sourceMappingURL=index.js.map

package/dist/esm/shared/charts/descriptors/nlu/matchPattern.js

@@ -61,6 +61,7 @@ export const MATCH_PATTERN = createNodeDescriptor({
             description: "UI__NODE_EDITOR__NLU__MATCH_PATTERN__FIELDS__USE_FULL_SYSTEM_SLOT_TEXT_DESCRIPTION",
             type: "toggle",
             defaultValue: true,
+            fallbackValue: false
         }
     ],
     sections: [

package/dist/esm/shared/charts/descriptors/placeholder.js

@@ -16,6 +16,9 @@ export const PLACEHOLDER = createNodeDescriptor({
             key: "text",
             label: "UI__NODE_EDITOR__PLACEHOLDER__FIELDS__TEXT__LABEL",
             type: "text",
+            params: {
+                multiline: true
+            },
         },
         {
             key: "data",

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

@@ -0,0 +1,190 @@
+import { __awaiter } from "tslib";
+/* Custom modules */
+import { createNodeDescriptor } from "../../../createNodeDescriptor";
+import { TranscriptEntryType, TranscriptRole } from "../../../../interfaces/transcripts/transcripts";
+export const HANDOVER_TO_AI_AGENT_TOOL = createNodeDescriptor({
+    type: "handoverToAiAgentTool",
+    defaultLabel: "Handover to AI Agent 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: "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: "handover_to_ai_agent",
+            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",
+            params: {
+                required: true,
+                rows: 5,
+                multiline: true,
+                placeholder: "UI__NODE_EDITOR__SERVICE__HANDOVER_TO_AI_AGENT_TOOL__FIELDS__DESCRIPTION__PLACEHOLDER"
+            }
+        },
+        {
+            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": {
+		"handover_reason": {
+			"type": "string",
+			"description": "The reason for handing over to the AI Agent, including context from the conversation."
+		}
+	},
+	"required": ["handover_reason"],
+	"additionalProperties": false
+}`,
+            params: {
+                required: false,
+            },
+        },
+        {
+            key: "flowNode",
+            type: "flowNode",
+            label: "UI__NODE_EDITOR__SERVICE__HANDOVER_TO_AI_AGENT_TOOL__FIELDS__FLOW_NODE__LABEL",
+            params: {
+                required: true,
+                nodeTypeFilter: ["aiAgentJob"]
+            }
+        },
+        {
+            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: "",
+        },
+    ],
+    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: [
+                "condition",
+            ],
+        },
+    ],
+    form: [
+        { type: "field", key: "toolId" },
+        { type: "field", key: "description" },
+        { type: "field", key: "flowNode" },
+        { type: "section", key: "debugging" },
+        { type: "section", key: "advanced" },
+    ],
+    appearance: {
+        color: "white",
+        textColor: "#252525",
+        variant: "mini",
+    },
+    function: ({ cognigy, config, nodeId: thisNodeId }) => __awaiter(void 0, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e, _f;
+        const { api } = cognigy;
+        const { debugMessage, flowNode } = config;
+        const sessionState = yield api.loadSessionState();
+        const toolCall = (_a = sessionState.lastToolCall) === null || _a === void 0 ? void 0 : _a.toolCall;
+        if (!(toolCall === null || toolCall === void 0 ? void 0 : toolCall.id)) {
+            (_b = api.logDebugError) === null || _b === void 0 ? void 0 : _b.call(api, "UI__DEBUG_MODE__AI_AGENT_ANSWER__ERROR__MESSAGE");
+        }
+        if (!(flowNode === null || flowNode === void 0 ? void 0 : flowNode.flow) || !(flowNode === null || flowNode === void 0 ? void 0 : flowNode.node)) {
+            throw new Error("Flow Node is required for Handover to AI Agent Tool");
+        }
+        if (toolCall) {
+            if (!((_c = api.checkThink) === null || _c === void 0 ? void 0 : _c.call(api, thisNodeId))) {
+                const handoverReason = ((_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.handover_reason) || "Handover requested";
+                // Optional Debug Message
+                if (debugMessage) {
+                    (_f = api.logDebugMessage) === null || _f === void 0 ? void 0 : _f.call(api, JSON.stringify({ handover_reason: handoverReason, target_flow: flowNode.flow, target_node: flowNode.node }, null, 2));
+                }
+                // Add Tool Call Message to Transcript
+                const toolCallTranscriptStep = {
+                    role: TranscriptRole.ASSISTANT,
+                    type: TranscriptEntryType.TOOL_CALL,
+                    source: "system",
+                    payload: {
+                        name: toolCall.function.name,
+                        id: toolCall.id,
+                        input: toolCall.function.arguments,
+                    }
+                };
+                yield api.addTranscriptStep(toolCallTranscriptStep);
+                // Add Tool Answer Message to Transcript
+                const toolAnswer = {
+                    role: TranscriptRole.TOOL,
+                    type: TranscriptEntryType.TOOL_ANSWER,
+                    source: "system",
+                    payload: {
+                        toolCallId: toolCall.id,
+                        name: toolCall.function.name,
+                        content: `Handover to AI Agent initiated. Reason: ${handoverReason}`,
+                    }
+                };
+                yield api.addTranscriptStep(toolAnswer);
+                api.resetNextNodes();
+                api.updateSessionStateValues({
+                    lastToolCall: undefined
+                });
+                yield api.executeFlow({
+                    flowNode: {
+                        flow: flowNode.flow,
+                        node: flowNode.node,
+                    },
+                    absorbContext: true,
+                });
+            }
+            else {
+                throw new Error("Infinite Loop Detected");
+            }
+        }
+    })
+});
+//# sourceMappingURL=handoverToAiAgentTool.js.map

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

@@ -72,7 +72,7 @@ export const KNOWLEDGE_TOOL = createNodeDescriptor({
 		"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

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

@@ -0,0 +1,241 @@
+import { __awaiter } from "tslib";
+/* Custom modules */
+import { createNodeDescriptor } from "../../../createNodeDescriptor";
+import { TranscriptEntryType, TranscriptRole } from "../../../../interfaces/transcripts/transcripts";
+export const SEND_EMAIL_TOOL = createNodeDescriptor({
+    type: "sendEmailTool",
+    defaultLabel: "Send Email 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: "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: "send_email",
+            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: "Create and send a new email message.",
+            params: {
+                required: true,
+                rows: 5,
+                multiline: true
+            }
+        },
+        {
+            key: "recipient",
+            label: "UI__NODE_EDITOR__SMTP__EMAIL_NOTIFICATION__RECIPIENT__LABEL",
+            description: "UI__NODE_EDITOR__SMTP__EMAIL_NOTIFICATION__RECIPIENT__DESCRIPTION",
+            type: "cognigyText",
+            params: {
+                required: true,
+                rows: 1,
+                multiline: false,
+                maxLength: 255,
+            },
+        },
+        {
+            key: "parameters",
+            label: "UI__NODE_EDITOR__SERVICE__AI_AGENT_TOOL__FIELDS__PARAMETERS__LABEL",
+            type: "toolParameters",
+            defaultValue: `{
+	"type": "object",
+	"properties": {
+		"subject": {
+			"type": "string",
+			"description": "The subject of the email."
+		},
+		"message": {
+			"type": "string",
+			"description": "The body of the email."
+		}
+	},
+	"required": ["subject", "message"],
+	"additionalProperties": 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: "",
+        },
+    ],
+    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: [
+                "condition"
+            ]
+        },
+    ],
+    form: [
+        { type: "field", key: "toolId" },
+        { type: "field", key: "description" },
+        { type: "field", key: "recipient" },
+        { type: "section", key: "debugging" },
+        { type: "section", key: "advanced" },
+    ],
+    appearance: {
+        color: "white",
+        textColor: "#252525",
+        variant: "mini",
+    },
+    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 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;
+        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) {
+            if (!((_d = api.checkThink) === null || _d === void 0 ? void 0 : _d.call(api, nodeId))) {
+                const { subject, message } = toolCall.function.arguments;
+                let result;
+                try {
+                    result = yield ((_e = api === null || api === void 0 ? void 0 : api.emailNotification) === null || _e === void 0 ? void 0 : _e.call(api, {
+                        cognigy,
+                        config: {
+                            recipient,
+                            subject,
+                            message,
+                            cc: "",
+                            bcc: "",
+                            priority: "normal",
+                            async: false,
+                            storeLocation: "none",
+                            inputKey: "",
+                            contextKey: "",
+                            stopOnError: false,
+                        },
+                        nodeId,
+                        nodeType,
+                        organisationId,
+                        projectId,
+                        childConfigs,
+                    }));
+                }
+                catch (error) {
+                    // Log error message to debug mode
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    (_f = api.logDebugError) === null || _f === void 0 ? void 0 : _f.call(api, errorMessage, "UI__DEBUG_MODE__AI_AGENT__SEND_EMAIL_TOOL__ERROR");
+                    // Pass error message to LLM as result
+                    result = errorMessage;
+                }
+                // Optional Debug Message of Email sending and response
+                if (debugMessage) {
+                    const messageLines = [];
+                    if (recipient) {
+                        messageLines.push(`\n<b>UI__DEBUG_MODE__AI_AGENT__SEND_EMAIL_TOOL__RECIPIENT</b> ${recipient}`);
+                    }
+                    if (subject) {
+                        messageLines.push(`\n<b>UI__DEBUG_MODE__AI_AGENT__SEND_EMAIL_TOOL__SUBJECT</b> ${subject}`);
+                    }
+                    if (message) {
+                        messageLines.push(`\n<b>UI__DEBUG_MODE__AI_AGENT__SEND_EMAIL_TOOL__MESSAGE</b> ${message}`);
+                    }
+                    if (result) {
+                        const resultString = typeof result === 'string' ? result : JSON.stringify(result, null, 2);
+                        messageLines.push(`\n<b>UI__DEBUG_MODE__AI_AGENT__SEND_EMAIL_TOOL__RESULT</b>\n${resultString}`);
+                    }
+                    (_g = api.logDebugMessage) === null || _g === void 0 ? void 0 : _g.call(api, messageLines.join("\n"), "UI__DEBUG_MODE__AI_AGENT__SEND_EMAIL_TOOL__HEADER");
+                }
+                const { flow, node } = aiAgentJobNode;
+                if (flow && node) {
+                    // Add Tool Call Message to Transcript
+                    const toolCallTranscriptStep = {
+                        role: TranscriptRole.ASSISTANT,
+                        type: TranscriptEntryType.TOOL_CALL,
+                        source: "system",
+                        payload: {
+                            name: toolCall.function.name,
+                            id: toolCall.id,
+                            input: toolCall.function.arguments,
+                        }
+                    };
+                    yield api.addTranscriptStep(toolCallTranscriptStep);
+                    // Add Tool Answer Message to Transcript
+                    const resultString = typeof result === 'string' ? result : JSON.stringify(result);
+                    const toolAnswer = {
+                        role: TranscriptRole.TOOL,
+                        type: TranscriptEntryType.TOOL_ANSWER,
+                        source: "system",
+                        payload: {
+                            toolCallId: toolCall.id,
+                            name: toolCall.function.name,
+                            content: `Send email result:\n${resultString}`,
+                        }
+                    };
+                    yield api.addTranscriptStep(toolAnswer);
+                    api.resetNextNodes();
+                    // remove the call from the session state, because the call has been answered
+                    api.updateSessionStateValues({
+                        lastToolCall: undefined
+                    });
+                    yield api.executeFlow({
+                        flowNode: {
+                            flow,
+                            node,
+                        },
+                        absorbContext: true,
+                    });
+                }
+            }
+            else {
+                throw new Error("Infinite Loop Detected");
+            }
+        }
+    })
+});
+//# sourceMappingURL=sendEmailTool.js.map

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

@@ -11,7 +11,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", "knowledgeTool"];
+export const AI_AGENT_TOOLS_WHITELIST = ["aiAgentJobDefault", "aiAgentJobTool", "aiAgentJobMCPTool", "knowledgeTool", "handoverToAiAgentTool", "sendEmailTool"];
 export const AI_AGENT_JOB = createNodeDescriptor({
     type: "aiAgentJob",
     defaultLabel: "AI Agent",

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

@@ -160,8 +160,11 @@ export const createToolDefinitions = (childConfigs, api, useStrict) => __awaiter
             if (useStrict) {
                 tool.function.strict = true;
             }
-            if (child.config.useParameters) {
-                tool.function.parameters = child.config.parameters;
+            if (child.config.parameters && child.config.useParameters !== false) {
+                const parameters = safeParseJson(child.config.parameters);
+                if (parameters !== null) {
+                    tool.function.parameters = parameters;
+                }
             }
             tools.push(tool);
         }
@@ -174,4 +177,34 @@ export const createToolDefinitions = (childConfigs, api, useStrict) => __awaiter
         tools,
     };
 });
+/**
+ * Safely parses JSON with backwards compatibility for trailing commas.
+ *
+ * The trailing comma cleanup is required for backwards compatibility with the
+ * knowledge tool, which had invalid JSON (with trailing commas) in the initial
+ * release. Although the JSON wasn't actually used at that time due to parameters not being used,
+ * we need to handle it gracefully to support any stored configurations.
+ *
+ * @param raw - The value to parse. If already parsed (not a string), returns it as-is if truthy.
+ * @returns The parsed JSON object, the input value if already parsed, or null if parsing fails or input is falsy.
+ */
+export function safeParseJson(raw) {
+    // If not a string, return as-is if truthy, otherwise null
+    if (typeof raw !== "string") {
+        return raw || null;
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch (_a) {
+        // Fallback: remove trailing commas before } or ]
+        const cleaned = raw.replace(/,\s*([}\]])/g, "$1");
+        try {
+            return JSON.parse(cleaned);
+        }
+        catch (_b) {
+            return null; // safe fallback instead of throwing
+        }
+    }
+}
 //# sourceMappingURL=createToolDefinitions.js.map