@uipath/uipath-typescript 1.3.10 → 1.4.0

package/dist/cases/index.mjs

@@ -59,6 +59,7 @@ var ProcessType;
  */
 const ORCHESTRATOR_BASE = 'orchestrator_';
 const PIMS_BASE = 'pims_';
+const LLMOPS_BASE = 'llmopstenant_';
 const INSIGHTS_RTM_BASE = 'insightsrtm_';
 
 /**
@@ -98,7 +99,7 @@ const MAESTRO_ENDPOINTS = {
     INSTANCES: {
         GET_ALL: `${PIMS_BASE}/api/v1/instances`,
         GET_BY_ID: (instanceId) => `${PIMS_BASE}/api/v1/instances/${instanceId}`,
-        GET_EXECUTION_HISTORY: (instanceId) => `${PIMS_BASE}/api/v1/spans/${instanceId}`,
+        GET_ELEMENT_EXECUTIONS: (instanceId) => `${PIMS_BASE}/api/v1/instances/${instanceId}/element-executions`,
         GET_BPMN: (instanceId) => `${PIMS_BASE}/api/v1/instances/${instanceId}/bpmn`,
         GET_VARIABLES: (instanceId) => `${PIMS_BASE}/api/v1/instances/${instanceId}/variables`,
         CANCEL: (instanceId) => `${PIMS_BASE}/api/v1/instances/${instanceId}/cancel`,
@@ -110,6 +111,9 @@ const MAESTRO_ENDPOINTS = {
         GET_BY_PROCESS: (processKey) => `${PIMS_BASE}/api/v1/incidents/process/${processKey}`,
         GET_BY_INSTANCE: (instanceId) => `${PIMS_BASE}/api/v1/instances/${instanceId}/incidents`,
     },
+    TRACES: {
+        GET_SPANS: (traceId) => `${LLMOPS_BASE}/api/Traces/spans?traceId=${traceId}`,
+    },
     CASES: {
         GET_CASE_JSON: (instanceId) => `${PIMS_BASE}/api/v1/cases/${instanceId}/case-json`,
         GET_ELEMENT_EXECUTIONS: (instanceId) => `${PIMS_BASE}/api/v1/element-executions/case-instances/${instanceId}`,
@@ -124,13 +128,51 @@ const MAESTRO_ENDPOINTS = {
         TOP_PROCESSES_BY_RUN_COUNT: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/TopProcessesByRunCount`,
         /** Top processes ranked by failure count */
         TOP_PROCESSES_WITH_FAILURE: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/TopProcesseswithFailure`,
+        /** Top elements ranked by failure count */
+        TOP_ELEMENTS_WITH_FAILURE: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/TopElementswithFailure`,
         /** Instance status aggregated by date for time-series charts */
         INSTANCE_STATUS_BY_DATE: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/InstanceStatusByDate`,
         /** Top processes ranked by total duration */
         TOP_PROCESSES_BY_DURATION: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/TopProcessesByDuration`,
+        /** Element count by status for agentic instances (process and case) */
+        ELEMENT_COUNT_BY_STATUS: `${INSIGHTS_RTM_BASE}/agenticInstanceStatus/ElementCountByStatus`,
     },
 };
 
