@credal/actions 0.2.216 → 0.2.218

package/dist/actions/parse.js

@@ -125,8 +125,16 @@ async function addActionTypes({ file, prefix, action }) {
     });
 }
 async function addTypesToFile({ file, obj, fallback, name, }) {
-    // Tool calling framework currently having trouble filling in records as opposed to objects
-    const zodSchema = obj ? convert(obj).replace(/z\.record\(z\.any\(\)\)/g, "z.object({}).catchall(z.any())") : fallback;
+    // Tool calling framework currently having trouble filling in records as opposed to objects.
+    // Also coerce numeric types from strings: LLMs often emit numbers as JSON strings (e.g. "2"
+    // instead of 2) even when the schema specifies integer/number, causing Zod validation failures.
+    // z.coerce.number() is a no-op for actual numbers, so this is fully backward-compatible.
+    const zodSchema = obj
+        ? convert(obj)
+            .replace(/z\.record\(z\.any\(\)\)/g, "z.object({}).catchall(z.any())")
+            .replace(/z\.number\(\)\.int\(\)/g, "z.coerce.number().int()")
+            .replace(/z\.number\(\)/g, "z.coerce.number()")
+        : fallback;
     const zodName = `${name}Schema`;
     file.addVariableStatement({
         declarationKind: VariableDeclarationKind.Const,

package/dist/actions/providers/google-oauth/appendRowsToSpreadsheet.js

@@ -9,16 +9,17 @@ const appendRowsToSpreadsheet = async ({ params, authParams, }) => {
         throw new Error(MISSING_AUTH_TOKEN);
     }
     const { spreadsheetId, sheetName, rows } = params;
-    // Transform rows from schema format to Google Sheets API format
-    // Schema: [[{ stringValue: "cell1" }, { stringValue: "cell2" }], ...]
-    // API expects: [["cell1", "cell2"], ...]
-    const values = rows.map(row => row.map(cell => cell.stringValue));
-    const appendUrl = `https://sheets.googleapis.com/v4/spreadsheets/${spreadsheetId}/values/'${sheetName ?? "Sheet1"}':append`;
     try {
+        if (rows.length === 0) {
+            throw new Error("rows array cannot be empty");
+        }
+        const sheet = sheetName ?? "Sheet1";
+        const quotedSheet = /[\s'!]/.test(sheet) ? `'${sheet.replace(/'/g, "''")}'` : sheet;
+        const appendUrl = `https://sheets.googleapis.com/v4/spreadsheets/${spreadsheetId}/values/${encodeURIComponent(quotedSheet)}:append`;
         const response = await axiosClient.post(appendUrl, {
-            values,
+            values: rows,
             majorDimension: "ROWS",
-            range: `'${sheetName}'`,
+            range: quotedSheet,
         }, {
             headers: {
                 Authorization: `Bearer ${authParams.authToken}`,

package/dist/actions/providers/google-oauth/updateRowsInSpreadsheet.js

@@ -8,20 +8,26 @@ const updateRowsInSpreadsheet = async ({ params, authParams, }) => {
     if (!authParams.authToken) {
         throw new Error(MISSING_AUTH_TOKEN);
     }
-    const { spreadsheetId, sheetName, startRow, rows } = params;
-    if (rows.length === 0) {
-        throw new Error("rows array cannot be empty");
-    }
-    const values = rows.map(row => row.map(cell => cell.stringValue));
-    if (startRow < 1) {
-        throw new Error("startRow must be >= 1");
-    }
-    const endRow = startRow + rows.length - 1;
-    const range = `'${sheetName ?? "Sheet1"}'!A${startRow}:ZZ${endRow}`;
-    const updateUrl = `https://sheets.googleapis.com/v4/spreadsheets/${spreadsheetId}/values/${encodeURIComponent(range)}`;
+    const { spreadsheetId, sheetName, startRow, startColumn, rows } = params;
     try {
+        if (rows.length === 0) {
+            throw new Error("rows array cannot be empty");
+        }
+        if (startRow < 1) {
+            throw new Error("startRow must be >= 1");
+        }
+        const col = startColumn ?? "A";
+        if (!/^[A-Za-z]+$/.test(col)) {
+            throw new Error(`startColumn must be a column letter (e.g. "A", "BE"), got: "${col}"`);
+        }
+        const endRow = startRow + rows.length - 1;
+        const sheet = sheetName ?? "Sheet1";
+        // Only quote sheet names that contain spaces or special characters
+        const quotedSheet = /[\s'!]/.test(sheet) ? `'${sheet.replace(/'/g, "''")}'` : sheet;
+        const range = `${quotedSheet}!${col}${startRow}:ZZ${endRow}`;
+        const updateUrl = `https://sheets.googleapis.com/v4/spreadsheets/${spreadsheetId}/values/${encodeURIComponent(range)}`;
         const response = await axiosClient.put(updateUrl, {
-            values,
+            values: rows,
             majorDimension: "ROWS",
             range,
         }, {

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.216",
+  "version": "0.2.218",
   "type": "module",
   "description": "AI Actions by Credal AI",
   "sideEffects": false,