@credal/actions 0.2.217 → 0.2.218

package/dist/actions/autogen/templates.js

@@ -2018,13 +2018,25 @@ export const jiraGetJiraIssuesByQueryDefinition = {
             },
             limit: {
                 type: "number",
-                description: "The maximum number of records to retrieve. Defaults to 100. For exhaustive queries where all matching issues are needed, set this to a value larger than the expected result count (e.g. 500 or 1000).",
+                description: "The maximum number of records to retrieve per call (page size). Defaults to 100.",
+            },
+            startAt: {
+                type: "number",
+                description: "Offset of the first result to return. Defaults to 0. To page through results: count the number of results you can actually read in the response and pass currentStartAt + countOfResultsRead as the next startAt. Do not blindly use itemsReturned to advance — the response may be truncated by the system after this action returns, meaning you may see fewer results than itemsReturned reports.",
             },
         },
     },
     output: {
         type: "object",
         properties: {
+            itemsReturned: {
+                type: "number",
+                description: "Number of items fetched by this action. This field intentionally appears before results so it survives system-level response truncation. Warning: the system may truncate the results array before you see it, so you may receive fewer results than this number. Always count the results you can actually read and use currentStartAt + countOfResultsRead as the next startAt, not currentStartAt + itemsReturned.",
+            },
+            truncated: {
+                type: "boolean",
+                description: "True when more results exist beyond this batch. Call again with startAt set to currentStartAt + countOfResultsRead (the number of results you actually received in this response).",
+            },
             results: {
                 type: "array",
                 description: "The results of the Jira issues",
@@ -2194,14 +2206,6 @@ export const jiraGetJiraIssuesByQueryDefinition = {
                     },
                 },
             },
-            total: {
-                type: "number",
-                description: "The total number of Jira issues matching the query. When present and greater than the number of results returned, re-run with a higher limit to retrieve all issues.",
-            },
-            truncated: {
-                type: "boolean",
-                description: "True when the result set was cut off at the requested limit and more issues exist. Re-run with a higher limit to retrieve all issues.",
-            },
             error: {
                 type: "string",
                 description: "The error that occurred if the records were not successfully retrieved",
@@ -2882,13 +2886,25 @@ export const jiraOrgGetJiraIssuesByQueryDefinition = {
             },
             limit: {
                 type: "number",
-                description: "The maximum number of records to retrieve. Defaults to 100. For exhaustive queries where all matching issues are needed, set this to a value larger than the expected result count (e.g. 500 or 1000).",
+                description: "The maximum number of records to retrieve per call (page size). Defaults to 100.",
+            },
+            startAt: {
+                type: "number",
+                description: "Offset of the first result to return. Defaults to 0. To page through results: count the number of results you can actually read in the response and pass currentStartAt + countOfResultsRead as the next startAt. Do not blindly use itemsReturned to advance — the response may be truncated by the system after this action returns, meaning you may see fewer results than itemsReturned reports.",
             },
         },
     },
     output: {
         type: "object",
         properties: {
+            itemsReturned: {
+                type: "number",
+                description: "Number of items fetched by this action. This field intentionally appears before results so it survives system-level response truncation. Warning: the system may truncate the results array before you see it, so you may receive fewer results than this number. Always count the results you can actually read and use currentStartAt + countOfResultsRead as the next startAt, not currentStartAt + itemsReturned.",
+            },
+            truncated: {
+                type: "boolean",
+                description: "True when more results exist beyond this batch. Call again with startAt set to currentStartAt + countOfResultsRead (the number of results you actually received in this response).",
+            },
             results: {
                 type: "array",
                 description: "The results of the Jira issues",
@@ -3058,14 +3074,6 @@ export const jiraOrgGetJiraIssuesByQueryDefinition = {
                     },
                 },
             },
-            total: {
-                type: "number",
-                description: "The total number of Jira issues matching the query. When present and greater than the number of results returned, re-run with a higher limit to retrieve all issues.",
-            },
-            truncated: {
-                type: "boolean",
-                description: "True when the result set was cut off at the requested limit and more issues exist. Re-run with a higher limit to retrieve all issues.",
-            },
             error: {
                 type: "string",
                 description: "The error that occurred if the records were not successfully retrieved",
@@ -3746,13 +3754,25 @@ export const jiraDataCenterGetJiraIssuesByQueryDefinition = {
             },
             limit: {
                 type: "number",
-                description: "The maximum number of records to retrieve. Defaults to 100. For exhaustive queries where all matching issues are needed, set this to a value larger than the expected result count (e.g. 500 or 1000).",
+                description: "The maximum number of records to retrieve per call (page size). Defaults to 100.",
+            },
+            startAt: {
+                type: "number",
+                description: "Offset of the first result to return. Defaults to 0. To page through results: count the number of results you can actually read in the response and pass currentStartAt + countOfResultsRead as the next startAt. Do not blindly use itemsReturned to advance — the response may be truncated by the system after this action returns, meaning you may see fewer results than itemsReturned reports.",
             },
         },
     },
     output: {
         type: "object",
         properties: {
+            itemsReturned: {
+                type: "number",
+                description: "Number of items fetched by this action. This field intentionally appears before results so it survives system-level response truncation. Warning: the system may truncate the results array before you see it, so you may receive fewer results than this number. Always count the results you can actually read and use currentStartAt + countOfResultsRead as the next startAt, not currentStartAt + itemsReturned.",
+            },
+            truncated: {
+                type: "boolean",
+                description: "True when more results exist beyond this batch. Call again with startAt set to currentStartAt + countOfResultsRead (the number of results you actually received in this response).",
+            },
             results: {
                 type: "array",
                 description: "The results of the Jira issues",
@@ -3922,14 +3942,6 @@ export const jiraDataCenterGetJiraIssuesByQueryDefinition = {
                     },
                 },
             },
-            total: {
-                type: "number",
-                description: "The total number of Jira issues matching the query. When present and greater than the number of results returned, re-run with a higher limit to retrieve all issues.",
-            },
-            truncated: {
-                type: "boolean",
-                description: "True when the result set was cut off at the requested limit and more issues exist. Re-run with a higher limit to retrieve all issues.",
-            },
             error: {
                 type: "string",
                 description: "The error that occurred if the records were not successfully retrieved",

package/dist/actions/autogen/types.d.ts

@@ -2029,15 +2029,20 @@ export type jiraUpdateJiraTicketStatusFunction = ActionFunction<jiraUpdateJiraTi
 export declare const jiraGetJiraIssuesByQueryParamsSchema: z.ZodObject<{
     query: z.ZodString;
     limit: z.ZodOptional<z.ZodNumber>;
+    startAt: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     query: string;
     limit?: number | undefined;
+    startAt?: number | undefined;
 }, {
     query: string;
     limit?: number | undefined;
+    startAt?: number | undefined;
 }>;
 export type jiraGetJiraIssuesByQueryParamsType = z.infer<typeof jiraGetJiraIssuesByQueryParamsSchema>;
 export declare const jiraGetJiraIssuesByQueryOutputSchema: z.ZodObject<{
+    itemsReturned: z.ZodOptional<z.ZodNumber>;
+    truncated: z.ZodOptional<z.ZodBoolean>;
     results: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         url: z.ZodString;
@@ -2292,8 +2297,6 @@ export declare const jiraGetJiraIssuesByQueryOutputSchema: z.ZodObject<{
             resolution?: string | null | undefined;
         };
     }>, "many">>;
-    total: z.ZodOptional<z.ZodNumber>;
-    truncated: z.ZodOptional<z.ZodBoolean>;
     error: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     error?: string | undefined;
@@ -2341,7 +2344,7 @@ export declare const jiraGetJiraIssuesByQueryOutputSchema: z.ZodObject<{
             resolution?: string | null | undefined;
         };
     }[] | undefined;
-    total?: number | undefined;
+    itemsReturned?: number | undefined;
     truncated?: boolean | undefined;
 }, {
     error?: string | undefined;
@@ -2389,7 +2392,7 @@ export declare const jiraGetJiraIssuesByQueryOutputSchema: z.ZodObject<{
             resolution?: string | null | undefined;
         };
     }[] | undefined;