+/**
+ * Maestro Cases Models
+ * Model classes for Maestro cases
+ */
+/**
+ * Creates methods for a case object
+ *
+ * @param caseData - The case data (response from API)
+ * @param service - The cases service instance
+ * @returns Object containing case methods
+ */
+function createCaseMethods(caseData, service) {
+    return {
+        getElementStats(startTime, endTime, packageVersion) {
+            if (!caseData.processKey)
+                throw new Error('Process key is undefined');
+            if (!caseData.packageId)
+                throw new Error('Package ID is undefined');
+            return service.getElementStats(caseData.processKey, caseData.packageId, startTime, endTime, packageVersion);
+        }
+    };
+}
+/**
+ * Creates an actionable case by combining API case data with operational methods.
+ *
+ * @param caseData - The case data from API
+ * @param service - The cases service instance
+ * @returns A case object with added methods
+ */
+function createCaseWithMethods(caseData, service) {
+    const methods = createCaseMethods(caseData, service);
+    return Object.assign({}, caseData, methods);
+}
+
 /**
  * Builds the request body for Insights RTM "top" endpoints.
  *
@@ -177,6 +219,28 @@ async function fetchInstanceStatusTimeline(postFn, startTime, endTime, isCaseMan
     });
     return response.data ?? [];
 }
+/**
+ * Builds the request body for the ElementCountByStatus endpoint.
+ *
+ * @param processKey - Process key to filter by
+ * @param packageId - Package identifier
+ * @param startTime - Start of the time range to query
+ * @param endTime - End of the time range to query
+ * @param packageVersion - Package version to filter by
+ * @returns Request body for the ElementCountByStatus endpoint
+ * @internal
+ */
+function buildElementCountByStatusBody(processKey, packageId, startTime, endTime, packageVersion) {
+    return {
+        commonParams: {
+            processKey,
+            packageId,
+            startTime: startTime.getTime(),
+            endTime: endTime.getTime(),
+            version: packageVersion
+        }
+    };
+}
 
 /**
  * Type guards for error response types
@@ -873,6 +937,32 @@ function processODataArrayResponse(oDataResponse, successData) {
  */
 const isBrowser = typeof window !== 'undefined' && typeof window.document !== 'undefined';
 isBrowser && window.self != window.top && window.location.href.includes('source=ActionCenter');
