@uipath/uipath-typescript 1.3.10 → 1.3.11

package/dist/index.mjs

@@ -4596,6 +4596,8 @@ const MAESTRO_ENDPOINTS = {
         TOP_PROCESSES_BY_RUN_COUNT: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/TopProcessesByRunCount`,
         /** Top processes ranked by failure count */
         TOP_PROCESSES_WITH_FAILURE: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/TopProcesseswithFailure`,
+        /** Top elements ranked by failure count */
+        TOP_ELEMENTS_WITH_FAILURE: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/TopElementswithFailure`,
         /** Instance status aggregated by date for time-series charts */
         INSTANCE_STATUS_BY_DATE: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/InstanceStatusByDate`,
         /** Top processes ranked by total duration */
@@ -5490,7 +5492,7 @@ function normalizeBaseUrl(url) {
  * SDK's public API.
  */
 /** SDK version placeholder — patched by the SDK publish workflow. */
-const SDK_VERSION = '1.3.10';
+const SDK_VERSION = '1.3.11';
 const CLOUD_ROLE_NAME = 'uipath-ts-sdk';
 const SDK_SERVICE_NAME = 'UiPath.TypeScript.Sdk';
 const SDK_LOGGER_NAME = 'uipath-ts-sdk-telemetry';
@@ -8536,10 +8538,6 @@ class EntityService extends BaseService {
      * @internal
      */
     async create(name, fields, options) {
-        this.validateName(name, 'entity');
-        for (const field of fields) {
-            this.validateName(field.fieldName, 'field');
-        }
         const opts = options ?? {};
         const payload = {
             ...(opts.description !== undefined && { description: opts.description }),
@@ -8682,6 +8680,7 @@ class EntityService extends BaseService {
                     ...(update.isUnique !== undefined && { isUnique: update.isUnique }),
                     ...(update.isRbacEnabled !== undefined && { isRbacEnabled: update.isRbacEnabled }),
                     ...(update.isEncrypted !== undefined && { isEncrypted: update.isEncrypted }),
+                    ...(update.isHiddenField !== undefined && { isHiddenField: update.isHiddenField }),
                     ...(update.defaultValue !== undefined && { defaultValue: update.defaultValue }),
                     ...(hasConstraintUpdate && f.sqlType && { sqlType: { ...f.sqlType, ...constraintUpdate } }),
                 };
@@ -8690,9 +8689,6 @@ class EntityService extends BaseService {
         // Build and append new fields
         const newFields = [];
         if (options.addFields?.length) {
-            for (const field of options.addFields) {
-                this.validateName(field.fieldName, 'field');
-            }
             newFields.push(...options.addFields.map(f => this.buildSchemaFieldPayload(f)));
         }
         await this.post(DATA_FABRIC_ENDPOINTS.ENTITY.UPSERT, {
@@ -8793,9 +8789,15 @@ class EntityService extends BaseService {
     }
     /** Converts a user-facing EntityCreateFieldOptions to the raw API field payload */
     buildSchemaFieldPayload(field) {
-        this.validateName(field.fieldName, 'field');
         const fieldType = field.type ?? EntityFieldDataType.STRING;
         this.validateFieldConstraints(fieldType, field, field.fieldName);
+        const isRelationship = fieldType === EntityFieldDataType.RELATIONSHIP;
+        const isFile = fieldType === EntityFieldDataType.FILE;
+        if ((isRelationship || isFile) && (!field.referenceEntityId || !field.referenceFieldId)) {
+            throw new ValidationError({
+                message: `Field '${field.fieldName}' of type ${fieldType} requires both referenceEntityId and referenceFieldId (UUIDs of the target entity and field).`,
+            });
+        }
         const mapping = EntitySchemaFieldTypeMap[fieldType];
         return {
             name: field.fieldName,
@@ -8810,10 +8812,13 @@ class EntityService extends BaseService {
             isUnique: field.isUnique ?? false,
             isRbacEnabled: field.isRbacEnabled ?? false,
             isEncrypted: field.isEncrypted ?? false,
+            isHiddenField: field.isHiddenField ?? false,
             ...(field.defaultValue !== undefined && { defaultValue: field.defaultValue }),
             ...(field.choiceSetId !== undefined && { choiceSetId: field.choiceSetId }),
-            ...(field.referenceEntityName !== undefined && { referenceEntityName: field.referenceEntityName }),
-            ...(field.referenceFieldName !== undefined && { referenceFieldName: field.referenceFieldName }),
+            ...((isRelationship || isFile) && { isForeignKey: true }),
+            ...(isRelationship && { referenceType: ReferenceType.ManyToOne }),
+            ...(field.referenceEntityId !== undefined && { referenceEntity: { id: field.referenceEntityId } }),
+            ...(field.referenceFieldId !== undefined && { referenceField: { id: field.referenceFieldId } }),
         };
     }
     /**
@@ -8917,24 +8922,7 @@ class EntityService extends BaseService {
                 return {};
         }
     }
-    validateName(name, context) {
-        if (name.length < 3 || name.length > 100 || !/^[a-zA-Z]\w*$/.test(name)) {
-            const suggestion = name.replace(/\W/g, '').replace(/^[0-9_]+/, '');
-            const defaultName = `My${context.charAt(0).toUpperCase() + context.slice(1)}`;
-            throw new ValidationError({
-                message: `Invalid ${context} name '${name}'. Must start with a letter, contain only letters, numbers, and underscores, 3–100 characters (e.g., "${suggestion || defaultName}").`
-            });
-        }
-        if (context === 'field' && EntityService.RESERVED_FIELD_NAMES.has(name)) {
-            throw new ValidationError({
-                message: `Field name '${name}' is reserved. Reserved names: ${[...EntityService.RESERVED_FIELD_NAMES].join(', ')}.`
-            });
-        }
-    }
 }
-EntityService.RESERVED_FIELD_NAMES = new Set([
-    'Id', 'CreatedBy', 'CreateTime', 'UpdatedBy', 'UpdateTime'
-]);
 __decorate([
     track('Entities.GetById')
 ], EntityService.prototype, "getById", null);
@@ -10215,6 +10203,52 @@ class MaestroProcessesService extends BaseService {
         const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.TOP_PROCESSES_BY_RUN_COUNT, buildInsightsTopBody(startTime, endTime, false, options));
         return (data ?? []).map(process => ({ ...process, name: process.packageId }));
     }
+    /**
+     * Get the top 10 BPMN elements ranked by failure count within a time range.
+     *
+     * Returns an array of up to 10 elements sorted by how many times they failed,
+     * useful for identifying the most error-prone activities in processes.
+     *
+     * @param startTime - Start of the time range to query
+     * @param endTime - End of the time range to query
+     * @param options - Optional filters (packageId, processKey, version)
+     * @returns Promise resolving to an array of {@link ElementGetTopFailedCountResponse}
+     * @example
+     * ```typescript
+     * import { MaestroProcesses } from '@uipath/uipath-typescript/maestro-processes';
+     *
+     * const maestroProcesses = new MaestroProcesses(sdk);
+     *
+     * // Get top failing elements for the last 7 days
+     * const topFailing = await maestroProcesses.getTopElementFailedCount(
+     *   new Date(Date.now() - 7 * 24 * 60 * 60 * 1000),
+     *   new Date()
+     * );
+     *
+     * for (const element of topFailing) {
+     *   console.log(`${element.elementName} (${element.elementType}): ${element.failedCount} failures`);
+     * }
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Get top failing elements for a specific process
+     * const filtered = await maestroProcesses.getTopElementFailedCount(
+     *   new Date(Date.now() - 7 * 24 * 60 * 60 * 1000),
+     *   new Date(),
+     *   { processKey: '<processKey>' }
+     * );
+     * ```
+     */
+    async getTopElementFailedCount(startTime, endTime, options) {
+        const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.TOP_ELEMENTS_WITH_FAILURE, buildInsightsTopBody(startTime, endTime, false, options));
+        return (data ?? []).map(item => ({
+            elementName: item.elementName,
+            elementType: item.elementType,
+            processKey: item.processKey,
+            failedCount: item.count,
+        }));
+    }
     /**
      * Get all instances status counts aggregated by date for maestro processes.
      *
@@ -10355,6 +10389,9 @@ __decorate([
 __decorate([
     track('MaestroProcesses.GetTopRunCount')
 ], MaestroProcessesService.prototype, "getTopRunCount", null);
+__decorate([
+    track('MaestroProcesses.GetTopElementFailedCount')
+], MaestroProcessesService.prototype, "getTopElementFailedCount", null);
 __decorate([
     track('MaestroProcesses.GetInstanceStatusTimeline')
 ], MaestroProcessesService.prototype, "getInstanceStatusTimeline", null);
@@ -10489,6 +10526,52 @@ class CasesService extends BaseService {
         const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.TOP_PROCESSES_BY_RUN_COUNT, buildInsightsTopBody(startTime, endTime, true, options));
         return (data ?? []).map(process => ({ ...process, name: this.extractCaseName(process.packageId) }));
     }
+    /**
+     * Get the top 10 BPMN elements ranked by failure count within a time range.
+     *
+     * Returns an array of up to 10 elements sorted by how many times they failed,
+     * useful for identifying the most error-prone activities in case processes.
+     *
+     * @param startTime - Start of the time range to query
+     * @param endTime - End of the time range to query
+     * @param options - Optional filters (packageId, processKey, version)
+     * @returns Promise resolving to an array of {@link ElementGetTopFailedCountResponse}
+     * @example
+     * ```typescript
+     * import { Cases } from '@uipath/uipath-typescript/cases';
+     *
+     * const cases = new Cases(sdk);
+     *
+     * // Get top failing elements for the last 7 days
+     * const topFailing = await cases.getTopElementFailedCount(
+     *   new Date(Date.now() - 7 * 24 * 60 * 60 * 1000),
+     *   new Date()
+     * );
+     *
+     * for (const element of topFailing) {
+     *   console.log(`${element.elementName} (${element.elementType}): ${element.failedCount} failures`);
+     * }
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Get top failing elements for a specific process
+     * const filtered = await cases.getTopElementFailedCount(
+     *   new Date(Date.now() - 7 * 24 * 60 * 60 * 1000),
+     *   new Date(),
+     *   { processKey: '<processKey>' }
+     * );
+     * ```
+     */
+    async getTopElementFailedCount(startTime, endTime, options) {
+        const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.TOP_ELEMENTS_WITH_FAILURE, buildInsightsTopBody(startTime, endTime, true, options));
+        return (data ?? []).map(item => ({
+            elementName: item.elementName,
+            elementType: item.elementType,
+            processKey: item.processKey,
+            failedCount: item.count,
+        }));
+    }
     /**
      * Get all instances status counts aggregated by date for case management processes.
      *
@@ -10644,6 +10727,9 @@ __decorate([
 __decorate([
     track('Cases.GetTopRunCount')
 ], CasesService.prototype, "getTopRunCount", null);
+__decorate([
+    track('Cases.GetTopElementFailedCount')
+], CasesService.prototype, "getTopElementFailedCount", null);
 __decorate([
     track('Cases.GetInstanceStatusTimeline')
 ], CasesService.prototype, "getInstanceStatusTimeline", null);

package/dist/index.umd.js

@@ -4600,6 +4600,8 @@
             TOP_PROCESSES_BY_RUN_COUNT: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/TopProcessesByRunCount`,
             /** Top processes ranked by failure count */
             TOP_PROCESSES_WITH_FAILURE: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/TopProcesseswithFailure`,
+            /** Top elements ranked by failure count */
+            TOP_ELEMENTS_WITH_FAILURE: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/TopElementswithFailure`,
             /** Instance status aggregated by date for time-series charts */
             INSTANCE_STATUS_BY_DATE: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/InstanceStatusByDate`,
             /** Top processes ranked by total duration */
@@ -9247,7 +9249,7 @@
      * shared across all consumers and is patched into this file at publish time.
      */
     // Connection string placeholder that will be replaced during build
-    const CONNECTION_STRING = '$CONNECTION_STRING';
+    const CONNECTION_STRING = 'InstrumentationKey=a6efa11d-1feb-4508-9738-e13e12dcae5e;IngestionEndpoint=https://westeurope-5.in.applicationinsights.azure.com/;LiveEndpoint=https://westeurope.livediagnostics.monitor.azure.com/;ApplicationId=7c58eb1c-9581-4ba6-839e-11725848a037';
     const VERSION = 'Version';
     const SERVICE = 'Service';
     const CLOUD_ORGANIZATION_NAME = 'CloudOrganizationName';
@@ -9573,7 +9575,7 @@
      * SDK's public API.
      */
     /** SDK version placeholder — patched by the SDK publish workflow. */
-    const SDK_VERSION = '1.3.10';
+    const SDK_VERSION = '1.3.11';
     const CLOUD_ROLE_NAME = 'uipath-ts-sdk';
     const SDK_SERVICE_NAME = 'UiPath.TypeScript.Sdk';
     const SDK_LOGGER_NAME = 'uipath-ts-sdk-telemetry';
@@ -12619,10 +12621,6 @@
          * @internal
          */
         async create(name, fields, options) {
-            this.validateName(name, 'entity');
-            for (const field of fields) {
-                this.validateName(field.fieldName, 'field');
-            }
             const opts = options ?? {};
             const payload = {
                 ...(opts.description !== undefined && { description: opts.description }),
@@ -12765,6 +12763,7 @@
                         ...(update.isUnique !== undefined && { isUnique: update.isUnique }),
                         ...(update.isRbacEnabled !== undefined && { isRbacEnabled: update.isRbacEnabled }),
                         ...(update.isEncrypted !== undefined && { isEncrypted: update.isEncrypted }),
+                        ...(update.isHiddenField !== undefined && { isHiddenField: update.isHiddenField }),
                         ...(update.defaultValue !== undefined && { defaultValue: update.defaultValue }),
                         ...(hasConstraintUpdate && f.sqlType && { sqlType: { ...f.sqlType, ...constraintUpdate } }),
                     };
@@ -12773,9 +12772,6 @@
             // Build and append new fields
             const newFields = [];
             if (options.addFields?.length) {
-                for (const field of options.addFields) {
-                    this.validateName(field.fieldName, 'field');
-                }
                 newFields.push(...options.addFields.map(f => this.buildSchemaFieldPayload(f)));
             }
             await this.post(DATA_FABRIC_ENDPOINTS.ENTITY.UPSERT, {
@@ -12876,9 +12872,15 @@
         }
         /** Converts a user-facing EntityCreateFieldOptions to the raw API field payload */
         buildSchemaFieldPayload(field) {
-            this.validateName(field.fieldName, 'field');
             const fieldType = field.type ?? exports.EntityFieldDataType.STRING;
             this.validateFieldConstraints(fieldType, field, field.fieldName);
+            const isRelationship = fieldType === exports.EntityFieldDataType.RELATIONSHIP;
+            const isFile = fieldType === exports.EntityFieldDataType.FILE;
+            if ((isRelationship || isFile) && (!field.referenceEntityId || !field.referenceFieldId)) {
+                throw new ValidationError({
+                    message: `Field '${field.fieldName}' of type ${fieldType} requires both referenceEntityId and referenceFieldId (UUIDs of the target entity and field).`,
+                });
+            }
             const mapping = EntitySchemaFieldTypeMap[fieldType];
             return {
                 name: field.fieldName,
@@ -12893,10 +12895,13 @@
                 isUnique: field.isUnique ?? false,
                 isRbacEnabled: field.isRbacEnabled ?? false,
                 isEncrypted: field.isEncrypted ?? false,
+                isHiddenField: field.isHiddenField ?? false,
                 ...(field.defaultValue !== undefined && { defaultValue: field.defaultValue }),
                 ...(field.choiceSetId !== undefined && { choiceSetId: field.choiceSetId }),
-                ...(field.referenceEntityName !== undefined && { referenceEntityName: field.referenceEntityName }),
-                ...(field.referenceFieldName !== undefined && { referenceFieldName: field.referenceFieldName }),
+                ...((isRelationship || isFile) && { isForeignKey: true }),
+                ...(isRelationship && { referenceType: exports.ReferenceType.ManyToOne }),
+                ...(field.referenceEntityId !== undefined && { referenceEntity: { id: field.referenceEntityId } }),
+                ...(field.referenceFieldId !== undefined && { referenceField: { id: field.referenceFieldId } }),
             };
         }
         /**
@@ -13000,24 +13005,7 @@
                     return {};
             }
         }
-        validateName(name, context) {
-            if (name.length < 3 || name.length > 100 || !/^[a-zA-Z]\w*$/.test(name)) {
-                const suggestion = name.replace(/\W/g, '').replace(/^[0-9_]+/, '');
-                const defaultName = `My${context.charAt(0).toUpperCase() + context.slice(1)}`;
-                throw new ValidationError({
-                    message: `Invalid ${context} name '${name}'. Must start with a letter, contain only letters, numbers, and underscores, 3–100 characters (e.g., "${suggestion || defaultName}").`
-                });
-            }
-            if (context === 'field' && EntityService.RESERVED_FIELD_NAMES.has(name)) {
-                throw new ValidationError({
-                    message: `Field name '${name}' is reserved. Reserved names: ${[...EntityService.RESERVED_FIELD_NAMES].join(', ')}.`
-                });
-            }
-        }
     }
-    EntityService.RESERVED_FIELD_NAMES = new Set([
-        'Id', 'CreatedBy', 'CreateTime', 'UpdatedBy', 'UpdateTime'
-    ]);
     __decorate([
         track('Entities.GetById')
     ], EntityService.prototype, "getById", null);
@@ -14298,6 +14286,52 @@
             const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.TOP_PROCESSES_BY_RUN_COUNT, buildInsightsTopBody(startTime, endTime, false, options));
             return (data ?? []).map(process => ({ ...process, name: process.packageId }));
         }
+        /**
+         * Get the top 10 BPMN elements ranked by failure count within a time range.
+         *
+         * Returns an array of up to 10 elements sorted by how many times they failed,
+         * useful for identifying the most error-prone activities in processes.
+         *
+         * @param startTime - Start of the time range to query
+         * @param endTime - End of the time range to query
+         * @param options - Optional filters (packageId, processKey, version)
+         * @returns Promise resolving to an array of {@link ElementGetTopFailedCountResponse}
+         * @example
+         * ```typescript
+         * import { MaestroProcesses } from '@uipath/uipath-typescript/maestro-processes';
+         *
+         * const maestroProcesses = new MaestroProcesses(sdk);
+         *
+         * // Get top failing elements for the last 7 days
+         * const topFailing = await maestroProcesses.getTopElementFailedCount(
+         *   new Date(Date.now() - 7 * 24 * 60 * 60 * 1000),
+         *   new Date()
+         * );
+         *
+         * for (const element of topFailing) {
+         *   console.log(`${element.elementName} (${element.elementType}): ${element.failedCount} failures`);
+         * }
+         * ```
+         *
+         * @example
+         * ```typescript
+         * // Get top failing elements for a specific process
+         * const filtered = await maestroProcesses.getTopElementFailedCount(
+         *   new Date(Date.now() - 7 * 24 * 60 * 60 * 1000),
+         *   new Date(),
+         *   { processKey: '<processKey>' }
+         * );
+         * ```
+         */
+        async getTopElementFailedCount(startTime, endTime, options) {
+            const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.TOP_ELEMENTS_WITH_FAILURE, buildInsightsTopBody(startTime, endTime, false, options));
+            return (data ?? []).map(item => ({
+                elementName: item.elementName,
+                elementType: item.elementType,
+                processKey: item.processKey,
+                failedCount: item.count,
+            }));
+        }
         /**
          * Get all instances status counts aggregated by date for maestro processes.
          *
@@ -14438,6 +14472,9 @@
     __decorate([
         track('MaestroProcesses.GetTopRunCount')
     ], MaestroProcessesService.prototype, "getTopRunCount", null);
+    __decorate([
+        track('MaestroProcesses.GetTopElementFailedCount')
+    ], MaestroProcessesService.prototype, "getTopElementFailedCount", null);
     __decorate([
         track('MaestroProcesses.GetInstanceStatusTimeline')
     ], MaestroProcessesService.prototype, "getInstanceStatusTimeline", null);
@@ -14572,6 +14609,52 @@
             const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.TOP_PROCESSES_BY_RUN_COUNT, buildInsightsTopBody(startTime, endTime, true, options));
             return (data ?? []).map(process => ({ ...process, name: this.extractCaseName(process.packageId) }));
         }
+        /**
+         * Get the top 10 BPMN elements ranked by failure count within a time range.
+         *
+         * Returns an array of up to 10 elements sorted by how many times they failed,
+         * useful for identifying the most error-prone activities in case processes.
+         *
+         * @param startTime - Start of the time range to query
+         * @param endTime - End of the time range to query
+         * @param options - Optional filters (packageId, processKey, version)
+         * @returns Promise resolving to an array of {@link ElementGetTopFailedCountResponse}
+         * @example
+         * ```typescript
+         * import { Cases } from '@uipath/uipath-typescript/cases';
+         *
+         * const cases = new Cases(sdk);
+         *
+         * // Get top failing elements for the last 7 days
+         * const topFailing = await cases.getTopElementFailedCount(
+         *   new Date(Date.now() - 7 * 24 * 60 * 60 * 1000),
+         *   new Date()
+         * );
+         *
+         * for (const element of topFailing) {
+         *   console.log(`${element.elementName} (${element.elementType}): ${element.failedCount} failures`);
+         * }
+         * ```
+         *
+         * @example
+         * ```typescript
+         * // Get top failing elements for a specific process
+         * const filtered = await cases.getTopElementFailedCount(
+         *   new Date(Date.now() - 7 * 24 * 60 * 60 * 1000),
+         *   new Date(),
+         *   { processKey: '<processKey>' }
+         * );
+         * ```
+         */
+        async getTopElementFailedCount(startTime, endTime, options) {
+            const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.TOP_ELEMENTS_WITH_FAILURE, buildInsightsTopBody(startTime, endTime, true, options));
+            return (data ?? []).map(item => ({
+                elementName: item.elementName,
+                elementType: item.elementType,
+                processKey: item.processKey,
+                failedCount: item.count,
+            }));
+        }
         /**
          * Get all instances status counts aggregated by date for case management processes.
          *
@@ -14727,6 +14810,9 @@
     __decorate([
         track('Cases.GetTopRunCount')
     ], CasesService.prototype, "getTopRunCount", null);
+    __decorate([
+        track('Cases.GetTopElementFailedCount')
+    ], CasesService.prototype, "getTopElementFailedCount", null);
     __decorate([
         track('Cases.GetInstanceStatusTimeline')
     ], CasesService.prototype, "getInstanceStatusTimeline", null);

package/dist/maestro-processes/index.cjs

@@ -79,6 +79,8 @@ const MAESTRO_ENDPOINTS = {
         TOP_PROCESSES_BY_RUN_COUNT: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/TopProcessesByRunCount`,
         /** Top processes ranked by failure count */
         TOP_PROCESSES_WITH_FAILURE: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/TopProcesseswithFailure`,
+        /** Top elements ranked by failure count */
+        TOP_ELEMENTS_WITH_FAILURE: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/TopElementswithFailure`,
         /** Instance status aggregated by date for time-series charts */
         INSTANCE_STATUS_BY_DATE: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/InstanceStatusByDate`,
         /** Top processes ranked by total duration */
@@ -2516,6 +2518,52 @@ class MaestroProcessesService extends BaseService {
         const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.TOP_PROCESSES_BY_RUN_COUNT, buildInsightsTopBody(startTime, endTime, false, options));
         return (data ?? []).map(process => ({ ...process, name: process.packageId }));
     }
+    /**
+     * Get the top 10 BPMN elements ranked by failure count within a time range.
+     *
+     * Returns an array of up to 10 elements sorted by how many times they failed,
+     * useful for identifying the most error-prone activities in processes.
+     *
+     * @param startTime - Start of the time range to query
+     * @param endTime - End of the time range to query
+     * @param options - Optional filters (packageId, processKey, version)
+     * @returns Promise resolving to an array of {@link ElementGetTopFailedCountResponse}
+     * @example
+     * ```typescript
+     * import { MaestroProcesses } from '@uipath/uipath-typescript/maestro-processes';
+     *
+     * const maestroProcesses = new MaestroProcesses(sdk);
+     *
+     * // Get top failing elements for the last 7 days
+     * const topFailing = await maestroProcesses.getTopElementFailedCount(
+     *   new Date(Date.now() - 7 * 24 * 60 * 60 * 1000),
+     *   new Date()
+     * );
+     *
+     * for (const element of topFailing) {
+     *   console.log(`${element.elementName} (${element.elementType}): ${element.failedCount} failures`);
+     * }
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Get top failing elements for a specific process
+     * const filtered = await maestroProcesses.getTopElementFailedCount(
+     *   new Date(Date.now() - 7 * 24 * 60 * 60 * 1000),
+     *   new Date(),
+     *   { processKey: '<processKey>' }
+     * );
+     * ```
+     */
+    async getTopElementFailedCount(startTime, endTime, options) {
+        const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.TOP_ELEMENTS_WITH_FAILURE, buildInsightsTopBody(startTime, endTime, false, options));
+        return (data ?? []).map(item => ({
+            elementName: item.elementName,
+            elementType: item.elementType,
+            processKey: item.processKey,
+            failedCount: item.count,
+        }));
+    }
     /**
      * Get all instances status counts aggregated by date for maestro processes.
      *
@@ -2656,6 +2704,9 @@ __decorate([
 __decorate([
     track('MaestroProcesses.GetTopRunCount')
 ], MaestroProcessesService.prototype, "getTopRunCount", null);
+__decorate([
+    track('MaestroProcesses.GetTopElementFailedCount')
+], MaestroProcessesService.prototype, "getTopElementFailedCount", null);
 __decorate([
     track('MaestroProcesses.GetInstanceStatusTimeline')
 ], MaestroProcessesService.prototype, "getInstanceStatusTimeline", null);

package/dist/maestro-processes/index.d.ts

@@ -39,6 +39,20 @@ interface GetTopFaultedCountResponse extends GetTopBaseResponse {
     /** Number of faulted instances in the given time range */
     faultedCount: number;
 }
+/**
+ * SDK response for top elements with failure.
+ * Shared by both MaestroProcesses and Cases — no service-specific enrichment.
+ */
+interface ElementGetTopFailedCountResponse {
+    /** BPMN element name (falls back to element ID if name is empty) */
+    elementName: string;
+    /** BPMN element type (e.g. ServiceTask, ReceiveTask, IntermediateCatchEvent) */
+    elementType: string;
+    /** The unique process key this element belongs to */
+    processKey: string;
+    /** Number of failed executions of this element in the given time range */
+    failedCount: number;
+}
 /**
  * Time bucketing granularity for insights time-series queries.
  *
@@ -364,6 +378,44 @@ interface MaestroProcessesServiceModel {
      * ```
      */
     getTopFaultedCount(startTime: Date, endTime: Date, options?: TopQueryOptions): Promise<ProcessGetTopFaultedCountResponse[]>;
+    /**
+     * Get the top 10 BPMN elements ranked by failure count within a time range.
+     *
+     * Returns an array of up to 10 elements sorted by how many times they failed,
+     * useful for identifying the most error-prone activities in processes.
+     *
+     * @param startTime - Start of the time range to query
+     * @param endTime - End of the time range to query
+     * @param options - Optional filters (packageId, processKey, version)
+     * @returns Promise resolving to an array of {@link ElementGetTopFailedCountResponse}
+     * @example
+     * ```typescript
+     * import { MaestroProcesses } from '@uipath/uipath-typescript/maestro-processes';
+     *
+     * const maestroProcesses = new MaestroProcesses(sdk);
+     *
+     * // Get top failing elements for the last 7 days
+     * const topFailing = await maestroProcesses.getTopElementFailedCount(
+     *   new Date(Date.now() - 7 * 24 * 60 * 60 * 1000),
+     *   new Date()
+     * );
+     *
+     * for (const element of topFailing) {
+     *   console.log(`${element.elementName} (${element.elementType}): ${element.failedCount} failures`);
+     * }
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Get top failing elements for a specific process
+     * const filtered = await maestroProcesses.getTopElementFailedCount(
+     *   new Date(Date.now() - 7 * 24 * 60 * 60 * 1000),
+     *   new Date(),
+     *   { processKey: '<processKey>' }
+     * );
+     * ```
+     */
+    getTopElementFailedCount(startTime: Date, endTime: Date, options?: TopQueryOptions): Promise<ElementGetTopFailedCountResponse[]>;
     /**
      * Get all instances status counts aggregated by date for maestro processes.
      *
@@ -1289,6 +1341,44 @@ declare class MaestroProcessesService extends BaseService implements MaestroProc
      * ```
      */
     getTopRunCount(startTime: Date, endTime: Date, options?: TopQueryOptions): Promise<ProcessGetTopRunCountResponse[]>;
+    /**
+     * Get the top 10 BPMN elements ranked by failure count within a time range.
+     *
+     * Returns an array of up to 10 elements sorted by how many times they failed,
+     * useful for identifying the most error-prone activities in processes.
+     *
+     * @param startTime - Start of the time range to query
+     * @param endTime - End of the time range to query
+     * @param options - Optional filters (packageId, processKey, version)
+     * @returns Promise resolving to an array of {@link ElementGetTopFailedCountResponse}
+     * @example
+     * ```typescript
+     * import { MaestroProcesses } from '@uipath/uipath-typescript/maestro-processes';
+     *
+     * const maestroProcesses = new MaestroProcesses(sdk);
+     *
+     * // Get top failing elements for the last 7 days
+     * const topFailing = await maestroProcesses.getTopElementFailedCount(
+     *   new Date(Date.now() - 7 * 24 * 60 * 60 * 1000),
+     *   new Date()
+     * );
+     *
+     * for (const element of topFailing) {
+     *   console.log(`${element.elementName} (${element.elementType}): ${element.failedCount} failures`);
+     * }
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Get top failing elements for a specific process
+     * const filtered = await maestroProcesses.getTopElementFailedCount(
+     *   new Date(Date.now() - 7 * 24 * 60 * 60 * 1000),
+     *   new Date(),
+     *   { processKey: '<processKey>' }
+     * );
+     * ```
+     */
+    getTopElementFailedCount(startTime: Date, endTime: Date, options?: TopQueryOptions): Promise<ElementGetTopFailedCountResponse[]>;
     /**
      * Get all instances status counts aggregated by date for maestro processes.
      *
@@ -1562,4 +1652,4 @@ declare class ProcessIncidentsService extends BaseService implements ProcessInci
 }
 
 export { DebugMode, InstanceFinalStatus, MaestroProcessesService as MaestroProcesses, MaestroProcessesService, ProcessIncidentSeverity, ProcessIncidentStatus, ProcessIncidentType, ProcessIncidentsService as ProcessIncidents, ProcessIncidentsService, ProcessInstancesService as ProcessInstances, ProcessInstancesService, TimeInterval, createProcessInstanceWithMethods, createProcessWithMethods };
-export type { BpmnXmlString, ElementMetaData, GetTopBaseResponse, GetTopDurationResponse, GetTopFaultedCountResponse, GetTopRunCountResponse, GlobalVariableMetaData, InstanceStatusTimelineResponse, MaestroProcessGetAllResponse, MaestroProcessesServiceModel, ProcessGetTopDurationResponse, ProcessGetTopFaultedCountResponse, ProcessGetTopRunCountResponse, ProcessIncidentGetAllResponse, ProcessIncidentGetResponse, ProcessIncidentsServiceModel, ProcessInstanceExecutionHistoryResponse, ProcessInstanceGetAllOptions, ProcessInstanceGetAllWithPaginationOptions, ProcessInstanceGetResponse, ProcessInstanceGetVariablesOptions, ProcessInstanceGetVariablesResponse, ProcessInstanceMethods, ProcessInstanceOperationOptions, ProcessInstanceOperationResponse, ProcessInstanceRun, ProcessInstancesServiceModel, ProcessMethods, RawMaestroProcessGetAllResponse, RawProcessInstanceGetResponse, TimelineOptions, TopQueryOptions };
+export type { BpmnXmlString, ElementGetTopFailedCountResponse, ElementMetaData, GetTopBaseResponse, GetTopDurationResponse, GetTopFaultedCountResponse, GetTopRunCountResponse, GlobalVariableMetaData, InstanceStatusTimelineResponse, MaestroProcessGetAllResponse, MaestroProcessesServiceModel, ProcessGetTopDurationResponse, ProcessGetTopFaultedCountResponse, ProcessGetTopRunCountResponse, ProcessIncidentGetAllResponse, ProcessIncidentGetResponse, ProcessIncidentsServiceModel, ProcessInstanceExecutionHistoryResponse, ProcessInstanceGetAllOptions, ProcessInstanceGetAllWithPaginationOptions, ProcessInstanceGetResponse, ProcessInstanceGetVariablesOptions, ProcessInstanceGetVariablesResponse, ProcessInstanceMethods, ProcessInstanceOperationOptions, ProcessInstanceOperationResponse, ProcessInstanceRun, ProcessInstancesServiceModel, ProcessMethods, RawMaestroProcessGetAllResponse, RawProcessInstanceGetResponse, TimelineOptions, TopQueryOptions };