@rjsebening/n8n-nodes-learningsuite 1.3.6 → 1.4.0

package/README.md

@@ -88,9 +88,9 @@ This community node uses the public LearningSuite API and is not affiliated with
 
 - Send push notification
 
-### 🤖 **AI** (3 operations)
+### 🤖 **AI** (4 operations)
 
-- Get agent actions, get AI agents, RAG Chat
+- Agent chat, concierge chat, get agent actions, get AI agents
 
 ### 🛡️ **Role** (1 operation)
 

package/dist/nodes/LearningSuite/descriptions/ai.properties.js

@@ -7,7 +7,7 @@ exports.aiProperties = [
         name: 'operation',
         type: 'options',
         noDataExpression: true,
-        default: 'ragChat',
+        default: 'agentChat',
         displayOptions: { show: { resource: ['ai'] } },
         options: [
             {
@@ -16,6 +16,12 @@ exports.aiProperties = [
                 description: 'Send a message to an AI agent and get the response',
                 action: 'Send message to AI agent',
             },
+            {
+                name: 'Concierge Chat',
+                value: 'conciergeChat',
+                description: 'Send a message to the global AI Concierge agent and get the response',
+                action: 'Send message to AI concierge',
+            },
             {
                 name: 'Get Agent Actions',
                 value: 'getAgentActions',
@@ -28,12 +34,6 @@ exports.aiProperties = [
                 description: 'List all enabled AI agents',
                 action: 'List AI agents',
             },
-            {
-                name: 'RAG Chat',
-                value: 'ragChat',
-                description: 'Ask a question using the AI RAG chat endpoint',
-                action: 'Ask AI question',
-            },
         ],
     },
     {
@@ -54,7 +54,7 @@ exports.aiProperties = [
         required: true,
         default: '',
         description: 'The user ID of the member sending the message. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
-        displayOptions: { show: { resource: ['ai'], operation: ['agentChat'] } },
+        displayOptions: { show: { resource: ['ai'], operation: ['agentChat', 'conciergeChat'] } },
     },
     {
         displayName: 'Message',
@@ -62,7 +62,7 @@ exports.aiProperties = [
         type: 'string',
         default: '',
         description: 'The message you want to send to the AI agent',
-        displayOptions: { show: { resource: ['ai'], operation: ['agentChat'] } },
+        displayOptions: { show: { resource: ['ai'], operation: ['agentChat', 'conciergeChat'] } },
     },
     {
         displayName: 'Chat ID',
@@ -70,7 +70,7 @@ exports.aiProperties = [
         type: 'string',
         default: '',
         description: 'The chat/conversation you want to send the message to. Leave empty to start a new chat.',
-        displayOptions: { show: { resource: ['ai'], operation: ['agentChat'] } },
+        displayOptions: { show: { resource: ['ai'], operation: ['agentChat', 'conciergeChat'] } },
     },
     {
         displayName: 'Include Chat History',
@@ -78,7 +78,7 @@ exports.aiProperties = [
         type: 'boolean',
         default: false,
         description: 'Whether to return the full chat history in the response. Otherwise, only the latest agent response is returned.',
-        displayOptions: { show: { resource: ['ai'], operation: ['agentChat'] } },
+        displayOptions: { show: { resource: ['ai'], operation: ['agentChat', 'conciergeChat'] } },
     },
     {
         displayName: 'End Chat',
@@ -86,7 +86,7 @@ exports.aiProperties = [
         type: 'boolean',
         default: false,
         description: 'Whether to end the chat after this message. The agent will not generate a response. Useful when filling out a form is complete.',
-        displayOptions: { show: { resource: ['ai'], operation: ['agentChat'] } },
+        displayOptions: { show: { resource: ['ai'], operation: ['agentChat', 'conciergeChat'] } },
     },
     {
         displayName: 'Metadata',
@@ -94,134 +94,14 @@ exports.aiProperties = [
         type: 'json',
         default: '{}',
         description: 'If a previous agent response included metadata, it should be included in the next request. Provide as JSON object.',
-        displayOptions: { show: { resource: ['ai'], operation: ['agentChat'] } },
+        displayOptions: { show: { resource: ['ai'], operation: ['agentChat', 'conciergeChat'] } },
     },
     {
         displayName: 'Profile Context',
         name: 'profileContext',
         type: 'json',
         default: '{}',
-        description: 'Optional profile context to use when interacting with custom field (forms). Only used if the agent config supports it. Provide as JSON object with a "selectedProfileIdByCard" property.',
-        displayOptions: { show: { resource: ['ai'], operation: ['agentChat'] } },
-    },
-    {
-        displayName: 'Question',
-        name: 'question',
-        type: 'string',
-        required: true,
-        default: '',
-        description: 'The question to ask the AI',
-        displayOptions: { show: { resource: ['ai'], operation: ['ragChat'] } },
-    },
-    {
-        displayName: 'User Name or ID',
-        name: 'userId',
-        type: 'options',
-        typeOptions: { loadOptionsMethod: 'member_getMembers' },
-        default: '',
-        description: 'The ID of the user making the request. Used to personalize and scope the AI response. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
-        displayOptions: { show: { resource: ['ai'], operation: ['ragChat'] } },
-    },
-    {
-        displayName: 'Conversation ID',
-        name: 'conversationId',
-        type: 'string',
-        default: '',
-        description: 'If set, the conversation history with this ID will be taken into account',
-        displayOptions: { show: { resource: ['ai'], operation: ['ragChat'] } },
-    },
-    {
-        displayName: 'Answer Length',
-        name: 'answerLength',
-        type: 'options',
-        default: 'standard',
-        description: 'The desired length of the AI’s answer',
-        displayOptions: { show: { resource: ['ai'], operation: ['ragChat'] } },
-        options: [
-            {
-                name: 'Concise',
-                value: 'concise',
-                description: 'A short and to-the-point answer',
-            },
-            {
-                name: 'Standard',
-                value: 'standard',
-                description: 'A balanced answer with sufficient detail',
-            },
-            {
-                name: 'Detailed',
-                value: 'detailed',
-                description: 'A comprehensive and detailed answer',
-            },
-        ],
-    },
-    {
-        displayName: 'Tone',
-        name: 'tone',
-        type: 'options',
-        default: 'neutral',
-        description: 'The desired tone of the AI’s answer',
-        displayOptions: { show: { resource: ['ai'], operation: ['ragChat'] } },
-        options: [
-            {
-                name: 'Friendly',
-                value: 'friendly',
-                description: 'A warm and approachable tone',
-            },
-            {
-                name: 'Neutral',
-                value: 'neutral',
-                description: 'A neutral and factual tone',
-            },
-            {
-                name: 'Professional',
-                value: 'professional',
-                description: 'A formal and professional tone',
-            },
-        ],
-    },
-    {
-        displayName: 'Format',
-        name: 'format',
-        type: 'options',
-        default: 'markdown',
-        description: 'The desired output format of the AI’s answer',
-        displayOptions: { show: { resource: ['ai'], operation: ['ragChat'] } },
-        options: [
-            {
-                name: 'Markdown',
-                value: 'markdown',
-                description: 'Formatted output using Markdown',
-            },
-            {
-                name: 'Plain Text',
-                value: 'plaintext',
-                description: 'Unformatted plain text output',
-            },
-        ],
-    },
-    {
-        displayName: 'Add Citations',
-        name: 'addCitations',
-        type: 'boolean',
-        default: false,
-        description: 'Whether the AI will add citations to its answer',
-        displayOptions: { show: { resource: ['ai'], operation: ['ragChat'] } },
-    },
-    {
-        displayName: 'Unlock Content Drip',
-        name: 'unlockContentDrip',
-        type: 'boolean',
-        default: false,
-        description: 'Whether the AI will have access to content that is normally restricted by content drip settings',
-        displayOptions: { show: { resource: ['ai'], operation: ['ragChat'] } },
-    },
-    {
-        displayName: 'System Prompt Addition',
-        name: 'systemPromptAddition',
-        type: 'string',
-        default: '',
-        description: 'Additional system prompt instructions to guide the AI’s behavior',
-        displayOptions: { show: { resource: ['ai'], operation: ['ragChat'] } },
+        description: 'Optional profile context to use when interacting with custom field (forms). Only used if the agent config supports it. Leave as {} to omit. Expected structure: { "selectedProfileIdByCard": { "cardId": "profileId or null" } } - keys are custom field card IDs, values are profile IDs or null for the default profile.',
+        displayOptions: { show: { resource: ['ai'], operation: ['agentChat', 'conciergeChat'] } },
     },
 ];

package/dist/nodes/LearningSuite/execute/ai.handlers.d.ts

@@ -1,7 +1,7 @@
 import type { ExecuteHandler } from '../exec.types';
 export declare const aiHandlers: {
     agentChat: ExecuteHandler;
+    conciergeChat: ExecuteHandler;
     getAgentActions: ExecuteHandler;
     getAiAgents: ExecuteHandler;
-    ragChat: ExecuteHandler;
 };

package/dist/nodes/LearningSuite/execute/ai.handlers.js

@@ -13,24 +13,49 @@ function parseJsonObjectParam(ctx, i, name) {
     const raw = ctx.getNodeParameter(name, i, '');
     if (raw === undefined || raw === null || raw === '')
         return undefined;
-    if (typeof raw === 'object')
-        return raw;
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch (err) {
-        throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), `Invalid JSON in "${name}": ${String(err)}`);
+    let parsed = raw;
+    if (typeof raw !== 'object') {
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch (err) {
+            throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), `Invalid JSON in "${name}": ${String(err)}`);
+        }
     }
     if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
         throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), `"${name}" must be a JSON object`);
     }
+    // The "{}" placeholder means "not set" - sending it would fail the API's schema validation
+    if (Object.keys(parsed).length === 0)
+        return undefined;
     return parsed;
 }
-const agentChat = async (ctx, i) => {
-    const agentId = ctx.getNodeParameter('agentId', i);
-    if (!agentId)
-        throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), 'AI Agent is required');
+const PROFILE_CONTEXT_EXAMPLE = '{ "selectedProfileIdByCard": { "<cardId>": "<profileId or null>" } }';
+/** Reads and validates the optional profile context, which the API only accepts fully formed. */
+function buildProfileContext(ctx, i) {
+    const profileContext = parseJsonObjectParam(ctx, i, 'profileContext');
+    if (!profileContext)
+        return undefined;
+    const selection = profileContext.selectedProfileIdByCard;
+    if (!selection || typeof selection !== 'object' || Array.isArray(selection)) {
+        throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), '"Profile Context" must contain a "selectedProfileIdByCard" object', {
+            itemIndex: i,
+            description: `Expected structure: ${PROFILE_CONTEXT_EXAMPLE}. Keys are custom field card IDs, values are profile IDs (or null for the default profile).`,
+        });
+    }
+    const invalid = Object.entries(selection)
+        .filter(([, v]) => v !== null && typeof v !== 'string')
+        .map(([k]) => k);
+    if (invalid.length) {
+        throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), `"Profile Context" contains invalid profile IDs for the following cards: ${invalid.join(', ')}`, {
+            itemIndex: i,
+            description: `Each value must be a profile ID string or null (= default profile). Expected structure: ${PROFILE_CONTEXT_EXAMPLE}.`,
+        });
+    }
+    return profileContext;
+}
+/** Builds the chat request body shared by the agent and concierge chat endpoints. */
+function buildChatBody(ctx, i) {
     const body = {
         userId: ctx.getNodeParameter('userId', i),
         chatId: ctx.getNodeParameter('chatId', i, undefined),
@@ -38,30 +63,25 @@ const agentChat = async (ctx, i) => {
         includeChatHistory: ctx.getNodeParameter('includeChatHistory', i, false),
         endChat: ctx.getNodeParameter('endChat', i, false),
         metadata: parseJsonObjectParam(ctx, i, 'metadata'),
-        profileContext: parseJsonObjectParam(ctx, i, 'profileContext'),
-    };
-    const cleanBody = Object.fromEntries(Object.entries(body).filter(([, v]) => v !== undefined && v !== ''));
-    return await shared_1.lsRequest.call(ctx, 'POST', `/ai-agents/${encodeURIComponent(agentId)}/chat`, { body: cleanBody });
-};
-const ragChat = async (ctx, i) => {
-    const body = {
-        question: ctx.getNodeParameter('question', i),
-        userId: ctx.getNodeParameter('userId', i, undefined),
-        conversationId: ctx.getNodeParameter('conversationId', i, undefined),
-        addCitations: ctx.getNodeParameter('addCitations', i, false),
-        systemPromptAddition: ctx.getNodeParameter('systemPromptAddition', i, undefined),
-        answerLength: ctx.getNodeParameter('answerLength', i, 'standard'),
-        tone: ctx.getNodeParameter('tone', i, 'neutral'),
-        format: ctx.getNodeParameter('format', i, 'markdown'),
-        unlockContentDrip: ctx.getNodeParameter('unlockContentDrip', i, false),
+        profileContext: buildProfileContext(ctx, i),
     };
     // Remove keys with undefined or empty string values so optional params are not sent as empty
-    const cleanBody = Object.fromEntries(Object.entries(body).filter(([, v]) => v !== undefined && v !== ''));
-    return await shared_1.lsRequest.call(ctx, 'POST', '/ai/rag-chat', { body: cleanBody });
+    return Object.fromEntries(Object.entries(body).filter(([, v]) => v !== undefined && v !== ''));
+}
+const agentChat = async (ctx, i) => {
+    const agentId = ctx.getNodeParameter('agentId', i);
+    if (!agentId)
+        throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), 'AI Agent is required');
+    return await shared_1.lsRequest.call(ctx, 'POST', `/ai-agents/${encodeURIComponent(agentId)}/chat`, {
+        body: buildChatBody(ctx, i),
+    });
+};
+const conciergeChat = async (ctx, i) => {
+    return await shared_1.lsRequest.call(ctx, 'POST', '/ai-agents/concierge/chat', { body: buildChatBody(ctx, i) });
 };
 exports.aiHandlers = {
     agentChat,
+    conciergeChat,
     getAgentActions,
     getAiAgents,
-    ragChat,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rjsebening/n8n-nodes-learningsuite",
-	"version": "1.3.6",
+	"version": "1.4.0",
 	"description": "n8n node for LearningSuite API",
 	"keywords": [
 		"n8n-community-node-package",