+const _params = isBrowser ? new URLSearchParams(window.location.search) : null;
+/**
+ * True when the coded app has been loaded inside a host frame that explicitly
+ * opted into token delegation by adding `?host=embed` to the iframe src URL.
+ */
+const isHostEmbedded = isBrowser && window.self !== window.top && _params?.get('host') === 'embed';
+/**
+ * The validated parent origin, read from the `?basedomain=` query param set
+ * by the embedding host in the iframe src URL.
+ * Mirrors the same mechanism used by ActionCenterTokenManager.
+ * Non-null only when `?host=embed` is present and `?basedomain=` is a valid URL.
+ */
+(() => {
+    if (!isHostEmbedded)
+        return null;
+    const basedomain = _params?.get('basedomain');
+    if (!basedomain)
+        return null;
+    try {
+        return new URL(basedomain).origin;
+    }
+    catch {
+        console.warn('embeddingOrigin: basedomain query param is not a valid URL', basedomain);
+        return null;
+    }
+})();
 
 /**
  * Base64 encoding/decoding
@@ -1580,8 +1670,9 @@ class PaginationHelpers {
             });
         }
         // Extract and transform items from response
-        // Handle both plain array responses and envelope responses ({ value: [...], totalRecordCount: N })
-        const rawItems = Array.isArray(response.data) ? response.data : response.data?.[itemsField];
+        // Handle both plain array responses and envelope responses ({ value: [...], totalRecordCount: N }).
+        // itemsField may be a dotted path (e.g. 'data.agents') for nested envelopes.
+        const rawItems = Array.isArray(response.data) ? response.data : resolveNestedField(response.data, itemsField);
         const rawTotalCount = Array.isArray(response.data) ? undefined : resolveNestedField(response.data, totalCountField);
         const totalCount = typeof rawTotalCount === 'number' ? rawTotalCount : undefined;
         // Parse items - automatically handle JSON string responses
@@ -1627,7 +1718,7 @@ class PaginationHelpers {
                 getEndpoint: config.getEndpoint,
                 folderId,
                 headers: config.headers,
-                paginationParams: cursor ? { cursor, pageSize } : jumpToPage ? { jumpToPage, pageSize } : { pageSize },
+                paginationParams: cursor ? { cursor, pageSize } : jumpToPage !== undefined ? { jumpToPage, pageSize } : { pageSize },
                 additionalParams: prefixedOptions,
                 transformFn: config.transformFn,
                 method: config.method,
@@ -1885,6 +1976,8 @@ class BaseService {
                 // When true (default), converts pageNumber to a skip/offset value (e.g., page 3 with pageSize 10 → skip 20).
                 // When false, passes pageNumber directly as the offset param — used by APIs that accept a page number instead of a record offset.
                 const convertToSkip = paginationParams?.convertToSkip ?? true;
+                // When true, sends pageNumber - 1 (for 0-based APIs). Default false (1-based).
+                const zeroBased = paginationParams?.zeroBased ?? false;
                 requestParams[pageSizeParam] = limitedPageSize;
                 if (convertToSkip) {
                     if (params.pageNumber && params.pageNumber > 1) {
@@ -1892,7 +1985,8 @@ class BaseService {
                     }
                 }
                 else {
-                    requestParams[offsetParam] = params.pageNumber || 1;
+                    const sdkPageNumber = params.pageNumber || 1;
+                    requestParams[offsetParam] = zeroBased ? sdkPageNumber - 1 : sdkPageNumber;
                 }
                 {
                     requestParams[countParam] = true;
@@ -1921,8 +2015,9 @@ class BaseService {
         const totalCountField = fields.totalCountField || 'totalRecordCount';
         const continuationTokenField = fields.continuationTokenField || 'continuationToken';
         // Extract items and metadata
-        // Handle both plain array responses and envelope responses ({ value: [...], totalRecordCount: N })
-        const items = Array.isArray(response.data) ? response.data : (response.data[itemsField] || []);
+        // Handle both plain array responses and envelope responses ({ value: [...], totalRecordCount: N }).
+        // itemsField may be a dotted path (e.g. 'data.agents') for nested envelopes.
+        const items = Array.isArray(response.data) ? response.data : (resolveNestedField(response.data, itemsField) || []);
         const rawTotalCount = Array.isArray(response.data) ? undefined : resolveNestedField(response.data, totalCountField);
         const totalCount = typeof rawTotalCount === 'number' ? rawTotalCount : undefined;
         const continuationToken = response.data[continuationTokenField];
@@ -2039,7 +2134,7 @@ function createParams(paramsObj = {}) {
 class CasesService extends BaseService {
     /**
      * Get all case management processes with their instance statistics
-     * @returns Promise resolving to array of Case objects
+     * @returns Promise resolving to an array of {@link CaseGetAllWithMethodsResponse}
      *
      * @example
      * ```typescript
@@ -2063,10 +2158,10 @@ class CasesService extends BaseService {
         const response = await this.get(MAESTRO_ENDPOINTS.PROCESSES.GET_ALL, { params });
         // Extract processes array from response data and add name field
         const cases = response.data?.processes || [];
-        return cases.map(caseItem => ({
+        return cases.map(caseItem => createCaseWithMethods({
             ...caseItem,
             name: this.extractCaseName(caseItem.packageId)
-        }));
+        }, this));
     }
     /**
      * Get the top 5 case processes ranked by run count within a time range.
@@ -2109,6 +2204,52 @@ class CasesService extends BaseService {
         const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.TOP_PROCESSES_BY_RUN_COUNT, buildInsightsTopBody(startTime, endTime, true, options));
         return (data ?? []).map(process => ({ ...process, name: this.extractCaseName(process.packageId) }));
     }
+    /**
+     * Get the top 10 BPMN elements ranked by failure count within a time range.
+     *
+     * Returns an array of up to 10 elements sorted by how many times they failed,
+     * useful for identifying the most error-prone activities in case processes.
+     *
+     * @param startTime - Start of the time range to query
+     * @param endTime - End of the time range to query
+     * @param options - Optional filters (packageId, processKey, version)
+     * @returns Promise resolving to an array of {@link ElementGetTopFailedCountResponse}
+     * @example
+     * ```typescript
+     * import { Cases } from '@uipath/uipath-typescript/cases';
+     *
+     * const cases = new Cases(sdk);
+     *
+     * // Get top failing elements for the last 7 days
+     * const topFailing = await cases.getTopElementFailedCount(
+     *   new Date(Date.now() - 7 * 24 * 60 * 60 * 1000),
+     *   new Date()
+     * );
+     *
+     * for (const element of topFailing) {
+     *   console.log(`${element.elementName} (${element.elementType}): ${element.failedCount} failures`);
+     * }
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Get top failing elements for a specific process
+     * const filtered = await cases.getTopElementFailedCount(
+     *   new Date(Date.now() - 7 * 24 * 60 * 60 * 1000),
+     *   new Date(),
+     *   { processKey: '<processKey>' }
+     * );
+     * ```
+     */
+    async getTopElementFailedCount(startTime, endTime, options) {
+        const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.TOP_ELEMENTS_WITH_FAILURE, buildInsightsTopBody(startTime, endTime, true, options));
+        return (data ?? []).map(item => ({
+            elementName: item.elementName,
+            elementType: item.elementType,
+            processKey: item.processKey,
+            failedCount: item.count,
+        }));
+    }
     /**
      * Get all instances status counts aggregated by date for case management processes.
      *
@@ -2239,6 +2380,40 @@ class CasesService extends BaseService {
         const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.TOP_PROCESSES_BY_DURATION, buildInsightsTopBody(startTime, endTime, true, options));
         return (data ?? []).map(process => ({ ...process, name: this.extractCaseName(process.packageId) }));
     }
+    /**
+     * Get element stats for case instances
+     *
+     * Returns per-element execution counts (success, fail, terminated, paused, in-progress) and
+     * duration percentile metrics (min, max, avg, p50, p95, p99) for BPMN elements within a case.
+     *
+     * @param processKey - Process key to filter by
+     * @param packageId - Package identifier
+     * @param startTime - Start of the time range to query
+     * @param endTime - End of the time range to query
+     * @param packageVersion - Package version to filter by
+     * @returns Promise resolving to an array of {@link ElementStats}
+     * @example
+     * ```typescript
+     * // Get element metrics for a case
+     * const elements = await cases.getElementStats(
+     *   '<processKey>',
+     *   '<packageId>',
+     *   new Date('2026-04-01'),
+     *   new Date(),
+     *   '1.0.1'
+     * );
+     *
+     * // Find elements with failures
+     * const failedElements = elements.filter(e => e.failCount > 0);
+     * for (const element of failedElements) {
+     *   console.log(`Failed element: ${element.elementId}, failures: ${element.failCount}`);
+     * }
+     * ```
+     */
+    async getElementStats(processKey, packageId, startTime, endTime, packageVersion) {
+        const { data } = await this.post(MAESTRO_ENDPOINTS.INSIGHTS.ELEMENT_COUNT_BY_STATUS, buildElementCountByStatusBody(processKey, packageId, startTime, endTime, packageVersion));
+        return data ?? [];
+    }
     /**
      * Extract a readable case name from the packageId
      * @param packageId - The full package identifier
@@ -2264,6 +2439,9 @@ __decorate([
 __decorate([
     track('Cases.GetTopRunCount')
 ], CasesService.prototype, "getTopRunCount", null);
+__decorate([
+    track('Cases.GetTopElementFailedCount')
+], CasesService.prototype, "getTopElementFailedCount", null);
 __decorate([
     track('Cases.GetInstanceStatusTimeline')
 ], CasesService.prototype, "getInstanceStatusTimeline", null);
@@ -2273,6 +2451,9 @@ __decorate([
 __decorate([
     track('Cases.GetTopExecutionDuration')
 ], CasesService.prototype, "getTopExecutionDuration", null);
+__decorate([
+    track('Cases.GetElementStats')
+], CasesService.prototype, "getElementStats", null);
 
 /**
  * Process Incident Status
@@ -3794,4 +3975,4 @@ __decorate([
     track('CaseInstances.GetStagesSlaSummary')
 ], CaseInstancesService.prototype, "getStagesSlaSummary", null);
 
-export { CaseInstancesService as CaseInstances, CaseInstancesService, CasesService as Cases, CasesService, EscalationActionType, EscalationRecipientScope, EscalationTriggerType, InstanceFinalStatus, InstanceStatus, SLADurationUnit, SlaSummaryStatus, StageTaskType, TimeInterval, createCaseInstanceWithMethods };
+export { CaseInstancesService as CaseInstances, CaseInstancesService, CasesService as Cases, CasesService, EscalationActionType, EscalationRecipientScope, EscalationTriggerType, InstanceFinalStatus, InstanceStatus, SLADurationUnit, SlaSummaryStatus, StageTaskType, TimeInterval, createCaseInstanceWithMethods, createCaseWithMethods };

package/dist/conversational-agent/index.cjs

@@ -779,6 +779,32 @@ function filterUndefined(obj) {
  */
 const isBrowser = typeof window !== 'undefined' && typeof window.document !== 'undefined';
 isBrowser && window.self != window.top && window.location.href.includes('source=ActionCenter');