-    total?: number | undefined;
+    itemsReturned?: number | undefined;
     truncated?: boolean | undefined;
 }>;
 export type jiraGetJiraIssuesByQueryOutputType = z.infer<typeof jiraGetJiraIssuesByQueryOutputSchema>;
@@ -2844,15 +2847,20 @@ export type jiraOrgUpdateJiraTicketStatusFunction = ActionFunction<jiraOrgUpdate
 export declare const jiraOrgGetJiraIssuesByQueryParamsSchema: z.ZodObject<{
     query: z.ZodString;
     limit: z.ZodOptional<z.ZodNumber>;
+    startAt: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     query: string;
     limit?: number | undefined;
+    startAt?: number | undefined;
 }, {
     query: string;
     limit?: number | undefined;
+    startAt?: number | undefined;
 }>;
 export type jiraOrgGetJiraIssuesByQueryParamsType = z.infer<typeof jiraOrgGetJiraIssuesByQueryParamsSchema>;
 export declare const jiraOrgGetJiraIssuesByQueryOutputSchema: z.ZodObject<{
+    itemsReturned: z.ZodOptional<z.ZodNumber>;
+    truncated: z.ZodOptional<z.ZodBoolean>;
     results: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         url: z.ZodString;
@@ -3107,8 +3115,6 @@ export declare const jiraOrgGetJiraIssuesByQueryOutputSchema: z.ZodObject<{
             resolution?: string | null | undefined;
         };
     }>, "many">>;
