@uipath/data-fabric-tool 1.197.0 → 1.198.0-preview.80

package/dist/tool.js

@@ -27244,7 +27244,7 @@ var require_src6 = __commonJS((exports) => {
 var package_default = {
   name: "@uipath/data-fabric-tool",
   license: "MIT",
-  version: "1.197.0",
+  version: "1.198.0-preview.80",
   description: "Manage Data Fabric entities and records.",
   type: "module",
   main: "./dist/tool.js",
@@ -27267,7 +27267,7 @@ var package_default = {
     "@uipath/common": "workspace:*",
     "@uipath/auth": "workspace:*",
     "@uipath/filesystem": "workspace:*",
-    "@uipath/uipath-typescript": "^1.4.1",
+    "@uipath/uipath-typescript": "^1.5.2",
     "@types/node": "^25.5.2",
     typescript: "^6.0.2"
   }
@@ -27333,8 +27333,15 @@ var TLS_ERROR_CODES = new Set([
 var TLS_INSTRUCTIONS = "The server's TLS certificate could not be verified. Most often a " + "corporate proxy/firewall re-signs HTTPS with a root CA that Node does " + "not trust — set NODE_EXTRA_CA_CERTS to that CA's PEM file (and HTTPS_PROXY " + "if you connect through a proxy). If the certificate is instead expired or " + "its hostname does not match, fix the endpoint URL or the system clock. " + "Then retry.";
 var NETWORK_INSTRUCTIONS = "Could not reach the UiPath service. Check your network connection and " + "VPN, confirm any HTTP_PROXY/HTTPS_PROXY/NO_PROXY settings are correct, " + "then retry.";
 function describeConnectivityError(error) {
-  let current = error;
-  for (let depth = 0;depth < 5 && current !== null && typeof current === "object"; depth++) {
+  const queue = [error];
+  const seen = new Set;
+  for (let steps = 0;queue.length > 0 && steps < 32; steps++) {
+    const current = queue.shift();
+    if (current === null || typeof current !== "object")
+      continue;
+    if (seen.has(current))
+      continue;
+    seen.add(current);
     const cur = current;
     const code = typeof cur.code === "string" ? cur.code : undefined;
     const message = typeof cur.message === "string" ? cur.message : undefined;
@@ -27354,7 +27361,10 @@ function describeConnectivityError(error) {
         instructions: NETWORK_INSTRUCTIONS
       };
     }
-    current = cur.cause;
+    if (cur.cause !== undefined)
+      queue.push(cur.cause);
+    if (Array.isArray(cur.errors))
+      queue.push(...cur.errors);
   }
   return;
 }
@@ -32589,6 +32599,7 @@ function getLogFilePath() {
 // ../common/src/output-format-context.ts
 var formatSlot = singleton("OutputFormat");
 var formatExplicitSlot = singleton("OutputFormatExplicit");
+var helpRequestedSlot = singleton("HelpRequested");
 var filterSlot = singleton("OutputFilter");
 function getOutputFormat() {
   return formatSlot.get("json");
@@ -33656,6 +33667,9 @@ var OutputFormatter;
     if (opts?.warning) {
       data.Warning = opts.warning;
     }
+    if (opts?.pagination) {
+      data.Pagination = opts.pagination;
+    }
     success(data);
   }
   OutputFormatter.emitList = emitList;
@@ -34117,6 +34131,7 @@ var savedOriginalsSlot = singleton("ConsoleGuardOriginals");
 var DEFAULT_AUTH_TIMEOUT_MS = 5 * 60 * 1000;
 // ../common/src/interactivity-context.ts
 var modeSlot = singleton("InteractivityMode");
+var interactiveFlagSlot = singleton("InteractiveFlag");
 // ../common/src/option-aliases.ts
 function warnDeprecatedOptionAlias(deprecatedFlag, preferredFlag) {
   getOutputSink().writeErr(`[WARN] ${deprecatedFlag} is deprecated. Use ${preferredFlag} instead.
@@ -35399,6 +35414,10 @@ function normalizeTokenRefreshUnavailableFailure() {
 function errorMessage(error) {
   return error instanceof Error ? error.message : String(error);
 }
+
+// ../auth/src/index.ts
+init_constants();
+
 // ../auth/src/interactive.ts
 init_src();
 
@@ -39632,7 +39651,8 @@ var MAESTRO_ENDPOINTS = {
     GET_VARIABLES: (instanceId) => `${PIMS_BASE}/api/v1/instances/${instanceId}/variables`,
     CANCEL: (instanceId) => `${PIMS_BASE}/api/v1/instances/${instanceId}/cancel`,
     PAUSE: (instanceId) => `${PIMS_BASE}/api/v1/instances/${instanceId}/pause`,
-    RESUME: (instanceId) => `${PIMS_BASE}/api/v1/instances/${instanceId}/resume`
+    RESUME: (instanceId) => `${PIMS_BASE}/api/v1/instances/${instanceId}/resume`,
+    RETRY: (instanceId) => `${PIMS_BASE}/api/v1/instances/${instanceId}/retry`
   },
   INCIDENTS: {
     GET_ALL: `${PIMS_BASE}/api/v1/incidents/summary`,
@@ -39655,7 +39675,9 @@ var MAESTRO_ENDPOINTS = {
     TOP_ELEMENTS_WITH_FAILURE: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/TopElementswithFailure`,
     INSTANCE_STATUS_BY_DATE: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/InstanceStatusByDate`,
     TOP_PROCESSES_BY_DURATION: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/TopProcessesByDuration`,
-    ELEMENT_COUNT_BY_STATUS: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/ElementCountByStatus`
+    INSTANCE_COUNT_BY_STATUS: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/InstanceCountByStatus`,
+    ELEMENT_COUNT_BY_STATUS: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/ElementCountByStatus`,
+    INCIDENTS_BY_TIME_WINDOW: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/IncidentsByTimeWindow`
   }
 };
 var DATA_FABRIC_TENANT_FOLDER_ID = "00000000-0000-0000-0000-000000000000";
@@ -39665,7 +39687,7 @@ var DATA_FABRIC_ENDPOINTS = {
     GET_ALL_V2: `${DATAFABRIC_BASE}/api/v2/Entity`,
     GET_ENTITY_RECORDS: (entityId) => `${DATAFABRIC_BASE}/api/EntityService/entity/${entityId}/read`,
     GET_BY_ID: (entityId) => `${DATAFABRIC_BASE}/api/Entity/${entityId}`,
-    GET_RECORD_BY_ID: (entityId, recordId) => `${DATAFABRIC_BASE}/api/EntityService/entity/${entityId}/read/${recordId}`,
+    GET_RECORD_BY_ID: (entityId, recordId) => `${DATAFABRIC_BASE}/api/v2/EntityService/entity/${entityId}/read/${recordId}`,
     INSERT_BY_ID: (entityId) => `${DATAFABRIC_BASE}/api/EntityService/entity/${entityId}/insert`,
     BATCH_INSERT_BY_ID: (entityId) => `${DATAFABRIC_BASE}/api/EntityService/entity/${entityId}/insert-batch`,
     UPDATE_RECORD_BY_ID: (entityId, recordId) => `${DATAFABRIC_BASE}/api/EntityService/entity/${entityId}/update/${recordId}`,
@@ -39690,6 +39712,14 @@ var DATA_FABRIC_ENDPOINTS = {
     INSERT_BY_NAME: (choiceSetName) => `${DATAFABRIC_BASE}/api/EntityService/${choiceSetName}/choiceset/insert`,
     UPDATE_BY_NAME: (choiceSetName, valueId) => `${DATAFABRIC_BASE}/api/EntityService/${choiceSetName}/choiceset/${valueId}/update`,
     DELETE_BY_ID: (choiceSetId) => `${DATAFABRIC_BASE}/api/EntityService/entity/${choiceSetId}/choiceset/delete`
+  },
+  ROLES: {
+    GET_ALL: `${DATAFABRIC_BASE}/api/v2/Role`
+  },
+  DIRECTORY: {
+    GET_ALL: `${DATAFABRIC_BASE}/api/Directory`,
+    ASSIGN_ROLES: `${DATAFABRIC_BASE}/api/Directory/Role`,
+    REVOKE_ROLES: `${DATAFABRIC_BASE}/api/Directory/RevokeRole`
   }
 };
 var IDENTITY_ENDPOINTS = {
@@ -39910,7 +39940,7 @@ class EmbeddedTokenManager {
     this.cancelRefresh?.();
   }
 }
-var SDK_VERSION = "1.4.2";
+var SDK_VERSION = "1.5.2";
 var CLOUD_ROLE_NAME = "uipath-ts-sdk";
 var SDK_SERVICE_NAME = "UiPath.TypeScript.Sdk";
 var SDK_LOGGER_NAME = "uipath-ts-sdk-telemetry";
@@ -41164,16 +41194,16 @@ function toISOUtc(value) {
   return isNaN(date2.getTime()) ? value : date2.toISOString();
 }
 function transformData(data, fieldMapping) {
+  if (data == null) {
+    return data;
+  }
   if (Array.isArray(data)) {
     return data.map((item) => transformData(item, fieldMapping));
   }
-  const result = { ...data };
-  for (const [sourceField, targetField] of Object.entries(fieldMapping)) {
-    if (sourceField in result) {
-      const value = result[sourceField];
-      delete result[sourceField];
-      result[targetField] = value;
-    }
+  const result = {};
+  for (const [key, value] of Object.entries(data)) {
+    const renamedKey = fieldMapping[key] ?? key;
+    result[renamedKey] = value;
   }
   return result;
 }
@@ -41258,6 +41288,26 @@ function transformRequest(data, responseMap) {
   }
   return result;
 }
+var ODATA_FIELD_PARAM_KEYS = ["filter", "orderby", "select", "expand"];
+var ODATA_TOKEN_RE = /'(?:[^']|'')*'|[A-Za-z_][A-Za-z0-9_]*/g;
+function rewriteODataIdentifiers(expression, requestMap) {
+  if (!expression)
+    return expression;
+  return expression.replace(ODATA_TOKEN_RE, (match) => match.startsWith("'") ? match : requestMap[match] ?? match);
+}
+function transformOptions(options, responseMap) {
+  const requestMap = reverseMap(responseMap);
+  if (Object.keys(requestMap).length === 0)
+    return options;
+  const result = { ...options };
+  for (const key of ODATA_FIELD_PARAM_KEYS) {
+    const value = result[key];
+    if (typeof value === "string") {
+      result[key] = rewriteODataIdentifiers(value, requestMap);
+    }
+  }
+  return result;
+}
 function arrayDictionaryToRecord(dictionary) {
   if (!dictionary || !dictionary.keys || !dictionary.values) {
     return {};
@@ -41743,6 +41793,7 @@ var EntityFieldDataType;
   EntityFieldDataType2["BOOLEAN"] = "BOOLEAN";
   EntityFieldDataType2["BIG_INTEGER"] = "BIG_INTEGER";
   EntityFieldDataType2["MULTILINE_TEXT"] = "MULTILINE_TEXT";
+  EntityFieldDataType2["MULTILINE_MAX"] = "MULTILINE_MAX";
   EntityFieldDataType2["FILE"] = "FILE";
   EntityFieldDataType2["CHOICE_SET_SINGLE"] = "CHOICE_SET_SINGLE";
   EntityFieldDataType2["CHOICE_SET_MULTIPLE"] = "CHOICE_SET_MULTIPLE";
@@ -41836,10 +41887,12 @@ var SqlFieldType;
   SqlFieldType2["BIT"] = "BIT";
   SqlFieldType2["DECIMAL"] = "DECIMAL";
   SqlFieldType2["MULTILINE"] = "MULTILINE";
+  SqlFieldType2["MULTILINE_MAX"] = "MULTILINE_MAX";
 })(SqlFieldType || (SqlFieldType = {}));
 var ENTITY_TYPE_IDS = {
   [EntityType.ChoiceSet]: 1
 };
+var MAX_QUERY_JOINS = 3;
 var EntityMap = {
   createTime: "createdTime",
   updateTime: "updatedTime",
@@ -41859,6 +41912,7 @@ var EntitySchemaFieldTypeMap = {
   [EntityFieldDataType.BOOLEAN]: { sqlTypeName: SqlFieldType.BIT, fieldDisplayType: FieldDisplayType.Basic },
   [EntityFieldDataType.BIG_INTEGER]: { sqlTypeName: SqlFieldType.BIGINT, fieldDisplayType: FieldDisplayType.Basic },
   [EntityFieldDataType.MULTILINE_TEXT]: { sqlTypeName: SqlFieldType.MULTILINE, fieldDisplayType: FieldDisplayType.Basic },
+  [EntityFieldDataType.MULTILINE_MAX]: { sqlTypeName: SqlFieldType.MULTILINE_MAX, fieldDisplayType: FieldDisplayType.Basic },
   [EntityFieldDataType.FILE]: { sqlTypeName: SqlFieldType.UNIQUEIDENTIFIER, fieldDisplayType: FieldDisplayType.File },
   [EntityFieldDataType.CHOICE_SET_SINGLE]: { sqlTypeName: SqlFieldType.INT, fieldDisplayType: FieldDisplayType.ChoiceSetSingle },
   [EntityFieldDataType.CHOICE_SET_MULTIPLE]: { sqlTypeName: SqlFieldType.NVARCHAR, fieldDisplayType: FieldDisplayType.ChoiceSetMultiple },
@@ -41875,6 +41929,7 @@ var FieldDisplayTypeToDataType = {
 var ENTITY_FIELD_CONSTRAINT_DEFAULTS = {
   STRING_LENGTH_LIMIT: 200,
   MULTILINE_TEXT_LENGTH_LIMIT: 200,
+  MULTILINE_MAX_LENGTH_LIMIT: 128 * 1024,
   DECIMAL_LENGTH_LIMIT: 1000,
   DECIMAL_PRECISION: 2,
   BOOLEAN_LENGTH_LIMIT: 100,
@@ -41891,6 +41946,9 @@ var ENTITY_FIELD_CONSTRAINT_SPEC = {
   [EntityFieldDataType.MULTILINE_TEXT]: {
     [EntityFieldConstraint.LengthLimit]: { min: 1, max: 1e4 }
   },
+  [EntityFieldDataType.MULTILINE_MAX]: {
+    [EntityFieldConstraint.LengthLimit]: { min: 1, max: 128 * 1024 }
+  },
   [EntityFieldDataType.INTEGER]: {
     [EntityFieldConstraint.MaxValue]: { min: -Number.MAX_SAFE_INTEGER, max: Number.MAX_SAFE_INTEGER },
     [EntityFieldConstraint.MinValue]: { min: -Number.MAX_SAFE_INTEGER, max: Number.MAX_SAFE_INTEGER }
@@ -41927,7 +41985,8 @@ var EntityFieldTypeMap = {
   [SqlFieldType.DATE]: EntityFieldDataType.DATE,
   [SqlFieldType.BIT]: EntityFieldDataType.BOOLEAN,
   [SqlFieldType.DECIMAL]: EntityFieldDataType.DECIMAL,
-  [SqlFieldType.MULTILINE]: EntityFieldDataType.MULTILINE_TEXT
+  [SqlFieldType.MULTILINE]: EntityFieldDataType.MULTILINE_TEXT,
+  [SqlFieldType.MULTILINE_MAX]: EntityFieldDataType.MULTILINE_MAX
 };
 
 class EntityService extends BaseService {
@@ -42030,6 +42089,11 @@ class EntityService extends BaseService {
     return entities;
   }
   async queryRecordsById(id, options) {
+    if (options?.joins && options.joins.length > MAX_QUERY_JOINS) {
+      throw new ValidationError({
+        message: `A maximum of ${MAX_QUERY_JOINS} joins is supported per query (received ${options.joins.length})`
+      });
+    }
     const { folderKey, expansionLevel, ...rest } = options ?? {};
     const downstreamOptions = options === undefined ? undefined : rest;
     return PaginationHelpers.getAll({
@@ -42048,7 +42112,7 @@ class EntityService extends BaseService {
           countParam: ENTITY_OFFSET_PARAMS.COUNT_PARAM
         }
       },
-      excludeFromPrefix: ["filterGroup", "selectedFields", "sortOptions", "aggregates", "groupBy"]
+      excludeFromPrefix: ["filterGroup", "selectedFields", "sortOptions", "aggregates", "groupBy", "joins"]
     }, downstreamOptions);
   }
   async importRecordsById(id, file, options) {
@@ -42278,7 +42342,7 @@ class EntityService extends BaseService {
     this.validateFieldConstraints(fieldType, field, field.fieldName);
     const isRelationship = fieldType === EntityFieldDataType.RELATIONSHIP;
     const isFile = fieldType === EntityFieldDataType.FILE;
-    if ((isRelationship || isFile) && (!field.referenceEntityId || !field.referenceFieldId)) {
+    if (isRelationship && (!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).`
       });
@@ -42304,9 +42368,9 @@ class EntityService extends BaseService {
       ...field.choiceSetId !== undefined && { choiceSetId: field.choiceSetId },
       ...(isRelationship || isFile) && { isForeignKey: true },
       ...isRelationship && { referenceType: ReferenceType.ManyToOne },
-      ...referenceEntityBody !== undefined && { referenceEntity: referenceEntityBody },
+      ...!isFile && referenceEntityBody !== undefined && { referenceEntity: referenceEntityBody },
       ...referenceChoiceSetBody !== undefined && { referenceChoiceSet: referenceChoiceSetBody },
-      ...field.referenceFieldId !== undefined && { referenceField: { id: field.referenceFieldId } }
+      ...!isFile && field.referenceFieldId !== undefined && { referenceField: { id: field.referenceFieldId } }
     };
   }
   resolveFieldDataType(f) {
@@ -42351,6 +42415,8 @@ class EntityService extends BaseService {
         return { lengthLimit: field.lengthLimit ?? defaults.STRING_LENGTH_LIMIT };
       case EntityFieldDataType.MULTILINE_TEXT:
         return { lengthLimit: field.lengthLimit ?? defaults.MULTILINE_TEXT_LENGTH_LIMIT };
+      case EntityFieldDataType.MULTILINE_MAX:
+        return { lengthLimit: field.lengthLimit ?? defaults.MULTILINE_MAX_LENGTH_LIMIT };
       case EntityFieldDataType.DECIMAL:
         return {
           lengthLimit: defaults.DECIMAL_LENGTH_LIMIT,
@@ -42557,143 +42623,300 @@ __decorate([
 __decorate([
   track("Choicesets.DeleteValuesById")
 ], ChoiceSetService.prototype, "deleteValuesById", null);
-function createProcessMethods(processData, service) {
+var DataFabricRoleType;
+(function(DataFabricRoleType2) {
+  DataFabricRoleType2["System"] = "System";
+  DataFabricRoleType2["UserDefined"] = "UserDefined";
+})(DataFabricRoleType || (DataFabricRoleType = {}));
+function isRecord$1(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isDataFabricRole(value) {
+  if (!isRecord$1(value)) {
+    return false;
+  }
+  const { id, name, type, directoryEntityCount, folderId } = value;
+  const hasValidDirectoryEntityCount = directoryEntityCount === undefined || directoryEntityCount === null || typeof directoryEntityCount === "number";
+  const hasValidFolderId = folderId === undefined || typeof folderId === "string";
+  return typeof id === "string" && typeof name === "string" && (type === DataFabricRoleType.System || type === DataFabricRoleType.UserDefined) && hasValidDirectoryEntityCount && hasValidFolderId;
+}
+function validateRolesResponse(data) {
+  if (Array.isArray(data) && data.every(isDataFabricRole)) {
+    return data;
+  }
+  throw new ServerError({
+    message: "Invalid Data Fabric roles response format."
+  });
+}
+
+class DataFabricRoleService extends BaseService {
+  async getAll(options = {}) {
+    const params = createParams({
+      stats: options.stats ?? true
+    });
+    const headers = createHeaders({ [FOLDER_KEY]: options.folderKey });
+    const response = await this.get(DATA_FABRIC_ENDPOINTS.ROLES.GET_ALL, { params, headers });
+    return validateRolesResponse(response.data);
+  }
+}
+__decorate([
+  track("DataFabricRoles.GetAll")
+], DataFabricRoleService.prototype, "getAll", null);
+var DataFabricDirectoryEntityType;
+(function(DataFabricDirectoryEntityType2) {
+  DataFabricDirectoryEntityType2[DataFabricDirectoryEntityType2["User"] = 0] = "User";
+  DataFabricDirectoryEntityType2[DataFabricDirectoryEntityType2["Group"] = 1] = "Group";
+  DataFabricDirectoryEntityType2[DataFabricDirectoryEntityType2["Application"] = 2] = "Application";
+})(DataFabricDirectoryEntityType || (DataFabricDirectoryEntityType = {}));
+var DataFabricDirectoryEntityTypeName;
+(function(DataFabricDirectoryEntityTypeName2) {
+  DataFabricDirectoryEntityTypeName2["User"] = "User";
+  DataFabricDirectoryEntityTypeName2["Group"] = "Group";
+  DataFabricDirectoryEntityTypeName2["Application"] = "Application";
+})(DataFabricDirectoryEntityTypeName || (DataFabricDirectoryEntityTypeName = {}));
+var DEFAULT_DIRECTORY_PAGE_SIZE = 100;
+var MAX_DIRECTORY_PAGE_SIZE = 100;
+function validateDirectoryListResponse(data) {
+  if (data === null || typeof data !== "object" || Array.isArray(data)) {
+    throw new ServerError({
+      message: "Invalid Data Fabric directory response format."
+    });
+  }
+  const response = data;
+  if (typeof response.totalCount !== "number" || !Array.isArray(response.results)) {
+    throw new ServerError({
+      message: "Invalid Data Fabric directory response format."
+    });
+  }
   return {
-    async getIncidents() {
-      if (!processData.processKey)
-        throw new Error("Process key is undefined");
-      if (!processData.folderKey)
-        throw new Error("Folder key is undefined");
-      return service.getIncidents(processData.processKey, processData.folderKey);
-    },
-    getElementStats(startTime, endTime, packageVersion) {
-      if (!processData.processKey)
-        throw new Error("Process key is undefined");
-      if (!processData.packageId)
-        throw new Error("Package ID is undefined");
-      return service.getElementStats(processData.processKey, processData.packageId, startTime, endTime, packageVersion);
-    }
+    totalCount: response.totalCount,
+    results: response.results
   };
 }
-function createProcessWithMethods(processData, service) {
-  const methods = createProcessMethods(processData, service);
-  return Object.assign({}, processData, methods);
+function isRecord2(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
 }
-function buildInsightsTopBody(startTime, endTime, isCaseManagement, options) {
-  return {
-    commonParams: {
-      startTime: startTime.getTime(),
-      endTime: endTime.getTime(),
-      isCaseManagement,
-      ...options?.packageId ? { packageId: options.packageId } : {},
-      ...options?.processKey ? { processKey: options.processKey } : {},
-      ...options?.version ? { version: options.version } : {}
-    }
+function isDirectoryEntityTypeName(value) {
+  return value === DataFabricDirectoryEntityTypeName.User || value === DataFabricDirectoryEntityTypeName.Group || value === DataFabricDirectoryEntityTypeName.Application;
+}
+function isDirectoryRole(value) {
+  if (!isRecord2(value)) {
+    return false;
+  }
+  return typeof value.id === "string" && typeof value.name === "string";
+}
+function normalizeDirectoryEntry(entry) {
+  if (!isRecord2(entry) || typeof entry.externalId !== "string" || typeof entry.name !== "string" || !isDirectoryEntityTypeName(entry.type) || entry.email !== undefined && entry.email !== null && typeof entry.email !== "string" || entry.objectType !== undefined && entry.objectType !== null && typeof entry.objectType !== "string" || entry.isUIEnabled !== undefined && typeof entry.isUIEnabled !== "boolean" || entry.roles !== undefined && entry.roles !== null && (!Array.isArray(entry.roles) || !entry.roles.every(isDirectoryRole))) {
+    throw new ServerError({
+      message: "Invalid Data Fabric directory entry response format."
+    });
+  }
+  const normalized = {
+    externalId: entry.externalId,
+    name: entry.name,
+    type: entry.type,
+    roles: entry.roles ?? [],
+    isUIEnabled: entry.isUIEnabled ?? true
   };
+  if (entry.email !== undefined) {
+    normalized.email = entry.email;
+  }
+  if (entry.objectType !== undefined) {
+    normalized.objectType = entry.objectType;
+  }
+  return normalized;
 }
-async function fetchInstanceStatusTimeline(postFn, startTime, endTime, isCaseManagement, options) {
-  const response = await postFn(MAESTRO_ENDPOINTS.INSIGHTS.INSTANCE_STATUS_BY_DATE, {
-    commonParams: {
-      startTime: startTime.getTime(),
-      endTime: endTime.getTime(),
-      isCaseManagement
-    },
-    timeSliceUnit: options?.groupBy,
-    timezoneOffset: new Date().getTimezoneOffset() * -1
-  });
-  return response.data ?? [];
+function normalizePrincipalIds(principalIds) {
+  const ids = Array.isArray(principalIds) ? principalIds : [principalIds];
+  return [...new Set(ids.map((id) => id.trim()).filter(Boolean))];
 }
-function buildElementCountByStatusBody(processKey, packageId, startTime, endTime, packageVersion) {
-  return {
-    commonParams: {
-      processKey,
-      packageId,
-      startTime: startTime.getTime(),
-      endTime: endTime.getTime(),
-      version: packageVersion
+function normalizeRoleIds(roleIds) {
+  return [...new Set(roleIds.map((id) => id.trim()).filter(Boolean))];
+}
+function normalizePrincipalType(type) {
+  if (typeof type === "number") {
+    if (type === DataFabricDirectoryEntityType.User || type === DataFabricDirectoryEntityType.Group || type === DataFabricDirectoryEntityType.Application) {
+      return type;
     }
-  };
+    throw new ValidationError({
+      message: "Invalid Data Fabric principal type."
+    });
+  }
+  switch (type) {
+    case DataFabricDirectoryEntityTypeName.User:
+      return DataFabricDirectoryEntityType.User;
+    case DataFabricDirectoryEntityTypeName.Group:
+      return DataFabricDirectoryEntityType.Group;
+    case DataFabricDirectoryEntityTypeName.Application:
+      return DataFabricDirectoryEntityType.Application;
+    default:
+      throw new ValidationError({
+        message: "Invalid Data Fabric principal type."
+      });
+  }
+}
+function roleIdsFromEntry(entry) {
+  if (!entry) {
+    return [];
+  }
+  return normalizeRoleIds(entry.roles.map((role) => role.id));
+}
+function clampDirectoryPageSize(pageSize) {
+  return Math.max(1, Math.min(pageSize ?? DEFAULT_DIRECTORY_PAGE_SIZE, MAX_DIRECTORY_PAGE_SIZE));
 }
-var ProcessIncidentMap = {
-  errorTimeUtc: "errorTime"
-};
-var ProcessIncidentSummaryMap = {
-  firstTimeUtc: "firstOccuranceTime"
-};
 
-class BpmnHelpers {
-  static parseBpmnElementsForIncidents(bpmnXml) {
-    const elementInfo = {};
-    try {
-      const bpmnOpenTagRegex = /<bpmn:([A-Za-z][\w.-]*)\b[^>]*>/g;
-      for (const tagMatch of bpmnXml.matchAll(bpmnOpenTagRegex)) {
-        const [fullTag, elementType] = tagMatch;
-        const idMatch = /\bid\s*=\s*"([^"]*)"/.exec(fullTag);
-        if (!idMatch) {
-          continue;
-        }
-        const elementId = idMatch[1];
-        const nameMatch = /\bname\s*=\s*"([^"]*)"/.exec(fullTag);
-        const name = nameMatch ? nameMatch[1] : "";
-        const activityType = this.formatActivityTypeForIncidents(elementType);
-        const activityName = name || elementId;
-        elementInfo[elementId] = {
-          type: activityType,
-          name: activityName
-        };
+class DataFabricDirectoryService extends BaseService {
+  async fetchAllEntries(options = {}) {
+    const top = clampDirectoryPageSize(options.pageSize);
+    const entries = [];
+    let skip = 0;
+    while (true) {
+      const page = await this.list(skip === 0 ? { top } : { top, skip });
+      entries.push(...page.results);
+      if (page.results.length < top || page.totalCount !== undefined && entries.length >= page.totalCount) {
+        return entries;
       }
-    } catch (error) {
-      console.warn("Failed to parse BPMN XML for incidents:", error);
+      skip += top;
     }
-    return elementInfo;
   }
-  static formatActivityTypeForIncidents(elementType) {
-    return elementType.replace(/([A-Z])/g, " $1").replace(/^./, (str) => str.toUpperCase()).trim();
-  }
-  static async enrichIncidentsWithBpmnData(incidents, folderKey, service) {
-    const uniqueInstanceIds = [...new Set(incidents.map((i) => i.instanceId))];
-    if (uniqueInstanceIds.length === 1) {
-      const elementInfo = await this.getBpmnElementInfo(uniqueInstanceIds[0], folderKey, service);
-      return incidents.map((incident) => this.transformIncidentWithBpmn(incident, elementInfo));
-    } else {
-      return this.enrichMultipleInstanceIncidents(incidents, folderKey, service);
-    }
+  async list(options = {}) {
+    const params = createParams({
+      skip: options.skip,
+      top: clampDirectoryPageSize(options.top)
+    });
+    const response = await this.get(DATA_FABRIC_ENDPOINTS.DIRECTORY.GET_ALL, { params });
+    const data = validateDirectoryListResponse(response.data);
+    const results = data.results.map(normalizeDirectoryEntry);
+    return {
+      totalCount: data.totalCount,
+      results
+    };
   }
-  static async enrichMultipleInstanceIncidents(incidents, folderKey, service) {
-    const groups = incidents.reduce((acc, incident) => {
-      const id = incident.instanceId || NO_INSTANCE;
-      (acc[id] = acc[id] || []).push(incident);
-      return acc;
-    }, {});
-    const results = await Promise.all(Object.entries(groups).map(async (entry) => {
-      const [instanceId, groupIncidents] = entry;
-      const elementInfo = await this.getBpmnElementInfo(instanceId, folderKey, service);
-      return groupIncidents.map((incident) => this.transformIncidentWithBpmn(incident, elementInfo));
-    }));
-    return results.flat();
+  async getAll(options = {}) {
+    return this.fetchAllEntries(options);
   }
-  static async getBpmnElementInfo(instanceId, folderKey, service) {
-    if (!instanceId || instanceId === NO_INSTANCE) {
-      return {};
+  async assignRoles(principalIds, principalType, roleIds, options = {}) {
+    const normalizedPrincipalIds = normalizePrincipalIds(principalIds);
+    const normalizedRoleIds = normalizeRoleIds(roleIds);
+    if (normalizedPrincipalIds.length === 0) {
+      throw new ValidationError({ message: "At least one principal ID is required." });
     }
-    try {
-      const bpmnXml = await service.getBpmn(instanceId, folderKey);
-      return this.parseBpmnElementsForIncidents(bpmnXml);
-    } catch (error) {
-      console.warn(`Failed to get BPMN for instance ${instanceId}:`, error);
-      return {};
+    if (normalizedRoleIds.length === 0) {
+      throw new ValidationError({ message: "At least one Data Fabric role ID is required." });
     }
+    const type = normalizePrincipalType(principalType);
+    const preserveExisting = options.preserveExisting ?? true;
+    const existingById = new Map;
+    if (preserveExisting) {
+      for (const entry of await this.fetchAllEntries()) {
+        existingById.set(entry.externalId.toLowerCase(), entry);
+      }
+    }
+    return Promise.all(normalizedPrincipalIds.map(async (principalId) => {
+      const existing = existingById.get(principalId.toLowerCase());
+      const mergedRoleIds = preserveExisting ? normalizeRoleIds([...roleIdsFromEntry(existing), ...normalizedRoleIds]) : normalizedRoleIds;
+      const payload = {
+        directoryEntities: [
+          {
+            externalId: principalId,
+            type,
+            resolved: true
+          }
+        ],
+        roles: mergedRoleIds,
+        isUIEnabled: options.uiEnabled ?? true
+      };
+      await this.post(DATA_FABRIC_ENDPOINTS.DIRECTORY.ASSIGN_ROLES, payload);
+      return {
+        principalId,
+        roleIds: mergedRoleIds
+      };
+    }));
   }
-  static transformIncidentWithBpmn(incident, elementInfo) {
-    const element = elementInfo[incident.elementId];
-    const transformed = transformData(incident, ProcessIncidentMap);
-    return {
-      ...transformed,
-      incidentElementActivityType: element?.type || UNKNOWN2,
-      incidentElementActivityName: element?.name || UNKNOWN2
+  async revokeRoles(principalIds) {
+    const normalizedPrincipalIds = normalizePrincipalIds(principalIds);
+    if (normalizedPrincipalIds.length === 0) {
+      throw new ValidationError({ message: "At least one principal ID is required." });
+    }
+    const payload = {
+      externalIds: normalizedPrincipalIds
     };
+    await this.post(DATA_FABRIC_ENDPOINTS.DIRECTORY.REVOKE_ROLES, payload);
   }
 }
+__decorate([
+  track("DataFabricDirectory.List")
+], DataFabricDirectoryService.prototype, "list", null);
+__decorate([
+  track("DataFabricDirectory.GetAll")
+], DataFabricDirectoryService.prototype, "getAll", null);
+__decorate([
+  track("DataFabricDirectory.AssignRoles")
+], DataFabricDirectoryService.prototype, "assignRoles", null);
+__decorate([
+  track("DataFabricDirectory.RevokeRoles")
+], DataFabricDirectoryService.prototype, "revokeRoles", null);
+var InstanceStatsMap = {
+  countOfAllInstances: "totalCount",
+  countOfRunning: "runningCount",
+  countOfTransitioning: "transitioningCount",
+  countOfPaused: "pausedCount",
+  countOfFaulted: "faultedCount",
+  countOfCompleted: "completedCount",
+  countOfCancelled: "cancelledCount",
+  countOfDeleted: "deletedCount"
+};
+function createProcessMethods(processData, service) {
+  return {
+    async getIncidents() {
+      if (!processData.processKey)
+        throw new Error("Process key is undefined");
+      if (!processData.folderKey)
+        throw new Error("Folder key is undefined");
+      return service.getIncidents(processData.processKey, processData.folderKey);
+    },
+    getElementStats(startTime, endTime, packageVersion) {
+      if (!processData.processKey)
+        throw new Error("Process key is undefined");
+      if (!processData.packageId)
+        throw new Error("Package ID is undefined");
+      return service.getElementStats({
+        processKey: processData.processKey,
+        packageId: processData.packageId,
+        packageVersion,
+        startTime,
+        endTime
+      });
+    },
+    getInstanceStats(startTime, endTime, packageVersion) {
+      if (!processData.processKey)
+        throw new Error("Process key is undefined");
+      if (!processData.packageId)
+        throw new Error("Package ID is undefined");
+      return service.getInstanceStats({
+        processKey: processData.processKey,
+        packageId: processData.packageId,
+        packageVersion,
+        startTime,
+        endTime
+      });
+    },
+    getInstanceStatusTimeline(startTime, endTime, options) {
+      if (!processData.processKey)
+        throw new Error("Process key is undefined");
+      return service.getInstanceStatusTimeline(startTime, endTime, { ...options, processKeys: [processData.processKey] });
+    },
+    getIncidentsTimeline(startTime, endTime, options) {
+      if (!processData.processKey)
+        throw new Error("Process key is undefined");
+      return service.getIncidentsTimeline(startTime, endTime, { ...options, processKeys: [processData.processKey] });
+    }
+  };
+}
+function createProcessWithMethods(processData, service) {
+  const methods = createProcessMethods(processData, service);
+  return Object.assign({}, processData, methods);
+}
 function createProcessInstanceMethods(instanceData, service) {
   return {
     async cancel(options) {
@@ -42717,6 +42940,13 @@ function createProcessInstanceMethods(instanceData, service) {
         throw new Error("Process instance folder key is undefined");
       return service.resume(instanceData.instanceId, instanceData.folderKey, options);
     },
+    async retry(options) {
+      if (!instanceData.instanceId)
+        throw new Error("Process instance ID is undefined");
+      if (!instanceData.folderKey)
+        throw new Error("Process instance folder key is undefined");
+      return service.retry(instanceData.instanceId, instanceData.folderKey, options);
+    },
     async getIncidents() {
       if (!instanceData.instanceId)
         throw new Error("Process instance ID is undefined");
@@ -42781,7 +43011,36 @@ function createCaseMethods(caseData, service) {
         throw new Error("Process key is undefined");
       if (!caseData.packageId)
         throw new Error("Package ID is undefined");
-      return service.getElementStats(caseData.processKey, caseData.packageId, startTime, endTime, packageVersion);
+      return service.getElementStats({
+        processKey: caseData.processKey,
+        packageId: caseData.packageId,
+        packageVersion,
+        startTime,
+        endTime
+      });
+    },
+    getInstanceStats(startTime, endTime, packageVersion) {
+      if (!caseData.processKey)
+        throw new Error("Process key is undefined");
+      if (!caseData.packageId)
+        throw new Error("Package ID is undefined");
+      return service.getInstanceStats({
+        processKey: caseData.processKey,
+        packageId: caseData.packageId,
+        packageVersion,
+        startTime,
+        endTime
+      });
+    },
+    getInstanceStatusTimeline(startTime, endTime, options) {
+      if (!caseData.processKey)
+        throw new Error("Process key is undefined");
+      return service.getInstanceStatusTimeline(startTime, endTime, { ...options, processKeys: [caseData.processKey] });
+    },
+    getIncidentsTimeline(startTime, endTime, options) {
+      if (!caseData.processKey)
+        throw new Error("Process key is undefined");
+      return service.getIncidentsTimeline(startTime, endTime, { ...options, processKeys: [caseData.processKey] });
     }
   };
 }
@@ -42920,6 +43179,123 @@ var InstanceFinalStatus;
   InstanceFinalStatus2["Faulted"] = "Faulted";
   InstanceFinalStatus2["Cancelled"] = "Cancelled";
 })(InstanceFinalStatus || (InstanceFinalStatus = {}));
+function buildInsightsTopBody(startTime, endTime, isCaseManagement, options) {
+  return {
+    commonParams: {
+      startTime: startTime.getTime(),
+      endTime: endTime.getTime(),
+      isCaseManagement,
+      ...options?.packageId ? { packageId: options.packageId } : {},
+      ...options?.processKey ? { processKey: options.processKey } : {},
+      ...options?.version ? { version: options.version } : {}
+    }
+  };
+}
+function buildInsightsTimelineBody(startTime, endTime, isCaseManagement, options) {
+  return {
+    commonParams: {
+      startTime: startTime.getTime(),
+      endTime: endTime.getTime(),
+      isCaseManagement,
+      ...options?.packageId ? { packageId: options.packageId } : {},
+      ...options?.version ? { version: options.version } : {},
+      ...options?.processKeys ? { processKeys: options.processKeys } : {}
+    },
+    timeSliceUnit: options?.groupBy ?? TimeInterval.Day,
+    timezoneOffset: new Date().getTimezoneOffset() * -1
+  };
+}
+function buildInsightsCommonBody(request) {
+  return {
+    commonParams: {
+      processKey: request.processKey,
+      packageId: request.packageId,
+      startTime: request.startTime.getTime(),
+      endTime: request.endTime.getTime(),
+      version: request.packageVersion
+    }
+  };
+}
+var ProcessIncidentMap = {
+  errorTimeUtc: "errorTime"
+};
+var ProcessIncidentSummaryMap = {
+  firstTimeUtc: "firstOccuranceTime"
+};
+
+class BpmnHelpers {
+  static parseBpmnElementsForIncidents(bpmnXml) {
+    const elementInfo = {};
+    try {
+      const bpmnOpenTagRegex = /<bpmn:([A-Za-z][\w.-]*)\b[^>]*>/g;
+      for (const tagMatch of bpmnXml.matchAll(bpmnOpenTagRegex)) {
+        const [fullTag, elementType] = tagMatch;
+        const idMatch = /\bid\s*=\s*"([^"]*)"/.exec(fullTag);
+        if (!idMatch) {
+          continue;
+        }
+        const elementId = idMatch[1];
+        const nameMatch = /\bname\s*=\s*"([^"]*)"/.exec(fullTag);
+        const name = nameMatch ? nameMatch[1] : "";
+        const activityType = this.formatActivityTypeForIncidents(elementType);
+        const activityName = name || elementId;
+        elementInfo[elementId] = {
+          type: activityType,
+          name: activityName
+        };
+      }
+    } catch (error) {
+      console.warn("Failed to parse BPMN XML for incidents:", error);
+    }
+    return elementInfo;
+  }
+  static formatActivityTypeForIncidents(elementType) {
+    return elementType.replace(/([A-Z])/g, " $1").replace(/^./, (str) => str.toUpperCase()).trim();
+  }
+  static async enrichIncidentsWithBpmnData(incidents, folderKey, service) {
+    const uniqueInstanceIds = [...new Set(incidents.map((i) => i.instanceId))];
+    if (uniqueInstanceIds.length === 1) {
+      const elementInfo = await this.getBpmnElementInfo(uniqueInstanceIds[0], folderKey, service);
+      return incidents.map((incident) => this.transformIncidentWithBpmn(incident, elementInfo));
+    } else {
+      return this.enrichMultipleInstanceIncidents(incidents, folderKey, service);
+    }
+  }
+  static async enrichMultipleInstanceIncidents(incidents, folderKey, service) {
+    const groups = incidents.reduce((acc, incident) => {
+      const id = incident.instanceId || NO_INSTANCE;
+      (acc[id] = acc[id] || []).push(incident);
+      return acc;
+    }, {});
+    const results = await Promise.all(Object.entries(groups).map(async (entry) => {
+      const [instanceId, groupIncidents] = entry;
+      const elementInfo = await this.getBpmnElementInfo(instanceId, folderKey, service);
+      return groupIncidents.map((incident) => this.transformIncidentWithBpmn(incident, elementInfo));
+    }));
+    return results.flat();
+  }
+  static async getBpmnElementInfo(instanceId, folderKey, service) {
+    if (!instanceId || instanceId === NO_INSTANCE) {
+      return {};
+    }
+    try {
+      const bpmnXml = await service.getBpmn(instanceId, folderKey);
+      return this.parseBpmnElementsForIncidents(bpmnXml);
+    } catch (error) {
+      console.warn(`Failed to get BPMN for instance ${instanceId}:`, error);
+      return {};
+    }
+  }
+  static transformIncidentWithBpmn(incident, elementInfo) {
+    const element = elementInfo[incident.elementId];
+    const transformed = transformData(incident, ProcessIncidentMap);
+    return {
+      ...transformed,
+      incidentElementActivityType: element?.type || UNKNOWN2,
+      incidentElementActivityName: element?.name || UNKNOWN2
+    };
+  }
+}
 var ProcessInstanceMap = {
   startedTimeUtc: "startedTime",
   completedTimeUtc: "completedTime",
@@ -43031,6 +43407,15 @@ class ProcessInstancesService extends BaseService {
       data: response.data
     };
   }
+  async retry(instanceId, folderKey, options) {
+    const response = await this.post(MAESTRO_ENDPOINTS.INSTANCES.RETRY(instanceId), options || {}, {
+      headers: createHeaders({ [FOLDER_KEY]: folderKey })
+    });
+    return {
+      success: true,
+      data: response.data
+    };
+  }
   parseBpmnVariables(bpmnXml) {
     const variableMap = new Map;
     const variableSourceMap = this.getVariableSource(bpmnXml);
@@ -43139,6 +43524,9 @@ __decorate([
 __decorate([
   track("ProcessInstances.Resume")
 ], ProcessInstancesService.prototype, "resume", null);
+__decorate([
+  track("ProcessInstances.Retry")
+], ProcessInstancesService.prototype, "retry", null);
 __decorate([
   track("ProcessInstances.GetVariables")
 ], ProcessInstancesService.prototype, "getVariables", null);
@@ -43180,7 +43568,12 @@ class MaestroProcessesService extends BaseService {
     }));
   }
   async getInstanceStatusTimeline(startTime, endTime, options) {
-    return fetchInstanceStatusTimeline(this.post.bind(this), startTime, endTime, false, options);
+    const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.INSTANCE_STATUS_BY_DATE, buildInsightsTimelineBody(startTime, endTime, false, options));
+    return data ?? [];
+  }
+  async getIncidentsTimeline(startTime, endTime, options) {
+    const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.INCIDENTS_BY_TIME_WINDOW, buildInsightsTimelineBody(startTime, endTime, false, options));
+    return data?.dataPoints ?? [];
   }
   async getTopFaultedCount(startTime, endTime, options) {
     const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.TOP_PROCESSES_WITH_FAILURE, buildInsightsTopBody(startTime, endTime, false, options));
@@ -43195,10 +43588,14 @@ class MaestroProcessesService extends BaseService {
     const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.TOP_PROCESSES_BY_DURATION, buildInsightsTopBody(startTime, endTime, false, options));
     return (data ?? []).map((process10) => ({ ...process10, name: process10.packageId }));
   }
-  async getElementStats(processKey, packageId, startTime, endTime, packageVersion) {
-    const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.ELEMENT_COUNT_BY_STATUS, buildElementCountByStatusBody(processKey, packageId, startTime, endTime, packageVersion));
+  async getElementStats(request) {
+    const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.ELEMENT_COUNT_BY_STATUS, buildInsightsCommonBody(request));
     return data ?? [];
   }
+  async getInstanceStats(request) {
+    const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.INSTANCE_COUNT_BY_STATUS, buildInsightsCommonBody(request));
+    return transformData(data, InstanceStatsMap);
+  }
 }
 __decorate([
   track("MaestroProcesses.GetAll")
@@ -43215,6 +43612,9 @@ __decorate([
 __decorate([
   track("MaestroProcesses.GetInstanceStatusTimeline")
 ], MaestroProcessesService.prototype, "getInstanceStatusTimeline", null);
+__decorate([
+  track("MaestroProcesses.GetIncidentsTimeline")
+], MaestroProcessesService.prototype, "getIncidentsTimeline", null);
 __decorate([
   track("MaestroProcesses.GetTopFaultedCount")
 ], MaestroProcessesService.prototype, "getTopFaultedCount", null);
@@ -43224,6 +43624,9 @@ __decorate([
 __decorate([
   track("MaestroProcesses.GetElementStats")
 ], MaestroProcessesService.prototype, "getElementStats", null);
+__decorate([
+  track("MaestroProcesses.GetInstanceStats")
+], MaestroProcessesService.prototype, "getInstanceStats", null);
 
 class ProcessIncidentsService extends BaseService {
   async getAll() {
@@ -43266,7 +43669,12 @@ class CasesService extends BaseService {
     }));
   }
   async getInstanceStatusTimeline(startTime, endTime, options) {
-    return fetchInstanceStatusTimeline(this.post.bind(this), startTime, endTime, true, options);
+    const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.INSTANCE_STATUS_BY_DATE, buildInsightsTimelineBody(startTime, endTime, true, options));
+    return data ?? [];
+  }
+  async getIncidentsTimeline(startTime, endTime, options) {
+    const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.INCIDENTS_BY_TIME_WINDOW, buildInsightsTimelineBody(startTime, endTime, true, options));
+    return data?.dataPoints ?? [];
   }
   async getTopFaultedCount(startTime, endTime, options) {
     const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.TOP_PROCESSES_WITH_FAILURE, buildInsightsTopBody(startTime, endTime, true, options));
@@ -43281,10 +43689,14 @@ class CasesService extends BaseService {
     const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.TOP_PROCESSES_BY_DURATION, buildInsightsTopBody(startTime, endTime, true, options));
     return (data ?? []).map((process10) => ({ ...process10, name: this.extractCaseName(process10.packageId) }));
   }
-  async getElementStats(processKey, packageId, startTime, endTime, packageVersion) {
-    const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.ELEMENT_COUNT_BY_STATUS, buildElementCountByStatusBody(processKey, packageId, startTime, endTime, packageVersion));
+  async getElementStats(request) {
+    const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.ELEMENT_COUNT_BY_STATUS, buildInsightsCommonBody(request));
     return data ?? [];
   }
+  async getInstanceStats(request) {
+    const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.INSTANCE_COUNT_BY_STATUS, buildInsightsCommonBody(request));
+    return transformData(data, InstanceStatsMap);
+  }
   extractCaseName(packageId) {
     const caseManagementIndex = packageId.indexOf("CaseManagement.");
     if (caseManagementIndex !== -1) {
@@ -43306,6 +43718,9 @@ __decorate([
 __decorate([
   track("Cases.GetInstanceStatusTimeline")
 ], CasesService.prototype, "getInstanceStatusTimeline", null);
+__decorate([
+  track("Cases.GetIncidentsTimeline")
+], CasesService.prototype, "getIncidentsTimeline", null);
 __decorate([
   track("Cases.GetTopFaultedCount")
 ], CasesService.prototype, "getTopFaultedCount", null);
@@ -43315,6 +43730,9 @@ __decorate([
 __decorate([
   track("Cases.GetElementStats")
 ], CasesService.prototype, "getElementStats", null);
+__decorate([
+  track("Cases.GetInstanceStats")
+], CasesService.prototype, "getInstanceStats", null);
 var CaseInstanceMap = {
   startedTimeUtc: "startedTime",
   completedTimeUtc: "completedTime",
@@ -43447,6 +43865,7 @@ class TaskService extends BaseService {
       const transformedTask = transformData(pascalToCamelCaseKeys(task), TaskMap);
       return createTaskWithMethods(applyDataTransforms(transformedTask, { field: "status", valueMap: TaskStatusMap }), this);
     };
+    const apiOptions = options ? transformOptions(options, TaskMap) : options;
     return PaginationHelpers.getAll({
       serviceAccess: this.createPaginationServiceAccess(),
       getEndpoint: () => endpoint,
@@ -43463,7 +43882,7 @@ class TaskService extends BaseService {
           countParam: ODATA_OFFSET_PARAMS.COUNT_PARAM
         }
       }
-    }, options);
+    }, apiOptions);
   }
   async getById(id, options = {}, folderId) {
     const { taskType, ...restOptions } = options;
@@ -43475,8 +43894,8 @@ class TaskService extends BaseService {
     }
     const headers = createHeaders({ [FOLDER_ID]: folderId });
     const modifiedOptions = this.addDefaultExpand(restOptions);
-    const keysToPrefix = Object.keys(modifiedOptions);
-    const apiOptions = addPrefixToKeys(modifiedOptions, ODATA_PREFIX, keysToPrefix);
+    const apiFieldOptions = transformOptions(modifiedOptions, TaskMap);
+    const apiOptions = addPrefixToKeys(apiFieldOptions, ODATA_PREFIX, Object.keys(apiFieldOptions));
     const response = await this.get(TASK_ENDPOINTS.GET_BY_ID(id), {
       params: apiOptions,
       headers
@@ -43941,7 +44360,7 @@ class FolderScopedService extends BaseService {
     }
     return response.data?.value;
   }
-  async getByNameLookup(resourceType, endpoint, name, options, transform2) {
+  async getByNameLookup(resourceType, endpoint, name, options, transform2, responseFieldMap) {
     const validatedName = validateName(resourceType, name);
     const { folderId, folderKey, folderPath, ...queryOptions } = options;
     const headers = resolveFolderHeaders({
@@ -43951,8 +44370,9 @@ class FolderScopedService extends BaseService {
       resourceType: `${resourceType}.getByName`,
       fallbackFolderKey: this.config.folderKey
     });
+    const apiFieldOptions = responseFieldMap ? transformOptions(queryOptions, responseFieldMap) : queryOptions;
     const apiOptions = {
-      ...addPrefixToKeys(queryOptions, ODATA_PREFIX, Object.keys(queryOptions)),
+      ...addPrefixToKeys(apiFieldOptions, ODATA_PREFIX, Object.keys(apiFieldOptions)),
       $filter: `Name eq '${validatedName.replace(SINGLE_QUOTE_RE, "''")}'`,
       $top: "1"
     };
@@ -44002,6 +44422,7 @@ var AssetMap = {
 class AssetService extends FolderScopedService {
   async getAll(options) {
     const transformAssetResponse = (asset) => transformData(pascalToCamelCaseKeys(asset), AssetMap);
+    const apiOptions = options ? transformOptions(options, AssetMap) : options;
     return PaginationHelpers.getAll({
       serviceAccess: this.createPaginationServiceAccess(),
       getEndpoint: (folderId) => folderId ? ASSET_ENDPOINTS.GET_BY_FOLDER : ASSET_ENDPOINTS.GET_ALL,
@@ -44017,12 +44438,12 @@ class AssetService extends FolderScopedService {
           countParam: ODATA_OFFSET_PARAMS.COUNT_PARAM
         }
       }
-    }, options);
+    }, apiOptions);
   }
   async getById(id, folderId, options = {}) {
     const headers = createHeaders({ [FOLDER_ID]: folderId });
-    const keysToPrefix = Object.keys(options);
-    const apiOptions = addPrefixToKeys(options, ODATA_PREFIX, keysToPrefix);
+    const apiFieldOptions = transformOptions(options, AssetMap);
+    const apiOptions = addPrefixToKeys(apiFieldOptions, ODATA_PREFIX, Object.keys(apiFieldOptions));
     const response = await this.get(ASSET_ENDPOINTS.GET_BY_ID(id), {
       headers,
       params: apiOptions
@@ -44031,7 +44452,7 @@ class AssetService extends FolderScopedService {
     return transformedAsset;
   }
   async getByName(name, options = {}) {
-    return this.getByNameLookup("Asset", ASSET_ENDPOINTS.GET_BY_FOLDER, name, options, (raw) => transformData(pascalToCamelCaseKeys(raw), AssetMap));
+    return this.getByNameLookup("Asset", ASSET_ENDPOINTS.GET_BY_FOLDER, name, options, (raw) => transformData(pascalToCamelCaseKeys(raw), AssetMap), AssetMap);
   }
   async updateValueById(id, newValue, options) {
     if (!id) {
@@ -44170,6 +44591,7 @@ class BucketService extends FolderScopedService {
       fallbackFolderKey: this.config.folderKey
     });
     const transformBlobItem = (item) => transformData(item, BucketMap);
+    const apiRestOptions = transformOptions(restOptions, BucketMap);
     return PaginationHelpers.getAll({
       serviceAccess: this.createPaginationServiceAccess(),
       getEndpoint: () => BUCKET_ENDPOINTS.GET_FILE_META_DATA(bucketId),
@@ -44185,7 +44607,7 @@ class BucketService extends FolderScopedService {
       },
       excludeFromPrefix: ["prefix"],
       headers
-    }, restOptions);
+    }, apiRestOptions);
   }
   async uploadFile(bucketIdOrOptions, path3, content, options) {
     let bucketId;
@@ -44260,9 +44682,10 @@ class BucketService extends FolderScopedService {
       resourceType: "Buckets.getReadUri",
       fallbackFolderKey: this.config.folderKey
     });
+    const apiRestOptions = transformOptions(restOptions, BucketMap);
     const queryOptions = {
       expiryInMinutes,
-      ...addPrefixToKeys(restOptions, ODATA_PREFIX, Object.keys(restOptions))
+      ...addPrefixToKeys(apiRestOptions, ODATA_PREFIX, Object.keys(apiRestOptions))
     };
     return this._getUri(BUCKET_ENDPOINTS.GET_READ_URI(bucketId), bucketId, resolvedPath, headers, queryOptions);
   }
@@ -44316,6 +44739,7 @@ class BucketService extends FolderScopedService {
       fallbackFolderKey: this.config.folderKey
     });
     const transformBucketFile = (file) => transformData(pascalToCamelCaseKeys(file), BucketMap);
+    const apiRestOptions = transformOptions(restOptions, BucketMap);
     return PaginationHelpers.getAll({
       serviceAccess: this.createPaginationServiceAccess(),
       getEndpoint: () => BUCKET_ENDPOINTS.GET_FILES(bucketId),
@@ -44332,7 +44756,7 @@ class BucketService extends FolderScopedService {
       },
       excludeFromPrefix: ["directory", "recursive", "fileNameRegex"],
       headers
-    }, { ...restOptions, directory: "/", recursive: true });
+    }, { ...apiRestOptions, directory: "/", recursive: true });
   }
   async deleteFile(bucketId, path3, options) {
     if (!bucketId) {
@@ -44355,9 +44779,10 @@ class BucketService extends FolderScopedService {
   }
   async _getWriteUri(options) {
     const { bucketId, path: path3, expiryInMinutes, headers, ...restOptions } = options;
+    const apiRestOptions = transformOptions(restOptions, BucketMap);
     const queryOptions = {
       expiryInMinutes,
-      ...addPrefixToKeys(restOptions, ODATA_PREFIX, Object.keys(restOptions))
+      ...addPrefixToKeys(apiRestOptions, ODATA_PREFIX, Object.keys(apiRestOptions))
     };
     return this._getUri(BUCKET_ENDPOINTS.GET_WRITE_URI(bucketId), bucketId, path3, headers, queryOptions);
   }
@@ -44450,8 +44875,8 @@ class AttachmentService extends BaseService {
     if (!id) {
       throw new ValidationError({ message: "id is required for getById" });
     }
-    const keysToPrefix = Object.keys(options);
-    const apiOptions = addPrefixToKeys(options, ODATA_PREFIX, keysToPrefix);
+    const apiFieldOptions = transformOptions(options, { ...AttachmentsMap, ...BucketMap });
+    const apiOptions = addPrefixToKeys(apiFieldOptions, ODATA_PREFIX, Object.keys(apiFieldOptions));
     const response = await this.get(ORCHESTRATOR_ATTACHMENT_ENDPOINTS.GET_BY_ID(id), {
       params: apiOptions
     });
@@ -44616,6 +45041,7 @@ class JobService extends FolderScopedService {
       const rawJob = transformData(pascalToCamelCaseKeys(job), JobMap);
       return createJobWithMethods(rawJob, this);
     };
+    const apiOptions = options ? transformOptions(options, JobMap) : options;
     return PaginationHelpers.getAll({
       serviceAccess: this.createPaginationServiceAccess(),
       getEndpoint: () => JOB_ENDPOINTS.GET_ALL,
@@ -44631,7 +45057,7 @@ class JobService extends FolderScopedService {
           countParam: ODATA_OFFSET_PARAMS.COUNT_PARAM
         }
       }
-    }, options);
+    }, apiOptions);
   }
   async getById(id, folderId, options) {
     if (!id) {
@@ -44641,8 +45067,8 @@ class JobService extends FolderScopedService {
       throw new ValidationError({ message: "folderId is required for getById" });
     }
     const headers = createHeaders({ [FOLDER_ID]: folderId });
-    const keysToPrefix = Object.keys(options ?? {});
-    const apiOptions = options ? addPrefixToKeys(options, ODATA_PREFIX, keysToPrefix) : {};
+    const apiFieldOptions = options ? transformOptions(options, JobMap) : {};
+    const apiOptions = addPrefixToKeys(apiFieldOptions, ODATA_PREFIX, Object.keys(apiFieldOptions));
     const response = await this.get(JOB_ENDPOINTS.GET_BY_KEY(id), {
       params: apiOptions,
       headers
@@ -44810,6 +45236,8 @@ var JobState;
   JobState2["Stopped"] = "Stopped";
   JobState2["Suspended"] = "Suspended";
   JobState2["Resumed"] = "Resumed";
+  JobState2["Cancelled"] = "Cancelled";
+  JobState2["Unknown"] = "Unknown";
 })(JobState || (JobState = {}));
 var ProcessMap = {
   lastModificationTime: "lastModifiedTime",
@@ -44828,6 +45256,7 @@ var ProcessMap = {
 class ProcessService extends FolderScopedService {
   async getAll(options) {
     const transformProcessResponse = (process10) => transformData(pascalToCamelCaseKeys(process10), ProcessMap);
+    const apiOptions = options ? transformOptions(options, ProcessMap) : options;
     return PaginationHelpers.getAll({
       serviceAccess: this.createPaginationServiceAccess(),
       getEndpoint: () => PROCESS_ENDPOINTS.GET_ALL,
@@ -44843,7 +45272,7 @@ class ProcessService extends FolderScopedService {
           countParam: ODATA_OFFSET_PARAMS.COUNT_PARAM
         }
       }
-    }, options);
+    }, apiOptions);
   }
   async start(request, optionsOrFolderId, legacyOptions) {
     let folderId;
@@ -44871,8 +45300,8 @@ class ProcessService extends FolderScopedService {
     const requestBody = {
       startInfo: apiRequest
     };
-    const keysToPrefix = Object.keys(queryOptions);
-    const apiOptions = addPrefixToKeys(queryOptions, ODATA_PREFIX, keysToPrefix);
+    const apiFieldOptions = transformOptions(queryOptions, ProcessMap);
+    const apiOptions = addPrefixToKeys(apiFieldOptions, ODATA_PREFIX, Object.keys(apiFieldOptions));
     const response = await this.post(PROCESS_ENDPOINTS.START_PROCESS, requestBody, {
       params: apiOptions,
       headers
@@ -44882,8 +45311,8 @@ class ProcessService extends FolderScopedService {
   }
   async getById(id, folderId, options = {}) {
     const headers = createHeaders({ [FOLDER_ID]: folderId });
-    const keysToPrefix = Object.keys(options);
-    const apiOptions = addPrefixToKeys(options, ODATA_PREFIX, keysToPrefix);
+    const apiFieldOptions = transformOptions(options, ProcessMap);
+    const apiOptions = addPrefixToKeys(apiFieldOptions, ODATA_PREFIX, Object.keys(apiFieldOptions));
     const response = await this.get(PROCESS_ENDPOINTS.GET_BY_ID(id), {
       headers,
       params: apiOptions
@@ -44892,7 +45321,7 @@ class ProcessService extends FolderScopedService {
     return transformedProcess;
   }
   async getByName(name, options = {}) {
-    return this.getByNameLookup("Process", PROCESS_ENDPOINTS.GET_ALL, name, options, (raw) => transformData(pascalToCamelCaseKeys(raw), ProcessMap));
+    return this.getByNameLookup("Process", PROCESS_ENDPOINTS.GET_ALL, name, options, (raw) => transformData(pascalToCamelCaseKeys(raw), ProcessMap), ProcessMap);
   }
 }
 __decorate([
@@ -44916,6 +45345,7 @@ var QueueMap = {
 class QueueService extends FolderScopedService {
   async getAll(options) {
     const transformQueueResponse = (queue) => transformData(pascalToCamelCaseKeys(queue), QueueMap);
+    const apiOptions = options ? transformOptions(options, QueueMap) : options;
     return PaginationHelpers.getAll({
       serviceAccess: this.createPaginationServiceAccess(),
       getEndpoint: (folderId) => folderId ? QUEUE_ENDPOINTS.GET_BY_FOLDER : QUEUE_ENDPOINTS.GET_ALL,
@@ -44931,12 +45361,12 @@ class QueueService extends FolderScopedService {
           countParam: ODATA_OFFSET_PARAMS.COUNT_PARAM
         }
       }
-    }, options);
+    }, apiOptions);
   }
   async getById(id, folderId, options = {}) {
     const headers = createHeaders({ [FOLDER_ID]: folderId });
-    const keysToPrefix = Object.keys(options);
-    const apiOptions = addPrefixToKeys(options, ODATA_PREFIX, keysToPrefix);
+    const apiFieldOptions = transformOptions(options, QueueMap);
+    const apiOptions = addPrefixToKeys(apiFieldOptions, ODATA_PREFIX, Object.keys(apiFieldOptions));
     const response = await this.get(QUEUE_ENDPOINTS.GET_BY_ID(id), {
       headers,
       params: apiOptions
@@ -44977,7 +45407,9 @@ class UiPath2 extends UiPath$1 {
   }
   get entities() {
     return Object.assign(this.getService(EntityService), {
-      choicesets: this.getService(ChoiceSetService)
+      choicesets: this.getService(ChoiceSetService),
+      roles: this.getService(DataFabricRoleService),
+      directory: this.getService(DataFabricDirectoryService)
     });
   }
   get tasks() {
@@ -45082,6 +45514,17 @@ var AgentErrorSortColumn;
   AgentErrorSortColumn2["LastSeenFolderName"] = "LastSeenFolderName";
   AgentErrorSortColumn2["LastSeenFolderPath"] = "LastSeenFolderPath";
 })(AgentErrorSortColumn || (AgentErrorSortColumn = {}));
+var AgentType;
+(function(AgentType2) {
+  AgentType2["Autonomous"] = "Autonomous";
+  AgentType2["Conversational"] = "Conversational";
+  AgentType2["Coded"] = "Coded";
+})(AgentType || (AgentType = {}));
+var AgentExecutionType;
+(function(AgentExecutionType2) {
+  AgentExecutionType2["Debug"] = "Debug";
+  AgentExecutionType2["Runtime"] = "Runtime";
+})(AgentExecutionType || (AgentExecutionType = {}));
 var AgentMemoryExecutionType;
 (function(AgentMemoryExecutionType2) {
   AgentMemoryExecutionType2["Debug"] = "Debug";
@@ -45375,6 +45818,28 @@ var SpanAttachmentDirection;
   SpanAttachmentDirection2["In"] = "In";
   SpanAttachmentDirection2["Out"] = "Out";
 })(SpanAttachmentDirection || (SpanAttachmentDirection = {}));
+var AgentGovernanceMode;
+(function(AgentGovernanceMode2) {
+  AgentGovernanceMode2["Audit"] = "AUDIT";
+  AgentGovernanceMode2["Enforce"] = "ENFORCE";
+  AgentGovernanceMode2["Unknown"] = "Unknown";
+})(AgentGovernanceMode || (AgentGovernanceMode = {}));
+var AgentGovernanceVerdict;
+(function(AgentGovernanceVerdict2) {
+  AgentGovernanceVerdict2["Allow"] = "ALLOW";
+  AgentGovernanceVerdict2["Deny"] = "DENY";
+  AgentGovernanceVerdict2["Unknown"] = "Unknown";
+})(AgentGovernanceVerdict || (AgentGovernanceVerdict = {}));
+var AgentGovernanceSection;
+(function(AgentGovernanceSection2) {
+  AgentGovernanceSection2["Totals"] = "totals";
+  AgentGovernanceSection2["Hook"] = "hook";
+  AgentGovernanceSection2["Agent"] = "agent";
+  AgentGovernanceSection2["Policy"] = "policy";
+  AgentGovernanceSection2["Pack"] = "pack";
+  AgentGovernanceSection2["Action"] = "action";
+  AgentGovernanceSection2["Mode"] = "mode";
+})(AgentGovernanceSection || (AgentGovernanceSection = {}));
 
 // src/utils/sdk-client.ts
 var createDataFabricClient = async (tenantOverride) => {
@@ -45880,15 +46345,15 @@ var ENTITIES_DELETE_EXAMPLES = [
 ];
 var ENTITIES_CREATE_EXAMPLES = [
   {
-    Description: "Create an entity with choice-set, relationship, and file fields. " + "CHOICE_SET_SINGLE/CHOICE_SET_MULTIPLE require 'choiceSetId' (from 'df choice-sets list'). " + "RELATIONSHIP and FILE both require 'referenceEntityId' (UUID of the target entity, from 'df entities list') and 'referenceFieldId' (UUID of the field on the target entity, from 'df entities get <target-id>'). " + "Note: a RELATIONSHIP column on a record always stores the target record's UUID 'Id' (regardless of which 'referenceFieldId' configured the join) — see 'df records insert' for how to write the value.",
-    Command: `uip df entities create Expense --body '{"displayName":"Expense","fields":[{"fieldName":"category","type":"CHOICE_SET_SINGLE","choiceSetId":"c1d2e3f4-0000-0000-0000-000000000001","isRequired":true},{"fieldName":"tags","type":"CHOICE_SET_MULTIPLE","choiceSetId":"c1d2e3f4-0000-0000-0000-000000000002"},{"fieldName":"submitter","type":"RELATIONSHIP","referenceEntityId":"a1b2c3d4-0000-0000-0000-000000000010","referenceFieldId":"f1000000-0000-0000-0000-000000000100","isRequired":true},{"fieldName":"receipt","type":"FILE","referenceEntityId":"a1b2c3d4-0000-0000-0000-000000000099","referenceFieldId":"f1000000-0000-0000-0000-000000000199"}]}'`,
+    Description: "Create an entity with choice-set, relationship, and file fields. " + "CHOICE_SET_SINGLE/CHOICE_SET_MULTIPLE require 'choiceSetId' (from 'df choice-sets list'). " + "RELATIONSHIP requires 'referenceEntityId' (UUID of the target entity, from 'df entities list') and 'referenceFieldId' (UUID of the field on the target entity, from 'df entities get <target-id>'). " + "Note: a RELATIONSHIP column on a record always stores the target record's UUID 'Id' (regardless of which 'referenceFieldId' configured the join) — see 'df records insert' for how to write the value. " + "FILE fields take only 'fieldName' and 'type' — the server auto-wires the internal attachment reference; populate them later with 'uip df files upload <entity-id> <record-id> <field-name> --file <path>'.",
+    Command: `uip df entities create Expense --body '{"displayName":"Expense","fields":[{"fieldName":"category","type":"CHOICE_SET_SINGLE","choiceSetId":"c1d2e3f4-0000-0000-0000-000000000001","isRequired":true},{"fieldName":"tags","type":"CHOICE_SET_MULTIPLE","choiceSetId":"c1d2e3f4-0000-0000-0000-000000000002"},{"fieldName":"submitter","type":"RELATIONSHIP","referenceEntityId":"a1b2c3d4-0000-0000-0000-000000000010","referenceFieldId":"f1000000-0000-0000-0000-000000000100","isRequired":true},{"fieldName":"receipt","type":"FILE"}]}'`,
     Output: {
       Code: "EntityCreated",
       Data: { ID: "a1b2c3d4-0000-0000-0000-000000000004" }
     }
   },
   {
-    Description: "Create a folder-scoped entity with cross-folder references. " + "Pass '--folder-key' to place the new entity in a folder. " + "Per-field 'referenceFolderKey' points a RELATIONSHIP, FILE, or CHOICE_SET_* field at a target that lives in a different folder (or at the tenant level when omitted). " + "Get target entity/field IDs from 'df entities list --folder-key <key>' and 'df entities get <id> --folder-key <key>'; get choice-set IDs from 'df choice-sets list --folder-key <key>' (omit '--folder-key' for tenant-level choice sets).",
+    Description: "Create a folder-scoped entity with cross-folder references. " + "Pass '--folder-key' to place the new entity in a folder. " + "Per-field 'referenceFolderKey' points a RELATIONSHIP or CHOICE_SET_* field at a target that lives in a different folder (or at the tenant level when omitted). " + "Get target entity/field IDs from 'df entities list --folder-key <key>' and 'df entities get <id> --folder-key <key>'; get choice-set IDs from 'df choice-sets list --folder-key <key>' (omit '--folder-key' for tenant-level choice sets).",
     Command: `uip df entities create OrderLine --folder-key f1000000-0000-0000-0000-000000000050 --body '{"displayName":"Order Line","fields":[{"fieldName":"order","type":"RELATIONSHIP","referenceEntityId":"a1b2c3d4-0000-0000-0000-000000000010","referenceFieldId":"f1000000-0000-0000-0000-000000000100","referenceFolderKey":"f1000000-0000-0000-0000-000000000060","isRequired":true},{"fieldName":"userType","type":"CHOICE_SET_SINGLE","choiceSetId":"c1d2e3f4-0000-0000-0000-000000000077"}]}'`,
     Output: {
       Code: "EntityCreated",
@@ -46351,6 +46816,38 @@ var RECORDS_UPDATE_EXAMPLES = [
     }
   }
 ];
+var RECORDS_QUERY_EXAMPLES = [
+  {
+    Description: "Filter records — exact keys: filterGroup / queryFilters / fieldName / operator / value. " + "Operators: = != > < >= <= contains 'not contains' startswith endswith in 'not in'. " + "Not accepted: 'filters', 'field', '==', 'Equals', 'eq', 'like'.",
+    Command: "uip df records query a1b2c3d4-0000-0000-0000-000000000001 " + `--body '{"filterGroup":{"logicalOperator":0,"queryFilters":[{"fieldName":"status","operator":"=","value":"Paid"}]}}'`,
+    Output: {
+      Code: "RecordQuery",
+      Data: {
+        items: [
+          {
+            Id: "b2c3d4e5-0000-0000-0000-000000000001",
+            status: "Paid"
+          }
+        ],
+        totalCount: 1,
+        hasNextPage: false
+      }
+    }
+  },
+  {
+    Description: "Aggregate — COUNT grouped by a field.",
+    Command: "uip df records query a1b2c3d4-0000-0000-0000-000000000001 " + `--body '{"aggregates":[{"function":"COUNT","field":"Id","alias":"total"}],"groupBy":["status"]}'`,
+    Output: {
+      Code: "RecordQuery",
+      Data: {
+        items: [
+          { status: "Paid", total: 12 },
+          { status: "Pending", total: 3 }
+        ]
+      }
+    }
+  }
+];
 var RECORDS_DELETE_EXAMPLES = [
   {
     Description: "Delete records by ID",
@@ -46517,7 +47014,7 @@ var registerRecordsCommand = (program2) => {
       }
     }
   });
-  records.command("query").description("Query records in a Data Fabric entity with filters, sorting, and aggregates. " + "Provide a JSON object via --body or --file with optional keys: " + "filterGroup, sortOptions (use isDescending: true/false), selectedFields, " + "aggregates (function: COUNT/SUM/AVG/MIN/MAX, field, alias?), groupBy.").argument("<id>", "Entity ID").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("-f, --file <path>", "Path to JSON file with query options (filterGroup, selectedFields, sortOptions, aggregates, groupBy)").option("--body <json>", "Inline JSON query options (filterGroup, selectedFields, sortOptions, aggregates, groupBy; use `-` to read from stdin)").option("-l, --limit <number>", "Number of records to return per page", "50").option("-o, --offset <number>", "Start from the page containing this record index (rounded down to nearest page boundary;(mutually exclusive with --cursor)").option("--cursor <cursor>", "Pagination cursor from a previous response to fetch the next page").option("--folder-key <key>", "Folder key (GUID) of the folder containing the entity (for folder-scoped entities)").trackedAction(processContext, async (entityId, options) => {
+  records.command("query").description("Query records in a Data Fabric entity with filters, sorting, and aggregates. " + "Provide a JSON object via --body or --file with optional keys: " + "filterGroup, sortOptions (use isDescending: true/false), selectedFields, " + "aggregates (function: COUNT/SUM/AVG/MIN/MAX, field, alias?), groupBy.").argument("<id>", "Entity ID").addOption(createHiddenDeprecatedTenantOption("-t, --tenant <tenant-name>")).option("-f, --file <path>", "Path to JSON file with query options (filterGroup, selectedFields, sortOptions, aggregates, groupBy)").option("--body <json>", "Inline JSON query options (filterGroup, selectedFields, sortOptions, aggregates, groupBy; use `-` to read from stdin)").option("-l, --limit <number>", "Number of records to return per page", "50").option("-o, --offset <number>", "Start from the page containing this record index (rounded down to nearest page boundary;(mutually exclusive with --cursor)").option("--cursor <cursor>", "Pagination cursor from a previous response to fetch the next page").option("--folder-key <key>", "Folder key (GUID) of the folder containing the entity (for folder-scoped entities)").examples(RECORDS_QUERY_EXAMPLES).trackedAction(processContext, async (entityId, options) => {
     const pageSize = Number(options.limit);
     if (Number.isNaN(pageSize) || pageSize < 1) {
       return fail("Invalid --limit value", "Provide a positive integer for --limit.");
@@ -46652,4 +47149,4 @@ export {
   metadata
 };
 
-//# debugId=DA83B0B60172C03664756E2164756E21
+//# debugId=FE76A85C8BE8050764756E2164756E21