+const _params = isBrowser ? new URLSearchParams(window.location.search) : null;
+/**
+ * True when the coded app has been loaded inside a host frame that explicitly
+ * opted into token delegation by adding `?host=embed` to the iframe src URL.
+ */
+const isHostEmbedded = isBrowser && window.self !== window.top && _params?.get('host') === 'embed';
+/**
+ * The validated parent origin, read from the `?basedomain=` query param set
+ * by the embedding host in the iframe src URL.
+ * Mirrors the same mechanism used by ActionCenterTokenManager.
+ * Non-null only when `?host=embed` is present and `?basedomain=` is a valid URL.
+ */
+(() => {
+    if (!isHostEmbedded)
+        return null;
+    const basedomain = _params?.get('basedomain');
+    if (!basedomain)
+        return null;
+    try {
+        return new URL(basedomain).origin;
+    }
+    catch {
+        console.warn('embeddingOrigin: basedomain query param is not a valid URL', basedomain);
+        return null;
+    }
+})();
 
 /**
  * Base64 encoding/decoding
@@ -1363,8 +1389,9 @@ class PaginationHelpers {
             });
         }
         // Extract and transform items from response
-        // Handle both plain array responses and envelope responses ({ value: [...], totalRecordCount: N })
-        const rawItems = Array.isArray(response.data) ? response.data : response.data?.[itemsField];
+        // Handle both plain array responses and envelope responses ({ value: [...], totalRecordCount: N }).
+        // itemsField may be a dotted path (e.g. 'data.agents') for nested envelopes.
+        const rawItems = Array.isArray(response.data) ? response.data : resolveNestedField(response.data, itemsField);
         const rawTotalCount = Array.isArray(response.data) ? undefined : resolveNestedField(response.data, totalCountField);
         const totalCount = typeof rawTotalCount === 'number' ? rawTotalCount : undefined;
         // Parse items - automatically handle JSON string responses
@@ -1410,7 +1437,7 @@ class PaginationHelpers {
                 getEndpoint: config.getEndpoint,
                 folderId,
                 headers: config.headers,
-                paginationParams: cursor ? { cursor, pageSize } : jumpToPage ? { jumpToPage, pageSize } : { pageSize },
+                paginationParams: cursor ? { cursor, pageSize } : jumpToPage !== undefined ? { jumpToPage, pageSize } : { pageSize },
                 additionalParams: prefixedOptions,
                 transformFn: config.transformFn,
                 method: config.method,
@@ -1668,6 +1695,8 @@ class BaseService {
                 // When true (default), converts pageNumber to a skip/offset value (e.g., page 3 with pageSize 10 → skip 20).
                 // When false, passes pageNumber directly as the offset param — used by APIs that accept a page number instead of a record offset.
                 const convertToSkip = paginationParams?.convertToSkip ?? true;
+                // When true, sends pageNumber - 1 (for 0-based APIs). Default false (1-based).
+                const zeroBased = paginationParams?.zeroBased ?? false;
                 requestParams[pageSizeParam] = limitedPageSize;
                 if (convertToSkip) {
                     if (params.pageNumber && params.pageNumber > 1) {
@@ -1675,7 +1704,8 @@ class BaseService {
                     }
                 }
                 else {
-                    requestParams[offsetParam] = params.pageNumber || 1;
+                    const sdkPageNumber = params.pageNumber || 1;
+                    requestParams[offsetParam] = zeroBased ? sdkPageNumber - 1 : sdkPageNumber;
                 }
                 {
                     requestParams[countParam] = true;
@@ -1704,8 +1734,9 @@ class BaseService {
         const totalCountField = fields.totalCountField || 'totalRecordCount';
         const continuationTokenField = fields.continuationTokenField || 'continuationToken';
         // Extract items and metadata
-        // Handle both plain array responses and envelope responses ({ value: [...], totalRecordCount: N })
-        const items = Array.isArray(response.data) ? response.data : (response.data[itemsField] || []);
+        // Handle both plain array responses and envelope responses ({ value: [...], totalRecordCount: N }).
+        // itemsField may be a dotted path (e.g. 'data.agents') for nested envelopes.
+        const items = Array.isArray(response.data) ? response.data : (resolveNestedField(response.data, itemsField) || []);
         const rawTotalCount = Array.isArray(response.data) ? undefined : resolveNestedField(response.data, totalCountField);
         const totalCount = typeof rawTotalCount === 'number' ? rawTotalCount : undefined;
         const continuationToken = response.data[continuationTokenField];
@@ -4947,37 +4978,58 @@ class ExchangeService extends BaseService {
         super(instance, buildConversationalAgentHeaders(options));
     }
     /**
-     * Gets all exchanges for a conversation with optional filtering and pagination
+     * Gets exchanges for a conversation with pagination and optional sort parameters
      *
-     * 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)
+     * Returns a paginated response. When called without `pageSize`/`cursor`, the
+     * backend applies its default page size — inspect `hasNextPage`/`nextCursor`
+     * to navigate further pages.
      *
      * @param conversationId - The conversation ID to get exchanges for
      * @param options - Options for querying exchanges including optional pagination parameters
-     * @returns Promise resolving to either an array of exchanges {@link NonPaginatedResponse}<{@link ExchangeGetResponse}> or a {@link PaginatedResponse}<{@link ExchangeGetResponse}> when pagination options are used
+     * @returns Promise resolving to a {@link PaginatedResponse}<{@link ExchangeGetResponse}>
      *
-     * @example
+     * @example Basic usage - default page size and sort order
      * ```typescript
-     * // Get all exchanges (non-paginated)
-     * const conversationExchanges = await exchanges.getAll(conversationId);
-     *
-     * // First page with pagination
-     * const firstPageOfExchanges = await exchanges.getAll(conversationId, { pageSize: 10 });
+     * // First page
+     * const firstPage = await exchanges.getAll(conversationId);
      *
      * // Navigate using cursor
-     * if (firstPageOfExchanges.hasNextPage) {
-     *   const nextPageOfExchanges = await exchanges.getAll(conversationId, { cursor: firstPageOfExchanges.nextCursor });
+     * if (firstPage.hasNextPage) {
+     *   const nextPage = await exchanges.getAll(conversationId, { cursor: firstPage.nextCursor });
+     * }
+     * ```
+     *
+     * @example With explicit page size and exchange/message sort orders
+     * ```typescript
+     * import { SortOrder } from '@uipath/uipath-typescript/conversational-agent';
+     *
+     * const firstPage = await exchanges.getAll(conversationId, {
+     *   pageSize: 10,
+     *   exchangeSort: SortOrder.Descending,
+     *   messageSort: SortOrder.Ascending
+     * });
+     *
+     * // Navigate using cursor and same parameters
+     * if (firstPage.hasNextPage) {
+     *   const nextPage = await exchanges.getAll(conversationId, {
+     *     pageSize: 10,
+     *     exchangeSort: SortOrder.Descending,
+     *     messageSort: SortOrder.Ascending,
+     *     cursor: firstPage.nextCursor
+     *   });
      * }
      * ```
      */
     async getAll(conversationId, options) {
-        const transformFn = transformExchange;
-        return PaginationHelpers.getAll({
+        const { pageSize, cursor, jumpToPage, ...additionalParams } = options ?? {};
+        const paginationParams = cursor ? { cursor, pageSize } : jumpToPage ? { jumpToPage, pageSize } : { pageSize };
+        return PaginationHelpers.getAllPaginated({
             serviceAccess: this.createPaginationServiceAccess(),
             getEndpoint: () => EXCHANGE_ENDPOINTS.LIST(conversationId),
-            transformFn,
-            pagination: {
+            paginationParams,
+            additionalParams,
+            transformFn: transformExchange,
+            options: {
                 paginationType: PaginationType.TOKEN,
                 itemsField: CONVERSATIONAL_PAGINATION.ITEMS_FIELD,
                 continuationTokenField: CONVERSATIONAL_PAGINATION.CONTINUATION_TOKEN_FIELD,
@@ -4985,9 +5037,8 @@ class ExchangeService extends BaseService {
                     pageSizeParam: CONVERSATIONAL_TOKEN_PARAMS.PAGE_SIZE_PARAM,
                     tokenParam: CONVERSATIONAL_TOKEN_PARAMS.TOKEN_PARAM
                 }
-            },
-            excludeFromPrefix: Object.keys(options || {}) // Conversational params are not OData
-        }, options);
+            }
+        });
     }
     /**
      * Gets an exchange by ID with its messages
@@ -5969,28 +6020,23 @@ class ConversationService extends BaseService {
         return createConversationWithMethods(transformedData, this, this, this._exchangeService);
     }
     /**
-     * Gets all conversations with optional filtering and pagination
+     * Gets conversations with pagination and optional sort/filter parameters
      *
-     * 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)
+     * Returns a paginated response. When called without `pageSize`/`cursor`, a
+     * default page size is applied - inspect `hasNextPage`/`nextCursor`
+     * to navigate further pages.
      *
-     * @param options - Options for querying conversations including optional pagination parameters
-     * @returns Promise resolving to either an array of conversations {@link NonPaginatedResponse}<{@link ConversationGetResponse}> or a {@link PaginatedResponse}<{@link ConversationGetResponse}> when pagination options are used
+     * @param options - Options for querying conversations
+     * @returns Promise resolving to a {@link PaginatedResponse}<{@link ConversationGetResponse}>
      *
-     * @example Basic usage - get all conversations
+     * @example Basic usage - default sort, pagination, and without filtering
      * ```typescript
-     * const allConversations = await conversationalAgent.conversations.getAll();
+     * // First page
+     * const firstPage = await conversationalAgent.conversations.getAll();
      *
-     * for (const conversation of allConversations.items) {
+     * for (const conversation of firstPage.items) {
      *   console.log(`${conversation.label} - created: ${conversation.createdTime}`);
      * }
-     * ```
-     *
-     * @example With pagination
-     * ```typescript
-     * // First page
-     * const firstPage = await conversationalAgent.conversations.getAll({ pageSize: 10 });
      *
      * // Navigate using cursor
      * if (firstPage.hasNextPage) {
@@ -6000,37 +6046,59 @@ class ConversationService extends BaseService {
      * }
      * ```
      *
-     * @example Sorted with limit
+     * @example With explicit page size and sort order (by last-activity timestamp)
      * ```typescript
-     * const result = await conversationalAgent.conversations.getAll({
-     *   sort: SortOrder.Descending,
-     *   pageSize: 20
+     * import { SortOrder } from '@uipath/uipath-typescript/conversational-agent';
+     *
+     * // First page
+     * const firstPage = await conversationalAgent.conversations.getAll({
+     *   pageSize: 10,
+     *   sort: SortOrder.Descending
      * });
+     *
+     * // Navigate using cursor and same parameters
+     * if (firstPage.hasNextPage) {
+     *   const nextPage = await conversationalAgent.conversations.getAll({
+     *     pageSize: 10,
+     *     sort: SortOrder.Descending,
+     *     cursor: firstPage.nextCursor
+     *   });
+     * }
      * ```
      *
-     * @example Filter by agent and search by label
+     * @example With agent-filter and label-search
      * ```typescript
-     * const filtered = await conversationalAgent.conversations.getAll({
+     * const firstPage = await conversationalAgent.conversations.getAll({
      *   agentId: <agentId>,
      *   label: 'budget'
      * });
+     *
+     * // Navigate using cursor and same parameters
+     * if (firstPage.hasNextPage) {
+     *   const nextPage = await conversationalAgent.conversations.getAll({
+     *     agentId: <agentId>,
+     *     label: 'budget',
+     *     cursor: firstPage.nextCursor
+     *   });
+     * }
      * ```
      */
     async getAll(options) {
-        // Transform function to convert API timestamps to SDK naming convention and add methods
         const transformFn = (conversation) => {
             const transformedData = transformData(conversation, ConversationMap);
             return createConversationWithMethods(transformedData, this, this, this._exchangeService);
         };
+        const { pageSize, cursor, jumpToPage, ...filterOptions } = options ?? {};
         // Translate SDK filter names (agentKey/agentId/label) to backend names before forwarding
-        const apiOptions = options
-            ? transformRequest(options, ConversationGetAllFilterMap)
-            : undefined;
-        return PaginationHelpers.getAll({
+        const additionalParams = transformRequest(filterOptions, ConversationGetAllFilterMap);
+        const paginationParams = cursor ? { cursor, pageSize } : jumpToPage ? { jumpToPage, pageSize } : { pageSize };
+        return PaginationHelpers.getAllPaginated({
             serviceAccess: this.createPaginationServiceAccess(),
             getEndpoint: () => CONVERSATION_ENDPOINTS.LIST,
+            paginationParams,
+            additionalParams,
             transformFn,
-            pagination: {
+            options: {
                 paginationType: PaginationType.TOKEN,
                 itemsField: CONVERSATIONAL_PAGINATION.ITEMS_FIELD,
                 continuationTokenField: CONVERSATIONAL_PAGINATION.CONTINUATION_TOKEN_FIELD,
@@ -6038,9 +6106,8 @@ class ConversationService extends BaseService {
                     pageSizeParam: CONVERSATIONAL_TOKEN_PARAMS.PAGE_SIZE_PARAM,
                     tokenParam: CONVERSATIONAL_TOKEN_PARAMS.TOKEN_PARAM
                 }
-            },
-            excludeFromPrefix: Object.keys(apiOptions || {}) // Conversational params are not OData
-        }, apiOptions);
+            }
+        });
     }
     /**
      * Updates a conversation by ID
@@ -6074,7 +6141,7 @@ class ConversationService extends BaseService {
      */
     async deleteById(id) {
         const response = await this.delete(CONVERSATION_ENDPOINTS.DELETE(id));
-        return response.data;
+        return transformData(response.data, ConversationMap);
     }
     // ==================== Attachments ====================
     /**