-    total: z.ZodOptional<z.ZodNumber>;
-    truncated: z.ZodOptional<z.ZodBoolean>;
     error: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     error?: string | undefined;
@@ -3156,7 +3162,7 @@ export declare const jiraOrgGetJiraIssuesByQueryOutputSchema: z.ZodObject<{
             resolution?: string | null | undefined;
         };
     }[] | undefined;
-    total?: number | undefined;
+    itemsReturned?: number | undefined;
     truncated?: boolean | undefined;
 }, {
     error?: string | undefined;
@@ -3204,7 +3210,7 @@ export declare const jiraOrgGetJiraIssuesByQueryOutputSchema: z.ZodObject<{
             resolution?: string | null | undefined;
         };
     }[] | undefined;
-    total?: number | undefined;
+    itemsReturned?: number | undefined;
     truncated?: boolean | undefined;
 }>;
 export type jiraOrgGetJiraIssuesByQueryOutputType = z.infer<typeof jiraOrgGetJiraIssuesByQueryOutputSchema>;
@@ -3659,15 +3665,20 @@ export type jiraDataCenterUpdateJiraTicketStatusFunction = ActionFunction<jiraDa
 export declare const jiraDataCenterGetJiraIssuesByQueryParamsSchema: z.ZodObject<{
     query: z.ZodString;
     limit: z.ZodOptional<z.ZodNumber>;
+    startAt: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     query: string;
     limit?: number | undefined;
+    startAt?: number | undefined;
 }, {
     query: string;
     limit?: number | undefined;
+    startAt?: number | undefined;
 }>;
 export type jiraDataCenterGetJiraIssuesByQueryParamsType = z.infer<typeof jiraDataCenterGetJiraIssuesByQueryParamsSchema>;
 export declare const jiraDataCenterGetJiraIssuesByQueryOutputSchema: z.ZodObject<{
+    itemsReturned: z.ZodOptional<z.ZodNumber>;
+    truncated: z.ZodOptional<z.ZodBoolean>;
     results: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         url: z.ZodString;
@@ -3922,8 +3933,6 @@ export declare const jiraDataCenterGetJiraIssuesByQueryOutputSchema: z.ZodObject
             resolution?: string | null | undefined;
         };
     }>, "many">>;
-    total: z.ZodOptional<z.ZodNumber>;
-    truncated: z.ZodOptional<z.ZodBoolean>;
     error: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     error?: string | undefined;
@@ -3971,7 +3980,7 @@ export declare const jiraDataCenterGetJiraIssuesByQueryOutputSchema: z.ZodObject
             resolution?: string | null | undefined;
         };
     }[] | undefined;
-    total?: number | undefined;
+    itemsReturned?: number | undefined;
     truncated?: boolean | undefined;
 }, {
     error?: string | undefined;
@@ -4019,7 +4028,7 @@ export declare const jiraDataCenterGetJiraIssuesByQueryOutputSchema: z.ZodObject
             resolution?: string | null | undefined;
         };
     }[] | undefined;
-    total?: number | undefined;
+    itemsReturned?: number | undefined;
     truncated?: boolean | undefined;
 }>;
 export type jiraDataCenterGetJiraIssuesByQueryOutputType = z.infer<typeof jiraDataCenterGetJiraIssuesByQueryOutputSchema>;

