@learningsuite/n8n-nodes-learningsuite 1.2.5 → 1.3.4

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' },
@@ -126,7 +128,40 @@ exports.webhookProperties = [
             { name: 'User Activation Status Changed Events', value: 'user-activation-status-changed-events' },
         ],
     },
-    // ====== Optionen pro Event (identisch zu instantProperties) ======
+    // ====== 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',
@@ -532,7 +567,7 @@ exports.webhookProperties = [
             },
         ],
     },
-    // Lesson Completed (kaskadiert)
+    // Lesson Completed (cascading)
     {
         displayName: 'Lesson Completed Options',
         name: 'additionalLessonCompleted',

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

@@ -3,6 +3,32 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.webhookSampleDataProperties = void 0;
 exports.webhookSampleDataProperties = [
+    {
+        displayName: 'Agent Action Executed Options',
+        name: 'additionalAgentActionExecutedSample',
+        type: 'collection',
+        default: {},
+        placeholder: 'Add option',
+        displayOptions: { show: { sampleDataType: ['agent-action-executed-events'] } },
+        options: [
+            {
+                displayName: 'Tool Key Name or ID',
+                name: 'toolKey',
+                type: 'options',
+                default: '',
+                description: 'Optional tool key to filter agent action executions. 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 agent ID to filter agent action executions. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code/expressions/">expression</a>.',
+                typeOptions: { loadOptionsMethod: 'ai_getAiAgents' },
+            },
+        ],
+    },
     {
         displayName: 'Progress Changed Options',
         name: 'additionalProgressChangedSample',

package/dist/nodes/LearningSuite/exec.types.d.ts

@@ -1,5 +1,5 @@
 import type { IDataObject, IExecuteFunctions } from 'n8n-workflow';
-/** Einheitlicher Funktions-Typ für alle Execute-Handler. */
+/** Unified function type for all execute handlers. */
 export type ExecuteHandler = (ctx: IExecuteFunctions, itemIndex: number) => Promise<IDataObject | IDataObject[]>;
-/** Registry-Typ: resource -> operation -> handler */
+/** Registry type: resource -> operation -> handler */
 export type HandlersRegistry = Record<string, Record<string, ExecuteHandler>>;

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

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

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

@@ -1,7 +1,48 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.aiHandlers = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
 const shared_1 = require("../shared");
+const getAgentActions = async (ctx) => {
+    return await shared_1.lsRequest.call(ctx, 'GET', '/agent-actions');
+};
+const getAiAgents = async (ctx) => {
+    return await shared_1.lsRequest.call(ctx, 'GET', '/ai-agents');
+};
+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)}`);
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), `"${name}" must be a JSON object`);
+    }
+    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 body = {
+        userId: ctx.getNodeParameter('userId', i),
+        chatId: ctx.getNodeParameter('chatId', i, undefined),
+        message: ctx.getNodeParameter('message', i, undefined),
+        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),
@@ -19,5 +60,8 @@ const ragChat = async (ctx, i) => {
     return await shared_1.lsRequest.call(ctx, 'POST', '/ai/rag-chat', { body: cleanBody });
 };
 exports.aiHandlers = {
+    agentChat,
+    getAgentActions,
+    getAiAgents,
     ragChat,
 };

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

@@ -9,6 +9,7 @@ export declare const customFieldsHandlers: {
     getFieldValues: ExecuteHandler;
     setFieldValue: ExecuteHandler;
     setMultipleFieldValues: ExecuteHandler;
+    createFileUploadTarget: ExecuteHandler;
     getProfiles: ExecuteHandler;
     getProfilesExpanded: ExecuteHandler;
     getProfileByCard: ExecuteHandler;

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

@@ -95,6 +95,178 @@ function normalizeCustomFieldValue(response) {
         return { value: response[0] };
     return { value: response };
 }
+function normalizeValuesArray(value) {
+    if (value === undefined || value === null) {
+        return [];
+    }
+    return Array.isArray(value) ? value : [value];
+}
+function normalizeStoreFileValuesResponse(response) {
+    if (!Array.isArray(response)) {
+        return normalizeValuesArray(response);
+    }
+    if (response.length === 0) {
+        return [];
+    }
+    if (response.length === 1 && Array.isArray(response[0])) {
+        return response[0];
+    }
+    return response;
+}
+function normalizeFileValuesResponse(response) {
+    return normalizeStoreFileValuesResponse(response);
+}
+function normalizeProfileIndex(value) {
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        return value;
+    }
+    if (typeof value === 'string' && value.trim() !== '') {
+        const parsed = Number(value);
+        return Number.isFinite(parsed) ? parsed : undefined;
+    }
+    return undefined;
+}
+function getMediaFieldLimit(type, typeDefinition) {
+    switch (type) {
+        case 'files':
+            return typeDefinition.maxFiles;
+        case 'images':
+            return typeDefinition.maxImages;
+        case 'videos':
+            return typeDefinition.maxVideos;
+        case 'audios':
+            return typeDefinition.maxAudios;
+        default:
+            return undefined;
+    }
+}
+function buildProfileSelector(ctx, i) {
+    const profileId = ctx.getNodeParameter('profileId', i, '');
+    const profileIndex = normalizeProfileIndex(ctx.getNodeParameter('profileIndex', i, ''));
+    const profileName = ctx.getNodeParameter('profileName', i, '');
+    const selector = {};
+    if (profileId) {
+        selector.profileId = profileId;
+    }
+    else if (profileIndex !== undefined) {
+        selector.profileIndex = profileIndex;
+    }
+    else if (profileName) {
+        selector.profileName = profileName;
+    }
+    return selector;
+}
+function hasProfileSelector(selector) {
+    return selector.profileId !== undefined || selector.profileIndex !== undefined || selector.profileName !== undefined;
+}
+function getEffectiveProfileSelector(fieldContext, selector) {
+    return fieldContext.multipleProfilesAllowed ? selector : {};
+}
+async function cardAllowsMultipleProfiles(ctx, cardId) {
+    const cards = await shared_1.lsRequest.call(ctx, 'GET', '/custom-fields/cards');
+    if (!Array.isArray(cards)) {
+        return false;
+    }
+    const card = cards.find((entry) => {
+        if (typeof entry !== 'object' || entry === null)
+            return false;
+        return entry.id === cardId;
+    });
+    if (!card || typeof card !== 'object') {
+        return false;
+    }
+    return card.multipleProfilesAllowed === true;
+}
+function getFileValueMode(ctx, i) {
+    return ctx.getNodeParameter('fileValueMode', i, 'add');
+}
+function countBinaryPropertyNames(binaryPropertyNames) {
+    return binaryPropertyNames
+        .split(',')
+        .map((name) => name.trim())
+        .filter((name) => name.length > 0).length;
+}
+function findFileFieldContext(ctx, cards, customFieldKey) {
+    var _a, _b, _c;
+    for (const card of cards) {
+        if (!(card === null || card === void 0 ? void 0 : card.id) || !Array.isArray(card.definitions)) {
+            continue;
+        }
+        const definition = card.definitions.find((def) => (def === null || def === void 0 ? void 0 : def.key) === customFieldKey);
+        if (!definition) {
+            continue;
+        }
+        const type = String((_b = (_a = definition.typeDefinition) === null || _a === void 0 ? void 0 : _a.type) !== null && _b !== void 0 ? _b : '');
+        if (!FILE_FIELD_TYPES.has(type)) {
+            throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), `Custom field "${customFieldKey}" is not a file, image, video, or audio field.`);
+        }
+        return {
+            cardId: card.id,
+            type,
+            maxItems: getMediaFieldLimit(type, (_c = definition.typeDefinition) !== null && _c !== void 0 ? _c : {}),
+            multipleProfilesAllowed: card.multipleProfilesAllowed === true,
+        };
+    }
+    throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), `Unknown custom field "${customFieldKey}".`);
+}
+async function getPublicUrlFileFieldContext(ctx, customFieldKey) {
+    const cardsResponse = await shared_1.lsRequest.call(ctx, 'GET', '/custom-fields/cards/expanded');
+    if (!Array.isArray(cardsResponse)) {
+        throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), 'Failed to load custom field definitions.');
+    }
+    return findFileFieldContext(ctx, cardsResponse, customFieldKey);
+}
+async function readExistingFileValues(ctx, userId, customFieldKey, fieldContext, profileSelector, forceProfileContext = false) {
+    const effectiveProfileSelector = getEffectiveProfileSelector(fieldContext, profileSelector);
+    const useProfileContext = forceProfileContext || fieldContext.multipleProfilesAllowed || hasProfileSelector(effectiveProfileSelector);
+    if (useProfileContext) {
+        const existingProfileValues = await shared_1.lsRequest.call(ctx, 'GET', `/custom-fields/store/${userId}/profiles/by-card/${fieldContext.cardId}`, { qs: effectiveProfileSelector });
+        return {
+            existingValues: normalizeFileValuesResponse(existingProfileValues === null || existingProfileValues === void 0 ? void 0 : existingProfileValues[customFieldKey]),
+            useProfileContext,
+        };
+    }
+    const existingFieldValues = await shared_1.lsRequest.call(ctx, 'GET', `/custom-fields/store/${userId}/fields/${customFieldKey}`);
+    return {
+        existingValues: normalizeStoreFileValuesResponse(existingFieldValues),
+        useProfileContext,
+    };
+}
+function assertFileValueCountWithinLimit(ctx, customFieldKey, valueCount, maxItems) {
+    if (maxItems !== undefined && valueCount > maxItems) {
+        throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), `Cannot set custom field "${customFieldKey}". Maximum of ${maxItems} file values would be exceeded.`);
+    }
+}
+function buildNextFileValues(ctx, customFieldKey, existingValues, uploadedValues, maxItems, mode) {
+    assertFileValueCountWithinLimit(ctx, customFieldKey, uploadedValues.length, maxItems);
+    if (mode === 'replace') {
+        return uploadedValues;
+    }
+    const appendedValues = [...existingValues, ...uploadedValues];
+    if (maxItems === undefined || appendedValues.length <= maxItems) {
+        return appendedValues;
+    }
+    if (mode === 'replaceIfFull') {
+        return uploadedValues;
+    }
+    throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), `Cannot add file to custom field "${customFieldKey}". Maximum of ${maxItems} would be exceeded.`);
+}
+async function writeFileValues(ctx, userId, customFieldKey, fieldContext, profileSelector, useProfileContext, nextValues) {
+    const effectiveProfileSelector = getEffectiveProfileSelector(fieldContext, profileSelector);
+    if (useProfileContext) {
+        const updateBody = {
+            fieldKey: customFieldKey,
+            fieldValue: nextValues,
+            ...effectiveProfileSelector,
+        };
+        return await shared_1.lsRequest.call(ctx, 'PUT', `/custom-fields/store/${userId}/profiles/by-card/${fieldContext.cardId}`, {
+            body: updateBody,
+        });
+    }
+    return await shared_1.lsRequest.call(ctx, 'PUT', `/custom-fields/store/${userId}/fields/${customFieldKey}`, {
+        body: { fieldValue: nextValues },
+    });
+}
 function readTypedFieldValue(ctx, i, fieldType) {
     switch (fieldType) {
         case 'string':
@@ -154,9 +326,9 @@ const getStore = async (ctx, i) => {
 };
 const getStoreValues = async (ctx, i) => {
     const userId = ctx.getNodeParameter('userId', i);
-    const profileIndex = ctx.getNodeParameter('profileIndex', i, null);
+    const profileIndex = normalizeProfileIndex(ctx.getNodeParameter('profileIndex', i, ''));
     const qs = {};
-    if (profileIndex !== null && Number.isFinite(profileIndex)) {
+    if (profileIndex !== undefined) {
         qs.profileIndex = profileIndex;
     }
     return await shared_1.lsRequest.call(ctx, 'GET', `/custom-fields/store/${userId}/values`, { qs });
@@ -172,10 +344,24 @@ const setFieldValue = async (ctx, i) => {
     const fieldKey = ctx.getNodeParameter('fieldKey', i);
     const fieldType = ctx.getNodeParameter('fieldType', i, '');
     let fieldValue;
+    let fileFieldContext;
+    let fileProfileSelector;
+    let useFileProfileContext = false;
     if (FILE_FIELD_TYPES.has(fieldType)) {
         const binaryPropertyNames = readTypedFieldValue(ctx, i, fieldType);
         const fileNameOverride = ctx.getNodeParameter('fieldValueFileName', i, '').trim() || undefined;
-        fieldValue = await (0, shared_1.uploadFilesFromBinaryProperties)(ctx, i, userId, binaryPropertyNames, fieldType, fileNameOverride);
+        const fileValueMode = getFileValueMode(ctx, i);
+        fileFieldContext = await getPublicUrlFileFieldContext(ctx, fieldKey);
+        fileProfileSelector = buildProfileSelector(ctx, i);
+        const { existingValues, useProfileContext } = await readExistingFileValues(ctx, userId, fieldKey, fileFieldContext, fileProfileSelector);
+        useFileProfileContext = useProfileContext;
+        const uploadCount = countBinaryPropertyNames(binaryPropertyNames);
+        if (fileValueMode !== 'replaceIfFull') {
+            const expectedValues = fileValueMode === 'replace' ? uploadCount : existingValues.length + uploadCount;
+            assertFileValueCountWithinLimit(ctx, fieldKey, expectedValues, fileFieldContext.maxItems);
+        }
+        const uploadedValues = await (0, shared_1.uploadFilesFromBinaryProperties)(ctx, i, userId, fieldKey, binaryPropertyNames, fieldType, fileNameOverride);
+        fieldValue = buildNextFileValues(ctx, fieldKey, existingValues, uploadedValues, fileFieldContext.maxItems, fileValueMode);
     }
     else {
         fieldValue = readTypedFieldValue(ctx, i, fieldType);
@@ -184,8 +370,7 @@ const setFieldValue = async (ctx, i) => {
         throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), `No value provided for custom field "${fieldKey}".`);
     }
     const profileId = ctx.getNodeParameter('profileId', i, '');
-    const profileIndex = ctx.getNodeParameter('profileIndex', i, null);
-    const validProfileIndex = profileIndex !== null && Number.isFinite(profileIndex) ? profileIndex : undefined;
+    const validProfileIndex = normalizeProfileIndex(ctx.getNodeParameter('profileIndex', i, ''));
     const body = { fieldValue };
     if (profileId) {
         body.profileId = profileId;
@@ -193,6 +378,10 @@ const setFieldValue = async (ctx, i) => {
     else if (validProfileIndex !== undefined) {
         body.profileIndex = validProfileIndex;
     }
+    if (fileFieldContext && fileProfileSelector) {
+        const response = await writeFileValues(ctx, userId, fieldKey, fileFieldContext, fileProfileSelector, useFileProfileContext, fieldValue);
+        return normalizeCustomFieldValue(response);
+    }
     const response = await shared_1.lsRequest.call(ctx, 'PUT', `/custom-fields/store/${userId}/fields/${fieldKey}`, { body });
     return normalizeCustomFieldValue(response);
 };
@@ -213,8 +402,8 @@ function buildFieldTypeMap(cards) {
 const setMultipleFieldValues = async (ctx, i) => {
     const userId = ctx.getNodeParameter('userId', i);
     const profileId = ctx.getNodeParameter('profileId', i, '');
-    const profileIndex = ctx.getNodeParameter('profileIndex', i, null);
-    const validProfileIndex = profileIndex !== null && Number.isFinite(profileIndex) ? profileIndex : undefined;
+    const validProfileIndex = normalizeProfileIndex(ctx.getNodeParameter('profileIndex', i, ''));
+    const fileValueMode = getFileValueMode(ctx, i);
     const mapperData = ctx.getNodeParameter('fieldValues', i);
     const fieldMappings = (mapperData === null || mapperData === void 0 ? void 0 : mapperData.value) || {};
     const cardsResponse = await shared_1.lsRequest.call(ctx, 'GET', '/custom-fields/cards/expanded');
@@ -222,6 +411,7 @@ const setMultipleFieldValues = async (ctx, i) => {
         throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), 'Failed to load custom field definitions.');
     }
     const cards = cardsResponse;
+    const expandedCards = cardsResponse;
     const fieldTypeMap = buildFieldTypeMap(cards);
     const entries = Object.entries(fieldMappings).filter(([, value]) => value !== undefined);
     const payload = [];
@@ -233,7 +423,22 @@ const setMultipleFieldValues = async (ctx, i) => {
         let fieldValue;
         if (FILE_FIELD_TYPES.has(lsType)) {
             const binaryPropertyNames = typeof value === 'string' ? value : 'data';
-            fieldValue = await (0, shared_1.uploadFilesFromBinaryProperties)(ctx, i, userId, binaryPropertyNames, lsType);
+            const fieldContext = findFileFieldContext(ctx, expandedCards, fieldKey);
+            const profileSelector = {};
+            if (profileId) {
+                profileSelector.profileId = profileId;
+            }
+            else if (validProfileIndex !== undefined) {
+                profileSelector.profileIndex = validProfileIndex;
+            }
+            const { existingValues } = await readExistingFileValues(ctx, userId, fieldKey, fieldContext, profileSelector);
+            const uploadCount = countBinaryPropertyNames(binaryPropertyNames);
+            if (fileValueMode !== 'replaceIfFull') {
+                const expectedValues = fileValueMode === 'replace' ? uploadCount : existingValues.length + uploadCount;
+                assertFileValueCountWithinLimit(ctx, fieldKey, expectedValues, fieldContext.maxItems);
+            }
+            const uploadedValues = await (0, shared_1.uploadFilesFromBinaryProperties)(ctx, i, userId, fieldKey, binaryPropertyNames, lsType);
+            fieldValue = buildNextFileValues(ctx, fieldKey, existingValues, uploadedValues, fieldContext.maxItems, fileValueMode);
         }
         else {
             fieldValue = normalizeSingleFieldValueOrFail(ctx, value, fieldKey, lsType);
@@ -254,6 +459,37 @@ const setMultipleFieldValues = async (ctx, i) => {
         body: payload,
     });
 };
+const createFileUploadTarget = async (ctx, i) => {
+    const userId = ctx.getNodeParameter('userId', i);
+    const customFieldKey = (ctx.getNodeParameter('customFieldKey', i, '') || ctx.getNodeParameter('fieldKey', i, '')).trim();
+    const fileName = ctx.getNodeParameter('customFieldFileName', i, '').trim();
+    const publicDownloadUrl = ctx.getNodeParameter('publicDownloadUrl', i, '').trim();
+    const profileSelector = buildProfileSelector(ctx, i);
+    const fileValueMode = getFileValueMode(ctx, i);
+    if (!customFieldKey) {
+        throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), 'No custom field key provided.');
+    }
+    if (!publicDownloadUrl) {
+        throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), 'No public download URL provided.');
+    }
+    const fieldContext = await getPublicUrlFileFieldContext(ctx, customFieldKey);
+    const { existingValues, useProfileContext } = await readExistingFileValues(ctx, userId, customFieldKey, fieldContext, profileSelector);
+    const body = { customFieldKey };
+    if (fileName) {
+        body.fileName = fileName;
+    }
+    body.publicDownloadUrl = publicDownloadUrl;
+    const createFileResponse = (await shared_1.lsRequest.call(ctx, 'POST', `/custom-fields/store/${userId}/files`, {
+        body,
+    }));
+    const customFieldValue = createFileResponse.customFieldValue;
+    if (customFieldValue === undefined || customFieldValue === null) {
+        throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), 'LearningSuite did not return a custom field value for the uploaded file.');
+    }
+    const uploadedValues = normalizeValuesArray(customFieldValue);
+    const nextValues = buildNextFileValues(ctx, customFieldKey, existingValues, uploadedValues, fieldContext.maxItems, fileValueMode);
+    return await writeFileValues(ctx, userId, customFieldKey, fieldContext, profileSelector, useProfileContext, nextValues);
+};
 const getProfiles = async (ctx, i) => {
     const userId = ctx.getNodeParameter('userId', i);
     const customFieldCardId = ctx.getNodeParameter('customFieldCardId', i, undefined);
@@ -274,13 +510,13 @@ const getProfileByCard = async (ctx, i) => {
     const userId = ctx.getNodeParameter('userId', i);
     const cardId = ctx.getNodeParameter('customFieldCardId', i);
     const profileId = ctx.getNodeParameter('profileId', i, '');
-    const profileIndex = ctx.getNodeParameter('profileIndex', i, null);
+    const profileIndex = normalizeProfileIndex(ctx.getNodeParameter('profileIndex', i, ''));
     const profileName = ctx.getNodeParameter('profileName', i, '');
     const qs = {};
     if (profileId) {
         qs.profileId = profileId;
     }
-    else if (profileIndex !== null && Number.isFinite(profileIndex)) {
+    else if (profileIndex !== undefined) {
         qs.profileIndex = profileIndex;
     }
     else if (profileName) {
@@ -294,10 +530,22 @@ const updateProfileField = async (ctx, i) => {
     const fieldKey = ctx.getNodeParameter('fieldKey', i);
     const fieldType = ctx.getNodeParameter('fieldType', i, '');
     let fieldValue;
+    let fileFieldContext;
+    let fileProfileSelector;
     if (FILE_FIELD_TYPES.has(fieldType)) {
         const binaryPropertyNames = readTypedFieldValue(ctx, i, fieldType);
         const fileNameOverride = ctx.getNodeParameter('fieldValueFileName', i, '').trim() || undefined;
-        fieldValue = await (0, shared_1.uploadFilesFromBinaryProperties)(ctx, i, userId, binaryPropertyNames, fieldType, fileNameOverride);
+        const fileValueMode = getFileValueMode(ctx, i);
+        fileFieldContext = await getPublicUrlFileFieldContext(ctx, fieldKey);
+        fileProfileSelector = getEffectiveProfileSelector(fileFieldContext, buildProfileSelector(ctx, i));
+        const { existingValues } = await readExistingFileValues(ctx, userId, fieldKey, fileFieldContext, fileProfileSelector, true);
+        const uploadCount = countBinaryPropertyNames(binaryPropertyNames);
+        if (fileValueMode !== 'replaceIfFull') {
+            const expectedValues = fileValueMode === 'replace' ? uploadCount : existingValues.length + uploadCount;
+            assertFileValueCountWithinLimit(ctx, fieldKey, expectedValues, fileFieldContext.maxItems);
+        }
+        const uploadedValues = await (0, shared_1.uploadFilesFromBinaryProperties)(ctx, i, userId, fieldKey, binaryPropertyNames, fieldType, fileNameOverride);
+        fieldValue = buildNextFileValues(ctx, fieldKey, existingValues, uploadedValues, fileFieldContext.maxItems, fileValueMode);
     }
     else {
         fieldValue = readTypedFieldValue(ctx, i, fieldType);
@@ -306,19 +554,21 @@ const updateProfileField = async (ctx, i) => {
         throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), `No value provided for custom field "${fieldKey}".`);
     }
     const body = { fieldKey, fieldValue };
-    const profileId = ctx.getNodeParameter('profileId', i, '');
-    const profileIndex = ctx.getNodeParameter('profileIndex', i, null);
-    if (profileId) {
-        body.profileId = profileId;
+    let profileSelector = buildProfileSelector(ctx, i);
+    if (fileFieldContext) {
+        profileSelector = getEffectiveProfileSelector(fileFieldContext, profileSelector);
     }
-    else if (profileIndex !== null && Number.isFinite(profileIndex)) {
-        body.profileIndex = profileIndex;
+    else if (!(await cardAllowsMultipleProfiles(ctx, cardId))) {
+        profileSelector = {};
     }
-    if (body.profileId === undefined && body.profileIndex === undefined) {
-        const profileName = ctx.getNodeParameter('profileName', i, '');
-        if (profileName) {
-            body.profileName = profileName;
-        }
+    if (profileSelector.profileId !== undefined) {
+        body.profileId = profileSelector.profileId;
+    }
+    else if (profileSelector.profileIndex !== undefined) {
+        body.profileIndex = profileSelector.profileIndex;
+    }
+    else if (profileSelector.profileName !== undefined) {
+        body.profileName = profileSelector.profileName;
     }
     const response = await shared_1.lsRequest.call(ctx, 'PUT', `/custom-fields/store/${userId}/profiles/by-card/${cardId}`, {
         body,
@@ -335,6 +585,7 @@ exports.customFieldsHandlers = {
     getFieldValues,
     setFieldValue,
     setMultipleFieldValues,
+    createFileUploadTarget,
     getProfiles,
     getProfilesExpanded,
     getProfileByCard,

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

@@ -28,5 +28,5 @@ const sendPushNotification = async (ctx, i) => {
     });
 };
 exports.userHandlers = {
-    sendPushNotification, // 👈 KEY muss exakt dem operation value entsprechen
+    sendPushNotification, // 👈 KEY must exactly match the operation value
 };

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

@@ -34,6 +34,17 @@ function buildDesiredFilter(ctx, i, eventType) {
     var _a;
     const filter = {};
     switch (eventType) {
+        // ---------------- Agent Action
+        case 'agentAction.executed': {
+            const col = getCol(ctx, i, '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(ctx, i, 'additionalCommunityPostCommented');
@@ -161,7 +172,7 @@ function buildDesiredFilter(ctx, i, eventType) {
                 filter.groupId = String(col.groupId);
             break;
         }
-        // ---------------- Lesson Completed (kaskadiert)
+        // ---------------- Lesson Completed (cascading)
         case 'lesson.completed': {
             const col = getCol(ctx, i, 'additionalLessonCompleted');
             if (col.courseId)
@@ -223,6 +234,11 @@ const getSampleData = async (ctx, i) => {
     const sampleDataType = ctx.getNodeParameter('sampleDataType', i);
     let qs = {};
     switch (sampleDataType) {
+        case 'agent-action-executed-events': {
+            const col = ctx.getNodeParameter('additionalAgentActionExecutedSample', i, {});
+            qs = col;
+            break;
+        }
         case 'progress-changed-events': {
             const col = ctx.getNodeParameter('additionalProgressChangedSample', i, {});
             qs = col;

package/dist/nodes/LearningSuite/methods/loadOptions/ai.loadOptions.d.ts

@@ -0,0 +1,3 @@
+import type { ILoadOptionsFunctions, INodePropertyOptions } from 'n8n-workflow';
+export declare function ai_getAgentActions(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+export declare function ai_getAiAgents(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;

package/dist/nodes/LearningSuite/methods/loadOptions/ai.loadOptions.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ai_getAgentActions = ai_getAgentActions;
+exports.ai_getAiAgents = ai_getAiAgents;
+const common_1 = require("./common");
+async function ai_getAgentActions() {
+    return common_1.fetchOptions.call(this, '/agent-actions', undefined, ['name'], ['toolKey']);
+}
+async function ai_getAiAgents() {
+    return common_1.fetchOptions.call(this, '/ai-agents', undefined, ['name'], ['id']);
+}

package/dist/nodes/LearningSuite/methods/loadOptions/common.d.ts

@@ -4,4 +4,5 @@ type LoadOptionRow = IDataObject;
 export declare function toOptions(rows: LoadOptionRow[], labelKeys?: string[], valueKeys?: string[]): INodePropertyOptions[];
 export declare function ensureArray<T>(res: T | T[]): T[];
 export declare function fetchOptions(this: ILoadOptionsFunctions, endpoint: string, qs?: IDataObject, labelKeys?: string[], valueKeys?: string[]): Promise<INodePropertyOptions[]>;
+export declare function fetchOptionsAll(this: ILoadOptionsFunctions, endpoint: string, qs?: IDataObject, labelKeys?: string[], valueKeys?: string[]): Promise<INodePropertyOptions[]>;
 export {};