@learningsuite/n8n-nodes-learningsuite 1.2.6 → 1.3.4

package/README.md

@@ -1,8 +1,8 @@
 # n8n-nodes-learningsuite
 
-![n8n](https://img.shields.io/badge/n8n-1.113.0+-brightgreen)
+![n8n](https://img.shields.io/badge/n8n-2.17.2+-brightgreen)
 
-![Version](https://img.shields.io/badge/version-0.1.0-blue)
+![Version](https://img.shields.io/badge/version-1.2.3-blue)
 
 ![License](https://img.shields.io/badge/license-MIT-green)
 
@@ -20,9 +20,9 @@ This community node uses the public LearningSuite API and is not affiliated with
 
 ## 🚀 Features
 
-- **14 resources** fully supported (Member, Course, Group, Bundle, Hub, Module, Community, Custom Fields, Popup, Webhook, Role, User, Team Member, AI, API Call)
-- **87 operations** for maximum flexibility
-- **Instant trigger (webhook-based)** with 17 event types for real-time automation
+- **15 resources** fully supported (Member, Course, Group, Bundle, Hub, Module, Community, Custom Fields, Popup, Webhook, Role, User, Team Member, AI, API Call)
+- **90 action endpoints** for maximum flexibility
+- **Instant trigger (webhook-based)** with 18 event types for real-time automation
 - **Polling trigger** with 11 event types for scheduled polling
 - **Flexible API call** resource for custom endpoints
 
@@ -64,12 +64,13 @@ This community node uses the public LearningSuite API and is not affiliated with
 - Get community areas, get community badges, get community forums, get community posts
 - Create community post comment
 
-### 🔧 **Custom Fields** (13 operations)
+### 🔧 **Custom Fields** (14 operations)
 
 - Get cards, get cards (expanded), get categories, get definitions
 - Get field values, get store, get store values
 - Get profile by card, get profiles, get profiles (expanded)
 - Set field value, set multiple field values, update profile field
+- Upload file from URL
 
 ### 🎯 **Popup** (4 operations)
 
@@ -87,9 +88,9 @@ This community node uses the public LearningSuite API and is not affiliated with
 
 - Send push notification
 
-### 🤖 **AI** (1 operation)
+### 🤖 **AI** (3 operations)
 
-- RAG Chat
+- Get agent actions, get AI agents, RAG Chat
 
 ### 🛡️ **Role** (1 operation)
 
@@ -106,6 +107,7 @@ The LearningSuite trigger supports the following events:
 ### ⚡ Instant Trigger Events (Webhook)
 
 - ✅ Community Post Commented
+- ✅ Agent Action Executed
 - ✅ Community Post Created
 - ✅ Community Post Moderated
 - ✅ Course Member Added
@@ -258,6 +260,19 @@ docker.n8n.io/n8nio/n8n
 
 ```
 
+### Custom Field File Uploads
+
+The Custom Fields resource supports file, image, video, and audio custom fields.
+
+- Use **Set Field Value**, **Set Multiple Field Values**, or **Update Profile Field** when the file is available as n8n binary data.
+- Use **Upload File From URL** when LearningSuite should download a public file URL and append the returned file value to the selected custom field.
+- File fields support **File Value Mode**:
+  - **Add**: append new file values and fail if the custom field limit would be exceeded
+  - **Replace**: replace existing file values with the uploaded file values
+  - **Replace if Limit Reached**: append while possible, otherwise replace existing file values
+- The node respects the LearningSuite file limits defined on the custom field, such as `maxFiles`, `maxImages`, `maxVideos`, and `maxAudios`.
+- For custom field cards with multiple profiles, use Profile ID, Profile Index, or Profile Name to target a specific profile. If the card does not allow multiple profiles, profile parameters are ignored and the default profile is used.
+
 ### ⚡ Instant Webhook Trigger Setup
 
 ```
@@ -352,15 +367,29 @@ npm test
 
 ## 📝 Changelog
 
+### Version 1.2.3 (current)
+
+#### Custom Fields File Uploads
+
+- ✅ Upload file from public URL
+
+- ✅ Binary uploads for file, image, video, and audio custom fields
+
+- ✅ File Value Mode: add, replace, and replace when the field limit is reached
+
+- ✅ Respect custom field file limits (`maxFiles`, `maxImages`, `maxVideos`, `maxAudios`)
+
+- ✅ Improved handling for custom field profile cards and default profiles
+
 ### Version 0.1.0 (2025-09-23)
 
-#### 🎉 Initial Release
+#### Initial Release
 
 - ✅ Full LearningSuite API integration
 
-- ✅ 14 resources with 87 operations
+- ✅ 15 resources with 90 action endpoints
 
-- ✅ Webhook triggers with 17 event types for real-time automation
+- ✅ Webhook triggers with 18 event types for real-time automation
 
 - ✅ Polling triggers with 11 event types
 
@@ -376,7 +405,7 @@ npm test
 
 ## 🛠️ Compatibility
 
-- **n8n Version**: 1.112.3+ (tested with latest)
+- **n8n Version**: 2.17.2+ (tested with latest)
 
 - **Node Version**: 20+
 

package/dist/nodes/LearningSuite/LearningSuite.node.d.ts

@@ -36,7 +36,11 @@ export declare class LearningSuite implements INodeType {
             hub_getTemplates(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<import("n8n-workflow").INodePropertyOptions[]>;
             group_getGroups(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<import("n8n-workflow").INodePropertyOptions[]>;
             customFields_getCards(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<import("n8n-workflow").INodePropertyOptions[]>;
-            customFields_getDefinitions(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<import("n8n-workflow").INodePropertyOptions[]>;
+            customFields_getDefinitions(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<{
+                name: string;
+                value: string;
+            }[]>;
+            customFields_getMediaDefinitions(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<import("n8n-workflow").INodePropertyOptions[]>;
             customFields_getCategories(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<import("n8n-workflow").INodePropertyOptions[]>;
             customFields_getFieldType(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<{
                 name: string;
@@ -55,6 +59,8 @@ export declare class LearningSuite implements INodeType {
             community_getBadges(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<import("n8n-workflow").INodePropertyOptions[]>;
             community_getLatestPosts(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<import("n8n-workflow").INodePropertyOptions[]>;
             bundle_getBundles(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<import("n8n-workflow").INodePropertyOptions[]>;
+            ai_getAgentActions(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<import("n8n-workflow").INodePropertyOptions[]>;
+            ai_getAiAgents(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<import("n8n-workflow").INodePropertyOptions[]>;
         };
         resourceMapping: {
             getTemplateVariablesResourceMapperFields: typeof getTemplateVariablesResourceMapperFields;

package/dist/nodes/LearningSuite/LearningSuite.node.js

@@ -36,6 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LearningSuite = void 0;
 const n8n_workflow_1 = require("n8n-workflow");
 // methods - loadOptions
+const loAi = __importStar(require("./methods/loadOptions/ai.loadOptions"));
 const loBundle = __importStar(require("./methods/loadOptions/bundle.loadOptions"));
 const loCommunity = __importStar(require("./methods/loadOptions/community.loadOptions"));
 const loCourse = __importStar(require("./methods/loadOptions/course.loadOptions"));
@@ -150,6 +151,7 @@ class LearningSuite {
         };
         this.methods = {
             loadOptions: {
+                ...loAi,
                 ...loBundle,
                 ...loCommunity,
                 ...loCourse,

package/dist/nodes/LearningSuite/LearningSuiteTrigger.node.d.ts

@@ -4,7 +4,11 @@ export declare class LearningSuiteTrigger implements INodeType {
     methods: {
         loadOptions: {
             customFields_getCards(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<import("n8n-workflow").INodePropertyOptions[]>;
-            customFields_getDefinitions(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<import("n8n-workflow").INodePropertyOptions[]>;
+            customFields_getDefinitions(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<{
+                name: string;
+                value: string;
+            }[]>;
+            customFields_getMediaDefinitions(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<import("n8n-workflow").INodePropertyOptions[]>;
             customFields_getCategories(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<import("n8n-workflow").INodePropertyOptions[]>;
             customFields_getFieldType(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<{
                 name: string;
@@ -53,6 +57,8 @@ export declare class LearningSuiteTrigger implements INodeType {
             community_getBadges(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<import("n8n-workflow").INodePropertyOptions[]>;
             community_getLatestPosts(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<import("n8n-workflow").INodePropertyOptions[]>;
             bundle_getBundles(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<import("n8n-workflow").INodePropertyOptions[]>;
+            ai_getAgentActions(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<import("n8n-workflow").INodePropertyOptions[]>;
+            ai_getAiAgents(this: import("n8n-workflow").ILoadOptionsFunctions): Promise<import("n8n-workflow").INodePropertyOptions[]>;
         };
     };
     webhookMethods: {

package/dist/nodes/LearningSuite/LearningSuiteTrigger.node.js

@@ -39,6 +39,7 @@ const request_1 = require("./shared/request");
 const trigger_instant_properties_1 = require("./descriptions/trigger.instant.properties");
 const parsing_1 = require("./shared/parsing");
 // methods - loadOptions
+const loAi = __importStar(require("./methods/loadOptions/ai.loadOptions"));
 const loBundle = __importStar(require("./methods/loadOptions/bundle.loadOptions"));
 const loCommunity = __importStar(require("./methods/loadOptions/community.loadOptions"));
 const loCourse = __importStar(require("./methods/loadOptions/course.loadOptions"));
@@ -52,6 +53,7 @@ const loWebhook = __importStar(require("./methods/loadOptions/webhook.loadOption
 const loTeamMember = __importStar(require("./methods/loadOptions/teamMember.loadOptions"));
 const loCustomFields = __importStar(require("./methods/loadOptions/customFields.loadOptions"));
 const INSTANT_EVENTS = new Set([
+    'agentAction.executed',
     'accessRequest.created',
     'communityPost.created',
     'communityPost.commented',
@@ -101,6 +103,17 @@ function buildDesiredFilter(event) {
         }
     };
     switch (event) {
+        // ---------------- Agent Action
+        case 'agentAction.executed': {
+            const col = getCol('additionalAgentActionExecuted');
+            if (col === null || col === void 0 ? void 0 : col.toolKey) {
+                filter.toolKey = String(col.toolKey);
+            }
+            if (col === null || col === void 0 ? void 0 : col.agentId) {
+                filter.agentId = String(col.agentId);
+            }
+            break;
+        }
         // ---------------- Community
         case 'communityPost.commented': {
             const col = getCol('additionalCommunityPostCommented');
@@ -290,6 +303,7 @@ class LearningSuiteTrigger {
         };
         this.methods = {
             loadOptions: {
+                ...loAi,
                 ...loBundle,
                 ...loCommunity,
                 ...loCourse,

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

@@ -10,6 +10,24 @@ exports.aiProperties = [
         default: 'ragChat',
         displayOptions: { show: { resource: ['ai'] } },
         options: [
+            {
+                name: 'Agent Chat',
+                value: 'agentChat',
+                description: 'Send a message to an AI agent and get the response',
+                action: 'Send message to AI agent',
+            },
+            {
+                name: 'Get Agent Actions',
+                value: 'getAgentActions',
+                description: 'List all agent actions',
+                action: 'List agent actions',
+            },
+            {
+                name: 'Get AI Agents',
+                value: 'getAiAgents',
+                description: 'List all enabled AI agents',
+                action: 'List AI agents',
+            },
             {
                 name: 'RAG Chat',
                 value: 'ragChat',
@@ -18,6 +36,74 @@ exports.aiProperties = [
             },
         ],
     },
+    {
+        displayName: 'AI Agent Name or ID',
+        name: 'agentId',
+        type: 'options',
+        typeOptions: { loadOptionsMethod: 'ai_getAiAgents' },
+        required: true,
+        default: '',
+        description: 'The AI agent to chat with. For the global AI Concierge agent, you may also use the shortcut "concierge". 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'] } },
+    },
+    {
+        displayName: 'User Name or ID',
+        name: 'userId',
+        type: 'options',
+        typeOptions: { loadOptionsMethod: 'member_getMembers' },
+        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'] } },
+    },
+    {
+        displayName: 'Message',
+        name: 'message',
+        type: 'string',
+        default: '',
+        description: 'The message you want to send to the AI agent',
+        displayOptions: { show: { resource: ['ai'], operation: ['agentChat'] } },
+    },
+    {
+        displayName: 'Chat ID',
+        name: 'chatId',
+        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'] } },
+    },
+    {
+        displayName: 'Include Chat History',
+        name: 'includeChatHistory',
+        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'] } },
+    },
+    {
+        displayName: 'End Chat',
+        name: 'endChat',
+        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'] } },
+    },
+    {
+        displayName: 'Metadata',
+        name: 'metadata',
+        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'] } },
+    },
+    {
+        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',

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

@@ -88,6 +88,12 @@ exports.customFieldsProperties = [
                 description: 'Update a custom field value within a profile of a custom field card',
                 action: 'Update a custom field value within a profile of a custom field card',
             },
+            {
+                name: 'Upload File From URL',
+                value: 'createFileUploadTarget',
+                description: 'Upload a file from a public URL and append it to a custom field',
+                action: 'Upload a file from a public URL and append it to a custom field',
+            },
         ],
     },
     {
@@ -99,7 +105,7 @@ exports.customFieldsProperties = [
         },
         required: true,
         default: '',
-        description: 'The ID of the user whose custom field data should be accessed. Choose from the list, or specify an ID using an expression. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+        description: 'The ID of the user whose custom field data should be accessed. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
         displayOptions: {
             show: {
                 resource: ['customFields'],
@@ -112,6 +118,7 @@ exports.customFieldsProperties = [
                     'getStoreValues',
                     'setFieldValue',
                     'setMultipleFieldValues',
+                    'createFileUploadTarget',
                     'updateProfileField',
                 ],
             },
@@ -122,7 +129,7 @@ exports.customFieldsProperties = [
         name: 'customFieldCardId',
         type: 'options',
         default: '',
-        description: 'Filter results by a specific custom field card. Choose from the list or specify an ID using an expression. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+        description: 'Filter results by a specific custom field card. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
         typeOptions: {
             loadOptionsMethod: 'customFields_getCards',
         },
@@ -139,7 +146,7 @@ exports.customFieldsProperties = [
         type: 'options',
         required: true,
         default: '',
-        description: 'The custom field card to use. Choose from the list or specify an ID using an expression. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+        description: 'The custom field card to use. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
         typeOptions: {
             loadOptionsMethod: 'customFields_getCards',
         },
@@ -151,34 +158,41 @@ exports.customFieldsProperties = [
         },
     },
     {
-        displayName: 'Profile Index',
-        name: 'profileIndex',
-        type: 'number',
-        default: null,
-        description: 'If specified, the profile with this index is used. Ignored if Profile ID is set. Takes precedence over Profile Name. If not specified or if the index does not exist for a given field key, the value in the default/first profile is returned.',
+        displayName: 'Profile ID',
+        name: 'profileId',
+        type: 'string',
+        default: '',
+        description: 'If specified, the profile with this ID is used. Takes precedence over Profile Index and Profile Name.',
         displayOptions: {
             show: {
                 resource: ['customFields'],
                 operation: [
                     'setFieldValue',
-                    'updateProfileField',
                     'setMultipleFieldValues',
                     'getProfileByCard',
-                    'getStoreValues',
+                    'updateProfileField',
+                    'createFileUploadTarget',
                 ],
             },
         },
     },
     {
-        displayName: 'Profile ID',
-        name: 'profileId',
-        type: 'string',
-        default: '',
-        description: 'If specified, the profile with this ID is used. Takes precedence over Profile Index and Profile Name.',
+        displayName: 'Profile Index',
+        name: 'profileIndex',
+        type: 'number',
+        default: null,
+        description: 'If specified, the profile with this index is used. Ignored if Profile ID is set. Takes precedence over Profile Name. If not specified or if the index does not exist for a given field key, the value in the default/first profile is returned.',
         displayOptions: {
             show: {
                 resource: ['customFields'],
-                operation: ['setFieldValue', 'setMultipleFieldValues', 'getProfileByCard', 'updateProfileField'],
+                operation: [
+                    'setFieldValue',
+                    'updateProfileField',
+                    'setMultipleFieldValues',
+                    'createFileUploadTarget',
+                    'getProfileByCard',
+                    'getStoreValues',
+                ],
             },
         },
     },
@@ -191,7 +205,7 @@ exports.customFieldsProperties = [
         displayOptions: {
             show: {
                 resource: ['customFields'],
-                operation: ['updateProfileField', 'getProfileByCard'],
+                operation: ['updateProfileField', 'getProfileByCard', 'createFileUploadTarget'],
             },
         },
     },
@@ -213,6 +227,52 @@ exports.customFieldsProperties = [
         },
         default: '',
     },
+    {
+        displayName: 'Field Key Name or ID',
+        name: 'customFieldKey',
+        type: 'options',
+        description: 'The file, image, video, or audio custom field to append to. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+        required: true,
+        typeOptions: {
+            loadOptionsMethod: 'customFields_getMediaDefinitions',
+        },
+        displayOptions: {
+            show: {
+                resource: ['customFields'],
+                operation: ['createFileUploadTarget'],
+            },
+        },
+        default: '',
+    },
+    {
+        displayName: 'File Name',
+        name: 'customFieldFileName',
+        type: 'string',
+        default: '',
+        placeholder: 'e.g. report.pdf',
+        description: 'Optional title for videos. Also used for files in the custom field file value returned by LearningSuite.',
+        displayOptions: {
+            show: {
+                resource: ['customFields'],
+                operation: ['createFileUploadTarget'],
+            },
+        },
+    },
+    {
+        displayName: 'Public Download URL',
+        name: 'publicDownloadUrl',
+        type: 'string',
+        default: '',
+        required: true,
+        placeholder: 'https://example.com/file.pdf',
+        description: 'Public URL that LearningSuite downloads and uploads before returning the custom field file value',
+        displayOptions: {
+            show: {
+                resource: ['customFields'],
+                operation: ['createFileUploadTarget'],
+            },
+        },
+    },
     {
         displayName: 'Field Type Name or ID',
         name: 'fieldType',
@@ -348,6 +408,67 @@ exports.customFieldsProperties = [
             },
         },
     },
+    {
+        displayName: 'File Value Mode',
+        name: 'fileValueMode',
+        type: 'options',
+        default: 'add',
+        description: 'How to handle existing file values in the custom field',
+        options: [
+            {
+                name: 'Add',
+                value: 'add',
+                description: 'Append uploaded files and fail if the field limit would be exceeded',
+            },
+            {
+                name: 'Replace',
+                value: 'replace',
+                description: 'Replace all existing file values with the uploaded files',
+            },
+            {
+                name: 'Replace if Limit Reached',
+                value: 'replaceIfFull',
+                description: 'Append uploaded files, but replace existing files if the field limit would be exceeded',
+            },
+        ],
+        displayOptions: {
+            show: {
+                resource: ['customFields'],
+                operation: ['setFieldValue', 'updateProfileField'],
+                fieldType: ['files', 'images', 'videos', 'audios'],
+            },
+        },
+    },
+    {
+        displayName: 'File Value Mode',
+        name: 'fileValueMode',
+        type: 'options',
+        default: 'add',
+        description: 'How to handle existing file values in the custom field',
+        options: [
+            {
+                name: 'Add',
+                value: 'add',
+                description: 'Append uploaded files and fail if the field limit would be exceeded',
+            },
+            {
+                name: 'Replace',
+                value: 'replace',
+                description: 'Replace all existing file values with the uploaded files',
+            },
+            {
+                name: 'Replace if Limit Reached',
+                value: 'replaceIfFull',
+                description: 'Append uploaded files, but replace existing files if the field limit would be exceeded',
+            },
+        ],
+        displayOptions: {
+            show: {
+                resource: ['customFields'],
+                operation: ['setMultipleFieldValues', 'createFileUploadTarget'],
+            },
+        },
+    },
     {
         displayName: 'File Name',
         name: 'fieldValueFileName',

package/dist/nodes/LearningSuite/descriptions/trigger.instant.properties.js

@@ -10,6 +10,11 @@ exports.instantProperties = [
         default: 'communityPost.created',
         description: 'Select the LearningSuite instant (webhook) event',
         options: [
+            {
+                name: 'Agent Action Executed',
+                value: 'agentAction.executed',
+                description: 'Triggers when an AI agent action has been executed',
+            },
             {
                 name: 'Community Post Commented',
                 value: 'communityPost.commented',
@@ -89,6 +94,33 @@ exports.instantProperties = [
             },
         ],
     },
+    // Agent Action Executed
+    {
+        displayName: 'Agent Action Executed Options',
+        name: 'additionalAgentActionExecuted',
+        type: 'collection',
+        default: {},
+        placeholder: 'Add option',
+        displayOptions: { show: { event: ['agentAction.executed'] } },
+        options: [
+            {
+                displayName: 'Tool Key Name or ID',
+                name: 'toolKey',
+                type: 'options',
+                default: '',
+                description: 'Optional: Only trigger for a specific agent action. Leave empty to trigger for all actions. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+                typeOptions: { loadOptionsMethod: 'ai_getAgentActions' },
+            },
+            {
+                displayName: 'Agent Name or ID',
+                name: 'agentId',
+                type: 'options',
+                default: '',
+                description: 'Optional: Only trigger for actions executed by a specific AI agent. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+                typeOptions: { loadOptionsMethod: 'ai_getAiAgents' },
+            },
+        ],
+    },
     // New Login
     {
         displayName: 'Login Options',

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

@@ -80,6 +80,7 @@ exports.webhookProperties = [
         displayOptions: { show: { resource: ['webhook'], operation: ['createSubscription', 'updateSubscription'] } },
         description: 'Type of event to subscribe to',
         options: [
+            { name: 'Agent Action Executed', value: 'agentAction.executed' },
             { name: 'Community Post Commented', value: 'communityPost.commented' },
             { name: 'Community Post Created', value: 'communityPost.created' },
             { name: 'Community Post Moderated', value: 'communityPost.moderated' },
@@ -109,6 +110,7 @@ exports.webhookProperties = [
         required: true,
         description: 'Type of sample data to retrieve',
         options: [
+            { name: 'Agent Action Executed Events', value: 'agent-action-executed-events' },
             { name: 'Community Post Commented', value: 'community-post-commented-events' },
             { name: 'Community Post Created Events', value: 'community-post-created-events' },
             { name: 'Community Post Moderated Events', value: 'community-post-moderated-events' },
@@ -127,6 +129,39 @@ exports.webhookProperties = [
         ],
     },
     // ====== Options per event (identical to instantProperties) ======
+    // Agent Action Executed
+    {
+        displayName: 'Agent Action Executed Options',
+        name: 'additionalAgentActionExecuted',
+        type: 'collection',
+        default: {},
+        placeholder: 'Add option',
+        displayOptions: {
+            show: {
+                resource: ['webhook'],
+                operation: ['createSubscription', 'updateSubscription'],
+                eventType: ['agentAction.executed'],
+            },
+        },
+        options: [
+            {
+                displayName: 'Tool Key Name or ID',
+                name: 'toolKey',
+                type: 'options',
+                default: '',
+                description: 'Optional: Only trigger for a specific agent action. Leave empty to trigger for all actions.  Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+                typeOptions: { loadOptionsMethod: 'ai_getAgentActions' },
+            },
+            {
+                displayName: 'Agent Name or ID',
+                name: 'agentId',
+                type: 'options',
+                default: '',
+                description: 'Optional: Only trigger for actions executed by a specific AI agent. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+                typeOptions: { loadOptionsMethod: 'ai_getAiAgents' },
+            },
+        ],
+    },
     // Login Options
     {
         displayName: 'Login Options',