package/dist/actions/autogen/types.js

@@ -823,10 +823,22 @@ export const jiraGetJiraIssuesByQueryParamsSchema = z.object({
     query: z.string().describe("The JQL query to execute"),
     limit: z.coerce
         .number()
-        .describe("The maximum number of records to retrieve. Defaults to 100. For exhaustive queries where all matching issues are needed, set this to a value larger than the expected result count (e.g. 500 or 1000).")
+        .describe("The maximum number of records to retrieve per call (page size). Defaults to 100.")
+        .optional(),
+    startAt: z.coerce
+        .number()
+        .describe("Offset of the first result to return. Defaults to 0. To page through results: count the number of results you can actually read in the response and pass currentStartAt + countOfResultsRead as the next startAt. Do not blindly use itemsReturned to advance — the response may be truncated by the system after this action returns, meaning you may see fewer results than itemsReturned reports.")
         .optional(),
 });
 export const jiraGetJiraIssuesByQueryOutputSchema = z.object({
+    itemsReturned: z.coerce
+        .number()
+        .describe("Number of items fetched by this action. This field intentionally appears before results so it survives system-level response truncation. Warning: the system may truncate the results array before you see it, so you may receive fewer results than this number. Always count the results you can actually read and use currentStartAt + countOfResultsRead as the next startAt, not currentStartAt + itemsReturned.")
+        .optional(),
+    truncated: z
+        .boolean()
+        .describe("True when more results exist beyond this batch. Call again with startAt set to currentStartAt + countOfResultsRead (the number of results you actually received in this response).")
+        .optional(),
     results: z
         .array(z.object({
         name: z.string().describe("The name of the result"),
@@ -881,14 +893,6 @@ export const jiraGetJiraIssuesByQueryOutputSchema = z.object({
     }))
         .describe("The results of the Jira issues")
         .optional(),
-    total: z.coerce
-        .number()
-        .describe("The total number of Jira issues matching the query. When present and greater than the number of results returned, re-run with a higher limit to retrieve all issues.")
-        .optional(),
-    truncated: z
-        .boolean()
-        .describe("True when the result set was cut off at the requested limit and more issues exist. Re-run with a higher limit to retrieve all issues.")
-        .optional(),
     error: z.string().describe("The error that occurred if the records were not successfully retrieved").optional(),
 });
 export const jiraLinkJiraIssuesParamsSchema = z.object({
@@ -1086,10 +1090,22 @@ export const jiraOrgGetJiraIssuesByQueryParamsSchema = z.object({
     query: z.string().describe("The JQL query to execute"),
     limit: z.coerce
         .number()
-        .describe("The maximum number of records to retrieve. Defaults to 100. For exhaustive queries where all matching issues are needed, set this to a value larger than the expected result count (e.g. 500 or 1000).")
+        .describe("The maximum number of records to retrieve per call (page size). Defaults to 100.")
+        .optional(),
+    startAt: z.coerce
+        .number()
+        .describe("Offset of the first result to return. Defaults to 0. To page through results: count the number of results you can actually read in the response and pass currentStartAt + countOfResultsRead as the next startAt. Do not blindly use itemsReturned to advance — the response may be truncated by the system after this action returns, meaning you may see fewer results than itemsReturned reports.")
         .optional(),
 });
 export const jiraOrgGetJiraIssuesByQueryOutputSchema = z.object({
+    itemsReturned: z.coerce
+        .number()
+        .describe("Number of items fetched by this action. This field intentionally appears before results so it survives system-level response truncation. Warning: the system may truncate the results array before you see it, so you may receive fewer results than this number. Always count the results you can actually read and use currentStartAt + countOfResultsRead as the next startAt, not currentStartAt + itemsReturned.")
+        .optional(),
+    truncated: z
+        .boolean()
+        .describe("True when more results exist beyond this batch. Call again with startAt set to currentStartAt + countOfResultsRead (the number of results you actually received in this response).")
+        .optional(),
     results: z
         .array(z.object({
         name: z.string().describe("The name of the result"),
@@ -1144,14 +1160,6 @@ export const jiraOrgGetJiraIssuesByQueryOutputSchema = z.object({
     }))
         .describe("The results of the Jira issues")
         .optional(),
-    total: z.coerce
-        .number()
-        .describe("The total number of Jira issues matching the query. When present and greater than the number of results returned, re-run with a higher limit to retrieve all issues.")
-        .optional(),
-    truncated: z
-        .boolean()
-        .describe("True when the result set was cut off at the requested limit and more issues exist. Re-run with a higher limit to retrieve all issues.")
-        .optional(),
     error: z.string().describe("The error that occurred if the records were not successfully retrieved").optional(),
 });
 export const jiraOrgLinkJiraIssuesParamsSchema = z.object({
@@ -1349,10 +1357,22 @@ export const jiraDataCenterGetJiraIssuesByQueryParamsSchema = z.object({
     query: z.string().describe("The JQL query to execute"),
     limit: z.coerce
         .number()
-        .describe("The maximum number of records to retrieve. Defaults to 100. For exhaustive queries where all matching issues are needed, set this to a value larger than the expected result count (e.g. 500 or 1000).")
+        .describe("The maximum number of records to retrieve per call (page size). Defaults to 100.")
+        .optional(),
+    startAt: z.coerce
+        .number()
+        .describe("Offset of the first result to return. Defaults to 0. To page through results: count the number of results you can actually read in the response and pass currentStartAt + countOfResultsRead as the next startAt. Do not blindly use itemsReturned to advance — the response may be truncated by the system after this action returns, meaning you may see fewer results than itemsReturned reports.")
         .optional(),
 });
 export const jiraDataCenterGetJiraIssuesByQueryOutputSchema = z.object({
+    itemsReturned: z.coerce
+        .number()
+        .describe("Number of items fetched by this action. This field intentionally appears before results so it survives system-level response truncation. Warning: the system may truncate the results array before you see it, so you may receive fewer results than this number. Always count the results you can actually read and use currentStartAt + countOfResultsRead as the next startAt, not currentStartAt + itemsReturned.")
+        .optional(),
+    truncated: z
+        .boolean()
+        .describe("True when more results exist beyond this batch. Call again with startAt set to currentStartAt + countOfResultsRead (the number of results you actually received in this response).")
+        .optional(),
     results: z
         .array(z.object({
         name: z.string().describe("The name of the result"),
@@ -1407,14 +1427,6 @@ export const jiraDataCenterGetJiraIssuesByQueryOutputSchema = z.object({
     }))
         .describe("The results of the Jira issues")
         .optional(),
-    total: z.coerce
-        .number()
-        .describe("The total number of Jira issues matching the query. When present and greater than the number of results returned, re-run with a higher limit to retrieve all issues.")
-        .optional(),
-    truncated: z
-        .boolean()
-        .describe("True when the result set was cut off at the requested limit and more issues exist. Re-run with a higher limit to retrieve all issues.")
-        .optional(),
     error: z.string().describe("The error that occurred if the records were not successfully retrieved").optional(),
 });
 export const jiraDataCenterLinkJiraIssuesParamsSchema = z.object({

package/dist/actions/providers/jira/getJiraDCIssuesByQuery.d.ts

@@ -1,9 +1,8 @@
 import type { jiraGetJiraIssuesByQueryFunction } from "../../autogen/types.js";
 /**
  * Get Jira issues from Jira Data Center using offset-based pagination (startAt).
- * Returns `total` from the Jira API response so callers can detect truncation by
- * comparing total > results.length. Does not return `truncated` — use `total` instead.
- * (Contrast with the Cloud implementation which returns `truncated` but not `total`.)
+ * Returns `itemsReturned` and `truncated` so agents can page through results by
+ * incrementing startAt by itemsReturned each call until truncated is false.
  */
 declare const getJiraDCIssuesByQuery: jiraGetJiraIssuesByQueryFunction;
 export default getJiraDCIssuesByQuery;

package/dist/actions/providers/jira/getJiraDCIssuesByQuery.js

@@ -3,13 +3,12 @@ import { getJiraApiConfig, getErrorMessage, extractPlainText } from "./utils.js"
 const DEFAULT_LIMIT = 100;
 /**
  * Get Jira issues from Jira Data Center using offset-based pagination (startAt).
- * Returns `total` from the Jira API response so callers can detect truncation by
- * comparing total > results.length. Does not return `truncated` — use `total` instead.
- * (Contrast with the Cloud implementation which returns `truncated` but not `total`.)
+ * Returns `itemsReturned` and `truncated` so agents can page through results by
+ * incrementing startAt by itemsReturned each call until truncated is false.
  */
 const getJiraDCIssuesByQuery = async ({ params, authParams, }) => {
     const { authToken } = authParams;
-    const { query, limit } = params;
+    const { query, limit, startAt: paramStartAt } = params;
     const { apiUrl, browseUrl, strategy } = getJiraApiConfig(authParams);
     if (!authToken) {
         throw new Error("Auth token is required");
@@ -36,7 +35,7 @@ const getJiraDCIssuesByQuery = async ({ params, authParams, }) => {
     const searchEndpoint = strategy.getSearchEndpoint();
     const requestedLimit = limit ?? DEFAULT_LIMIT;
     const allIssues = [];
-    let startAt = 0;
+    let currentStartAt = paramStartAt ?? 0;
     let jiraTotal = undefined;
     try {
         // Keep fetching pages until we have all requested issues
@@ -47,7 +46,7 @@ const getJiraDCIssuesByQuery = async ({ params, authParams, }) => {
             const queryParams = new URLSearchParams();
             queryParams.set("jql", query);
             queryParams.set("maxResults", String(maxResults));
-            queryParams.set("startAt", String(startAt));
+            queryParams.set("startAt", String(currentStartAt));
             queryParams.set("fields", fields.join(","));
             const fullApiUrl = `${apiUrl}${searchEndpoint}?${queryParams.toString()}`;
             const response = await axiosClient.get(fullApiUrl, {
@@ -59,13 +58,16 @@ const getJiraDCIssuesByQuery = async ({ params, authParams, }) => {
             const { issues, total } = response.data;
             jiraTotal = total;
             allIssues.push(...issues);
-            if (allIssues.length >= total || issues.length === 0) {
+            if ((paramStartAt ?? 0) + allIssues.length >= total || issues.length === 0) {
                 break;
             }
-            startAt += issues.length;
+            currentStartAt += issues.length;
         }
+        const absoluteEnd = (paramStartAt ?? 0) + allIssues.length;
+        const truncated = jiraTotal !== undefined && absoluteEnd < jiraTotal;
         return {
-            total: jiraTotal,
+            itemsReturned: allIssues.length,
+            truncated,
             results: allIssues.map(issue => {
                 const { id, key, fields } = issue;
                 const { summary, description, project, issuetype, status, assignee, reporter, creator, created, updated, resolution, duedate, } = fields;

package/dist/actions/providers/jira/getJiraIssuesByQuery.js

@@ -1,13 +1,12 @@
 import { Version3Client } from "jira.js";
+import { axiosClient } from "../../util/axiosClient.js";
 import { getJiraApiConfig, getErrorMessage, extractPlainText, getUserInfoFromAccountId } from "./utils.js";
 const DEFAULT_LIMIT = 100;
-// Jira Cloud implementation using the enhanced search API (cursor-based pagination).
-// Returns `truncated: true` when results were cut off at the limit and more pages exist.
-// Note: the enhanced API does not expose a total count, so `total` is never returned here.
-// Use `jiraDataCenter` provider if you need the exact total count.
+// Jira Cloud implementation using the legacy offset-based search API (/rest/api/3/search).
+// Uses startAt for pagination so agents can resume from any offset even when app-layer truncation occurs.
 const getJiraIssuesByQuery = async ({ params, authParams, }) => {
     const { authToken, cloudId } = authParams;
-    const { query, limit } = params;
+    const { query, limit, startAt: paramStartAt } = params;
     const { browseUrl } = getJiraApiConfig(authParams);
     if (!authToken)
         throw new Error("Auth token is required");
@@ -34,47 +33,36 @@ const getJiraIssuesByQuery = async ({ params, authParams, }) => {
     ];
     const requestedLimit = limit ?? DEFAULT_LIMIT;
     const allIssues = [];
-    let nextPageToken = undefined;
-    let truncated = false;
+    let currentStartAt = paramStartAt ?? 0;
+    let jiraTotal = undefined;
+    // jira.js client is kept solely for getUserInfoFromAccountId (user email lookups)
+    const client = new Version3Client({
+        host: `https://api.atlassian.com/ex/jira/${cloudId}`,
+        authentication: { oauth2: { accessToken: authToken } },
+    });
     try {
-        // Initialize jira.js client with OAuth 2.0 authentication
-        const client = new Version3Client({
-            host: `https://api.atlassian.com/ex/jira/${cloudId}`,
-            authentication: {
-                oauth2: {
-                    accessToken: authToken,
-                },
-            },
-        });
-        // Keep fetching pages until we have all requested issues
         while (allIssues.length < requestedLimit) {
-            // Calculate how many results to fetch in this request
             const remainingIssues = requestedLimit - allIssues.length;
             const maxResults = Math.min(remainingIssues, DEFAULT_LIMIT);
-            // Use the enhanced search endpoint (recommended)
-            const searchResults = await client.issueSearch.searchForIssuesUsingJqlEnhancedSearch({
-                jql: query,
-                nextPageToken,
-                maxResults,
-                fields,
-            });
-            if (!searchResults.issues || searchResults.issues.length === 0) {
-                break;
-            }
-            allIssues.push(...searchResults.issues);
-            // Check if we've reached the end or have enough results
-            if (allIssues.length >= requestedLimit || !searchResults.nextPageToken || searchResults.issues.length === 0) {
-                // Truncated when we hit the limit but Jira still has more pages
-                truncated = allIssues.length >= requestedLimit && !!searchResults.nextPageToken;
+            const queryParams = new URLSearchParams();
+            queryParams.set("jql", query);
+            queryParams.set("maxResults", String(maxResults));
+            queryParams.set("startAt", String(currentStartAt));
+            queryParams.set("fields", fields.join(","));
+            const response = await axiosClient.get(`https://api.atlassian.com/ex/jira/${cloudId}/rest/api/3/search?${queryParams.toString()}`, { headers: { Authorization: `Bearer ${authToken}`, Accept: "application/json" } });
+            const { issues, total } = response.data;
+            jiraTotal = total;
+            allIssues.push(...issues);
+            if ((paramStartAt ?? 0) + allIssues.length >= total || issues.length === 0) {
                 break;
             }
-            nextPageToken = searchResults.nextPageToken;
+            currentStartAt += issues.length;
         }
-        // Map issues with email addresses
+        const absoluteEnd = (paramStartAt ?? 0) + allIssues.length;
+        const truncated = jiraTotal !== undefined && absoluteEnd < jiraTotal;
         const results = await Promise.all(allIssues.map(async ({ id, key, fields }) => {
             const ticketUrl = `${browseUrl}/browse/${key}`;
             const { summary, description, project, issuetype, status, assignee, reporter, creator, created, updated, resolution, duedate, } = fields;
-            // Fetch user info in parallel
             const [assigneeInfo, reporterInfo, creatorInfo] = await Promise.all([
                 getUserInfoFromAccountId(assignee?.accountId, client),
                 getUserInfoFromAccountId(reporter?.accountId, client),
@@ -88,39 +76,25 @@ const getJiraIssuesByQuery = async ({ params, authParams, }) => {
                     key,
                     summary,
                     description: extractPlainText(description),
-                    project: {
-                        id: project?.id,
-                        key: project?.key,
-                        name: project?.name,
-                    },
-                    issueType: {
-                        id: issuetype?.id,
-                        name: issuetype?.name,
-                    },
-                    status: {
-                        id: status?.id,
-                        name: status?.name,
-                        category: status?.statusCategory?.name,
-                    },
+                    project: { id: project?.id, key: project?.key, name: project?.name },
+                    issueType: { id: issuetype?.id, name: issuetype?.name },
+                    status: { id: status?.id, name: status?.name, category: status?.statusCategory?.name },
                     assignee: assigneeInfo,
                     reporter: reporterInfo,
                     creator: creatorInfo,
-                    created: created,
-                    updated: updated,
+                    created,
+                    updated,
                     resolution: resolution?.name,
                     dueDate: duedate,
                     url: ticketUrl,
                 },
             };
         }));
-        return { results, truncated };
+        return { itemsReturned: allIssues.length, truncated, results };
     }
     catch (error) {
         console.error("Error retrieving Jira issues:", error);
-        return {
-            results: [],
-            error: getErrorMessage(error),
-        };
+        return { results: [], error: getErrorMessage(error) };
     }
 };
 export default getJiraIssuesByQuery;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@credal/actions",
-  "version": "0.2.217",
+  "version": "0.2.218",
   "type": "module",
   "description": "AI Actions by Credal AI",
   "sideEffects": false,