@uipath/uipath-typescript 1.4.0 → 1.4.2

package/dist/index.d.ts

@@ -483,6 +483,24 @@ declare class BaseService {
     private determineHasMorePages;
 }
 
+/**
+ * Shared types for the Data Fabric domain — used by both Entities and ChoiceSets.
+ * Lives here (not in either service's `*.types.ts`) to avoid cross-domain coupling
+ * between sibling services.
+ */
+/**
+ * Common shape for every folder-scoped Data Fabric operation.
+ * Forwarded on the wire as the `X-UIPATH-FolderKey` header.
+ */
+interface EntityFolderScopedOptions {
+    /**
+     * Key identifying the folder the entity belongs to. Omit for tenant-level entities.
+     *
+     * @experimental Folder-scoped Data Fabric is in preview — the contract may change.
+     */
+    folderKey?: string;
+}
+
 /**
  * Entity field data type names (SQL-level types returned by the API)
  */
@@ -599,14 +617,8 @@ interface EntityDeleteOptions extends EntityFolderScopedOptions {
  */
 interface EntityDeleteRecordsOptions extends EntityDeleteOptions {
 }
-/**
- * Options for {@link EntityServiceModel.deleteRecordById}
- */
 interface EntityDeleteRecordByIdOptions extends EntityFolderScopedOptions {
 }
-/**
- * Options for {@link EntityServiceModel.importRecordsById}
- */
 interface EntityImportRecordsByIdOptions extends EntityFolderScopedOptions {
 }
 /**
@@ -773,23 +785,25 @@ interface EntityCreateFieldOptions extends EntityFieldBase {
     referenceEntityId?: string;
     /** UUID of the referenced field on the target entity (required when `type` is `RELATIONSHIP` or `FILE`) */
     referenceFieldId?: string;
+    /**
+     * Folder key of the reference target when it lives outside the source's folder. Pass `'00000000-0000-0000-0000-000000000000'` for tenant-level system targets.
+     *
+     * @experimental Folder-scoped Data Fabric is in preview — the contract may change.
+     */
+    referenceFolderKey?: string;
 }
-/**
- * Common shape for every folder-scoped Data Fabric entity operation.
- * Forwarded on the wire as the `X-UIPATH-FolderKey` header.
- */
-interface EntityFolderScopedOptions {
-    /** Key identifying the folder the entity belongs to. Omit for tenant-level entities. */
-    folderKey?: string;
+interface EntityGetAllOptions extends EntityFolderScopedOptions {
+    /**
+     * When `true`, returns tenant-level and folder-level entities together.
+     * Omit (or `false`, the default) to return only tenant-level entities.
+     * Ignored when `folderKey` is provided — `folderKey` is preferred over `includeFolderEntities` when both are set.
+     *
+     * @experimental Folder-scoped Data Fabric is in preview — the contract may change.
+     */
+    includeFolderEntities?: boolean;
 }
-/**
- * Options for {@link EntityServiceModel.getById}
- */
 interface EntityGetByIdOptions extends EntityFolderScopedOptions {
 }
-/**
- * Options for {@link EntityServiceModel.deleteById}
- */
 interface EntityDeleteByIdOptions extends EntityFolderScopedOptions {
 }
 /**
@@ -1134,23 +1148,35 @@ interface RawEntityGetResponse {
  */
 interface EntityServiceModel {
     /**
-     * Gets all entities in the system
+     * Gets entities in the tenant.
+     *
+     * Three call modes:
+     * - `getAll()` — default. Returns only tenant-level entities.
+     * - `getAll({ folderKey: "<uuid>" })` — preferred for folder-scoped data. Returns only entities in that folder.
+     * - `getAll({ includeFolderEntities: true })` — returns tenant-level **and** folder-level entities together. `folderKey` is preferred over `includeFolderEntities` when both are set.
      *
-     * @returns Promise resolving to either an array of entities NonPaginatedResponse<EntityGetResponse> or a PaginatedResponse<EntityGetResponse> when pagination options are used.
+     * @param options - Optional {@link EntityGetAllOptions} (`folderKey` to list a single folder's entities — preferred when scoping to a folder; `includeFolderEntities: true` to list tenant + folder entities together) The `folderKey` property is **experimental**.
+     * @returns Promise resolving to an array of entity metadata
      * {@link EntityGetResponse}
      * @example
      * ```typescript
-     * // Get all entities
-     * const allEntities = await entities.getAll();
+     * // Tenant-only (default)
+     * const tenantEntities = await entities.getAll();
+     *
+     * // A single folder's entities (preferred when targeting a specific folder)
+     * const folderEntities = await entities.getAll({ folderKey: "<folderKey>" });
+     *
+     * // Tenant + folder entities together
+     * const allEntities = await entities.getAll({ includeFolderEntities: true });
      *
      * // Iterate through entities
-     * allEntities.forEach(entity => {
+     * tenantEntities.forEach(entity => {
      *   console.log(`Entity: ${entity.displayName} (${entity.name})`);
      *   console.log(`Type: ${entity.entityType}`);
      * });
      *
      * // Find a specific entity by name
-     * const customerEntity = allEntities.find(e => e.name === 'Customer');
+     * const customerEntity = tenantEntities.find(e => e.name === 'Customer');
      *
      * // Use entity methods directly
      * if (customerEntity) {
@@ -1168,12 +1194,12 @@ interface EntityServiceModel {
      * }
      * ```
      */
-    getAll(): Promise<EntityGetResponse[]>;
+    getAll(options?: EntityGetAllOptions): Promise<EntityGetResponse[]>;
     /**
      * Gets entity metadata by entity ID with attached operation methods
      *
      * @param id - UUID of the entity
-     * @param options - Optional {@link EntityGetByIdOptions} (e.g. `folderKey` for folder-scoped entities)
+     * @param options - Optional {@link EntityGetByIdOptions} (e.g. `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving to entity metadata with operation methods
      * {@link EntityGetResponse}
      * @example
@@ -1213,7 +1239,7 @@ interface EntityServiceModel {
      * Gets entity records by entity ID
      *
      * @param entityId - UUID of the entity
-     * @param options - Query options
+     * @param options - Query options The `folderKey` property is **experimental**.
      * @returns Promise resolving to either an array of entity records NonPaginatedResponse<EntityRecord> or a PaginatedResponse<EntityRecord> when pagination options are used.
      * {@link EntityRecord}
      * @example
@@ -1237,6 +1263,9 @@ interface EntityServiceModel {
      *   cursor: paginatedResponse.nextCursor,
      *   expansionLevel: 1
      * });
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * const records = await entities.getAllRecords("<entityId>", { folderKey: "<folderKey>" });
      * ```
      */
     getAllRecords<T extends EntityGetAllRecordsOptions = EntityGetAllRecordsOptions>(entityId: string, options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<EntityRecord> : NonPaginatedResponse<EntityRecord>>;
@@ -1250,7 +1279,7 @@ interface EntityServiceModel {
      *
      * @param entityId - UUID of the entity
      * @param recordId - UUID of the record
-     * @param options - Query options
+     * @param options - Query options The `folderKey` property is **experimental**.
      * @returns Promise resolving to a single entity record
      * {@link EntityRecord}
      * @example
@@ -1266,6 +1295,11 @@ interface EntityServiceModel {
      * const record = await entities.getRecordById(<entityId>, recordId, {
      *   expansionLevel: 1
      * });
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * const record = await entities.getRecordById(<entityId>, recordId, {
+     *   folderKey: "<folderKey>"
+     * });
      * ```
      */
     getRecordById(entityId: string, recordId: string, options?: EntityGetRecordByIdOptions): Promise<EntityRecord>;
@@ -1277,7 +1311,7 @@ interface EntityServiceModel {
      *
      * @param id - UUID of the entity
      * @param data - Record to insert
-     * @param options - Insert options
+     * @param options - Insert options The `folderKey` property is **experimental**.
      * @returns Promise resolving to the inserted record with generated record ID
      * {@link EntityInsertResponse}
      * @example
@@ -1289,6 +1323,11 @@ interface EntityServiceModel {
      * const result = await entities.insertRecordById(<entityId>, { name: "John", age: 30 }, {
      *   expansionLevel: 1
      * });
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.insertRecordById(<entityId>, { name: "John", age: 30 }, {
+     *   folderKey: "<folderKey>"
+     * });
      * ```
      */
     insertRecordById(id: string, data: Record<string, any>, options?: EntityInsertRecordOptions): Promise<EntityInsertResponse>;
@@ -1305,7 +1344,7 @@ interface EntityServiceModel {
      *
      * @param id - UUID of the entity
      * @param data - Array of records to insert
-     * @param options - Insert options
+     * @param options - Insert options The `folderKey` property is **experimental**.
      * @returns Promise resolving to insert response
      * {@link EntityBatchInsertResponse}
      * @example
@@ -1324,6 +1363,12 @@ interface EntityServiceModel {
      *   expansionLevel: 1,
      *   failOnFirst: true
      * });
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.insertRecordsById(<entityId>, [
+     *   { name: "John", age: 30 },
+     *   { name: "Jane", age: 25 }
+     * ], { folderKey: "<folderKey>" });
      * ```
      */
     insertRecordsById(id: string, data: Record<string, any>[], options?: EntityInsertRecordsOptions): Promise<EntityBatchInsertResponse>;
@@ -1341,7 +1386,7 @@ interface EntityServiceModel {
      * @param entityId - UUID of the entity
      * @param recordId - UUID of the record to update
      * @param data - Key-value pairs of fields to update
-     * @param options - Update options
+     * @param options - Update options The `folderKey` property is **experimental**.
      * @returns Promise resolving to the updated record
      * {@link EntityUpdateRecordResponse}
      * @example
@@ -1353,6 +1398,11 @@ interface EntityServiceModel {
      * const result = await entities.updateRecordById(<entityId>, <recordId>, { name: "John Updated", age: 31 }, {
      *   expansionLevel: 1
      * });
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.updateRecordById(<entityId>, <recordId>, { name: "John Updated" }, {
+     *   folderKey: "<folderKey>"
+     * });
      * ```
      */
     updateRecordById(entityId: string, recordId: string, data: Record<string, any>, options?: EntityUpdateRecordOptions): Promise<EntityUpdateRecordResponse>;
@@ -1363,7 +1413,7 @@ interface EntityServiceModel {
      *
      * @param id - UUID of the entity
      * @param data - Array of records to update. Each record MUST contain the record id.
-     * @param options - Update options
+     * @param options - Update options The `folderKey` property is **experimental**.
      * @returns Promise resolving to update response
      * {@link EntityUpdateResponse}
      * @example
@@ -1382,6 +1432,11 @@ interface EntityServiceModel {
      *   expansionLevel: 1,
      *   failOnFirst: true
      * });
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.updateRecordsById(<entityId>, [
+     *   { Id: "123", name: "John Updated" }
+     * ], { folderKey: "<folderKey>" });
      * ```
      */
     updateRecordsById(id: string, data: EntityRecord[], options?: EntityUpdateRecordsOptions): Promise<EntityUpdateResponse>;
@@ -1392,7 +1447,7 @@ interface EntityServiceModel {
      *
      * @param id - UUID of the entity
      * @param recordIds - Array of record UUIDs to delete
-     * @param options - Delete options
+     * @param options - Delete options The `folderKey` property is **experimental**.
      * @returns Promise resolving to delete response
      * {@link EntityDeleteResponse}
      * @example
@@ -1401,6 +1456,11 @@ interface EntityServiceModel {
      * const result = await entities.deleteRecordsById(<entityId>, [
      *   <recordId-1>, <recordId-2>
      * ]);
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.deleteRecordsById(<entityId>, [
+     *   <recordId-1>, <recordId-2>
+     * ], { folderKey: "<folderKey>" });
      * ```
      */
     deleteRecordsById(id: string, recordIds: string[], options?: EntityDeleteRecordsOptions): Promise<EntityDeleteResponse>;
@@ -1412,7 +1472,7 @@ interface EntityServiceModel {
      *
      * @param entityId - UUID of the entity
      * @param recordId - UUID of the record to delete
-     * @param options - Optional {@link EntityDeleteRecordByIdOptions} (e.g. `folderKey` for folder-scoped entities)
+     * @param options - Optional {@link EntityDeleteRecordByIdOptions} (e.g. `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving to void on success
      * @example
      * ```typescript
@@ -1431,7 +1491,7 @@ interface EntityServiceModel {
      * Queries entity records with filters, sorting, aggregates, and SDK-managed pagination
      *
      * @param id - UUID of the entity
-     * @param options - Query options including filterGroup, selectedFields, sortOptions, aggregates, groupBy, and pagination
+     * @param options - Query options including filterGroup, selectedFields, sortOptions, aggregates, groupBy, and pagination The `folderKey` property is **experimental**.
      * @returns Promise resolving to {@link NonPaginatedResponse} without pagination options,
      *   or {@link PaginatedResponse} when `pageSize`, `cursor`, or `jumpToPage` are provided
      * @example
@@ -1465,6 +1525,12 @@ interface EntityServiceModel {
      *   ],
      * });
      *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.queryRecordsById(<id>, {
+     *   filterGroup: { queryFilters: [{ fieldName: "status", operator: QueryFilterOperator.Equals, value: "active" }] },
+     *   folderKey: "<folderKey>",
+     * });
+     *
      * // Aggregate: total sum and average across all records (no grouping)
      * await entities.queryRecordsById(<id>, {
      *   aggregates: [
@@ -1480,7 +1546,7 @@ interface EntityServiceModel {
      *
      * @param id - UUID of the entity
      * @param file - CSV file to import as a Blob or File or Uint8Array
-     * @param options - Optional {@link EntityImportRecordsByIdOptions} (e.g. `folderKey` for folder-scoped entities)
+     * @param options - Optional {@link EntityImportRecordsByIdOptions} (e.g. `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving to {@link EntityImportRecordsResponse} with record counts
      * @example
      * ```typescript
@@ -1500,7 +1566,7 @@ interface EntityServiceModel {
      * @param entityId - UUID of the entity
      * @param recordId - UUID of the record containing the attachment
      * @param fieldName - Name of the File-type field containing the attachment
-     * @param options - Optional {@link EntityDownloadAttachmentOptions} (e.g. `folderKey` for folder-scoped entities)
+     * @param options - Optional {@link EntityDownloadAttachmentOptions} (e.g. `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving to Blob containing the file content
      * @example
      * ```typescript
@@ -1557,7 +1623,7 @@ interface EntityServiceModel {
      * @param recordId - UUID of the record to upload the attachment to
      * @param fieldName - Name of the File-type field
      * @param file - File to upload (Blob, File, or Uint8Array)
-     * @param options - Optional {@link EntityUploadAttachmentOptions} (e.g. `expansionLevel`, `folderKey` for folder-scoped entities)
+     * @param options - Optional {@link EntityUploadAttachmentOptions} (e.g. `expansionLevel`, `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving to {@link EntityUploadAttachmentResponse}
      * @example
      * ```typescript
@@ -1594,7 +1660,7 @@ interface EntityServiceModel {
      * @param entityId - UUID of the entity
      * @param recordId - UUID of the record containing the attachment
      * @param fieldName - Name of the File-type field containing the attachment
-     * @param options - Optional {@link EntityDeleteAttachmentOptions} (e.g. `folderKey` for folder-scoped entities)
+     * @param options - Optional {@link EntityDeleteAttachmentOptions} (e.g. `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving to {@link EntityDeleteAttachmentResponse}
      * @example
      * ```typescript
@@ -1625,7 +1691,7 @@ interface EntityServiceModel {
      * @param name - Entity name — must start with a letter, letters/numbers/underscores only
      *   (e.g., `"productCatalog"`).
      * @param fields - Array of field definitions
-     * @param options - Optional entity-level settings ({@link EntityCreateOptions})
+     * @param options - Optional entity-level settings ({@link EntityCreateOptions}) The `folderKey` property is **experimental**.
      * @returns Promise resolving to the ID of the created entity
      * @example
      * ```typescript
@@ -1644,6 +1710,24 @@ interface EntityServiceModel {
      *   { fieldName: "price", type: EntityFieldDataType.DECIMAL, decimalPrecision: 4, maxValue: 999999, minValue: 0 },
      *   { fieldName: "quantity", type: EntityFieldDataType.INTEGER, maxValue: 10000, minValue: 1, defaultValue: "0" },
      * ]);
+     *
+     * // Cross-folder references — link a folder-scoped entity to entities and
+     * // system choice sets that live in another folder or at the tenant level.
+     * await entities.create("orderLine", [
+     *   {
+     *     fieldName: "order",
+     *     type: EntityFieldDataType.RELATIONSHIP,
+     *     referenceEntityId: "<orderEntityId>",
+     *     referenceFieldId: "<orderEntityPkId>",
+     *     referenceFolderKey: "<otherFolderKey>",     // target lives in a different folder
+     *   },
+     *   {
+     *     fieldName: "userType",
+     *     type: EntityFieldDataType.CHOICE_SET_SINGLE,
+     *     choiceSetId: "<systemUserTypeChoiceSetId>", // tenant-level system choice set
+     *     // referenceFolderKey omitted → SDK looks up the target at tenant scope
+     *   },
+     * ], { folderKey: "<sourceFolderKey>" });
      * ```
      * @internal
      */
@@ -1652,7 +1736,7 @@ interface EntityServiceModel {
      * Deletes a Data Fabric entity and all its records
      *
      * @param id - UUID of the entity to delete
-     * @param options - Optional {@link EntityDeleteByIdOptions} (e.g. `folderKey` for folder-scoped entities)
+     * @param options - Optional {@link EntityDeleteByIdOptions} (e.g. `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving when the entity is deleted
      * @example
      * ```typescript
@@ -1672,7 +1756,7 @@ interface EntityServiceModel {
      * only when the corresponding fields are provided.
      *
      * @param id - UUID of the entity to update
-     * @param options - Changes to apply ({@link EntityUpdateByIdOptions})
+     * @param options - Changes to apply ({@link EntityUpdateByIdOptions}) The `folderKey` property is **experimental**.
      * @returns Promise resolving when the update is complete
      *
      * @example
@@ -1790,7 +1874,7 @@ interface EntityMethods {
     /**
      * Get all records from this entity
      *
-     * @param options - Query options
+     * @param options - Query options The `folderKey` property is **experimental**.
      * @returns Promise resolving to query response
      */
     getAllRecords<T extends EntityGetAllRecordsOptions = EntityGetAllRecordsOptions>(options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<EntityRecord> : NonPaginatedResponse<EntityRecord>>;
@@ -1807,7 +1891,7 @@ interface EntityMethods {
      *
      * @param recordId - UUID of the record containing the attachment
      * @param fieldName - Name of the File-type field containing the attachment
-     * @param options - Optional {@link EntityDownloadAttachmentOptions} (e.g. folderKey)
+     * @param options - Optional {@link EntityDownloadAttachmentOptions} (e.g. folderKey) The `folderKey` property is **experimental**.
      * @returns Promise resolving to Blob containing the file content
      */
     downloadAttachment(recordId: string, fieldName: string, options?: EntityDownloadAttachmentOptions): Promise<Blob>;
@@ -1817,7 +1901,7 @@ interface EntityMethods {
      * @param recordId - UUID of the record to upload the attachment to
      * @param fieldName - Name of the File-type field
      * @param file - File to upload (Blob, File, or Uint8Array)
-     * @param options - Optional {@link EntityUploadAttachmentOptions} (e.g. expansionLevel, folderKey)
+     * @param options - Optional {@link EntityUploadAttachmentOptions} (e.g. expansionLevel, folderKey) The `folderKey` property is **experimental**.
      * @returns Promise resolving to {@link EntityUploadAttachmentResponse}
      */
     uploadAttachment(recordId: string, fieldName: string, file: EntityFileType, options?: EntityUploadAttachmentOptions): Promise<EntityUploadAttachmentResponse>;
@@ -1826,7 +1910,7 @@ interface EntityMethods {
      *
      * @param recordId - UUID of the record containing the attachment
      * @param fieldName - Name of the File-type field containing the attachment
-     * @param options - Optional {@link EntityDeleteAttachmentOptions} (e.g. folderKey)
+     * @param options - Optional {@link EntityDeleteAttachmentOptions} (e.g. folderKey) The `folderKey` property is **experimental**.
      * @returns Promise resolving to {@link EntityDeleteAttachmentResponse}
      */
     deleteAttachment(recordId: string, fieldName: string, options?: EntityDeleteAttachmentOptions): Promise<EntityDeleteAttachmentResponse>;
@@ -1966,7 +2050,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * Gets entity metadata by entity ID with attached operation methods
      *
      * @param id - UUID of the entity
-     * @param options - Optional {@link EntityGetByIdOptions} (e.g. `folderKey` for folder-scoped entities)
+     * @param options - Optional {@link EntityGetByIdOptions} (e.g. `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving to entity metadata with schema information and operation methods
      *
      * @example
@@ -1997,7 +2081,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * Gets entity records by entity ID
      *
      * @param entityId - UUID of the entity
-     * @param options - Query options including expansionLevel and pagination options
+     * @param options - Query options including expansionLevel and pagination options The `folderKey` property is **experimental**.
      * @returns Promise resolving to an array of entity records or paginated response
      *
      * @example
@@ -2025,6 +2109,9 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *   cursor: paginatedResponse.nextCursor,
      *   expansionLevel: 1
      * });
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * const records = await entities.getAllRecords("<entityId>", { folderKey: "<folderKey>" });
      * ```
      */
     getAllRecords<T extends EntityGetAllRecordsOptions = EntityGetAllRecordsOptions>(entityId: string, options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<EntityRecord> : NonPaginatedResponse<EntityRecord>>;
@@ -2033,7 +2120,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *
      * @param entityId - UUID of the entity
      * @param recordId - UUID of the record
-     * @param options - Query options including expansionLevel
+     * @param options - Query options including `expansionLevel` and `folderKey` The `folderKey` property is **experimental**.
      * @returns Promise resolving to the entity record
      *
      * @example
@@ -2045,6 +2132,11 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * const record = await sdk.entities.getRecordById(<entityId>, <recordId>, {
      *   expansionLevel: 1
      * });
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * const record = await sdk.entities.getRecordById(<entityId>, <recordId>, {
+     *   folderKey: "<folderKey>"
+     * });
      * ```
      */
     getRecordById(entityId: string, recordId: string, options?: EntityGetRecordByIdOptions): Promise<EntityRecord>;
@@ -2053,7 +2145,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *
      * @param entityId - UUID of the entity
      * @param data - Record to insert
-     * @param options - Insert options
+     * @param options - Insert options The `folderKey` property is **experimental**.
      * @returns Promise resolving to the inserted record with generated record ID
      *
      * @example
@@ -2069,6 +2161,11 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * const result = await entities.insertRecordById("<entityId>", { name: "John", age: 30 }, {
      *   expansionLevel: 1
      * });
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.insertRecordById("<entityId>", { name: "John", age: 30 }, {
+     *   folderKey: "<folderKey>"
+     * });
      * ```
      */
     insertRecordById(id: string, data: Record<string, any>, options?: EntityInsertRecordOptions): Promise<EntityInsertResponse>;
@@ -2077,7 +2174,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *
      * @param entityId - UUID of the entity
      * @param data - Array of records to insert
-     * @param options - Insert options
+     * @param options - Insert options The `folderKey` property is **experimental**.
      * @returns Promise resolving to insert response
      *
      * @example
@@ -2100,6 +2197,12 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *   expansionLevel: 1,
      *   failOnFirst: true
      * });
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.insertRecordsById("<entityId>", [
+     *   { name: "John", age: 30 },
+     *   { name: "Jane", age: 25 }
+     * ], { folderKey: "<folderKey>" });
      * ```
      */
     insertRecordsById(id: string, data: Record<string, any>[], options?: EntityInsertRecordsOptions): Promise<EntityBatchInsertResponse>;
@@ -2109,7 +2212,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * @param entityId - UUID of the entity
      * @param recordId - UUID of the record to update
      * @param data - Key-value pairs of fields to update
-     * @param options - Update options
+     * @param options - Update options The `folderKey` property is **experimental**.
      * @returns Promise resolving to the updated record
      *
      * @example
@@ -2125,6 +2228,11 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * const result = await entities.updateRecordById("<entityId>", "<recordId>", { name: "John Updated", age: 31 }, {
      *   expansionLevel: 1
      * });
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.updateRecordById("<entityId>", "<recordId>", { name: "John Updated" }, {
+     *   folderKey: "<folderKey>"
+     * });
      * ```
      */
     updateRecordById(entityId: string, recordId: string, data: Record<string, any>, options?: EntityUpdateRecordOptions): Promise<EntityUpdateRecordResponse>;
@@ -2134,7 +2242,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * @param entityId - UUID of the entity
      * @param data - Array of records to update. Each record MUST contain the record Id,
      *               otherwise the update will fail.
-     * @param options - Update options
+     * @param options - Update options The `folderKey` property is **experimental**.
      * @returns Promise resolving to update response
      *
      * @example
@@ -2157,6 +2265,11 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *   expansionLevel: 1,
      *   failOnFirst: true
      * });
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.updateRecordsById("<entityId>", [
+     *   { Id: "123", name: "John Updated" }
+     * ], { folderKey: "<folderKey>" });
      * ```
      */
     updateRecordsById(id: string, data: EntityRecord[], options?: EntityUpdateRecordsOptions): Promise<EntityUpdateResponse>;
@@ -2167,7 +2280,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *
      * @param entityId - UUID of the entity
      * @param recordIds - Array of record UUIDs to delete
-     * @param options - Delete options
+     * @param options - Delete options The `folderKey` property is **experimental**.
      * @returns Promise resolving to delete response
      *
      * @example
@@ -2180,6 +2293,11 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * const result = await entities.deleteRecordsById("<entityId>", [
      *   "<recordId-1>", "<recordId-2>"
      * ]);
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.deleteRecordsById("<entityId>", [
+     *   "<recordId-1>", "<recordId-2>"
+     * ], { folderKey: "<folderKey>" });
      * ```
      */
     deleteRecordsById(id: string, recordIds: string[], options?: EntityDeleteRecordsOptions): Promise<EntityDeleteResponse>;
@@ -2191,7 +2309,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *
      * @param entityId - UUID of the entity
      * @param recordId - UUID of the record to delete
-     * @param options - Optional {@link EntityDeleteRecordByIdOptions} (e.g. `folderKey` for folder-scoped entities)
+     * @param options - Optional {@link EntityDeleteRecordByIdOptions} (e.g. `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving to void on success
      * @example
      * ```typescript
@@ -2207,8 +2325,14 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      */
     deleteRecordById(entityId: string, recordId: string, options?: EntityDeleteRecordByIdOptions): Promise<void>;
     /**
-     * Gets all entities in the system
+     * Gets entities in the tenant.
+     *
+     * Three call modes:
+     * - `getAll()` — default. Returns only tenant-level entities.
+     * - `getAll({ folderKey: "<uuid>" })` — preferred for folder-scoped data. Returns only entities in that folder.
+     * - `getAll({ includeFolderEntities: true })` — returns tenant-level **and** folder-level entities together. `folderKey` is preferred over `includeFolderEntities` when both are set.
      *
+     * @param options - Optional {@link EntityGetAllOptions} (`folderKey` to list a single folder's entities — preferred when scoping to a folder; `includeFolderEntities: true` to list tenant + folder entities together) The `folderKey` property is **experimental**.
      * @returns Promise resolving to an array of entity metadata
      *
      * @example
@@ -2217,19 +2341,25 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *
      * const entities = new Entities(sdk);
      *
-     * // Get all entities
-     * const allEntities = await entities.getAll();
+     * // Tenant-only (default)
+     * const tenantEntities = await entities.getAll();
+     *
+     * // A single folder's entities (preferred when targeting a specific folder)
+     * const folderEntities = await entities.getAll({ folderKey: "<folderKey>" });
+     *
+     * // Tenant + folder entities together
+     * const allEntities = await entities.getAll({ includeFolderEntities: true });
      *
      * // Call operations on an entity
-     * const records = await allEntities[0].getAllRecords();
+     * const records = await tenantEntities[0].getAllRecords();
      * ```
      */
-    getAll(): Promise<EntityGetResponse[]>;
+    getAll(options?: EntityGetAllOptions): Promise<EntityGetResponse[]>;
     /**
      * Queries entity records with filters, sorting, aggregates, and pagination
      *
      * @param id - UUID of the entity
-     * @param options - Query options including filterGroup, selectedFields, sortOptions, aggregates, groupBy, and pagination
+     * @param options - Query options including filterGroup, selectedFields, sortOptions, aggregates, groupBy, and pagination The `folderKey` property is **experimental**.
      * @returns Promise resolving to {@link NonPaginatedResponse} without pagination options,
      *   or {@link PaginatedResponse} when `pageSize`, `cursor`, or `jumpToPage` are provided
      *
@@ -2276,6 +2406,12 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *     { function: EntityAggregateFunction.Avg, field: "amount", alias: "avgAmount" },
      *   ],
      * });
+     *
+     * // Folder-scoped entity: pass the entity's folder key
+     * await entities.queryRecordsById("<entityId>", {
+     *   filterGroup: { queryFilters: [{ fieldName: "status", operator: QueryFilterOperator.Equals, value: "active" }] },
+     *   folderKey: "<folderKey>",
+     * });
      * ```
      */
     queryRecordsById<T extends EntityQueryRecordsOptions = EntityQueryRecordsOptions>(id: string, options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<EntityRecord> : NonPaginatedResponse<EntityRecord>>;
@@ -2284,7 +2420,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *
      * @param id - UUID of the entity
      * @param file - CSV file to import (Blob, File, or Uint8Array)
-     * @param options - Optional {@link EntityImportRecordsByIdOptions} (e.g. `folderKey` for folder-scoped entities)
+     * @param options - Optional {@link EntityImportRecordsByIdOptions} (e.g. `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving to import result with record counts
      *
      * @example
@@ -2317,7 +2453,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * @param entityId - UUID of the entity
      * @param recordId - UUID of the record containing the attachment
      * @param fieldName - Name of the File-type field containing the attachment
-     * @param options - Optional {@link EntityDownloadAttachmentOptions} (e.g. `folderKey` for folder-scoped entities)
+     * @param options - Optional {@link EntityDownloadAttachmentOptions} (e.g. `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving to Blob containing the file content
      *
      * @example
@@ -2349,7 +2485,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * @param recordId - UUID of the record to upload the attachment to
      * @param fieldName - Name of the File-type field
      * @param file - File to upload (Blob, File, or Uint8Array)
-     * @param options - Optional {@link EntityUploadAttachmentOptions} (e.g. `expansionLevel`, `folderKey` for folder-scoped entities)
+     * @param options - Optional {@link EntityUploadAttachmentOptions} (e.g. `expansionLevel`, `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving to {@link EntityUploadAttachmentResponse}
      *
      * @example
@@ -2380,7 +2516,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * @param entityId - UUID of the entity
      * @param recordId - UUID of the record containing the attachment
      * @param fieldName - Name of the File-type field containing the attachment
-     * @param options - Optional {@link EntityDeleteAttachmentOptions} (e.g. `folderKey` for folder-scoped entities)
+     * @param options - Optional {@link EntityDeleteAttachmentOptions} (e.g. `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving to {@link EntityDeleteAttachmentResponse}
      *
      * @example
@@ -2426,7 +2562,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * @param name - Entity name — must start with a letter and contain
      *   only letters, numbers, and underscores (e.g., `"productCatalog"`).
      * @param fields - Array of field definitions
-     * @param options - Optional entity-level settings ({@link EntityCreateOptions})
+     * @param options - Optional entity-level settings ({@link EntityCreateOptions}) The `folderKey` property is **experimental**.
      * @returns Promise resolving to the ID of the created entity
      *
      * @example
@@ -2442,6 +2578,24 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      *   { fieldName: "price", type: EntityFieldDataType.DECIMAL, decimalPrecision: 4, maxValue: 999999, minValue: 0 },
      *   { fieldName: "quantity", type: EntityFieldDataType.INTEGER, maxValue: 10000, minValue: 1, defaultValue: "0" },
      * ]);
+     *
+     * // Cross-folder references — link a folder-scoped entity to entities and
+     * // system choice sets that live in another folder or at the tenant level.
+     * await entities.create("orderLine", [
+     *   {
+     *     fieldName: "order",
+     *     type: EntityFieldDataType.RELATIONSHIP,
+     *     referenceEntityId: "<orderEntityId>",
+     *     referenceFieldId: "<orderEntityPkId>",
+     *     referenceFolderKey: "<otherFolderKey>",     // target lives in a different folder
+     *   },
+     *   {
+     *     fieldName: "userType",
+     *     type: EntityFieldDataType.CHOICE_SET_SINGLE,
+     *     choiceSetId: "<systemUserTypeChoiceSetId>", // tenant-level system choice set
+     *     // referenceFolderKey omitted → SDK looks up the target at tenant scope
+     *   },
+     * ], { folderKey: "<sourceFolderKey>" });
      * ```
      * @internal
      */
@@ -2450,7 +2604,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * Deletes a Data Fabric entity and all its records
      *
      * @param id - UUID of the entity to delete
-     * @param options - Optional {@link EntityDeleteByIdOptions} (e.g. `folderKey` for folder-scoped entities)
+     * @param options - Optional {@link EntityDeleteByIdOptions} (e.g. `folderKey` for folder-scoped entities) The `folderKey` property is **experimental**.
      * @returns Promise resolving when the entity is deleted
      *
      * @example
@@ -2475,7 +2629,7 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * overwrite each other's changes.
      *
      * @param id - UUID of the entity to update
-     * @param options - Changes to apply ({@link EntityUpdateByIdOptions})
+     * @param options - Changes to apply ({@link EntityUpdateByIdOptions}) The `folderKey` property is **experimental**.
      * @returns Promise resolving when the update is complete
      *
      * @example
@@ -2558,6 +2712,8 @@ declare class EntityService extends BaseService implements EntityServiceModel {
      * @private
      */
     private mapExternalFields;
+    private buildFieldsWithReferenceMeta;
+    private buildReferenceMeta;
     /** Converts a user-facing EntityCreateFieldOptions to the raw API field payload */
     private buildSchemaFieldPayload;
     /**
@@ -2631,40 +2787,54 @@ interface ChoiceSetGetResponse {
     /** User ID of the record owner */
     recordOwner?: string;
 }
+interface ChoiceSetGetAllOptions extends EntityFolderScopedOptions {
+    /**
+     * When `true`, also returns folder-level choice sets alongside tenant ones.
+     * Omit (or `false`, the default) to return only tenant-level choice sets.
+     * Ignored when `folderKey` is provided — `folderKey` is preferred over `includeFolderChoiceSets` when both are set.
+     *
+     * @experimental Folder-scoped Data Fabric is in preview — the contract may change.
+     */
+    includeFolderChoiceSets?: boolean;
+}
 /**
  * Options for getting choice set values by choice set ID
  */
-type ChoiceSetGetByIdOptions = PaginationOptions;
+type ChoiceSetGetByIdOptions = PaginationOptions & EntityFolderScopedOptions;
 /**
  * Options for creating a new choice set
  */
-interface ChoiceSetCreateOptions {
+interface ChoiceSetCreateOptions extends EntityFolderScopedOptions {
     /** Human-readable display name */
     displayName?: string;
     /** Optional choice set description */
     description?: string;
-    /** UUID of the folder to place the choice set in (defaults to the tenant-level folder) */
-    folderKey?: string;
 }
 /**
  * Options for updating an existing choice set's metadata
  */
-interface ChoiceSetUpdateOptions {
+interface ChoiceSetUpdateOptions extends EntityFolderScopedOptions {
     /** New display name for the choice set */
     displayName?: string;
     /** New description for the choice set */
     description?: string;
 }
+interface ChoiceSetDeleteByIdOptions extends EntityFolderScopedOptions {
+}
 /**
  * Optional fields when inserting a single value into a choice set.
  *
  * The required `name` identifier is passed as a positional argument to
  * `insertValueById`.
  */
-interface ChoiceSetValueInsertOptions {
+interface ChoiceSetValueInsertOptions extends EntityFolderScopedOptions {
     /** Human-readable display name */
     displayName?: string;
 }
+interface ChoiceSetValueUpdateOptions extends EntityFolderScopedOptions {
+}
+interface ChoiceSetValueDeleteOptions extends EntityFolderScopedOptions {
+}
 /**
  * Response returned after inserting a choice-set value — the full value object.
  */
@@ -2694,33 +2864,32 @@ interface ChoiceSetValueUpdateResponse extends ChoiceSetGetResponse {
  */
 interface ChoiceSetServiceModel {
     /**
-     * Gets all choice sets in the org
+     * Gets choice sets in the tenant.
      *
+     * Three call modes:
+     * - `getAll()` — default. Returns only tenant-level choice sets.
+     * - `getAll({ folderKey: "<uuid>" })` — preferred for folder-scoped data. Returns only choice sets in that folder.
+     * - `getAll({ includeFolderChoiceSets: true })` — returns tenant-level **and** folder-level choice sets together. `folderKey` is preferred over `includeFolderChoiceSets` when both are set.
+     *
+     * @param options - Optional {@link ChoiceSetGetAllOptions} (`folderKey` to list a single folder's choice sets — preferred when scoping to a folder; `includeFolderChoiceSets: true` to list tenant + folder choice sets together) The `folderKey` property is **experimental**.
      * @returns Promise resolving to an array of choice set metadata
      * {@link ChoiceSetGetAllResponse}
      * @example
      * ```typescript
-     * // Get all choice sets
-     * const allChoiceSets = await choicesets.getAll();
+     * // Tenant-only (default)
+     * const tenantChoiceSets = await choicesets.getAll();
      *
-     * // Iterate through choice sets
-     * allChoiceSets.forEach(choiceSet => {
-     *   console.log(`ChoiceSet: ${choiceSet.displayName} (${choiceSet.name})`);
-     *   console.log(`Description: ${choiceSet.description}`);
-     *   console.log(`Created by: ${choiceSet.createdBy}`);
-     * });
+     * // A single folder's choice sets (preferred when targeting a specific folder)
+     * const folderChoiceSets = await choicesets.getAll({ folderKey: "<folderKey>" });
      *
-     * // Find a specific choice set by name
-     * const expenseTypes = allChoiceSets.find(cs => cs.name === 'ExpenseTypes');
+     * // Tenant + folder choice sets together
+     * const allChoiceSets = await choicesets.getAll({ includeFolderChoiceSets: true });
      *
-     * // Check choice set details
-     * if (expenseTypes) {
-     *   console.log(`Last updated: ${expenseTypes.updatedTime}`);
-     *   console.log(`Updated by: ${expenseTypes.updatedBy}`);
-     * }
+     * // Find a specific choice set by name
+     * const expenseTypes = tenantChoiceSets.find(cs => cs.name === 'ExpenseTypes');
      * ```
      */
-    getAll(): Promise<ChoiceSetGetAllResponse[]>;
+    getAll(options?: ChoiceSetGetAllOptions): Promise<ChoiceSetGetAllResponse[]>;
     /**
      * Gets choice set values by choice set ID with optional pagination
      *
@@ -2729,7 +2898,7 @@ interface ChoiceSetServiceModel {
      * - A PaginatedResponse with navigation cursors (when any pagination parameter is provided)
      *
      * @param choiceSetId - UUID of the choice set
-     * @param options - Pagination options
+     * @param options - Pagination options and optional `folderKey` (omit for tenant-level choice sets) The `folderKey` property is **experimental**.
      * @returns Promise resolving to choice set values or paginated result
      * {@link ChoiceSetGetResponse}
      * @example
@@ -2754,6 +2923,9 @@ interface ChoiceSetServiceModel {
      * if (page1.hasNextPage) {
      *   const page2 = await choicesets.getById(choiceSetId, { cursor: page1.nextCursor });
      * }
+     *
+     * // Folder-scoped choice set
+     * const folderValues = await choicesets.getById(choiceSetId, { folderKey: "<folderKey>" });
      * ```
      */
     getById<T extends ChoiceSetGetByIdOptions = ChoiceSetGetByIdOptions>(choiceSetId: string, options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<ChoiceSetGetResponse> : NonPaginatedResponse<ChoiceSetGetResponse>>;
@@ -2763,7 +2935,7 @@ interface ChoiceSetServiceModel {
      * @param name - Choice set name. Must start with a
      *   letter, may contain only letters, numbers, and underscores, length
      *   3–100 characters (e.g., `"expenseTypes"`).
-     * @param options - Optional choice-set-level settings ({@link ChoiceSetCreateOptions})
+     * @param options - Optional choice-set-level settings ({@link ChoiceSetCreateOptions}) The `folderKey` property is **experimental**.
      * @returns Promise resolving to the UUID of the created choice set
      *
      * @example
@@ -2787,7 +2959,7 @@ interface ChoiceSetServiceModel {
      * the call throws `ValidationError` if both are omitted.
      *
      * @param choiceSetId - UUID of the choice set to update
-     * @param options - Metadata fields to change ({@link ChoiceSetUpdateOptions})
+     * @param options - Metadata fields to change ({@link ChoiceSetUpdateOptions}) The `folderKey` property is **experimental**.
      * @returns Promise resolving when the update is complete
      *
      * @example
@@ -2808,6 +2980,7 @@ interface ChoiceSetServiceModel {
      * Deletes a Data Fabric choice set and all its values.
      *
      * @param choiceSetId - UUID of the choice set to delete
+     * @param options - Optional {@link ChoiceSetDeleteByIdOptions} — pass `folderKey` for folder-scoped choice sets; omit for tenant-level The `folderKey` property is **experimental**.
      * @returns Promise resolving when the choice set is deleted
      *
      * @example
@@ -2817,16 +2990,19 @@ interface ChoiceSetServiceModel {
      * const expenseTypes = allChoiceSets.find(cs => cs.name === 'expense_types');
      *
      * await choicesets.deleteById(expenseTypes.id);
+     *
+     * // Folder-scoped choice set
+     * await choicesets.deleteById(expenseTypes.id, { folderKey: "<folderKey>" });
      * ```
      * @internal
      */
-    deleteById(choiceSetId: string): Promise<void>;
+    deleteById(choiceSetId: string, options?: ChoiceSetDeleteByIdOptions): Promise<void>;
     /**
      * Inserts a single value into a choice set.
      *
      * @param choiceSetId - UUID of the parent choice set
      * @param name - Identifier name of the new value (e.g., `"TRAVEL"`)
-     * @param options - Optional fields ({@link ChoiceSetValueInsertOptions})
+     * @param options - Optional fields ({@link ChoiceSetValueInsertOptions}) The `folderKey` property is **experimental**.
      * @returns Promise resolving to the inserted value ({@link ChoiceSetValueInsertResponse})
      *
      * @example
@@ -2839,6 +3015,12 @@ interface ChoiceSetServiceModel {
      *   displayName: 'Travel',
      * });
      * console.log(inserted.id);
+     *
+     * // Folder-scoped choice set: folderKey is required on the wire
+     * await choicesets.insertValueById(expenseTypes.id, 'TRAVEL', {
+     *   displayName: 'Travel',
+     *   folderKey: "<folderKey>",
+     * });
      * ```
      * @internal
      */
@@ -2852,6 +3034,7 @@ interface ChoiceSetServiceModel {
      * @param choiceSetId - UUID of the parent choice set
      * @param valueId - UUID of the value to update
      * @param displayName - New human-readable display name for the value
+     * @param options - Optional {@link ChoiceSetValueUpdateOptions} — pass `folderKey` for folder-scoped choice sets; omit for tenant-level. The `folderKey` property is **experimental**.
      * @returns Promise resolving to the updated value ({@link ChoiceSetValueUpdateResponse})
      *
      * @example
@@ -2863,15 +3046,21 @@ interface ChoiceSetServiceModel {
      * const travel = values.items.find(v => v.name === 'TRAVEL');
      *
      * await choicesets.updateValueById(expenseTypes.id, travel.id, 'Business Travel');
+     *
+     * // Folder-scoped choice set: folderKey is required on the wire
+     * await choicesets.updateValueById(expenseTypes.id, travel.id, 'Business Travel', {
+     *   folderKey: "<folderKey>",
+     * });
      * ```
      * @internal
      */
-    updateValueById(choiceSetId: string, valueId: string, displayName: string): Promise<ChoiceSetValueUpdateResponse>;
+    updateValueById(choiceSetId: string, valueId: string, displayName: string, options?: ChoiceSetValueUpdateOptions): Promise<ChoiceSetValueUpdateResponse>;
     /**
      * Deletes one or more values from a choice set.
      *
      * @param choiceSetId - UUID of the parent choice set
      * @param valueIds - Array of value UUIDs to delete
+     * @param options - Optional {@link ChoiceSetValueDeleteOptions} — pass `folderKey` for folder-scoped choice sets; omit for tenant-level The `folderKey` property is **experimental**.
      * @returns Promise resolving when the values are deleted
      *
      * @example
@@ -2881,16 +3070,25 @@ interface ChoiceSetServiceModel {
      * const idsToDelete = values.items.slice(0, 2).map(v => v.id);
      *
      * await choicesets.deleteValuesById('<choiceSetId>', idsToDelete);
+     *
+     * // Folder-scoped choice set
+     * await choicesets.deleteValuesById('<choiceSetId>', idsToDelete, { folderKey: "<folderKey>" });
      * ```
      * @internal
      */
-    deleteValuesById(choiceSetId: string, valueIds: string[]): Promise<void>;
+    deleteValuesById(choiceSetId: string, valueIds: string[], options?: ChoiceSetValueDeleteOptions): Promise<void>;
 }
 
 declare class ChoiceSetService extends BaseService implements ChoiceSetServiceModel {
     /**
-     * Gets all choice sets in the system
+     * Gets choice sets in the tenant.
+     *
+     * Three call modes:
+     * - `getAll()` — default. Returns only tenant-level choice sets.
+     * - `getAll({ folderKey: "<uuid>" })` — preferred for folder-scoped data. Returns only choice sets in that folder.
+     * - `getAll({ includeFolderChoiceSets: true })` — returns tenant-level **and** folder-level choice sets together. `folderKey` is preferred over `includeFolderChoiceSets` when both are set.
      *
+     * @param options - Optional {@link ChoiceSetGetAllOptions} (`folderKey` to list a single folder's choice sets — preferred when scoping to a folder; `includeFolderChoiceSets: true` to list tenant + folder choice sets together) The `folderKey` property is **experimental**.
      * @returns Promise resolving to an array of choice set metadata
      *
      * @example
@@ -2899,17 +3097,23 @@ declare class ChoiceSetService extends BaseService implements ChoiceSetServiceMo
      *
      * const choiceSets = new ChoiceSets(sdk);
      *
-     * // Get all choice sets
-     * const allChoiceSets = await choiceSets.getAll();
+     * // Tenant-only (default)
+     * const tenantChoiceSets = await choiceSets.getAll();
      *
-     * // Iterate through choice sets
-     * allChoiceSets.forEach(choiceSet => {
-     *   console.log(`ChoiceSet: ${choiceSet.displayName} (${choiceSet.name})`);
-     *   console.log(`Description: ${choiceSet.description}`);
-     * });
+     * // A single folder's choice sets (preferred when targeting a specific folder)
+     * const folderChoiceSets = await choiceSets.getAll({ folderKey: "<folderKey>" });
+     *
+     * // Tenant + folder choice sets together
+     * const allChoiceSets = await choiceSets.getAll({ includeFolderChoiceSets: true });
      * ```
      */
-    getAll(): Promise<ChoiceSetGetAllResponse[]>;
+    getAll(options?: ChoiceSetGetAllOptions): Promise<ChoiceSetGetAllResponse[]>;
+    /**
+     * Internal helper that performs the choice-set fetch. Kept separate from the
+     * public `getAll()` so that internal callers (e.g. `resolveChoiceSetName`)
+     * can reuse it without triggering double `@track` telemetry.
+     */
+    private fetchAllChoiceSets;
     /**
      * Gets choice set values by choice set ID with optional pagination
      *
@@ -2918,7 +3122,7 @@ declare class ChoiceSetService extends BaseService implements ChoiceSetServiceMo
      * - A PaginatedResponse with navigation cursors (when any pagination parameter is provided)
      *
      * @param choiceSetId - UUID of the choice set
-     * @param options - Pagination options
+     * @param options - Pagination options and optional `folderKey` for folder-scoped choice sets The `folderKey` property is **experimental**.
      * @returns Promise resolving to choice set values or paginated result
      *
      * @example
@@ -2947,6 +3151,9 @@ declare class ChoiceSetService extends BaseService implements ChoiceSetServiceMo
      * if (page1.hasNextPage) {
      *   const page2 = await choiceSets.getById(choiceSetId, { cursor: page1.nextCursor });
      * }
+     *
+     * // Folder-scoped choice set
+     * const folderValues = await choiceSets.getById(choiceSetId, { folderKey: "<folderKey>" });
      * ```
      */
     getById<T extends ChoiceSetGetByIdOptions = ChoiceSetGetByIdOptions>(choiceSetId: string, options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<ChoiceSetGetResponse> : NonPaginatedResponse<ChoiceSetGetResponse>>;
@@ -2956,7 +3163,7 @@ declare class ChoiceSetService extends BaseService implements ChoiceSetServiceMo
      * @param name - Choice set name. Must start with a
      *   letter, may contain only letters, numbers, and underscores, length
      *   3–100 characters (e.g., `"expenseTypes"`).
-     * @param options - Optional choice-set-level settings ({@link ChoiceSetCreateOptions})
+     * @param options - Optional choice-set-level settings ({@link ChoiceSetCreateOptions}) The `folderKey` property is **experimental**.
      * @returns Promise resolving to the UUID of the created choice set
      *
      * @example
@@ -2984,7 +3191,7 @@ declare class ChoiceSetService extends BaseService implements ChoiceSetServiceMo
      * the call throws `ValidationError` if both are omitted.
      *
      * @param choiceSetId - UUID of the choice set to update
-     * @param options - Metadata fields to change ({@link ChoiceSetUpdateOptions})
+     * @param options - Metadata fields to change ({@link ChoiceSetUpdateOptions}) The `folderKey` property is **experimental**.
      * @returns Promise resolving when the update is complete
      *
      * @example
@@ -3005,6 +3212,7 @@ declare class ChoiceSetService extends BaseService implements ChoiceSetServiceMo
      * Deletes a Data Fabric choice set and all its values.
      *
      * @param choiceSetId - UUID of the choice set to delete
+     * @param options - Optional {@link ChoiceSetDeleteByIdOptions} (e.g. `folderKey` for folder-scoped choice sets) The `folderKey` property is **experimental**.
      * @returns Promise resolving when the choice set is deleted
      *
      * @example
@@ -3014,16 +3222,19 @@ declare class ChoiceSetService extends BaseService implements ChoiceSetServiceMo
      * const expenseTypes = allChoiceSets.find(cs => cs.name === 'expense_types');
      *
      * await choicesets.deleteById(expenseTypes.id);
+     *
+     * // Folder-scoped choice set
+     * await choicesets.deleteById(expenseTypes.id, { folderKey: "<folderKey>" });
      * ```
      * @internal
      */
-    deleteById(choiceSetId: string): Promise<void>;
+    deleteById(choiceSetId: string, options?: ChoiceSetDeleteByIdOptions): Promise<void>;
     /**
      * Inserts a single value into a choice set.
      *
      * @param choiceSetId - UUID of the parent choice set
      * @param name - Identifier name of the new value (e.g., `"TRAVEL"`)
-     * @param options - Optional fields ({@link ChoiceSetValueInsertOptions})
+     * @param options - Optional fields ({@link ChoiceSetValueInsertOptions}) The `folderKey` property is **experimental**.
      * @returns Promise resolving to the inserted value ({@link ChoiceSetValueInsertResponse})
      *
      * @example
@@ -3036,6 +3247,12 @@ declare class ChoiceSetService extends BaseService implements ChoiceSetServiceMo
      *   displayName: 'Travel',
      * });
      * console.log(inserted.id);
+     *
+     * // Folder-scoped choice set: folderKey is required on the wire
+     * await choicesets.insertValueById(expenseTypes.id, 'TRAVEL', {
+     *   displayName: 'Travel',
+     *   folderKey: "<folderKey>",
+     * });
      * ```
      * @internal
      */
@@ -3049,6 +3266,7 @@ declare class ChoiceSetService extends BaseService implements ChoiceSetServiceMo
      * @param choiceSetId - UUID of the parent choice set
      * @param valueId - UUID of the value to update
      * @param displayName - New human-readable display name for the value
+     * @param options - Optional {@link ChoiceSetValueUpdateOptions} — pass `folderKey` for folder-scoped choice sets; omit for tenant-level. The `folderKey` property is **experimental**.
      * @returns Promise resolving to the updated value ({@link ChoiceSetValueUpdateResponse})
      *
      * @example
@@ -3060,15 +3278,21 @@ declare class ChoiceSetService extends BaseService implements ChoiceSetServiceMo
      * const travel = values.items.find(v => v.name === 'TRAVEL');
      *
      * await choicesets.updateValueById(expenseTypes.id, travel.id, 'Business Travel');
+     *
+     * // Folder-scoped choice set: folderKey is required on the wire
+     * await choicesets.updateValueById(expenseTypes.id, travel.id, 'Business Travel', {
+     *   folderKey: "<folderKey>",
+     * });
      * ```
      * @internal
      */
-    updateValueById(choiceSetId: string, valueId: string, displayName: string): Promise<ChoiceSetValueUpdateResponse>;
+    updateValueById(choiceSetId: string, valueId: string, displayName: string, options?: ChoiceSetValueUpdateOptions): Promise<ChoiceSetValueUpdateResponse>;
     /**
      * Deletes one or more values from a choice set.
      *
      * @param choiceSetId - UUID of the parent choice set
      * @param valueIds - Array of value UUIDs to delete
+     * @param options - Optional {@link ChoiceSetValueDeleteOptions} (e.g. `folderKey` for folder-scoped choice sets) The `folderKey` property is **experimental**.
      * @returns Promise resolving when the values are deleted
      *
      * @example
@@ -3078,10 +3302,13 @@ declare class ChoiceSetService extends BaseService implements ChoiceSetServiceMo
      * const idsToDelete = values.items.slice(0, 2).map(v => v.id);
      *
      * await choicesets.deleteValuesById('<choiceSetId>', idsToDelete);
+     *
+     * // Folder-scoped choice set
+     * await choicesets.deleteValuesById('<choiceSetId>', idsToDelete, { folderKey: "<folderKey>" });
      * ```
      * @internal
      */
-    deleteValuesById(choiceSetId: string, valueIds: string[]): Promise<void>;
+    deleteValuesById(choiceSetId: string, valueIds: string[], options?: ChoiceSetValueDeleteOptions): Promise<void>;
     private resolveChoiceSetName;
 }
 
@@ -5056,22 +5283,49 @@ interface RawTaskGetResponse extends TaskBaseResponse {
     actionLabel?: string | null;
     taskSlaDetails?: TaskSlaDetail[] | null;
     completedByUser?: UserLoginInfo | null;
-    taskAssignmentCriteria?: string;
+    taskAssignmentCriteria?: TaskAssignmentCriteria;
     taskAssignees?: UserLoginInfo[] | null;
     taskSource?: TaskSource | null;
     processingTime?: number | null;
     data?: Record<string, unknown> | null;
 }
+/**
+ * Defines how a task assignment is distributed.
+ *
+ * Defaults to {@link TaskAssignmentCriteria.SingleUser} (a direct single-user
+ * assignment) when not specified. The group-based criteria tell Action Center
+ * how to distribute the task across the members of a directory group.
+ */
+declare enum TaskAssignmentCriteria {
+    /** Assigned to a single user, like a direct assignment. */
+    SingleUser = "SingleUser",
+    /** Assigned to the group member with the fewest pending tasks. */
+    Workload = "Workload",
+    /** Assigned to all users in the group. */
+    AllUsers = "AllUsers",
+    /** Assigned in a round-robin manner across the group's members. */
+    RoundRobin = "RoundRobin"
+}
 /**
  * Options for task assignment operations when called from a task instance
- * Requires either userId or userNameOrEmail, but not both
+ * Requires either userId or userNameOrEmail, but not both. Optionally accepts
+ * an assignment criteria; defaults to a single-user assignment, set a group
+ * criteria (e.g. {@link TaskAssignmentCriteria.AllUsers}) for a directory group.
  */
-type TaskAssignOptions = {
+type TaskAssignOptions = ({
     userId: number;
     userNameOrEmail?: never;
 } | {
     userId?: never;
     userNameOrEmail: string;
+}) & {
+    /**
+     * How the assignment is distributed. Optional — defaults to
+     * {@link TaskAssignmentCriteria.SingleUser} (a direct single-user assignment).
+     * Set a group criteria (e.g. {@link TaskAssignmentCriteria.AllUsers}) to
+     * distribute the task across a directory group's members.
+     */
+    assignmentCriteria?: TaskAssignmentCriteria;
 };
 /**
  * Options for task assignment operations when called from the service
@@ -5291,6 +5545,26 @@ interface TaskServiceModel {
      *   { taskId: <taskId2>, userNameOrEmail: "user@example.com" }
      * ]);
      * ```
+     *
+     * @example Group assignment
+     * ```typescript
+     * import { TaskAssignmentCriteria } from '@uipath/uipath-typescript/tasks';
+     *
+     * // Assign to a directory group by userId + criteria — Action Center
+     * // distributes the task across the group's members based on the criteria
+     * const result = await tasks.assign({
+     *   taskId: <taskId>,
+     *   userId: <groupId>, // a DirectoryGroup id from tasks.getUsers()
+     *   assignmentCriteria: TaskAssignmentCriteria.AllUsers
+     * });
+     *
+     * // ...or identify the group by name instead of id
+     * const result2 = await tasks.assign({
+     *   taskId: <taskId>,
+     *   userNameOrEmail: "<groupName>",
+     *   assignmentCriteria: TaskAssignmentCriteria.AllUsers
+     * });
+     * ```
      */
     assign(options: TaskAssignmentOptions | TaskAssignmentOptions[]): Promise<OperationResponse<TaskAssignmentOptions[] | TaskAssignmentResponse[]>>;
     /**
@@ -5325,6 +5599,25 @@ interface TaskServiceModel {
      *   { taskId: <taskId2>, userNameOrEmail: "user@example.com" }
      * ]);
      * ```
+     *
+     * @example Group reassignment
+     * ```typescript
+     * import { TaskAssignmentCriteria } from '@uipath/uipath-typescript/tasks';
+     *
+     * // Reassign to a directory group by userId + criteria
+     * const result = await tasks.reassign({
+     *   taskId: <taskId>,
+     *   userId: <groupId>, // a DirectoryGroup id from tasks.getUsers()
+     *   assignmentCriteria: TaskAssignmentCriteria.AllUsers
+     * });
+     *
+     * // ...or identify the group by name instead of id
+     * const result2 = await tasks.reassign({
+     *   taskId: <taskId>,
+     *   userNameOrEmail: "<groupName>",
+     *   assignmentCriteria: TaskAssignmentCriteria.AllUsers
+     * });
+     * ```
      */
     reassign(options: TaskAssignmentOptions | TaskAssignmentOptions[]): Promise<OperationResponse<TaskAssignmentOptions[] | TaskAssignmentResponse[]>>;
     /**
@@ -7197,10 +7490,6 @@ interface BucketGetUriOptions extends BaseOptions {
      * The ID of the bucket
      */
     bucketId: number;
-    /**
-     * The ID of the folder
-     */
-    folderId: number;
     /**
      * The full path to the BlobFile
      */
@@ -7211,9 +7500,23 @@ interface BucketGetUriOptions extends BaseOptions {
     expiryInMinutes?: number;
 }
 /**
- * Request options for getting a read URI for a file in a bucket
+ * Optional parameters for the preferred `getReadUri(bucketId, path, options?)` form.
+ * Contains folder scoping (`folderId` / `folderKey` / `folderPath`),
+ * `expiryInMinutes`, and standard query options (`expand`, `select`).
+ */
+interface BucketGetReadUriRequestOptions extends BaseOptions, FolderScopedOptions {
+    /**
+     * URL expiration time in minutes (0 for default)
+     */
+    expiryInMinutes?: number;
+}
+/**
+ * @deprecated Use the positional form: `getReadUri(bucketId, path, options?)`.
+ * See {@link BucketGetReadUriRequestOptions} for the supported options.
+ *
+ * Request options for getting a read URI for a file in a bucket.
  */
-interface BucketGetReadUriOptions extends BucketGetUriOptions {
+interface BucketGetReadUriOptions extends BucketGetUriOptions, FolderScopedOptions {
 }
 /**
  * Request options for getting files in a bucket
@@ -7227,7 +7530,7 @@ interface BucketGetFileMetaDataOptions {
 /**
  * Request options for getting files in a bucket with pagination support
  */
-type BucketGetFileMetaDataWithPaginationOptions = BucketGetFileMetaDataOptions & PaginationOptions;
+type BucketGetFileMetaDataWithPaginationOptions = BucketGetFileMetaDataOptions & PaginationOptions & FolderScopedOptions;
 /**
  * Response from the GetFiles API
  */
@@ -7302,17 +7605,23 @@ type BucketGetFilesOptions = RequestOptions & PaginationOptions & FolderScopedOp
 interface BucketDeleteFileOptions extends FolderScopedOptions {
 }
 /**
- * Options for uploading files to a bucket
+ * Optional parameters for the preferred
+ * `uploadFile(bucketId, path, content, options?)` form. Contains folder
+ * scoping (`folderId` / `folderKey` / `folderPath`).
+ */
+interface BucketUploadFileRequestOptions extends FolderScopedOptions {
+}
+/**
+ * @deprecated Use the positional form: `uploadFile(bucketId, path, content, options?)`.
+ * See {@link BucketUploadFileRequestOptions} for the supported options.
+ *
+ * Options for uploading files to a bucket.
  */
-interface BucketUploadFileOptions {
+interface BucketUploadFileOptions extends FolderScopedOptions {
     /**
      * The ID of the bucket to upload to
      */
     bucketId: number;
-    /**
-     * The folder/organization unit ID for context
-     */
-    folderId: number;
     /**
      * Path where the file should be stored in the bucket
      */
@@ -7430,81 +7739,128 @@ interface BucketServiceModel {
      */
     getByName(name: string, options?: BucketGetByNameOptions): Promise<BucketGetResponse>;
     /**
-     * Gets metadata for files in a bucket with optional filtering and pagination
+     * Gets metadata for files in a bucket with optional filtering and pagination.
+     *
+     * Folder context can be supplied as `folderId`, `folderKey`, or `folderPath`
+     * inside the options.
      *
      * The method returns either:
      * - A NonPaginatedResponse with items array (when no pagination parameters are provided)
      * - A PaginatedResponse with navigation cursors (when any pagination parameter is provided)
      *
      * @param bucketId - The ID of the bucket to get file metadata from
-     * @param folderId - Required folder ID for organization unit context
-     * @param options - Optional parameters for filtering, pagination and access URL generation
+     * @param options - Folder scoping (`folderId` / `folderKey` / `folderPath`) and optional parameters for filtering and pagination
      * @returns Promise resolving to either an array of files metadata NonPaginatedResponse<BlobItem> or a PaginatedResponse<BlobItem> when pagination options are used.
      * {@link BlobItem}
      * @example
      * ```typescript
-     * // Get metadata for all files in a bucket
-     * const fileMetadata = await buckets.getFileMetaData(<bucketId>, <folderId>);
+     * // By folder ID
+     * const fileMetadata = await buckets.getFileMetaData(<bucketId>, { folderId: <folderId> });
      *
-     * // Get file metadata with a specific prefix
-     * const prefixMetadata = await buckets.getFileMetaData(<bucketId>, <folderId>, {
-     *   prefix: '/folder1'
-     * });
+     * // By folder key (GUID)
+     * await buckets.getFileMetaData(<bucketId>, { folderKey: '5f6dadf1-3677-49dc-8aca-c2999dd4b3ba' });
+     *
+     * // By folder path
+     * await buckets.getFileMetaData(<bucketId>, { folderPath: 'Shared/Finance' });
+     *
+     * // Filter by prefix
+     * await buckets.getFileMetaData(<bucketId>, { folderId: <folderId>, prefix: '/folder1' });
      *
      * // First page with pagination
-     * const page1 = await buckets.getFileMetaData(<bucketId>, <folderId>, { pageSize: 10 });
+     * const page1 = await buckets.getFileMetaData(<bucketId>, { folderId: <folderId>, pageSize: 10 });
      *
      * // Navigate using cursor
      * if (page1.hasNextPage) {
-     *   const page2 = await buckets.getFileMetaData(<bucketId>, <folderId>, { cursor: page1.nextCursor });
+     *   const page2 = await buckets.getFileMetaData(<bucketId>, { folderId: <folderId>, cursor: page1.nextCursor });
      * }
      * ```
      */
+    getFileMetaData<T extends BucketGetFileMetaDataWithPaginationOptions = BucketGetFileMetaDataWithPaginationOptions>(bucketId: number, options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<BlobItem> : NonPaginatedResponse<BlobItem>>;
+    /**
+     * Gets metadata for files in a bucket — positional `folderId` form.
+     *
+     * @deprecated Use the options-object form: `getFileMetaData(bucketId, { folderId })`. See {@link BucketGetFileMetaDataWithPaginationOptions} for the supported options.
+     *
+     * @param bucketId - The ID of the bucket to get file metadata from
+     * @param folderId - Required folder ID (numeric)
+     * @param options - Optional parameters for filtering and pagination
+     * @returns Promise resolving to either an array of files metadata NonPaginatedResponse<BlobItem> or a PaginatedResponse<BlobItem> when pagination options are used.
+     * {@link BlobItem}
+     */
     getFileMetaData<T extends BucketGetFileMetaDataWithPaginationOptions = BucketGetFileMetaDataWithPaginationOptions>(bucketId: number, folderId: number, options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<BlobItem> : NonPaginatedResponse<BlobItem>>;
     /**
-     * Gets a direct download URL for a file in the bucket
+     * Gets a direct download URL for a file in the bucket.
+     *
+     * Folder context can be supplied as `folderId`, `folderKey`, or `folderPath`
+     * in the options.
      *
-     * @param options - Contains bucketId, folderId, file path and optional expiry time
+     * @param bucketId - The ID of the bucket
+     * @param path - The full path to the file
+     * @param options - Folder scoping (`folderId` / `folderKey` / `folderPath`) and optional `expiryInMinutes`
      * @returns Promise resolving to blob file access information
      * {@link BucketGetUriResponse}
      * @example
      * ```typescript
-     * // Get download URL for a file
-     * const fileAccess = await buckets.getReadUri({
-     *   bucketId: <bucketId>,
-     *   folderId: <folderId>,
-     *   path: '/folder/file.pdf'
-     * });
+     * // By folder ID
+     * await buckets.getReadUri(<bucketId>, '/folder/file.pdf', { folderId: <folderId> });
+     *
+     * // By folder key (GUID)
+     * await buckets.getReadUri(<bucketId>, '/folder/file.pdf', { folderKey: '5f6dadf1-3677-49dc-8aca-c2999dd4b3ba' });
+     *
+     * // By folder path
+     * await buckets.getReadUri(<bucketId>, '/folder/file.pdf', { folderPath: 'Shared/Finance' });
      * ```
      */
+    getReadUri(bucketId: number, path: string, options?: BucketGetReadUriRequestOptions): Promise<BucketGetUriResponse>;
+    /**
+     * Gets a direct download URL for a file in the bucket — options-only form.
+     *
+     * @deprecated Use the positional form: `getReadUri(bucketId, path, options?)`. See {@link BucketGetReadUriRequestOptions} for the supported options.
+     *
+     * @param options - Contains bucketId, folder scoping (`folderId` / `folderKey` / `folderPath`), file path and optional expiry time
+     * @returns Promise resolving to blob file access information
+     * {@link BucketGetUriResponse}
+     */
     getReadUri(options: BucketGetReadUriOptions): Promise<BucketGetUriResponse>;
     /**
-     * Uploads a file to a bucket
+     * Uploads a file to a bucket.
+     *
+     * Folder context can be supplied as `folderId`, `folderKey`, or `folderPath`
+     * in the options.
      *
-     * @param options - Options for file upload including bucket ID, folder ID, path, content, and optional parameters
+     * @param bucketId - The ID of the bucket to upload to
+     * @param path - Path where the file should be stored in the bucket
+     * @param content - File content to upload
+     * @param options - Folder scoping (`folderId` / `folderKey` / `folderPath`)
      * @returns Promise resolving bucket upload response
      * {@link BucketUploadResponse}
      * @example
      * ```typescript
-     * // Upload a file from browser
+     * // By folder ID
      * const file = new File(['file content'], 'example.txt');
-     * const result = await buckets.uploadFile({
-     *   bucketId: <bucketId>,
-     *   folderId: <folderId>,
-     *   path: '/folder/example.txt',
-     *   content: file
-     * });
+     * await buckets.uploadFile(<bucketId>, '/folder/example.txt', file, { folderId: <folderId> });
+     *
+     * // By folder key (GUID)
+     * await buckets.uploadFile(<bucketId>, '/folder/example.txt', file, { folderKey: '5f6dadf1-3677-49dc-8aca-c2999dd4b3ba' });
+     *
+     * // By folder path
+     * await buckets.uploadFile(<bucketId>, '/folder/example.txt', file, { folderPath: 'Shared/Finance' });
      *
      * // In Node env with Uint8Array or Buffer
      * const content = new TextEncoder().encode('file content');
-     * const result = await buckets.uploadFile({
-     *   bucketId: <bucketId>,
-     *   folderId: <folderId>,
-     *   path: '/folder/example.txt',
-     *   content,
-     * });
+     * await buckets.uploadFile(<bucketId>, '/folder/example.txt', content, { folderId: <folderId> });
      * ```
      */
+    uploadFile(bucketId: number, path: string, content: Blob | Uint8Array<ArrayBuffer> | File, options?: BucketUploadFileRequestOptions): Promise<BucketUploadResponse>;
+    /**
+     * Uploads a file to a bucket — options-only form.
+     *
+     * @deprecated Use the positional form: `uploadFile(bucketId, path, content, options?)`. See {@link BucketUploadFileRequestOptions} for the supported options.
+     *
+     * @param options - Options for file upload including bucket ID, folder scoping (`folderId` / `folderKey` / `folderPath`), path, and content
+     * @returns Promise resolving bucket upload response
+     * {@link BucketUploadResponse}
+     */
     uploadFile(options: BucketUploadFileOptions): Promise<BucketUploadResponse>;
     /**
      * Deletes a file from a bucket
@@ -7655,16 +8011,19 @@ declare class BucketService extends FolderScopedService implements BucketService
      */
     getAll<T extends BucketGetAllOptions = BucketGetAllOptions>(options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<BucketGetResponse> : NonPaginatedResponse<BucketGetResponse>>;
     /**
-     * Gets metadata for files in a bucket with optional filtering and pagination
+     * Gets metadata for files in a bucket with optional filtering and pagination.
+     *
+     * Folder context can be supplied as `folderId`, `folderKey`, or `folderPath`
+     * inside the options.
      *
      * The method returns either:
      * - A NonPaginatedResponse with items array (when no pagination parameters are provided)
      * - A PaginatedResponse with navigation cursors (when any pagination parameter is provided)
      *
      * @param bucketId - The ID of the bucket to get file metadata from
-     * @param folderId - Required folder ID for organization unit context
-     * @param options - Optional parameters for filtering, pagination and access URL generation
+     * @param options - Folder scoping (`folderId` / `folderKey` / `folderPath`) and optional parameters for filtering and pagination
      * @returns Promise resolving to the list of file metadata in the bucket or paginated result
+     * {@link BlobItem}
      *
      * @example
      * ```typescript
@@ -7672,29 +8031,52 @@ declare class BucketService extends FolderScopedService implements BucketService
      *
      * const buckets = new Buckets(sdk);
      *
-     * // Get metadata for all files in a bucket
-     * const fileMetadata = await buckets.getFileMetaData(123, 456);
+     * // By folder ID
+     * const fileMetadata = await buckets.getFileMetaData(<bucketId>, { folderId: <folderId> });
      *
-     * // Get file metadata with a specific prefix
-     * const fileMetadata = await buckets.getFileMetaData(123, 456, {
-     *   prefix: '/folder1'
-     * });
+     * // By folder key (GUID)
+     * await buckets.getFileMetaData(<bucketId>, { folderKey: '5f6dadf1-3677-49dc-8aca-c2999dd4b3ba' });
+     *
+     * // By folder path
+     * await buckets.getFileMetaData(<bucketId>, { folderPath: 'Shared/Finance' });
+     *
+     * // Filter by prefix
+     * await buckets.getFileMetaData(<bucketId>, { folderId: <folderId>, prefix: '/folder1' });
      *
      * // First page with pagination
-     * const page1 = await buckets.getFileMetaData(123, 456, { pageSize: 10 });
+     * const page1 = await buckets.getFileMetaData(<bucketId>, { folderId: <folderId>, pageSize: 10 });
      *
      * // Navigate using cursor
      * if (page1.hasNextPage) {
-     *   const page2 = await buckets.getFileMetaData(123, 456, { cursor: page1.nextCursor });
+     *   const page2 = await buckets.getFileMetaData(<bucketId>, { folderId: <folderId>, cursor: page1.nextCursor });
      * }
      * ```
      */
+    getFileMetaData<T extends BucketGetFileMetaDataWithPaginationOptions = BucketGetFileMetaDataWithPaginationOptions>(bucketId: number, options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<BlobItem> : NonPaginatedResponse<BlobItem>>;
+    /**
+     * Gets metadata for files in a bucket — positional `folderId` form.
+     *
+     * @deprecated Use the options-object form: `getFileMetaData(bucketId, { folderId })`. See {@link BucketGetFileMetaDataWithPaginationOptions} for the supported options.
+     *
+     * @param bucketId - The ID of the bucket to get file metadata from
+     * @param folderId - Required folder ID (numeric)
+     * @param options - Optional parameters for filtering and pagination
+     * @returns Promise resolving to the list of file metadata in the bucket or paginated result
+     * {@link BlobItem}
+     */
     getFileMetaData<T extends BucketGetFileMetaDataWithPaginationOptions = BucketGetFileMetaDataWithPaginationOptions>(bucketId: number, folderId: number, options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<BlobItem> : NonPaginatedResponse<BlobItem>>;
     /**
-     * Uploads a file to a bucket
+     * Uploads a file to a bucket.
+     *
+     * Folder context can be supplied as `folderId`, `folderKey`, or `folderPath`
+     * in the options.
      *
-     * @param options - Options for file upload including bucket ID, folder ID, path, content, and optional parameters
+     * @param bucketId - The ID of the bucket to upload to
+     * @param path - Path where the file should be stored in the bucket
+     * @param content - File content to upload
+     * @param options - Folder scoping (`folderId` / `folderKey` / `folderPath`)
      * @returns Promise resolving to a response with success status and HTTP status code
+     * {@link BucketUploadResponse}
      *
      * @example
      * ```typescript
@@ -7702,31 +8084,43 @@ declare class BucketService extends FolderScopedService implements BucketService
      *
      * const buckets = new Buckets(sdk);
      *
-     * // Upload a file from browser
+     * // By folder ID
      * const file = new File(['file content'], 'example.txt');
-     * const result = await buckets.uploadFile({
-     *   bucketId: 123,
-     *   folderId: 456,
-     *   path: '/folder/example.txt',
-     *   content: file
-     * });
+     * await buckets.uploadFile(<bucketId>, '/folder/example.txt', file, { folderId: <folderId> });
+     *
+     * // By folder key (GUID)
+     * await buckets.uploadFile(<bucketId>, '/folder/example.txt', file, { folderKey: '5f6dadf1-3677-49dc-8aca-c2999dd4b3ba' });
+     *
+     * // By folder path
+     * await buckets.uploadFile(<bucketId>, '/folder/example.txt', file, { folderPath: 'Shared/Finance' });
      *
      * // In Node env with Buffer
      * const buffer = Buffer.from('file content');
-     * const result = await buckets.uploadFile({
-     *   bucketId: 123,
-     *   folderId: 456,
-     *   path: '/folder/example.txt',
-     *   content: buffer
-     * });
+     * await buckets.uploadFile(<bucketId>, '/folder/example.txt', buffer, { folderId: <folderId> });
      * ```
      */
+    uploadFile(bucketId: number, path: string, content: Blob | Uint8Array<ArrayBuffer> | File, options?: BucketUploadFileRequestOptions): Promise<BucketUploadResponse>;
+    /**
+     * Uploads a file to a bucket — options-only form.
+     *
+     * @deprecated Use the positional form: `uploadFile(bucketId, path, content, options?)`. See {@link BucketUploadFileRequestOptions} for the supported options.
+     *
+     * @param options - Options for file upload including bucket ID, folder scoping (`folderId` / `folderKey` / `folderPath`), path, and content
+     * @returns Promise resolving to a response with success status and HTTP status code
+     * {@link BucketUploadResponse}
+     */
     uploadFile(options: BucketUploadFileOptions): Promise<BucketUploadResponse>;
     /**
-     * Gets a direct download URL for a file in the bucket
+     * Gets a direct download URL for a file in the bucket.
+     *
+     * Folder context can be supplied as `folderId`, `folderKey`, or `folderPath`
+     * inside the options.
      *
-     * @param options - Contains bucketId, folderId, file path and optional expiry time
+     * @param bucketId - The ID of the bucket
+     * @param path - The full path to the file
+     * @param options - Folder scoping (`folderId` / `folderKey` / `folderPath`) and optional `expiryInMinutes`
      * @returns Promise resolving to blob file access information
+     * {@link BucketGetUriResponse}
      *
      * @example
      * ```typescript
@@ -7734,14 +8128,26 @@ declare class BucketService extends FolderScopedService implements BucketService
      *
      * const buckets = new Buckets(sdk);
      *
-     * // Get download URL for a file
-     * const fileAccess = await buckets.getReadUri({
-     *   bucketId: 123,
-     *   folderId: 456,
-     *   path: '/folder/file.pdf'
-     * });
+     * // By folder ID
+     * await buckets.getReadUri(<bucketId>, '/folder/file.pdf', { folderId: <folderId> });
+     *
+     * // By folder key (GUID)
+     * await buckets.getReadUri(<bucketId>, '/folder/file.pdf', { folderKey: '5f6dadf1-3677-49dc-8aca-c2999dd4b3ba' });
+     *
+     * // By folder path
+     * await buckets.getReadUri(<bucketId>, '/folder/file.pdf', { folderPath: 'Shared/Finance' });
      * ```
      */
+    getReadUri(bucketId: number, path: string, options?: BucketGetReadUriRequestOptions): Promise<BucketGetUriResponse>;
+    /**
+     * Gets a direct download URL for a file in the bucket — options-only form.
+     *
+     * @deprecated Use the positional form: `getReadUri(bucketId, path, options?)`. See {@link BucketGetReadUriRequestOptions} for the supported options.
+     *
+     * @param options - Contains bucketId, folder scoping (`folderId` / `folderKey` / `folderPath`), file path and optional expiry time
+     * @returns Promise resolving to blob file access information
+     * {@link BucketGetUriResponse}
+     */
     getReadUri(options: BucketGetReadUriOptions): Promise<BucketGetUriResponse>;
     /**
      * Uploads content to the provided URI
@@ -7754,8 +8160,8 @@ declare class BucketService extends FolderScopedService implements BucketService
      * Private method to handle common URI request logic
      * @param endpoint - The API endpoint to call
      * @param bucketId - The bucket ID
-     * @param folderId - The folder ID
      * @param path - The file path
+     * @param headers - Pre-built folder-context headers (built via `resolveFolderHeaders`)
      * @param queryOptions - Additional query parameters
      * @returns Promise resolving to blob file access information
      */
@@ -7829,7 +8235,7 @@ declare class BucketService extends FolderScopedService implements BucketService
     /**
      * Gets a direct upload URL for a file in the bucket
      *
-     * @param options - Contains bucketId, folderId, file path, optional expiry time
+     * @param options - Contains bucketId, file path, optional expiry time, and pre-built folder-context headers
      * @returns Promise resolving to blob file access information
      */
     private _getWriteUri;
@@ -9339,6 +9745,26 @@ declare class TaskService extends BaseService implements TaskServiceModel {
      *   }
      * ]);
      * ```
+     *
+     * @example Group assignment
+     * ```typescript
+     * import { TaskAssignmentCriteria } from '@uipath/uipath-typescript/tasks';
+     *
+     * // Assign to a directory group by userId + criteria — Action Center
+     * // distributes the task across the group's members based on the criteria
+     * const result = await tasks.assign({
+     *   taskId: 123,
+     *   userId: 456, // a DirectoryGroup id from tasks.getUsers()
+     *   assignmentCriteria: TaskAssignmentCriteria.AllUsers
+     * });
+     *
+     * // ...or identify the group by name instead of id
+     * const result2 = await tasks.assign({
+     *   taskId: 123,
+     *   userNameOrEmail: "My Group",
+     *   assignmentCriteria: TaskAssignmentCriteria.AllUsers
+     * });
+     * ```
      */
     assign(taskAssignments: TaskAssignmentOptions | TaskAssignmentOptions[]): Promise<OperationResponse<TaskAssignmentOptions[] | TaskAssignmentResponse[]>>;
     /**
@@ -9377,6 +9803,25 @@ declare class TaskService extends BaseService implements TaskServiceModel {
      *   }
      * ]);
      * ```
+     *
+     * @example Group reassignment
+     * ```typescript
+     * import { TaskAssignmentCriteria } from '@uipath/uipath-typescript/tasks';
+     *
+     * // Reassign to a directory group by userId + criteria
+     * const result = await tasks.reassign({
+     *   taskId: 123,
+     *   userId: 456, // a DirectoryGroup id from tasks.getUsers()
+     *   assignmentCriteria: TaskAssignmentCriteria.AllUsers
+     * });
+     *
+     * // ...or identify the group by name instead of id
+     * const result2 = await tasks.reassign({
+     *   taskId: 123,
+     *   userNameOrEmail: "My Group",
+     *   assignmentCriteria: TaskAssignmentCriteria.AllUsers
+     * });
+     * ```
      */
     reassign(taskAssignments: TaskAssignmentOptions | TaskAssignmentOptions[]): Promise<OperationResponse<TaskAssignmentOptions[] | TaskAssignmentResponse[]>>;
     /**
@@ -9569,145 +10014,633 @@ type MetaTagConfig = PartialUiPathConfig & {
  */
 declare function loadFromMetaTags(): MetaTagConfig | null;
 
-/**
- * Constants for Conversational Agent
- */
-/**
- * Maps API response fields to SDK field names (API → SDK)
- * Used when transforming API responses for SDK consumers.
- * For request transformation (SDK → API), use `transformRequest(data, ConversationMap)`.
- */
-declare const ConversationMap: {
-    [key: string]: string;
-};
-/**
- * Maps API filter param names (left) to SDK-facing names (right) for the conversation list endpoint.
- * Used by `getAll` to translate SDK filters to the field names the backend expects. Kept separate
- * from `ConversationMap` because `label`/`search` would otherwise collide with the `label` field
- * on create/update payloads.
- */
-declare const ConversationGetAllFilterMap: {
-    [key: string]: string;
-};
-/**
- * Maps fields for Exchange entity to ensure consistent SDK naming
- */
-declare const ExchangeMap: {
-    [key: string]: string;
-};
-/**
- * Maps fields for Message entity to ensure consistent SDK naming
- */
-declare const MessageMap: {
-    [key: string]: string;
-};
-
-/**
- * Common types for Conversational Agent
- * Contains IDs, primitives, and utility types used across conversation types.
- */
-/**
- * Identifies the origin of a message in the conversation.
- */
-declare enum MessageRole {
-    System = "system",
-    User = "user",
-    Assistant = "assistant"
-}
-/**
- * Identifies the type of an interrupt.
- */
-declare enum InterruptType {
-    ToolCallConfirmation = "uipath_cas_tool_call_confirmation"
+declare enum ComparisonOperator {
+    Equals = "Equals",
+    NotEquals = "NotEquals",
+    Greater = "Greater",
+    Less = "Less",
+    GreaterOrEqual = "GreaterOrEqual",
+    LessOrEqual = "LessOrEqual"
 }
-/**
- * Base interface for citation sources.
- */
-interface CitationSourceBase {
-    /**
-     * Title for the citation source, suitable for display to users.
-     */
-    title: string;
-    /**
-     * Label number for the citation source, suitable for display to users
-     * (e.g. [1] for the first unique source, [2] for the second, etc.).
-     */
-    number: number;
+declare enum Criticality {
+    Must = "Must",
+    Should = "Should"
 }
-/**
- * Used when the citation can be rendered as a link.
- */
-interface CitationSourceUrl extends CitationSourceBase {
-    /**
-     * Citation url.
-     */
-    url: string;
+declare enum FieldType {
+    Text = "Text",
+    Number = "Number",
+    Date = "Date",
+    Name = "Name",
+    Address = "Address",
+    Keyword = "Keyword",
+    Set = "Set",
+    Boolean = "Boolean",
+    Table = "Table",
+    Internal = "Internal",
+    FieldGroup = "FieldGroup",
+    MonetaryQuantity = "MonetaryQuantity"
 }
-/**
- * Used when the citation references media, such as a PDF document.
- */
-interface CitationSourceMedia extends CitationSourceBase {
-    /** The mime type of the media. If non-specified, should be discovered through the downloadUrl. */
-    mimeType?: string;
-    /** Download URL for the media */
-    downloadUrl?: string;
-    /** The page number for the media, if applicable (e.g. for application/pdf documents) */
-    pageNumber?: string;
+declare enum LogicalOperator {
+    AND = "AND",
+    OR = "OR"
 }
-/**
- * Citation sources can target either an Url or a media (e.g. a pdf document).
- * Repeated citation sources within a content part are identified by the same title and number.
- */
-type CitationSource = CitationSourceUrl | CitationSourceMedia;
-/**
- * JSON compatible primitive type.
- */
-type JSONPrimitive = string | number | boolean | null;
-/**
- * JSON compatible value type.
- */
-type JSONValue = JSONPrimitive | Record<string, any> | any[];
-/**
- * JSON compatible object type.
- */
-type JSONObject = Record<string, JSONValue>;
-/**
- * JSON compatible array type.
- */
-type JSONArray = JSONValue[];
-/**
- * An arbitrary JSON serializable object.
- */
-type MetaData = JSONObject;
-/**
- * Produces the provided object type with specified properties changed to optional.
- */
-type MakeOptional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
-/**
- * Produces the provided object type with specified properties changed to required.
- */
-type MakeRequired<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
-/**
- * Causes typescript to simplify the display of object types created using MakeOptional, MakeRequired, and other utility
- * types. This doesn't change the effective type, but makes popups in the ide and compile error messages cleaner.
- */
-type Simplify<T> = T extends any[] | Date ? T : {
-    [K in keyof T]: T[K];
-} & {};
-/**
- * Inline value - used when a value is small enough to be returned inline with an API result.
- */
-interface InlineValue<T> {
-    inline: T;
+declare enum RuleType {
+    Mandatory = "Mandatory",
+    PossibleValues = "PossibleValues",
+    Regex = "Regex",
+    StartsWith = "StartsWith",
+    EndsWith = "EndsWith",
+    FixedLength = "FixedLength",
+    IsNumeric = "IsNumeric",
+    IsDate = "IsDate",
+    IsEmail = "IsEmail",
+    Contains = "Contains",
+    Expression = "Expression",
+    TableExpression = "TableExpression",
+    IsEmpty = "IsEmpty"
 }
-/**
- * External value - used when a value is too large to be returned inline with an API result.
- */
-interface ExternalValue {
-    uri: string;
-    byteCount?: number;
+interface DataSource {
+    ResourceId?: string | null;
+    ElementFieldId?: string | null;
 }
-/**
+interface DocumentGroup {
+    Name?: string | null;
+    Categories?: string[] | null;
+}
+interface DocumentTaxonomy {
+    DataContractVersion?: string | null;
+    DocumentTypes?: DocumentTypeEntity[] | null;
+    Groups?: DocumentGroup[] | null;
+    SupportedLanguages?: LanguageInfo[] | null;
+    ReportAsExceptionSettings?: ReportAsExceptionSettings;
+}
+interface DocumentTypeEntity {
+    DocumentTypeId?: string | null;
+    Group?: string | null;
+    Category?: string | null;
+    Name?: string | null;
+    OptionalUniqueIdentifier?: string | null;
+    TypeField?: TypeField;
+    Fields?: Field[] | null;
+    Metadata?: MetadataEntry[] | null;
+}
+interface ExceptionReasonOption {
+    ExceptionReason?: string | null;
+}
+interface Field {
+    FieldId?: string | null;
+    FieldName?: string | null;
+    IsMultiValue?: boolean;
+    Type?: FieldType;
+    DeriveFieldsFormat?: string | null;
+    Components?: Field[] | null;
+    SetValues?: string[] | null;
+    Metadata?: MetadataEntry[] | null;
+    RuleSet?: RuleSet;
+    DefaultValue?: string | null;
+    DataSource?: DataSource;
+}
+interface LanguageInfo {
+    Name?: string | null;
+    Code?: string | null;
+}
+interface MetadataEntry {
+    Key?: string | null;
+    Value?: string | null;
+}
+interface ReportAsExceptionSettings {
+    ExceptionReasonOptions?: ExceptionReasonOption[] | null;
+}
+interface Rule {
+    Name?: string | null;
+    Type?: RuleType;
+    LogicalOperator?: LogicalOperator;
+    ComparisonOperator?: ComparisonOperator;
+    Expression?: string | null;
+    SetValues?: string[] | null;
+}
+interface RuleSet {
+    Criticality?: Criticality;
+    Rules?: Rule[] | null;
+}
+interface TypeField {
+    FieldId?: string | null;
+    FieldName?: string | null;
+}
+
+interface FieldValue {
+    Value?: string | null;
+    DerivedValue?: string | null;
+}
+interface FieldValueResult {
+    Value?: FieldValue;
+    IsValid?: boolean;
+    Rules?: RuleResult[] | null;
+}
+interface RuleResult {
+    Rule?: Rule;
+    IsValid?: boolean;
+}
+interface RuleSetResult {
+    FieldId?: string | null;
+    FieldType?: FieldType;
+    Criticality?: Criticality;
+    IsValid?: boolean;
+    Results?: FieldValueResult[] | null;
+    BrokenRules?: Rule[] | null;
+    RowIndex?: number | null;
+    TableFieldId?: string | null;
+}
+
+declare enum MarkupType {
+    Unknown = "Unknown",
+    Circled = "Circled",
+    Underlined = "Underlined",
+    Strikethrough = "Strikethrough"
+}
+declare enum ProcessingSource {
+    Unknown = "Unknown",
+    Ocr = "Ocr",
+    Pdf = "Pdf",
+    PlainText = "PlainText",
+    PdfAndOcr = "PdfAndOcr"
+}
+declare enum Rotation {
+    None = "None",
+    Rotated90 = "Rotated90",
+    Rotated180 = "Rotated180",
+    Rotated270 = "Rotated270",
+    Other = "Other"
+}
+declare enum SectionType {
+    Vertical = "Vertical",
+    Paragraph = "Paragraph",
+    Header = "Header",
+    Footer = "Footer",
+    Table = "Table"
+}
+declare enum TextType {
+    Unknown = "Unknown",
+    Text = "Text",
+    Checkbox = "Checkbox",
+    Handwriting = "Handwriting",
+    Barcode = "Barcode",
+    QRcode = "QRcode",
+    Stamp = "Stamp",
+    Logo = "Logo",
+    Circle = "Circle",
+    Underline = "Underline",
+    Cut = "Cut"
+}
+declare enum WordGroupType {
+    Sentence = "Sentence",
+    TableCell = "TableCell",
+    TableRowEnd = "TableRowEnd",
+    Heading = "Heading",
+    Other = "Other"
+}
+interface DocumentEntity {
+    DocumentId?: string | null;
+    ContentType?: string | null;
+    Length?: number;
+    Pages?: Page[] | null;
+    DocumentMetadata?: Metadata[] | null;
+}
+interface Metadata {
+    Key?: string | null;
+    Value?: string | null;
+}
+interface Page {
+    PageIndex?: number;
+    Size?: number[];
+    Sections?: PageSection[] | null;
+    PageMarkups?: PageMarkup[] | null;
+    ProcessingSource?: ProcessingSource;
+    IndexInText?: number;
+    TextLength?: number;
+    SkewAngle?: number;
+    Rotation?: Rotation;
+    PageMetadata?: Metadata[] | null;
+}
+interface PageMarkup {
+    Box?: number[];
+    Polygon?: number[] | null;
+    OcrConfidence?: number;
+    Text?: string | null;
+    MarkupType?: MarkupType;
+}
+interface PageSection {
+    IndexInText?: number;
+    Language?: string | null;
+    Length?: number;
+    Rotation?: Rotation;
+    SkewAngle?: number;
+    Type?: SectionType;
+    WordGroups?: WordGroup[] | null;
+}
+interface Word {
+    Box?: number[];
+    Polygon?: number[] | null;
+    IndexInText?: number;
+    OcrConfidence?: number;
+    Text?: string | null;
+    VisualLineNumber?: number;
+    TextType?: TextType;
+    MarkupType?: MarkupType[] | null;
+}
+interface WordGroup {
+    IndexInText?: number;
+    Length?: number;
+    Type?: WordGroupType;
+    Words?: Word[] | null;
+}
+
+declare enum ResultsDataSource {
+    Automatic = "Automatic",
+    Manual = "Manual",
+    ManuallyChanged = "ManuallyChanged",
+    Defaulted = "Defaulted",
+    External = "External"
+}
+interface ClassificationResult {
+    DocumentTypeId?: string | null;
+    DocumentId?: string | null;
+    Confidence?: number;
+    OcrConfidence?: number;
+    Reference?: ResultsContentReference;
+    DocumentBounds?: ResultsDocumentBounds;
+    ClassifierName?: string | null;
+}
+interface ExtractionResult {
+    DocumentId?: string | null;
+    ResultsVersion?: number;
+    ResultsDocument?: ResultsDocument;
+    ExtractorPayloads?: ExtractorPayload[] | null;
+    BusinessRulesResults?: RuleSetResult[] | null;
+}
+interface ExtractorPayload {
+    Id?: string | null;
+    Payload?: string | null;
+    SavedPayloadId?: string | null;
+    TaxonomySchemaMapping?: string | null;
+}
+interface ResultsContentReference {
+    TextStartIndex?: number;
+    TextLength?: number;
+    Tokens?: ResultsValueTokens[] | null;
+}
+interface ResultsDataPoint {
+    FieldId?: string | null;
+    FieldName?: string | null;
+    FieldType?: FieldType;
+    IsMissing?: boolean;
+    DataSource?: ResultsDataSource;
+    Values?: ResultsValue[] | null;
+    DataVersion?: number;
+    OperatorConfirmed?: boolean;
+    ValidatorNotes?: string | null;
+    ValidatorNotesInfo?: string | null;
+}
+interface ResultsDerivedField {
+    FieldId?: string | null;
+    Value?: string | null;
+}
+interface ResultsDocument {
+    Bounds?: ResultsDocumentBounds;
+    Language?: string | null;
+    DocumentGroup?: string | null;
+    DocumentCategory?: string | null;
+    DocumentTypeId?: string | null;
+    DocumentTypeName?: string | null;
+    DocumentTypeDataVersion?: number;
+    DataVersion?: number;
+    DocumentTypeSource?: ResultsDataSource;
+    DocumentTypeField?: ResultsValue;
+    Fields?: ResultsDataPoint[] | null;
+    Tables?: ResultsTable[] | null;
+}
+interface ResultsDocumentBounds {
+    PageCount?: number;
+    PageRange?: string | null;
+}
+interface ResultsTable {
+    FieldId?: string | null;
+    FieldName?: string | null;
+    IsMissing?: boolean;
+    DataSource?: ResultsDataSource;
+    DataVersion?: number;
+    OperatorConfirmed?: boolean;
+    Values?: ResultsTableValue[] | null;
+    ValidatorNotes?: string | null;
+    ValidatorNotesInfo?: string | null;
+}
+interface ResultsTableCell {
+    RowIndex?: number;
+    ColumnIndex?: number;
+    IsHeader?: boolean;
+    IsMissing?: boolean;
+    OperatorConfirmed?: boolean;
+    DataSource?: ResultsDataSource;
+    DataVersion?: number;
+    Values?: ResultsValue[] | null;
+}
+interface ResultsTableColumnInfo {
+    FieldId?: string | null;
+    FieldName?: string | null;
+    FieldType?: FieldType;
+}
+interface ResultsTableValue {
+    OperatorConfirmed?: boolean;
+    Confidence?: number;
+    OcrConfidence?: number;
+    Cells?: ResultsTableCell[] | null;
+    ColumnInfo?: ResultsTableColumnInfo[] | null;
+    NumberOfRows?: number;
+    ValidatorNotes?: string | null;
+    ValidatorNotesInfo?: string | null;
+}
+interface ResultsValue {
+    Components?: ResultsDataPoint[] | null;
+    Value?: string | null;
+    UnformattedValue?: string | null;
+    Reference?: ResultsContentReference;
+    DerivedFields?: ResultsDerivedField[] | null;
+    Confidence?: number;
+    OperatorConfirmed?: boolean;
+    OcrConfidence?: number;
+    TextType?: TextType;
+    ValidatorNotes?: string | null;
+    ValidatorNotesInfo?: string | null;
+}
+interface ResultsValueTokens {
+    TextStartIndex?: number;
+    TextLength?: number;
+    Page?: number;
+    PageWidth?: number;
+    PageHeight?: number;
+    Boxes?: number[][] | null;
+}
+
+/**
+ * Echoed payload returned alongside an exception-report submission.
+ */
+interface ExceptionReportSubmitResult {
+    /** Document identifier the exception was reported against. */
+    DocumentId: string | null;
+    /** Reason captured for the exception. */
+    Reason: string | null;
+}
+/**
+ * Response returned by `submitExceptionReport()`.
+ */
+interface SubmitExceptionReportResponse {
+    /** Echo of the submitted exception report. */
+    SubmitResult?: ExceptionReportSubmitResult;
+    /** Whether the submission was accepted by the server. */
+    IsSuccessful: boolean;
+    /** Server-supplied error message when {@link SubmitExceptionReportResponse.IsSuccessful} is `false`; empty string on success. */
+    ErrorMessage: string | null;
+}
+/**
+ * Options for `submitExceptionReport()`.
+ */
+interface SubmitExceptionReportOptions extends FolderScopedOptions {
+}
+/**
+ * Request body for processing extracted document data against a taxonomy.
+ *
+ * Combines the automatic extraction output with any validator-supplied edits so the
+ * server can compute the merged extraction result.
+ */
+interface ProcessExtractedDataRequest {
+    /** Extraction result produced by the automatic extractor. */
+    AutomaticExtractedResults: ExtractionResult;
+    /** Extraction result after human validation/edits. */
+    ValidatedExtractedResults: ExtractionResult;
+    /** Document taxonomy describing the schema both results conform to. */
+    Taxonomy: DocumentTaxonomy;
+}
+/**
+ * Options for `processExtractedData()`.
+ */
+interface ProcessExtractedDataOptions extends FolderScopedOptions {
+}
+
+/**
+ * Service for the Orchestrator Document Understanding module.
+ *
+ * Exposes the validation-flow endpoints used by Document Understanding apps to
+ * submit exception reports against a task and to process extracted data against
+ * a taxonomy. [UiPath Document Understanding Guide](https://docs.uipath.com/document-understanding/automation-cloud/latest)
+ *
+ * ### Usage
+ *
+ * Prerequisites: Initialize the SDK first - see [Getting Started](/uipath-typescript/getting-started/#import-initialize)
+ *
+ * ```typescript
+ * import { OrchestratorDuModule } from '@uipath/uipath-typescript/orchestrator-du-module';
+ *
+ * const orchestratorDuModule = new OrchestratorDuModule(sdk);
+ * ```
+ */
+interface OrchestratorDuModuleServiceModel {
+    /**
+     * Submits an exception report for a Document Understanding validation task.
+     *
+     * Records that the document under validation cannot be processed normally and captures
+     * a reason. The server echoes the submitted payload and signals acceptance via
+     * {@link SubmitExceptionReportResponse.IsSuccessful}.
+     *
+     * @param taskId - Identifier of the validation task the exception applies to.
+     * @param documentId - Identifier of the document the exception applies to.
+     * @param reason - Free-text reason the document is being reported as an exception.
+     * @returns Promise resolving to a {@link SubmitExceptionReportResponse} containing the echoed payload and success status.
+     *
+     * @example
+     * ```typescript
+     * import { Tasks, TaskType } from '@uipath/uipath-typescript/tasks';
+     *
+     * const tasks = new Tasks(sdk);
+     *
+     * // Fetch the Document Validation task to get its documentId
+     * const dvTask = await tasks.getById(<taskId>, { taskType: TaskType.DocumentValidation }, <folderId>);
+     * const documentId = dvTask.data?.documentId as string;
+     *
+     * // Submit an exception report for the validation task
+     * const result = await orchestratorDuModule.submitExceptionReport(<taskId>, documentId, '<reason>');
+     *
+     * if (result.IsSuccessful) {
+     *   console.log('Exception recorded for', result.SubmitResult?.DocumentId);
+     * }
+     * ```
+     * @internal
+     */
+    submitExceptionReport(taskId: number, documentId: string, reason: string, options: SubmitExceptionReportOptions): Promise<SubmitExceptionReportResponse>;
+    /**
+     * Processes automatically extracted data against validator-edited data and a taxonomy.
+     *
+     * Sends the automatic extraction result, the validated extraction result, and the
+     * document taxonomy to the server, which merges and normalizes the inputs and returns
+     * the resulting {@link ExtractionResult}.
+     *
+     * @param request - Automatic and validated extraction results plus the document taxonomy.
+     * @returns Promise resolving to the merged {@link ExtractionResult}.
+     *
+     * @example
+     * ```typescript
+     * // Merge automatic and validator-edited extraction results against a taxonomy
+     * const result = await orchestratorDuModule.processExtractedData({
+     *   AutomaticExtractedResults: <automaticExtractionResult>,
+     *   ValidatedExtractedResults: <validatedData>,
+     *   Taxonomy: <taxonomy>,
+     * });
+     *
+     * console.log(result.DocumentId, result.ResultsDocument?.DocumentTypeName);
+     * ```
+     * @internal
+     */
+    processExtractedData(request: ProcessExtractedDataRequest, options: ProcessExtractedDataOptions): Promise<ExtractionResult>;
+}
+
+/**
+ * Constants for Conversational Agent
+ */
+/**
+ * Maps API response fields to SDK field names (API → SDK)
+ * Used when transforming API responses for SDK consumers.
+ * For request transformation (SDK → API), use `transformRequest(data, ConversationMap)`.
+ */
+declare const ConversationMap: {
+    [key: string]: string;
+};
+/**
+ * Maps API filter param names (left) to SDK-facing names (right) for the conversation list endpoint.
+ * Used by `getAll` to translate SDK filters to the field names the backend expects. Kept separate
+ * from `ConversationMap` because `label`/`search` would otherwise collide with the `label` field
+ * on create/update payloads.
+ */
+declare const ConversationGetAllFilterMap: {
+    [key: string]: string;
+};
+/**
+ * Maps fields for Exchange entity to ensure consistent SDK naming
+ */
+declare const ExchangeMap: {
+    [key: string]: string;
+};
+/**
+ * Maps fields for Message entity to ensure consistent SDK naming
+ */
+declare const MessageMap: {
+    [key: string]: string;
+};
+
+/**
+ * Common types for Conversational Agent
+ * Contains IDs, primitives, and utility types used across conversation types.
+ */
+/**
+ * Identifies the origin of a message in the conversation.
+ */
+declare enum MessageRole {
+    System = "system",
+    User = "user",
+    Assistant = "assistant"
+}
+/**
+ * Identifies the type of an interrupt.
+ */
+declare enum InterruptType {
+    ToolCallConfirmation = "uipath_cas_tool_call_confirmation"
+}
+/**
+ * Base interface for citation sources.
+ */
+interface CitationSourceBase {
+    /**
+     * Title for the citation source, suitable for display to users.
+     */
+    title: string;
+    /**
+     * Label number for the citation source, suitable for display to users
+     * (e.g. [1] for the first unique source, [2] for the second, etc.).
+     */
+    number: number;
+}
+/**
+ * Used when the citation can be rendered as a link.
+ */
+interface CitationSourceUrl extends CitationSourceBase {
+    /**
+     * Citation url.
+     */
+    url: string;
+}
+/**
+ * Used when the citation references media, such as a PDF document.
+ */
+interface CitationSourceMedia extends CitationSourceBase {
+    /** The mime type of the media. If non-specified, should be discovered through the downloadUrl. */
+    mimeType?: string;
+    /** Download URL for the media */
+    downloadUrl?: string;
+    /** The page number for the media, if applicable (e.g. for application/pdf documents) */
+    pageNumber?: string;
+}
+/**
+ * Citation sources can target either an Url or a media (e.g. a pdf document).
+ * Repeated citation sources within a content part are identified by the same title and number.
+ */
+type CitationSource = CitationSourceUrl | CitationSourceMedia;
+/**
+ * JSON compatible primitive type.
+ */
+type JSONPrimitive = string | number | boolean | null;
+/**
+ * JSON compatible value type.
+ */
+type JSONValue = JSONPrimitive | Record<string, any> | any[];
+/**
+ * JSON compatible object type.
+ */
+type JSONObject = Record<string, JSONValue>;
+/**
+ * JSON compatible array type.
+ */
+type JSONArray = JSONValue[];
+/**
+ * An arbitrary JSON serializable object.
+ */
+type MetaData = JSONObject;
+/**
+ * Produces the provided object type with specified properties changed to optional.
+ */
+type MakeOptional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+/**
+ * Produces the provided object type with specified properties changed to required.
+ */
+type MakeRequired<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
+/**
+ * Causes typescript to simplify the display of object types created using MakeOptional, MakeRequired, and other utility
+ * types. This doesn't change the effective type, but makes popups in the ide and compile error messages cleaner.
+ */
+type Simplify<T> = T extends any[] | Date ? T : {
+    [K in keyof T]: T[K];
+} & {};
+/**
+ * Inline value - used when a value is small enough to be returned inline with an API result.
+ */
+interface InlineValue<T> {
+    inline: T;
+}
+/**
+ * External value - used when a value is too large to be returned inline with an API result.
+ */
+interface ExternalValue {
+    uri: string;
+    byteCount?: number;
+}
+/**
  * Inline or external value - used when a value can be too large to include inline in input or output data.
  * If the inline property is set, it contains the full value, otherwise the uri property is set and it contains an uri
  * from which the data can be downloaded.
@@ -14757,14 +15690,153 @@ interface AgentListItem {
     quantityPLTU: number;
 }
 /**
- * Options for {@link AgentServiceModel.getAll}.
- *
- * Composes filter, pagination, and sort options.
+ * Options for getting the list of agents.
+ *
+ * Composes filter, pagination, and sort options.
+ */
+type AgentGetAllOptions = AgentFilterOptions & PaginationOptions & {
+    /** Sort order for the result set. */
+    orderBy?: AgentListOrderBy;
+};
+/**
+ * Summary information about a single job execution — included on every
+ * error entry to anchor the window.
+ */
+interface AgentJobInfo {
+    /** Job key */
+    jobKey: string;
+    /** Folder key the job ran in */
+    folderKey: string;
+    /** Display name of the folder */
+    folderName: string;
+    /** Fully qualified folder path */
+    folderPath: string;
+    /** Job start time */
+    startTime: string;
+    /** Job end time. `null` while the job is still running. */
+    endTime: string | null;
+    /** Process key the job was launched from. `null` for ad-hoc jobs. */
+    processKey: string | null;
+}
+/**
+ * Columns available for ordering / grouping the agent errors list.
+ */
+declare enum AgentErrorSortColumn {
+    AgentId = "AgentId",
+    AgentName = "AgentName",
+    ParentProcessName = "ParentProcessName",
+    ErrorTitle = "ErrorTitle",
+    FirstSeenStartTime = "FirstSeenStartTime",
+    ExecutionCount = "ExecutionCount",
+    Type = "Type",
+    FirstSeenFolderName = "FirstSeenFolderName",
+    FirstSeenFolderPath = "FirstSeenFolderPath",
+    LastSeenStartTime = "LastSeenStartTime",
+    LastSeenFolderName = "LastSeenFolderName",
+    LastSeenFolderPath = "LastSeenFolderPath"
+}
+/**
+ * Ordering directive for the agent errors list.
+ */
+interface AgentErrorOrderBy {
+    /** Column to sort by */
+    column: AgentErrorSortColumn;
+    /** Sort descending. Defaults to false (ascending) server-side. */
+    desc?: boolean;
+}
+/**
+ * One error in the agent errors list — an error/error-class observed
+ * for an agent over the requested window.
+ */
+interface AgentError {
+    /** Error type */
+    type: string;
+    /** Error description */
+    description: string;
+    /** Agent ID */
+    agentId: string;
+    /** Agent display name. `null` if the agent has no display name set. */
+    agentName: string | null;
+    /** Job key where the error was first seen */
+    jobKey: string;
+    /** Parent process name. `null` for jobs not bound to a parent process. */
+    parentProcess: string | null;
+    /** First-seen timestamp */
+    firstSeen: string;
+    /** Folder key where the error was first observed */
+    folderKey: string;
+    /** Folder display name */
+    folderName: string;
+    /** Fully qualified folder path */
+    folderPath: string;
+    /** Number of error executions counted for this error */
+    count: number;
+    /** First job in the window where this error was observed */
+    firstSeenJob: AgentJobInfo;
+    /** Last job in the window where this error was observed */
+    lastSeenJob: AgentJobInfo;
+}
+/**
+ * Options for the agent errors list.
+ *
+ * Composes filter, pagination, and sort/group options.
+ */
+type AgentGetErrorsOptions = AgentFilterOptions & PaginationOptions & {
+    /** Sort order for the result set. */
+    orderBy?: AgentErrorOrderBy;
+    /** Group results by one or more columns. */
+    groupBy?: AgentErrorSortColumn[];
+};
+/**
+ * A single point on the agent errors timeline
+ */
+interface AgentGetErrorsTimelineResponse {
+    /** Agent name */
+    name: string;
+    /** Error count in this time bucket */
+    value: number;
+    /** Bucket timestamp (ISO 8601, UTC) */
+    date: string;
+}
+/**
+ * Options for getting the agent errors timeline.
  */
-type AgentListOptions = AgentFilterOptions & PaginationOptions & {
-    /** Sort order for the result set. */
-    orderBy?: AgentListOrderBy;
-};
+interface AgentGetErrorsTimelineOptions extends AgentFilterOptions {
+    /** Max number of agents to return. Defaults to 10 server-side. */
+    limit?: number;
+}
+/**
+ * A single point on the agent consumption timeline
+ */
+interface AgentGetConsumptionTimelineResponse {
+    /** Bucket timestamp (ISO 8601, UTC) */
+    timeSlice: string;
+    /** AGU quantity consumed in this time bucket */
+    aguConsumption: number;
+}
+/**
+ * Options for getting the agent consumption timeline.
+ */
+interface AgentGetConsumptionTimelineOptions extends AgentFilterOptions {
+}
+/**
+ * A single point on the agent latency timeline
+ */
+interface AgentGetLatencyTimelineResponse {
+    /**
+     * Percentile label for this point — observed values: `"P50"`, `"P95"`.
+     */
+    name: string;
+    /** Latency value in milliseconds. */
+    value: number;
+    /** Bucket timestamp (ISO 8601, UTC) */
+    date: string;
+}
+/**
+ * Options for getting the agent latency timeline.
+ */
+interface AgentGetLatencyTimelineOptions extends AgentFilterOptions {
+}
 
 /**
  * Service for retrieving runtime data for UiPath Agents.
@@ -14820,7 +15892,164 @@ interface AgentServiceModel {
      * }
      * ```
      */
-    getAll<T extends AgentListOptions = AgentListOptions>(startTime: Date, endTime: Date, options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<AgentListItem> : NonPaginatedResponse<AgentListItem>>;
+    getAll<T extends AgentGetAllOptions = AgentGetAllOptions>(startTime: Date, endTime: Date, options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<AgentListItem> : NonPaginatedResponse<AgentListItem>>;
+    /**
+     * Retrieves agent errors (error-classes observed for agents) over the
+     * requested window.
+     *
+     * Returns a {@link PaginatedResponse} when pagination options (`pageSize`,
+     * `cursor`, or `jumpToPage`) are provided, otherwise a
+     * {@link NonPaginatedResponse}.
+     *
+     * @param startTime - Inclusive lower bound for the query window
+     * @param endTime - Exclusive upper bound for the query window
+     * @param options - Optional pagination, sort/group, and filters
+     * @returns Promise resolving to a paginated or non-paginated list of {@link AgentError}
+     * @example
+     * ```typescript
+     * import { Agents, AgentErrorSortColumn } from '@uipath/uipath-typescript/agents';
+     *
+     * const agents = new Agents(sdk);
+     *
+     * // Non-paginated — errors in the window
+     * const result = await agents.getErrors(
+     *   new Date('2025-05-01T00:00:00Z'),
+     *   new Date('2026-05-14T00:00:00Z'),
+     * );
+     * result.items.forEach((error) => {
+     *   console.log(`${error.type}: ${error.description} (count=${error.count})`);
+     * });
+     *
+     * // Paginated — sorted by execution count descending
+     * const page = await agents.getErrors(
+     *   new Date('2025-05-01T00:00:00Z'),
+     *   new Date('2026-05-14T00:00:00Z'),
+     *   {
+     *     pageSize: 25,
+     *     orderBy: { column: AgentErrorSortColumn.ExecutionCount, desc: true },
+     *   },
+     * );
+     *
+     * if (page.hasNextPage && page.nextCursor) {
+     *   const next = await agents.getErrors(
+     *     new Date('2025-05-01T00:00:00Z'),
+     *     new Date('2026-05-14T00:00:00Z'),
+     *     { cursor: page.nextCursor },
+     *   );
+     * }
+     * ```
+     */
+    getErrors<T extends AgentGetErrorsOptions = AgentGetErrorsOptions>(startTime: Date, endTime: Date, options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<AgentError> : NonPaginatedResponse<AgentError>>;
+    /**
+     * Retrieves a time-series of error counts grouped by agent over the requested window.
+     *
+     * @param startTime - Inclusive lower bound for the query window
+     * @param endTime - Exclusive upper bound for the query window
+     * @param options - Optional filters
+     * @returns Promise resolving to an array of {@link AgentGetErrorsTimelineResponse}
+     * @example
+     * ```typescript
+     * import { Agents } from '@uipath/uipath-typescript/agents';
+     *
+     * const agents = new Agents(sdk);
+     *
+     * // All errors in May 2025
+     * const result = await agents.getErrorsTimeline(
+     *   new Date('2025-05-01T00:00:00Z'),
+     *   new Date('2025-06-01T00:00:00Z'),
+     * );
+     * result.forEach((point) => {
+     *   console.log(`${point.date} ${point.name}: ${point.value} errors`);
+     * });
+     * ```
+     * @example
+     * ```typescript
+     * // Scope to specific folders and top 5 agents
+     * const result = await agents.getErrorsTimeline(
+     *   new Date('2025-05-01T00:00:00Z'),
+     *   new Date('2025-06-01T00:00:00Z'),
+     *   {
+     *     folderKeys: ['<folderKey1>'],
+     *     agentNames: ['JokeAgent', 'StoryAgent'],
+     *     limit: 5,
+     *   },
+     * );
+     * ```
+     */
+    getErrorsTimeline(startTime: Date, endTime: Date, options?: AgentGetErrorsTimelineOptions): Promise<AgentGetErrorsTimelineResponse[]>;
+    /**
+     * Retrieves a time-series of AGU (Agent Units) consumption over the requested window.
+     *
+     * @param startTime - Inclusive lower bound for the query window
+     * @param endTime - Exclusive upper bound for the query window
+     * @param options - Optional filters
+     * @returns Promise resolving to an array of {@link AgentGetConsumptionTimelineResponse}
+     * @example
+     * ```typescript
+     * import { Agents } from '@uipath/uipath-typescript/agents';
+     *
+     * const agents = new Agents(sdk);
+     *
+     * // AGU consumption timeline in May 2025
+     * const result = await agents.getConsumptionTimeline(
+     *   new Date('2025-05-01T00:00:00Z'),
+     *   new Date('2025-06-01T00:00:00Z'),
+     * );
+     * result.forEach((point) => {
+     *   console.log(`${point.timeSlice}: ${point.aguConsumption} AGU`);
+     * });
+     * ```
+     * @example
+     * ```typescript
+     * // Scope to specific folders and agents
+     * const result = await agents.getConsumptionTimeline(
+     *   new Date('2025-05-01T00:00:00Z'),
+     *   new Date('2025-06-01T00:00:00Z'),
+     *   {
+     *     folderKeys: ['<folderKey1>'],
+     *     agentNames: ['JokeAgent'],
+     *   },
+     * );
+     * ```
+     */
+    getConsumptionTimeline(startTime: Date, endTime: Date, options?: AgentGetConsumptionTimelineOptions): Promise<AgentGetConsumptionTimelineResponse[]>;
+    /**
+     * Retrieves a time-series of agent latency (milliseconds) over the requested
+     * window.
+     *
+     * @param startTime - Inclusive lower bound for the query window
+     * @param endTime - Exclusive upper bound for the query window
+     * @param options - Optional filters
+     * @returns Promise resolving to an array of {@link AgentGetLatencyTimelineResponse}
+     * @example
+     * ```typescript
+     * import { Agents } from '@uipath/uipath-typescript/agents';
+     *
+     * const agents = new Agents(sdk);
+     *
+     * // Latency timeline in May 2025
+     * const result = await agents.getLatencyTimeline(
+     *   new Date('2025-05-01T00:00:00Z'),
+     *   new Date('2025-06-01T00:00:00Z'),
+     * );
+     * result.forEach((point) => {
+     *   console.log(`${point.date} ${point.name}: ${point.value} ms`);
+     * });
+     * ```
+     * @example
+     * ```typescript
+     * // Scope to specific folders and a single agent
+     * const result = await agents.getLatencyTimeline(
+     *   new Date('2025-05-01T00:00:00Z'),
+     *   new Date('2025-06-01T00:00:00Z'),
+     *   {
+     *     folderKeys: ['<folderKey1>'],
+     *     agentId: '<agentId>',
+     *   },
+     * );
+     * ```
+     */
+    getLatencyTimeline(startTime: Date, endTime: Date, options?: AgentGetLatencyTimelineOptions): Promise<AgentGetLatencyTimelineResponse[]>;
 }
 
 /**
@@ -15028,162 +16257,24 @@ interface AgentMemoryServiceModel {
     getTopSpaces(options?: AgentMemoryGetTopSpacesOptions): Promise<AgentMemoryGetTopSpacesResponse[]>;
 }
 
-declare enum DocumentActionPriority {
-    Low = "Low",
-    Medium = "Medium",
-    High = "High",
-    Critical = "Critical"
-}
-declare enum DocumentActionStatus {
-    Unassigned = "Unassigned",
-    Pending = "Pending",
-    Completed = "Completed"
-}
-declare enum DocumentActionType {
-    Validation = "Validation",
-    Classification = "Classification"
-}
-interface UserData {
-    Id?: number | null;
-    EmailAddress?: string | null;
-}
-
-declare enum ComparisonOperator {
-    Equals = "Equals",
-    NotEquals = "NotEquals",
-    Greater = "Greater",
-    Less = "Less",
-    GreaterOrEqual = "GreaterOrEqual",
-    LessOrEqual = "LessOrEqual"
-}
-declare enum Criticality {
-    Must = "Must",
-    Should = "Should"
-}
-declare enum FieldType {
-    Text = "Text",
-    Number = "Number",
-    Date = "Date",
-    Name = "Name",
-    Address = "Address",
-    Keyword = "Keyword",
-    Set = "Set",
-    Boolean = "Boolean",
-    Table = "Table",
-    Internal = "Internal",
-    FieldGroup = "FieldGroup",
-    MonetaryQuantity = "MonetaryQuantity"
-}
-declare enum LogicalOperator {
-    AND = "AND",
-    OR = "OR"
-}
-declare enum RuleType {
-    Mandatory = "Mandatory",
-    PossibleValues = "PossibleValues",
-    Regex = "Regex",
-    StartsWith = "StartsWith",
-    EndsWith = "EndsWith",
-    FixedLength = "FixedLength",
-    IsNumeric = "IsNumeric",
-    IsDate = "IsDate",
-    IsEmail = "IsEmail",
-    Contains = "Contains",
-    Expression = "Expression",
-    TableExpression = "TableExpression",
-    IsEmpty = "IsEmpty"
-}
-interface DataSource {
-    ResourceId?: string | null;
-    ElementFieldId?: string | null;
-}
-interface DocumentGroup {
-    Name?: string | null;
-    Categories?: string[] | null;
-}
-interface DocumentTaxonomy {
-    DataContractVersion?: string | null;
-    DocumentTypes?: DocumentTypeEntity[] | null;
-    Groups?: DocumentGroup[] | null;
-    SupportedLanguages?: LanguageInfo[] | null;
-    ReportAsExceptionSettings?: ReportAsExceptionSettings;
-}
-interface DocumentTypeEntity {
-    DocumentTypeId?: string | null;
-    Group?: string | null;
-    Category?: string | null;
-    Name?: string | null;
-    OptionalUniqueIdentifier?: string | null;
-    TypeField?: TypeField;
-    Fields?: Field[] | null;
-    Metadata?: MetadataEntry[] | null;
-}
-interface ExceptionReasonOption {
-    ExceptionReason?: string | null;
-}
-interface Field {
-    FieldId?: string | null;
-    FieldName?: string | null;
-    IsMultiValue?: boolean;
-    Type?: FieldType;
-    DeriveFieldsFormat?: string | null;
-    Components?: Field[] | null;
-    SetValues?: string[] | null;
-    Metadata?: MetadataEntry[] | null;
-    RuleSet?: RuleSet;
-    DefaultValue?: string | null;
-    DataSource?: DataSource;
-}
-interface LanguageInfo {
-    Name?: string | null;
-    Code?: string | null;
-}
-interface MetadataEntry {
-    Key?: string | null;
-    Value?: string | null;
-}
-interface ReportAsExceptionSettings {
-    ExceptionReasonOptions?: ExceptionReasonOption[] | null;
-}
-interface Rule {
-    Name?: string | null;
-    Type?: RuleType;
-    LogicalOperator?: LogicalOperator;
-    ComparisonOperator?: ComparisonOperator;
-    Expression?: string | null;
-    SetValues?: string[] | null;
-}
-interface RuleSet {
-    Criticality?: Criticality;
-    Rules?: Rule[] | null;
-}
-interface TypeField {
-    FieldId?: string | null;
-    FieldName?: string | null;
-}
-
-interface FieldValue {
-    Value?: string | null;
-    DerivedValue?: string | null;
+declare enum DocumentActionPriority {
+    Low = "Low",
+    Medium = "Medium",
+    High = "High",
+    Critical = "Critical"
 }
-interface FieldValueResult {
-    Value?: FieldValue;
-    IsValid?: boolean;
-    Rules?: RuleResult[] | null;
+declare enum DocumentActionStatus {
+    Unassigned = "Unassigned",
+    Pending = "Pending",
+    Completed = "Completed"
 }
-interface RuleResult {
-    Rule?: Rule;
-    IsValid?: boolean;
+declare enum DocumentActionType {
+    Validation = "Validation",
+    Classification = "Classification"
 }
-interface RuleSetResult {
-    FieldId?: string | null;
-    FieldType?: FieldType;
-    Criticality?: Criticality;
-    IsValid?: boolean;
-    Results?: FieldValueResult[] | null;
-    BrokenRules?: Rule[] | null;
-    RowIndex?: number | null;
-    TableFieldId?: string | null;
+interface UserData {
+    Id?: number | null;
+    EmailAddress?: string | null;
 }
 
 declare enum ClassifierDocumentTypeType {
@@ -15278,264 +16369,35 @@ interface DocumentExtractionActionDataModel {
     LastModifierUser?: UserData;
     CompletedByUser?: UserData;
     CreationTime?: string | null;
-    LastAssignedTime?: string | null;
-    CompletionTime?: string | null;
-    ProcessingTime?: number | null;
-    Type?: DocumentActionType;
-}
-interface ExtractionPrompt {
-    Id?: string | null;
-    Question?: string | null;
-    FieldType?: GptFieldType;
-    MultiValued?: boolean | null;
-}
-interface ExtractionValidationConfigurationV2 {
-    EnableRtlControls?: boolean;
-    DisplayMode?: ValidationDisplayMode;
-    FieldsValidationConfidence?: number | null;
-    AllowChangeOfDocumentType?: boolean | null;
-}
-interface FieldGroupValueProjection {
-    FieldGroupName?: string | null;
-    FieldValues?: FieldValueProjection[] | null;
-}
-interface FieldValueProjection {
-    Id?: string | null;
-    Name?: string | null;
-    Value?: string | null;
-    UnformattedValue?: string | null;
-    Confidence?: number | null;
-    OcrConfidence?: number | null;
-    Type?: FieldType;
-}
-
-declare enum MarkupType {
-    Unknown = "Unknown",
-    Circled = "Circled",
-    Underlined = "Underlined",
-    Strikethrough = "Strikethrough"
-}
-declare enum ProcessingSource {
-    Unknown = "Unknown",
-    Ocr = "Ocr",
-    Pdf = "Pdf",
-    PlainText = "PlainText",
-    PdfAndOcr = "PdfAndOcr"
-}
-declare enum Rotation {
-    None = "None",
-    Rotated90 = "Rotated90",
-    Rotated180 = "Rotated180",
-    Rotated270 = "Rotated270",
-    Other = "Other"
-}
-declare enum SectionType {
-    Vertical = "Vertical",
-    Paragraph = "Paragraph",
-    Header = "Header",
-    Footer = "Footer",
-    Table = "Table"
-}
-declare enum TextType {
-    Unknown = "Unknown",
-    Text = "Text",
-    Checkbox = "Checkbox",
-    Handwriting = "Handwriting",
-    Barcode = "Barcode",
-    QRcode = "QRcode",
-    Stamp = "Stamp",
-    Logo = "Logo",
-    Circle = "Circle",
-    Underline = "Underline",
-    Cut = "Cut"
-}
-declare enum WordGroupType {
-    Sentence = "Sentence",
-    TableCell = "TableCell",
-    TableRowEnd = "TableRowEnd",
-    Heading = "Heading",
-    Other = "Other"
-}
-interface DocumentEntity {
-    DocumentId?: string | null;
-    ContentType?: string | null;
-    Length?: number;
-    Pages?: Page[] | null;
-    DocumentMetadata?: Metadata[] | null;
-}
-interface Metadata {
-    Key?: string | null;
-    Value?: string | null;
-}
-interface Page {
-    PageIndex?: number;
-    Size?: number[];
-    Sections?: PageSection[] | null;
-    PageMarkups?: PageMarkup[] | null;
-    ProcessingSource?: ProcessingSource;
-    IndexInText?: number;
-    TextLength?: number;
-    SkewAngle?: number;
-    Rotation?: Rotation;
-    PageMetadata?: Metadata[] | null;
-}
-interface PageMarkup {
-    Box?: number[];
-    Polygon?: number[] | null;
-    OcrConfidence?: number;
-    Text?: string | null;
-    MarkupType?: MarkupType;
-}
-interface PageSection {
-    IndexInText?: number;
-    Language?: string | null;
-    Length?: number;
-    Rotation?: Rotation;
-    SkewAngle?: number;
-    Type?: SectionType;
-    WordGroups?: WordGroup[] | null;
-}
-interface Word {
-    Box?: number[];
-    Polygon?: number[] | null;
-    IndexInText?: number;
-    OcrConfidence?: number;
-    Text?: string | null;
-    VisualLineNumber?: number;
-    TextType?: TextType;
-    MarkupType?: MarkupType[] | null;
-}
-interface WordGroup {
-    IndexInText?: number;
-    Length?: number;
-    Type?: WordGroupType;
-    Words?: Word[] | null;
-}
-
-declare enum ResultsDataSource {
-    Automatic = "Automatic",
-    Manual = "Manual",
-    ManuallyChanged = "ManuallyChanged",
-    Defaulted = "Defaulted",
-    External = "External"
-}
-interface ClassificationResult {
-    DocumentTypeId?: string | null;
-    DocumentId?: string | null;
-    Confidence?: number;
-    OcrConfidence?: number;
-    Reference?: ResultsContentReference;
-    DocumentBounds?: ResultsDocumentBounds;
-    ClassifierName?: string | null;
-}
-interface ExtractionResult {
-    DocumentId?: string | null;
-    ResultsVersion?: number;
-    ResultsDocument?: ResultsDocument;
-    ExtractorPayloads?: ExtractorPayload[] | null;
-    BusinessRulesResults?: RuleSetResult[] | null;
-}
-interface ExtractorPayload {
-    Id?: string | null;
-    Payload?: string | null;
-    SavedPayloadId?: string | null;
-    TaxonomySchemaMapping?: string | null;
-}
-interface ResultsContentReference {
-    TextStartIndex?: number;
-    TextLength?: number;
-    Tokens?: ResultsValueTokens[] | null;
-}
-interface ResultsDataPoint {
-    FieldId?: string | null;
-    FieldName?: string | null;
-    FieldType?: FieldType;
-    IsMissing?: boolean;
-    DataSource?: ResultsDataSource;
-    Values?: ResultsValue[] | null;
-    DataVersion?: number;
-    OperatorConfirmed?: boolean;
-    ValidatorNotes?: string | null;
-    ValidatorNotesInfo?: string | null;
-}
-interface ResultsDerivedField {
-    FieldId?: string | null;
-    Value?: string | null;
-}
-interface ResultsDocument {
-    Bounds?: ResultsDocumentBounds;
-    Language?: string | null;
-    DocumentGroup?: string | null;
-    DocumentCategory?: string | null;
-    DocumentTypeId?: string | null;
-    DocumentTypeName?: string | null;
-    DocumentTypeDataVersion?: number;
-    DataVersion?: number;
-    DocumentTypeSource?: ResultsDataSource;
-    DocumentTypeField?: ResultsValue;
-    Fields?: ResultsDataPoint[] | null;
-    Tables?: ResultsTable[] | null;
-}
-interface ResultsDocumentBounds {
-    PageCount?: number;
-    PageRange?: string | null;
-}
-interface ResultsTable {
-    FieldId?: string | null;
-    FieldName?: string | null;
-    IsMissing?: boolean;
-    DataSource?: ResultsDataSource;
-    DataVersion?: number;
-    OperatorConfirmed?: boolean;
-    Values?: ResultsTableValue[] | null;
-    ValidatorNotes?: string | null;
-    ValidatorNotesInfo?: string | null;
-}
-interface ResultsTableCell {
-    RowIndex?: number;
-    ColumnIndex?: number;
-    IsHeader?: boolean;
-    IsMissing?: boolean;
-    OperatorConfirmed?: boolean;
-    DataSource?: ResultsDataSource;
-    DataVersion?: number;
-    Values?: ResultsValue[] | null;
+    LastAssignedTime?: string | null;
+    CompletionTime?: string | null;
+    ProcessingTime?: number | null;
+    Type?: DocumentActionType;
 }
-interface ResultsTableColumnInfo {
-    FieldId?: string | null;
-    FieldName?: string | null;
-    FieldType?: FieldType;
+interface ExtractionPrompt {
+    Id?: string | null;
+    Question?: string | null;
+    FieldType?: GptFieldType;
+    MultiValued?: boolean | null;
 }
-interface ResultsTableValue {
-    OperatorConfirmed?: boolean;
-    Confidence?: number;
-    OcrConfidence?: number;
-    Cells?: ResultsTableCell[] | null;
-    ColumnInfo?: ResultsTableColumnInfo[] | null;
-    NumberOfRows?: number;
-    ValidatorNotes?: string | null;
-    ValidatorNotesInfo?: string | null;
+interface ExtractionValidationConfigurationV2 {
+    EnableRtlControls?: boolean;
+    DisplayMode?: ValidationDisplayMode;
+    FieldsValidationConfidence?: number | null;
+    AllowChangeOfDocumentType?: boolean | null;
 }
-interface ResultsValue {
-    Components?: ResultsDataPoint[] | null;
+interface FieldGroupValueProjection {
+    FieldGroupName?: string | null;
+    FieldValues?: FieldValueProjection[] | null;
+}
+interface FieldValueProjection {
+    Id?: string | null;
+    Name?: string | null;
     Value?: string | null;
     UnformattedValue?: string | null;
-    Reference?: ResultsContentReference;
-    DerivedFields?: ResultsDerivedField[] | null;
-    Confidence?: number;
-    OperatorConfirmed?: boolean;
-    OcrConfidence?: number;
-    TextType?: TextType;
-    ValidatorNotes?: string | null;
-    ValidatorNotesInfo?: string | null;
-}
-interface ResultsValueTokens {
-    TextStartIndex?: number;
-    TextLength?: number;
-    Page?: number;
-    PageWidth?: number;
-    PageHeight?: number;
-    Boxes?: number[][] | null;
+    Confidence?: number | null;
+    OcrConfidence?: number | null;
+    Type?: FieldType;
 }
 
 interface ClassificationRequestBody {
@@ -16455,6 +17317,535 @@ interface GovernanceServiceModel {
     getOperationSummary(startTime: Date, options?: GovernanceFilterOptions): Promise<GovernanceOperationSummary>;
 }
 
+/** Status of a span: whether it completed successfully, with an error, or was not set. */
+declare enum SpanStatus {
+    Unset = "Unset",
+    Ok = "Ok",
+    Error = "Error",
+    /** Span is still in progress. */
+    Running = "Running",
+    /** Span data is hidden from the caller due to tenant/folder permission rules. */
+    Restricted = "Restricted",
+    /** Span was cancelled before completion. */
+    Cancelled = "Cancelled"
+}
+/** Platform source that produced the span. */
+declare enum SpanSource {
+    Testing = "Testing",
+    Agents = "Agents",
+    ProcessOrchestration = "ProcessOrchestration",
+    ApiWorkflows = "ApiWorkflows",
+    Robots = "Robots",
+    ConversationalAgentsService = "ConversationalAgentsService",
+    IntegrationServiceTrigger = "IntegrationServiceTrigger",
+    Playground = "Playground",
+    Governance = "Governance",
+    /** Intelligent Experience Platform — unstructured and complex document processing source. */
+    IXPUnstructuredAndComplexDocuments = "IXPUnstructuredAndComplexDocuments",
+    /** Agents authored in code (as opposed to visual/no-code designers). */
+    CodedAgents = "CodedAgents",
+    /** Intelligent Experience Platform — communications mining source. */
+    IXPCommunicationsMining = "IXPCommunicationsMining",
+    /** UiPath Context Grounding — span produced by the Enterprise Context Service for RAG/knowledge-base operations. */
+    EnterpriseContextService = "EnterpriseContextService",
+    /** Model Context Protocol — span produced by an MCP server integration. */
+    MCP = "MCP",
+    /** Agent-to-Agent — span produced by an A2A protocol call between agents. */
+    A2A = "A2A",
+    /** Serverless — span produced by a serverless function execution. */
+    Serverless = "Serverless"
+}
+/** Minimum severity level of events captured in the span. */
+declare enum SpanVerbosityLevel {
+    Verbose = "Verbose",
+    Trace = "Trace",
+    Information = "Information",
+    Warning = "Warning",
+    Error = "Error",
+    Critical = "Critical",
+    Off = "Off"
+}
+/** Whether the span was produced during a debug or production runtime. */
+declare enum SpanExecutionType {
+    Debug = "Debug",
+    Runtime = "Runtime"
+}
+/** Whether the caller has permission to read this span's data. */
+declare enum SpanPermissionStatus {
+    Allow = "Allow",
+    /** Some span fields are redacted due to permission constraints (e.g. attributes visible but payload hidden). */
+    PartialBlock = "PartialBlock",
+    Block = "Block"
+}
+/** Storage provider that created or manages the attachment. */
+declare enum SpanAttachmentProvider {
+    Orchestrator = "Orchestrator",
+    /** Span attachment stored by the observability platform. */
+    LLMOps = "LLMOps"
+}
+/** Whether the attachment is an input, output, or neither. */
+declare enum SpanAttachmentDirection {
+    None = "None",
+    In = "In",
+    Out = "Out"
+}
+/** One level in the reference hierarchy that produced this span. */
+interface SpanReferenceHierarchyEntry {
+    serviceType: string;
+    referenceId: string;
+    version: string | null;
+}
+/** Contextual lineage attached to the span (reference hierarchy). */
+interface SpanContext {
+    referenceHierarchy: SpanReferenceHierarchyEntry[];
+}
+/** File or payload attachment linked to the span. */
+interface SpanAttachment {
+    provider: SpanAttachmentProvider;
+    id: string;
+    fileName: string;
+    mimeType: string;
+    direction: SpanAttachmentDirection;
+}
+/** A single execution span returned by the Traces API. */
+interface SpanGetResponse {
+    /** Unique identifier of this span (GUID). */
+    id: string;
+    /** Trace this span belongs to (GUID). */
+    traceId: string;
+    /** Parent span ID, or null for root spans. */
+    parentId: string | null;
+    /** Human-readable name of the operation, or null if the span has no name. */
+    name: string | null;
+    /** ISO-8601 UTC timestamp when the span started. */
+    startTime: string;
+    /** ISO-8601 UTC timestamp when the span ended, or null if still running. */
+    endTime: string | null;
+    /**
+     * Span attributes (user-defined schema — do not transform keys).
+     * Values depend on the span type and the agent that produced them.
+     */
+    attributes: Record<string, unknown>;
+    /** Completion status of the span. */
+    status: SpanStatus;
+    /** Platform source that produced the span. */
+    source: SpanSource | null;
+    /** Span type tag (e.g. `"agentRun"`, `"llmCall"`). */
+    spanType: string | null;
+    /** Minimum verbosity level captured in this span. */
+    verbosityLevel: SpanVerbosityLevel | null;
+    /** Whether this span was from a debug or runtime execution. */
+    executionType: SpanExecutionType | null;
+    /** Folder key (GUID) scoping this span. */
+    folderKey: string | null;
+    /** Identifier of the entity (agent, process, etc.) that produced the span. */
+    referenceId: string | null;
+    /** Version of the entity that produced the span. */
+    referenceVersion: string | null;
+    /** Version of the agent runtime. */
+    agentVersion: string | null;
+    /** Organization (account) GUID. */
+    organizationId: string;
+    /** Tenant GUID. */
+    tenantId: string | null;
+    /** Key of the process associated with this span. */
+    processKey: string | null;
+    /** Key of the job associated with this span. */
+    jobKey: string | null;
+    /** ISO-8601 UTC timestamp of last update. */
+    updatedAt: string;
+    /** Expiry timestamp, or null if the span does not expire. */
+    expiredTime: string | null;
+    /** Reference hierarchy context for this span. */
+    context: SpanContext | null;
+    /** File or payload attachments linked to this span. */
+    attachments: SpanAttachment[] | null;
+    /** Whether the caller can read this span's data. */
+    permissionStatus: SpanPermissionStatus | null;
+}
+/** Options for retrieving all spans belonging to a trace. */
+interface TracesGetByIdOptions {
+    /** Maximum number of spans to return. */
+    pageSize?: number;
+    /** Filter spans to those produced by a specific agent ID. */
+    agentId?: string;
+    /** When true, include expired spans that are outside the default retention window. */
+    includeExpiredSpans?: boolean;
+}
+
+/**
+ * Service for querying UiPath execution traces (spans).
+ *
+ * Traces are OpenTelemetry-compatible execution records generated by agents, robots,
+ * Maestro processes, conversational agents, and other UiPath execution sources.
+ * The `source` field on each {@link SpanGetResponse} identifies the originating platform.
+ *
+ * @example
+ * ```typescript
+ * import { UiPath } from '@uipath/uipath-typescript/core';
+ * import { Traces } from '@uipath/uipath-typescript/traces';
+ *
+ * const sdk = new UiPath(config);
+ * await sdk.initialize();
+ *
+ * const traces = new Traces(sdk);
+ * const spans = await traces.getById('<traceId>');
+ * ```
+ */
+interface TracesServiceModel {
+    /**
+     * Gets all spans for a specific trace ID.
+     *
+     * Returns up to `pageSize` spans (default 1000) in a single fetch.
+     * Accepts both GUID format and OTEL 32-char hex format — the API normalizes both.
+     *
+     * @param traceId - Trace identifier
+     * @param options - Optional filters {@link TracesGetByIdOptions}
+     * @returns Promise resolving to an array of {@link SpanGetResponse}, each containing span identity, timing, status, source platform, attributes, verbosity, execution type, lineage context, and any file attachments.
+     * @example
+     * ```typescript
+     * import { Traces } from '@uipath/uipath-typescript/traces';
+     *
+     * const traces = new Traces(sdk);
+     * const spans = await traces.getById('<traceId>');
+     * console.log(spans.length, spans[0].spanType, spans[0].status);
+     * ```
+     * @example
+     * ```typescript
+     * // Filter to a specific agent's spans
+     * const agentSpans = await traces.getById('<traceId>', {
+     *   agentId: '<agentId>',
+     *   pageSize: 500,
+     * });
+     * ```
+     */
+    getById(traceId: string, options?: TracesGetByIdOptions): Promise<SpanGetResponse[]>;
+    /**
+     * Gets specific spans by trace ID and span IDs.
+     *
+     * Accepts OTEL 16-char hex or GUID format for span IDs.
+     *
+     * @param traceId - Trace identifier
+     * @param spanIds - List of span IDs to retrieve
+     * @returns Promise resolving to an array of matching {@link SpanGetResponse}, each containing span identity, timing, status, source platform, attributes, verbosity, execution type, lineage context, and any file attachments.
+     * @example
+     * ```typescript
+     * import { Traces } from '@uipath/uipath-typescript/traces';
+     *
+     * const traces = new Traces(sdk);
+     *
+     * // First retrieve all spans to find the IDs you want
+     * const allSpans = await traces.getById('<traceId>');
+     * const spanIds = allSpans.slice(0, 3).map(s => s.id);
+     *
+     * const subset = await traces.getSpansByIds('<traceId>', spanIds);
+     * ```
+     */
+    getSpansByIds(traceId: string, spanIds: string[]): Promise<SpanGetResponse[]>;
+}
+
+/**
+ * Filter fields shared by the trace-level agent endpoints
+ */
+interface AgentTraceFilterOptions {
+    /** Inclusive lower bound for the query window. Omit to use the server default (1 year ago). */
+    startTime?: Date;
+    /** Exclusive upper bound for the query window. Omit to use the server default (now). */
+    endTime?: Date;
+    /** Folder keys to scope the query. Intersected with the user's accessible folders. */
+    folderKeys?: string[];
+    /** Filter to a single agent by ID. */
+    agentId?: string;
+    /** Filter to a specific agent version. */
+    agentVersion?: string;
+    /** Filter to a specific execution type. */
+    executionType?: SpanExecutionType;
+}
+/**
+ * One point on the trace-level errors timeline — error count for a single
+ * (error name, time bucket).
+ */
+interface AgentTraceGetErrorsTimelineResponse {
+    /** Error name / category for this time-slice. */
+    name: string;
+    /** Count of errors in this time bucket for this name. */
+    value: number;
+    /** Bucket timestamp. */
+    date: string;
+}
+/**
+ * Options for the trace-level errors timeline.
+ */
+interface AgentTraceGetErrorsTimelineOptions extends AgentTraceFilterOptions {
+}
+/**
+ * One point on the trace-level latency timeline — a latency value for a single
+ * (series, time bucket).
+ */
+interface AgentTraceGetLatencyTimelineResponse {
+    /** Series/grouping name for this latency point. */
+    name: string;
+    /** Latency value in decimal seconds for this series and time bucket. */
+    value: number;
+    /** Bucket timestamp. */
+    date: string;
+}
+/**
+ * Options for the trace-level latency timeline.
+ */
+interface AgentTraceGetLatencyTimelineOptions extends AgentTraceFilterOptions {
+}
+/**
+ * Per-agent unit consumption totals over the requested window (trace-level) —
+ * a flat per-(agent, version, folder) breakdown of AGU and PLTU consumed.
+ */
+interface AgentTraceGetUnitConsumptionResponse {
+    /** Agent ID these totals belong to. */
+    agentId: string;
+    /** Folder key (GUID) the consumption was recorded in. */
+    folderKey: string;
+    /** Agent version these totals belong to. */
+    agentVersion: string;
+    /** Agent units consumed over the window. */
+    agentUnitsConsumed: number;
+    /** Platform units consumed over the window. */
+    platformUnitsConsumed: number;
+}
+/**
+ * Options for the trace-level per-agent unit consumption.
+ */
+interface AgentTraceGetUnitConsumptionOptions extends AgentTraceFilterOptions {
+}
+/**
+ * A single span record from the trace store.
+ */
+interface AgentSpanGetResponse {
+    /** Span ID. */
+    id: string;
+    /** ID of the trace this span belongs to. */
+    traceId: string;
+    /** Parent span ID. `null` for a root span. */
+    parentId: string | null;
+    /** Span name. */
+    name: string;
+    /** Span start time. */
+    startTime: string;
+    /** Span end time. `null` while the span is in progress. */
+    endTime: string | null;
+    /** Raw span attributes as a JSON string. */
+    attributes: string;
+    /** Span status. */
+    status: string;
+    /** Organization ID (GUID). */
+    organizationId: string;
+    /** Tenant ID (GUID). May be `null`. */
+    tenantId: string | null;
+    /** Span retention expiry time. May be `null`. */
+    expiredTime: string | null;
+    /** Folder key (GUID) the span was recorded in. May be `null`. */
+    folderKey: string | null;
+    /** Span source. May be `null`. */
+    source: string | null;
+    /** Span type. May be `null`. */
+    spanType: string | null;
+    /** Process key (GUID). May be `null`. */
+    processKey: string | null;
+    /** Job key (GUID). May be `null`. */
+    jobKey: string | null;
+    /** Reference ID (GUID). May be `null`. */
+    referenceId: string | null;
+    /** Verbosity level. May be `null`. */
+    verbosityLevel: string | null;
+    /** Record last-updated time. */
+    updatedAt: string;
+    /** Whether the span payload is stored as a large payload. */
+    isLargePayload: boolean;
+    /** Payload compression type. May be `null`. */
+    compressionType: string | null;
+    /** Agent version that produced the span. May be `null`. */
+    agentVersion: string | null;
+    /** Raw span context as a JSON string. May be `null`. */
+    context: string | null;
+}
+/**
+ * Options for the spans-by-reference query.
+ *
+ * Composes the optional hierarchy/time filters with pagination options.
+ */
+type AgentTraceGetSpansByReferenceOptions = PaginationOptions & {
+    /** Optional trace scope — narrows the scan to a single trace. */
+    traceId?: string;
+    /** Restrict matches to hierarchy entries with this service type. */
+    serviceType?: string;
+    /** Restrict matches to hierarchy entries with this version. */
+    version?: string;
+    /** Inclusive lower bound on span start time. */
+    startTime?: Date;
+    /** Exclusive upper bound on span end time. */
+    endTime?: Date;
+    /** Execution type filter */
+    executionType?: SpanExecutionType;
+};
+
+/**
+ * Service for retrieving UiPath Agent trace metrics.
+ */
+interface AgentTracesServiceModel {
+    /**
+     * Retrieves a trace-level time-series of error counts grouped by error name.
+     *
+     * @param options - Optional window and filters
+     * @returns Promise resolving to an array of {@link AgentTraceGetErrorsTimelineResponse}
+     * @example
+     * ```typescript
+     * import { AgentTraces } from '@uipath/uipath-typescript/traces';
+     *
+     * const trace = new AgentTraces(sdk);
+     *
+     * // Get the errors timeline
+     * const result = await trace.getErrorsTimeline();
+     * result.forEach((point) => {
+     *   console.log(`${point.date} ${point.name}: ${point.value} errors`);
+     * });
+     * ```
+     * @example
+     * ```typescript
+     * import { AgentTraceExecutionType } from '@uipath/uipath-typescript/traces';
+     *
+     * // Get the errors timeline for an agent version within a time window
+     * const filtered = await trace.getErrorsTimeline({
+     *   startTime: new Date('2025-05-01T00:00:00Z'),
+     *   endTime: new Date('2025-06-01T00:00:00Z'),
+     *   agentId: '<agentId>',
+     *   agentVersion: '1.0.0',
+     *   executionType: AgentTraceExecutionType.Runtime,
+     * });
+     * ```
+     */
+    getErrorsTimeline(options?: AgentTraceGetErrorsTimelineOptions): Promise<AgentTraceGetErrorsTimelineResponse[]>;
+    /**
+     * Retrieves a trace-level time-series of latency.
+     *
+     * @param options - Optional window and filters
+     * @returns Promise resolving to an array of {@link AgentTraceGetLatencyTimelineResponse}
+     * @example
+     * ```typescript
+     * import { AgentTraces } from '@uipath/uipath-typescript/traces';
+     *
+     * const trace = new AgentTraces(sdk);
+     *
+     * // Get the latency timeline
+     * const result = await trace.getLatencyTimeline();
+     * result.forEach((point) => {
+     *   console.log(`${point.date} ${point.name}: ${point.value}s`);
+     * });
+     * ```
+     * @example
+     * ```typescript
+     * import { AgentTraceExecutionType } from '@uipath/uipath-typescript/traces';
+     *
+     * // Get the latency timeline for an agent version within a time window
+     * const filtered = await trace.getLatencyTimeline({
+     *   startTime: new Date('2025-05-01T00:00:00Z'),
+     *   endTime: new Date('2025-06-01T00:00:00Z'),
+     *   agentId: '<agentId>',
+     *   agentVersion: '1.0.0',
+     *   executionType: AgentTraceExecutionType.Runtime,
+     * });
+     * ```
+     */
+    getLatencyTimeline(options?: AgentTraceGetLatencyTimelineOptions): Promise<AgentTraceGetLatencyTimelineResponse[]>;
+    /**
+     * Retrieves trace-level per-agent unit consumption totals.
+     *
+     * @param options - Optional window and filters
+     * @returns Promise resolving to an array of {@link AgentTraceGetUnitConsumptionResponse}
+     * @example
+     * ```typescript
+     * import { AgentTraces } from '@uipath/uipath-typescript/traces';
+     *
+     * const trace = new AgentTraces(sdk);
+     *
+     * // Get per-agent unit consumption
+     * const result = await trace.getUnitConsumption();
+     * result.forEach((row) => {
+     *   console.log(`${row.agentId}: ${row.agentUnitsConsumed} AGU, ${row.platformUnitsConsumed} PLTU`);
+     * });
+     * ```
+     * @example
+     * ```typescript
+     * import { AgentTraceExecutionType } from '@uipath/uipath-typescript/traces';
+     *
+     * // Get per-agent unit consumption for an agent version within a time window
+     * const filtered = await trace.getUnitConsumption({
+     *   startTime: new Date('2025-05-01T00:00:00Z'),
+     *   endTime: new Date('2025-06-01T00:00:00Z'),
+     *   agentId: '<agentId>',
+     *   agentVersion: '1.0.0',
+     *   executionType: AgentTraceExecutionType.Runtime,
+     * });
+     * ```
+     */
+    getUnitConsumption(options?: AgentTraceGetUnitConsumptionOptions): Promise<AgentTraceGetUnitConsumptionResponse[]>;
+    /**
+     * Retrieves every span belonging to a single trace.
+     *
+     * @param traceId - Identifier of the trace whose spans should be returned
+     * @returns Promise resolving to an array of {@link AgentSpanGetResponse}
+     * @example
+     * ```typescript
+     * import { AgentTraces } from '@uipath/uipath-typescript/traces';
+     *
+     * const trace = new AgentTraces(sdk);
+     *
+     * const spans = await trace.getSpansByTraceId('<traceId>');
+     * spans.forEach((span) => {
+     *   console.log(`${span.name} (${span.startTime} → ${span.endTime ?? 'in progress'})`);
+     * });
+     * ```
+     */
+    getSpansByTraceId(traceId: string): Promise<AgentSpanGetResponse[]>;
+    /**
+     * Retrieves spans whose reference hierarchy contains the given reference id.
+     *
+     * Returns a {@link PaginatedResponse} when pagination options (`pageSize`,
+     * `cursor`, or `jumpToPage`) are provided, otherwise a
+     * {@link NonPaginatedResponse}.
+     *
+     * @param referenceId - Reference id matched against each span's reference hierarchy
+     * @param options - Optional pagination and hierarchy/time filters
+     * @returns Promise resolving to a paginated or non-paginated list of {@link AgentSpanGetResponse}
+     * @example
+     * ```typescript
+     * import { AgentTraces } from '@uipath/uipath-typescript/traces';
+     *
+     * const trace = new AgentTraces(sdk);
+     *
+     * // Get spans by referenceId
+     * const result = await trace.getSpansByReference('<referenceId>');
+     * result.items.forEach((span) => console.log(span.name));
+     * ```
+     * @example
+     * ```typescript
+     * import { AgentTraceExecutionType } from '@uipath/uipath-typescript/traces';
+     *
+     * // Get spans by referenceId within a trace and time window
+     * const page = await trace.getSpansByReference('<referenceId>', {
+     *   traceId: '<traceId>',
+     *   executionType: AgentTraceExecutionType.Runtime,
+     *   startTime: new Date('2025-05-01T00:00:00Z'),
+     *   endTime: new Date('2025-06-01T00:00:00Z'),
+     *   pageSize: 25,
+     * });
+     *
+     * if (page.hasNextPage && page.nextCursor) {
+     *   const next = await trace.getSpansByReference('<referenceId>', { cursor: page.nextCursor });
+     * }
+     * ```
+     */
+    getSpansByReference<T extends AgentTraceGetSpansByReferenceOptions = AgentTraceGetSpansByReferenceOptions>(referenceId: string, options?: T): Promise<T extends HasPaginationOptions<T> ? PaginatedResponse<AgentSpanGetResponse> : NonPaginatedResponse<AgentSpanGetResponse>>;
+}
+
 /**
  * Error thrown when authorization fails (403 errors)
  * Common scenarios:
@@ -16728,5 +18119,5 @@ declare const telemetryClient: {
     setUserId(userId: string): void;
 };
 
-export { AgentListSortColumn, AgentMap, AgentMemoryExecutionType, AssetValueScope, AssetValueType, AuthenticationError, AuthorizationError, BucketOptions, CitationErrorType, ConversationGetAllFilterMap, ConversationMap, DEFAULT_ITEMS_FIELD, DEFAULT_PAGE_SIZE, DEFAULT_TOTAL_COUNT_FIELD, DataDirectionType, DebugMode, index as DuFramework, EntityAggregateFunction, EntityFieldDataType, EntityType, ErrorType, EscalationActionType, EscalationRecipientScope, EscalationTriggerType, ExchangeMap, FeedbackRating, FeedbackStatus, FieldDisplayType, HttpStatus, InputStreamSpeechSensitivity, InstanceFinalStatus, InstanceStatus, InterruptType, JobPriority, JobSourceType, JobState, JobSubState, JobType, JoinType, LogicalOperator$1 as LogicalOperator, MAX_PAGE_SIZE, MessageMap, MessageRole, NetworkError, NotFoundError, PackageSourceType, PackageType, PolicyEvaluationResult, ProcessIncidentSeverity, ProcessIncidentStatus, ProcessIncidentType, QueryFilterOperator, RateLimitError, ReferenceType, RemoteControlAccess, RobotSize, RuntimeType, SLADurationUnit, ServerError, ServerlessJobType, SlaSummaryStatus, SortOrder, StageTaskType, StartStrategy, StopStrategy, TargetFramework, TaskActivityType, TaskPriority, TaskSlaCriteria, TaskSlaStatus, TaskSourceName, TaskStatus, TaskType, TaskUserType, TimeInterval, UiPath, UiPathError, UiPathMetaTags, UserSettingsMap, ValidationError, createAgentWithMethods, createCaseInstanceWithMethods, createCaseWithMethods, createConversationWithMethods, createEntityWithMethods, createJobWithMethods, createProcessInstanceWithMethods, createProcessWithMethods, createTaskWithMethods, getAppBase, getAsset, getErrorDetails, getLimitedPageSize, isAuthenticationError, isAuthorizationError, isNetworkError, isNotFoundError, isRateLimitError, isServerError, isUiPathError, isValidationError, loadFromMetaTags, telemetryClient, track, trackEvent };
-export type { AgentAppearance, AgentConversationServiceModel, AgentCreateConversationOptions, AgentFilterOptions, AgentGetByIdResponse, AgentGetResponse, AgentInput, AgentListItem, AgentListOptions, AgentListOrderBy, AgentMemoryFilterOptions, AgentMemoryGetCallsTimelineOptions, AgentMemoryGetCallsTimelineResponse, AgentMemoryGetTimelineOptions, AgentMemoryGetTimelineResponse, AgentMemoryGetTopSpacesOptions, AgentMemoryGetTopSpacesResponse, AgentMemoryServiceModel, AgentMethods, AgentServiceModel, AgentStartingPrompt, ArgumentMetadata, AssetGetAllOptions, AssetGetByIdOptions, AssetGetByNameOptions, AssetGetResponse, AssetNewValue, AssetServiceModel, AssetUpdateValueByIdOptions, AsyncInputStream, AsyncInputStreamChunkEvent, AsyncInputStreamEndEvent, AsyncInputStreamEvent, AsyncInputStreamStartEvent, AsyncToolCallStream, AttachmentGetByIdOptions, AttachmentResponse, AttachmentServiceModel, BaseConfig, BaseOptions, BaseProcessStartRequest, BlobItem, BodyOptions, BpmnXmlString, BucketDeleteFileOptions, BucketFile, BucketGetAllOptions, BucketGetByIdOptions, BucketGetByNameOptions, BucketGetFileMetaDataOptions, BucketGetFileMetaDataResponse, BucketGetFileMetaDataWithPaginationOptions, BucketGetFilesOptions, BucketGetReadUriOptions, BucketGetResponse, BucketGetUriOptions, BucketGetUriResponse, BucketServiceModel, BucketUploadFileOptions, BucketUploadResponse, CaseAppConfig, CaseAppOverview, CaseGetAllResponse, CaseGetAllWithMethodsResponse, CaseGetStageResponse, CaseGetTopDurationResponse, CaseGetTopFaultedCountResponse, CaseGetTopRunCountResponse, CaseInstanceExecutionHistoryResponse, CaseInstanceGetAllOptions, CaseInstanceGetAllWithPaginationOptions, CaseInstanceGetResponse, CaseInstanceMethods, CaseInstanceOperationOptions, CaseInstanceOperationResponse, CaseInstanceReopenOptions, CaseInstanceRun, CaseInstanceSlaSummaryOptions, CaseInstanceStageSLAOptions, CaseInstanceStageSLAResponse, CaseInstanceStageSLAStage, CaseInstancesServiceModel, CaseMethods, CasesServiceModel, ChoiceSetCreateOptions, ChoiceSetGetAllResponse, ChoiceSetGetByIdOptions, ChoiceSetGetResponse, ChoiceSetServiceModel, ChoiceSetUpdateOptions, ChoiceSetValueInsertOptions, ChoiceSetValueInsertResponse, ChoiceSetValueUpdateResponse, Citation, CitationEndEvent, CitationError, CitationEvent, CitationOptions, CitationSource, CitationSourceBase, CitationSourceMedia, CitationSourceUrl, CitationStartEvent, CollectionResponse, CompletedContentPart, CompletedMessage, CompletedToolCall, ContentPart, ContentPartChunkEvent, ContentPartData, ContentPartEndEvent, ContentPartEvent, ContentPartGetResponse, ContentPartInterrupted, ContentPartStartEvent, ContentPartStartMetaData, ContentPartStream, ConversationAttachmentCreateResponse, ConversationAttachmentUploadResponse, ConversationCreateOptions, ConversationCreateResponse, ConversationDeleteResponse, ConversationEvent, ConversationExchangeServiceModel, ConversationGetAllOptions, ConversationGetResponse, ConversationJobStartOverrides, ConversationMethods, ConversationServiceModel, ConversationSessionMethods, ConversationSessionOptions, ConversationUpdateOptions, ConversationUpdateResponse, ConversationalAgentOptions, ConversationalAgentServiceModel, CreateFeedbackOptions, CustomKeyValuePair, ElementExecutionMetadata, ElementGetTopFailedCountResponse, ElementMetaData, ElementRunMetadata, ElementStats, EntityAggregate, EntityBatchInsertOptions, EntityBatchInsertResponse, EntityCreateFieldOptions, EntityCreateOptions, EntityDeleteAttachmentOptions, EntityDeleteAttachmentResponse, EntityDeleteByIdOptions, EntityDeleteOptions, EntityDeleteRecordByIdOptions, EntityDeleteRecordsOptions, EntityDeleteResponse, EntityDownloadAttachmentOptions, EntityFieldBase, EntityFieldUpdateOptions, EntityFileType, EntityFolderScopedOptions, EntityGetAllRecordsOptions, EntityGetByIdOptions, EntityGetRecordByIdOptions, EntityGetRecordsByIdOptions, EntityGetResponse, EntityImportRecordsByIdOptions, EntityImportRecordsResponse, EntityInsertOptions, EntityInsertRecordOptions, EntityInsertRecordsOptions, EntityInsertResponse, EntityMethods, EntityOperationOptions, EntityOperationResponse, EntityQueryFilter, EntityQueryFilterGroup, EntityQueryRecordsOptions, EntityQueryRecordsResponse, EntityQuerySortOption, EntityRecord, EntityRemoveFieldOptions, EntityServiceModel, EntityUpdateByIdOptions, EntityUpdateOptions, EntityUpdateRecordOptions, EntityUpdateRecordResponse, EntityUpdateRecordsOptions, EntityUpdateResponse, EntityUploadAttachmentOptions, EntityUploadAttachmentResponse, ErrorEndEvent, ErrorEvent, ErrorStartEvent, EscalationAction, EscalationRecipient, EscalationRule, EscalationTriggerMetadata, Exchange, ExchangeEndEvent, ExchangeEvent, ExchangeGetAllOptions, ExchangeGetByIdOptions, ExchangeGetResponse, ExchangeServiceModel, ExchangeStartEvent, ExchangeStream, ExternalConnection, ExternalField, ExternalFieldMapping, ExternalObject, ExternalSourceFields, ExternalValue, FailureRecord, FeatureFlags, FeedbackCategory, FeedbackCategoryInput, FeedbackCategoryResponse, FeedbackCreateCategoryOptions, FeedbackCreateResponse, FeedbackDeleteCategoryOptions, FeedbackGetAllOptions, FeedbackGetCategoriesOptions, FeedbackGetResponse, FeedbackOptions, FeedbackResponse, FeedbackServiceModel, FeedbackSubmitOptions, FeedbackUpdateOptions, Field$1 as Field, FieldDataType, FieldMetaData, FileUploadAccess, FolderProperties, FolderScopedOptions, GenericInterruptStartEvent, GetTopBaseResponse, GetTopDurationResponse, GetTopFaultedCountResponse, GetTopRunCountResponse, GlobalVariableMetaData, GovernanceFilterOptions, GovernanceOperationSummary, GovernancePolicyTrace, GovernancePolicyTraceGetAllOptions, GovernanceServiceModel, HasPaginationOptions, Headers, HttpMethod, InlineOrExternalValue, InlineValue, InstanceStatusTimelineResponse, Interrupt, InterruptEndEvent, InterruptEvent, InterruptStartEvent, JSONArray, JSONObject, JSONPrimitive, JSONValue, JobAttachment, JobError, JobGetAllOptions, JobGetByIdOptions, JobGetResponse, JobMethods, JobResumeOptions, JobServiceModel, JobStopOptions, LabelUpdatedEvent, Machine, MaestroProcessGetAllResponse, MaestroProcessesServiceModel, MakeOptional, MakeRequired, Message, MessageEndEvent, MessageEvent, MessageGetResponse, MessageServiceModel, MessageStartEvent, MessageStream, MetaData, MetaEvent, NonPaginatedResponse, OAuthFields, OperationResponse, PaginatedResponse, PaginationCursor, PaginationMetadata, PaginationMethodUnion, PaginationOptions, PartialUiPathConfig, ProcessGetAllOptions, ProcessGetByIdOptions, ProcessGetByNameOptions, ProcessGetResponse, ProcessGetTopDurationResponse, ProcessGetTopFaultedCountResponse, ProcessGetTopRunCountResponse, ProcessIncidentGetAllResponse, ProcessIncidentGetResponse, ProcessIncidentsServiceModel, ProcessInstanceExecutionHistoryResponse, ProcessInstanceGetAllOptions, ProcessInstanceGetAllWithPaginationOptions, ProcessInstanceGetResponse, ProcessInstanceGetVariablesOptions, ProcessInstanceGetVariablesResponse, ProcessInstanceMethods, ProcessInstanceOperationOptions, ProcessInstanceOperationResponse, ProcessInstanceRun, ProcessInstancesServiceModel, ProcessMetadata, ProcessMethods, ProcessProperties, ProcessServiceModel, ProcessStartOptions, ProcessStartRequest, ProcessStartRequestWithKey, ProcessStartRequestWithName, ProcessStartResponse, QueryParams, QueueGetAllOptions, QueueGetByIdOptions, QueueGetResponse, QueueServiceModel, RawAgentGetByIdResponse, RawAgentGetResponse, RawCaseInstanceGetResponse, RawConversationGetResponse, RawEntityGetResponse, RawJobGetResponse, RawMaestroProcessGetAllResponse, RawProcessInstanceGetResponse, RawTaskCreateResponse, RawTaskGetResponse, RequestOptions, RequestSpec, ResponseDictionary, ResponseType, RetryOptions, RobotMetadata, SessionCapabilities, SessionEndEvent, SessionEndingEvent, SessionStartEvent, SessionStartedEvent, SessionStream, Simplify, SlaSummaryResponse, SourceJoinCriteria, SqlType, StageSLA, StageTask, Tag, TaskActivity, TaskAssignOptions, TaskAssignment, TaskAssignmentOptions, TaskAssignmentResponse, TaskBaseResponse, TaskCompleteOptions, TaskCompletionOptions, TaskCreateOptions, TaskCreateResponse, TaskGetAllOptions, TaskGetByIdOptions, TaskGetResponse, TaskGetUsersOptions, TaskMethods, TaskServiceModel, TaskSlaDetail, TaskSource, TasksUnassignOptions, TimelineOptions, TimeoutOptions, ToolCall, ToolCallConfirmationEndValue, ToolCallConfirmationEvent, ToolCallConfirmationInterruptStartEvent, ToolCallConfirmationValue, ToolCallEndEvent, ToolCallEvent, ToolCallInputValue, ToolCallOutputValue, ToolCallResult, ToolCallStartEvent, ToolCallStream, TopQueryOptions, UiPathSDKConfig, UserLoginInfo, UserSettingsGetResponse, UserSettingsServiceModel, UserSettingsUpdateOptions, UserSettingsUpdateResponse };
+export { AgentErrorSortColumn, AgentListSortColumn, AgentMap, AgentMemoryExecutionType, SpanExecutionType as AgentTraceExecutionType, AssetValueScope, AssetValueType, AuthenticationError, AuthorizationError, BucketOptions, CitationErrorType, ConversationGetAllFilterMap, ConversationMap, DEFAULT_ITEMS_FIELD, DEFAULT_PAGE_SIZE, DEFAULT_TOTAL_COUNT_FIELD, DataDirectionType, DebugMode, index as DuFramework, EntityAggregateFunction, EntityFieldDataType, EntityType, ErrorType, EscalationActionType, EscalationRecipientScope, EscalationTriggerType, ExchangeMap, FeedbackRating, FeedbackStatus, FieldDisplayType, HttpStatus, InputStreamSpeechSensitivity, InstanceFinalStatus, InstanceStatus, InterruptType, JobPriority, JobSourceType, JobState, JobSubState, JobType, JoinType, LogicalOperator$1 as LogicalOperator, MAX_PAGE_SIZE, MessageMap, MessageRole, NetworkError, NotFoundError, PackageSourceType, PackageType, PolicyEvaluationResult, ProcessIncidentSeverity, ProcessIncidentStatus, ProcessIncidentType, QueryFilterOperator, RateLimitError, ReferenceType, RemoteControlAccess, RobotSize, RuntimeType, SLADurationUnit, ServerError, ServerlessJobType, SlaSummaryStatus, SortOrder, SpanAttachmentDirection, SpanAttachmentProvider, SpanExecutionType, SpanPermissionStatus, SpanSource, SpanStatus, SpanVerbosityLevel, StageTaskType, StartStrategy, StopStrategy, TargetFramework, TaskActivityType, TaskAssignmentCriteria, TaskPriority, TaskSlaCriteria, TaskSlaStatus, TaskSourceName, TaskStatus, TaskType, TaskUserType, TimeInterval, UiPath, UiPathError, UiPathMetaTags, UserSettingsMap, ValidationError, createAgentWithMethods, createCaseInstanceWithMethods, createCaseWithMethods, createConversationWithMethods, createEntityWithMethods, createJobWithMethods, createProcessInstanceWithMethods, createProcessWithMethods, createTaskWithMethods, getAppBase, getAsset, getErrorDetails, getLimitedPageSize, isAuthenticationError, isAuthorizationError, isNetworkError, isNotFoundError, isRateLimitError, isServerError, isUiPathError, isValidationError, loadFromMetaTags, telemetryClient, track, trackEvent };
+export type { AgentAppearance, AgentConversationServiceModel, AgentCreateConversationOptions, AgentError, AgentErrorOrderBy, AgentFilterOptions, AgentGetAllOptions, AgentGetByIdResponse, AgentGetConsumptionTimelineOptions, AgentGetConsumptionTimelineResponse, AgentGetErrorsOptions, AgentGetErrorsTimelineOptions, AgentGetErrorsTimelineResponse, AgentGetLatencyTimelineOptions, AgentGetLatencyTimelineResponse, AgentGetResponse, AgentInput, AgentJobInfo, AgentListItem, AgentListOrderBy, AgentMemoryFilterOptions, AgentMemoryGetCallsTimelineOptions, AgentMemoryGetCallsTimelineResponse, AgentMemoryGetTimelineOptions, AgentMemoryGetTimelineResponse, AgentMemoryGetTopSpacesOptions, AgentMemoryGetTopSpacesResponse, AgentMemoryServiceModel, AgentMethods, AgentServiceModel, AgentSpanGetResponse, AgentStartingPrompt, AgentTraceFilterOptions, AgentTraceGetErrorsTimelineOptions, AgentTraceGetErrorsTimelineResponse, AgentTraceGetLatencyTimelineOptions, AgentTraceGetLatencyTimelineResponse, AgentTraceGetSpansByReferenceOptions, AgentTraceGetUnitConsumptionOptions, AgentTraceGetUnitConsumptionResponse, AgentTracesServiceModel, ArgumentMetadata, AssetGetAllOptions, AssetGetByIdOptions, AssetGetByNameOptions, AssetGetResponse, AssetNewValue, AssetServiceModel, AssetUpdateValueByIdOptions, AsyncInputStream, AsyncInputStreamChunkEvent, AsyncInputStreamEndEvent, AsyncInputStreamEvent, AsyncInputStreamStartEvent, AsyncToolCallStream, AttachmentGetByIdOptions, AttachmentResponse, AttachmentServiceModel, BaseConfig, BaseOptions, BaseProcessStartRequest, BlobItem, BodyOptions, BpmnXmlString, BucketDeleteFileOptions, BucketFile, BucketGetAllOptions, BucketGetByIdOptions, BucketGetByNameOptions, BucketGetFileMetaDataOptions, BucketGetFileMetaDataResponse, BucketGetFileMetaDataWithPaginationOptions, BucketGetFilesOptions, BucketGetReadUriOptions, BucketGetReadUriRequestOptions, BucketGetResponse, BucketGetUriOptions, BucketGetUriResponse, BucketServiceModel, BucketUploadFileOptions, BucketUploadFileRequestOptions, BucketUploadResponse, CaseAppConfig, CaseAppOverview, CaseGetAllResponse, CaseGetAllWithMethodsResponse, CaseGetStageResponse, CaseGetTopDurationResponse, CaseGetTopFaultedCountResponse, CaseGetTopRunCountResponse, CaseInstanceExecutionHistoryResponse, CaseInstanceGetAllOptions, CaseInstanceGetAllWithPaginationOptions, CaseInstanceGetResponse, CaseInstanceMethods, CaseInstanceOperationOptions, CaseInstanceOperationResponse, CaseInstanceReopenOptions, CaseInstanceRun, CaseInstanceSlaSummaryOptions, CaseInstanceStageSLAOptions, CaseInstanceStageSLAResponse, CaseInstanceStageSLAStage, CaseInstancesServiceModel, CaseMethods, CasesServiceModel, ChoiceSetCreateOptions, ChoiceSetDeleteByIdOptions, ChoiceSetGetAllOptions, ChoiceSetGetAllResponse, ChoiceSetGetByIdOptions, ChoiceSetGetResponse, ChoiceSetServiceModel, ChoiceSetUpdateOptions, ChoiceSetValueDeleteOptions, ChoiceSetValueInsertOptions, ChoiceSetValueInsertResponse, ChoiceSetValueUpdateOptions, ChoiceSetValueUpdateResponse, Citation, CitationEndEvent, CitationError, CitationEvent, CitationOptions, CitationSource, CitationSourceBase, CitationSourceMedia, CitationSourceUrl, CitationStartEvent, CollectionResponse, CompletedContentPart, CompletedMessage, CompletedToolCall, ContentPart, ContentPartChunkEvent, ContentPartData, ContentPartEndEvent, ContentPartEvent, ContentPartGetResponse, ContentPartInterrupted, ContentPartStartEvent, ContentPartStartMetaData, ContentPartStream, ConversationAttachmentCreateResponse, ConversationAttachmentUploadResponse, ConversationCreateOptions, ConversationCreateResponse, ConversationDeleteResponse, ConversationEvent, ConversationExchangeServiceModel, ConversationGetAllOptions, ConversationGetResponse, ConversationJobStartOverrides, ConversationMethods, ConversationServiceModel, ConversationSessionMethods, ConversationSessionOptions, ConversationUpdateOptions, ConversationUpdateResponse, ConversationalAgentOptions, ConversationalAgentServiceModel, CreateFeedbackOptions, CustomKeyValuePair, ElementExecutionMetadata, ElementGetTopFailedCountResponse, ElementMetaData, ElementRunMetadata, ElementStats, EntityAggregate, EntityBatchInsertOptions, EntityBatchInsertResponse, EntityCreateFieldOptions, EntityCreateOptions, EntityDeleteAttachmentOptions, EntityDeleteAttachmentResponse, EntityDeleteByIdOptions, EntityDeleteOptions, EntityDeleteRecordByIdOptions, EntityDeleteRecordsOptions, EntityDeleteResponse, EntityDownloadAttachmentOptions, EntityFieldBase, EntityFieldUpdateOptions, EntityFileType, EntityFolderScopedOptions, EntityGetAllOptions, EntityGetAllRecordsOptions, EntityGetByIdOptions, EntityGetRecordByIdOptions, EntityGetRecordsByIdOptions, EntityGetResponse, EntityImportRecordsByIdOptions, EntityImportRecordsResponse, EntityInsertOptions, EntityInsertRecordOptions, EntityInsertRecordsOptions, EntityInsertResponse, EntityMethods, EntityOperationOptions, EntityOperationResponse, EntityQueryFilter, EntityQueryFilterGroup, EntityQueryRecordsOptions, EntityQueryRecordsResponse, EntityQuerySortOption, EntityRecord, EntityRemoveFieldOptions, EntityServiceModel, EntityUpdateByIdOptions, EntityUpdateOptions, EntityUpdateRecordOptions, EntityUpdateRecordResponse, EntityUpdateRecordsOptions, EntityUpdateResponse, EntityUploadAttachmentOptions, EntityUploadAttachmentResponse, ErrorEndEvent, ErrorEvent, ErrorStartEvent, EscalationAction, EscalationRecipient, EscalationRule, EscalationTriggerMetadata, ExceptionReportSubmitResult, Exchange, ExchangeEndEvent, ExchangeEvent, ExchangeGetAllOptions, ExchangeGetByIdOptions, ExchangeGetResponse, ExchangeServiceModel, ExchangeStartEvent, ExchangeStream, ExternalConnection, ExternalField, ExternalFieldMapping, ExternalObject, ExternalSourceFields, ExternalValue, FailureRecord, FeatureFlags, FeedbackCategory, FeedbackCategoryInput, FeedbackCategoryResponse, FeedbackCreateCategoryOptions, FeedbackCreateResponse, FeedbackDeleteCategoryOptions, FeedbackGetAllOptions, FeedbackGetCategoriesOptions, FeedbackGetResponse, FeedbackOptions, FeedbackResponse, FeedbackServiceModel, FeedbackSubmitOptions, FeedbackUpdateOptions, Field$1 as Field, FieldDataType, FieldMetaData, FileUploadAccess, FolderProperties, FolderScopedOptions, GenericInterruptStartEvent, GetTopBaseResponse, GetTopDurationResponse, GetTopFaultedCountResponse, GetTopRunCountResponse, GlobalVariableMetaData, GovernanceFilterOptions, GovernanceOperationSummary, GovernancePolicyTrace, GovernancePolicyTraceGetAllOptions, GovernanceServiceModel, HasPaginationOptions, Headers, HttpMethod, InlineOrExternalValue, InlineValue, InstanceStatusTimelineResponse, Interrupt, InterruptEndEvent, InterruptEvent, InterruptStartEvent, JSONArray, JSONObject, JSONPrimitive, JSONValue, JobAttachment, JobError, JobGetAllOptions, JobGetByIdOptions, JobGetResponse, JobMethods, JobResumeOptions, JobServiceModel, JobStopOptions, LabelUpdatedEvent, Machine, MaestroProcessGetAllResponse, MaestroProcessesServiceModel, MakeOptional, MakeRequired, Message, MessageEndEvent, MessageEvent, MessageGetResponse, MessageServiceModel, MessageStartEvent, MessageStream, MetaData, MetaEvent, NonPaginatedResponse, OAuthFields, OperationResponse, OrchestratorDuModuleServiceModel, PaginatedResponse, PaginationCursor, PaginationMetadata, PaginationMethodUnion, PaginationOptions, PartialUiPathConfig, ProcessExtractedDataOptions, ProcessExtractedDataRequest, ProcessGetAllOptions, ProcessGetByIdOptions, ProcessGetByNameOptions, ProcessGetResponse, ProcessGetTopDurationResponse, ProcessGetTopFaultedCountResponse, ProcessGetTopRunCountResponse, ProcessIncidentGetAllResponse, ProcessIncidentGetResponse, ProcessIncidentsServiceModel, ProcessInstanceExecutionHistoryResponse, ProcessInstanceGetAllOptions, ProcessInstanceGetAllWithPaginationOptions, ProcessInstanceGetResponse, ProcessInstanceGetVariablesOptions, ProcessInstanceGetVariablesResponse, ProcessInstanceMethods, ProcessInstanceOperationOptions, ProcessInstanceOperationResponse, ProcessInstanceRun, ProcessInstancesServiceModel, ProcessMetadata, ProcessMethods, ProcessProperties, ProcessServiceModel, ProcessStartOptions, ProcessStartRequest, ProcessStartRequestWithKey, ProcessStartRequestWithName, ProcessStartResponse, QueryParams, QueueGetAllOptions, QueueGetByIdOptions, QueueGetResponse, QueueServiceModel, RawAgentGetByIdResponse, RawAgentGetResponse, RawCaseInstanceGetResponse, RawConversationGetResponse, RawEntityGetResponse, RawJobGetResponse, RawMaestroProcessGetAllResponse, RawProcessInstanceGetResponse, RawTaskCreateResponse, RawTaskGetResponse, RequestOptions, RequestSpec, ResponseDictionary, ResponseType, RetryOptions, RobotMetadata, SessionCapabilities, SessionEndEvent, SessionEndingEvent, SessionStartEvent, SessionStartedEvent, SessionStream, Simplify, SlaSummaryResponse, SourceJoinCriteria, SpanAttachment, SpanContext, SpanGetResponse, SpanReferenceHierarchyEntry, SqlType, StageSLA, StageTask, SubmitExceptionReportOptions, SubmitExceptionReportResponse, Tag, TaskActivity, TaskAssignOptions, TaskAssignment, TaskAssignmentOptions, TaskAssignmentResponse, TaskBaseResponse, TaskCompleteOptions, TaskCompletionOptions, TaskCreateOptions, TaskCreateResponse, TaskGetAllOptions, TaskGetByIdOptions, TaskGetResponse, TaskGetUsersOptions, TaskMethods, TaskServiceModel, TaskSlaDetail, TaskSource, TasksUnassignOptions, TimelineOptions, TimeoutOptions, ToolCall, ToolCallConfirmationEndValue, ToolCallConfirmationEvent, ToolCallConfirmationInterruptStartEvent, ToolCallConfirmationValue, ToolCallEndEvent, ToolCallEvent, ToolCallInputValue, ToolCallOutputValue, ToolCallResult, ToolCallStartEvent, ToolCallStream, TopQueryOptions, TracesGetByIdOptions, TracesServiceModel, UiPathSDKConfig, UserLoginInfo, UserSettingsGetResponse, UserSettingsServiceModel, UserSettingsUpdateOptions, UserSettingsUpdateResponse };