@credal/actions 0.2.224 → 0.2.226

package/dist/actions/autogen/templates.js

@@ -11484,15 +11484,19 @@ export const microsoftCreateDocumentDefinition = {
         properties: {
             siteId: {
                 type: "string",
-                description: "The ID of the site where the document will be created",
+                description: "The ID of the site where the document will be created (targets the site's default document library; ignored if driveId is provided)",
+            },
+            driveId: {
+                type: "string",
+                description: "The ID of the drive (document library) to create the document in. Required to target a non-default document library; takes precedence over siteId. Can be resolved from a SharePoint URL with the getSharepointItem action",
             },
             name: {
                 type: "string",
-                description: "The name of the new document (include extension like .docx or .xlsx)",
+                description: "The name of the new document, including the extension. Use .docx for a Word document (the content is converted into a real Word file) or a plain-text extension like .txt or .md. Other Office extensions (.doc, .xlsx, .xls, .pptx, .ppt) are not supported and will be rejected",
             },
             content: {
                 type: "string",
-                description: "The content to add to the new document",
+                description: "The plain-text content of the document. When the name ends in .docx it is converted into a Word document with one paragraph per line; otherwise it is written as-is",
             },
             folderId: {
                 type: "string",
@@ -11540,7 +11544,11 @@ export const microsoftUpdateDocumentDefinition = {
         properties: {
             siteId: {
                 type: "string",
-                description: "The ID of the site where the document is located",
+                description: "The ID of the site where the document is located (targets the site's default document library; ignored if driveId is provided)",
+            },
+            driveId: {
+                type: "string",
+                description: "The ID of the drive (document library) containing the document. Required when the document is in a non-default document library; takes precedence over siteId. Can be resolved from a SharePoint URL with the getSharepointItem action",
             },
             documentId: {
                 type: "string",
@@ -11548,7 +11556,7 @@ export const microsoftUpdateDocumentDefinition = {
             },
             content: {
                 type: "string",
-                description: "The new content to update in the document",
+                description: "The new plain-text content for the document (replaces the existing content entirely). If the target file is a .docx it is converted into a Word document with one paragraph per line; other Office formats (.doc, .xlsx, .xls, .pptx, .ppt) cannot be updated",
             },
         },
     },
@@ -11602,7 +11610,11 @@ export const microsoftUpdateSpreadsheetDefinition = {
             },
             siteId: {
                 type: "string",
-                description: "The ID of the site where the spreadsheet is located",
+                description: "The ID of the site where the spreadsheet is located (targets the site's default document library; ignored if driveId is provided)",
+            },
+            driveId: {
+                type: "string",
+                description: "The ID of the drive (document library) containing the spreadsheet. Required when the spreadsheet is in a non-default document library; takes precedence over siteId. Can be resolved from a SharePoint URL with the getSharepointItem action",
             },
         },
     },
@@ -11722,7 +11734,11 @@ export const microsoftGetDocumentDefinition = {
         properties: {
             siteId: {
                 type: "string",
-                description: "The ID of the site where the document is located (optional for OneDrive)",
+                description: "The ID of the site where the document is located (optional for OneDrive; targets the site's default document library; ignored if driveId is provided)",
+            },
+            driveId: {
+                type: "string",
+                description: "The ID of the drive (document library) containing the document. Required when the document is in a non-default document library; takes precedence over siteId. Can be resolved from a SharePoint URL with the getSharepointItem action",
             },
             documentId: {
                 type: "string",

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

@@ -8228,6 +8228,7 @@ export type salesforceGetReportMetadataOutputType = z.infer<typeof salesforceGet
 export type salesforceGetReportMetadataFunction = ActionFunction<salesforceGetReportMetadataParamsType, AuthParamsType, salesforceGetReportMetadataOutputType>;
 export declare const microsoftCreateDocumentParamsSchema: z.ZodObject<{
     siteId: z.ZodOptional<z.ZodString>;
+    driveId: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
     content: z.ZodString;
     folderId: z.ZodOptional<z.ZodString>;
@@ -8235,11 +8236,13 @@ export declare const microsoftCreateDocumentParamsSchema: z.ZodObject<{
     name: string;
     content: string;
     siteId?: string | undefined;
+    driveId?: string | undefined;
     folderId?: string | undefined;
 }, {
     name: string;
     content: string;
     siteId?: string | undefined;
+    driveId?: string | undefined;
     folderId?: string | undefined;
 }>;
 export type microsoftCreateDocumentParamsType = z.infer<typeof microsoftCreateDocumentParamsSchema>;
@@ -8266,16 +8269,19 @@ export type microsoftCreateDocumentOutputType = z.infer<typeof microsoftCreateDo
 export type microsoftCreateDocumentFunction = ActionFunction<microsoftCreateDocumentParamsType, AuthParamsType, microsoftCreateDocumentOutputType>;
 export declare const microsoftUpdateDocumentParamsSchema: z.ZodObject<{
     siteId: z.ZodOptional<z.ZodString>;
+    driveId: z.ZodOptional<z.ZodString>;
     documentId: z.ZodString;
     content: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     content: string;
     documentId: string;
     siteId?: string | undefined;
+    driveId?: string | undefined;
 }, {
     content: string;
     documentId: string;
     siteId?: string | undefined;
+    driveId?: string | undefined;
 }>;
 export type microsoftUpdateDocumentParamsType = z.infer<typeof microsoftUpdateDocumentParamsSchema>;
 export declare const microsoftUpdateDocumentOutputSchema: z.ZodObject<{
@@ -8298,16 +8304,19 @@ export declare const microsoftUpdateSpreadsheetParamsSchema: z.ZodObject<{
     range: z.ZodString;
     values: z.ZodArray<z.ZodArray<z.ZodString, "many">, "many">;
     siteId: z.ZodOptional<z.ZodString>;
+    driveId: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     values: string[][];
     range: string;
     spreadsheetId: string;
     siteId?: string | undefined;
+    driveId?: string | undefined;
 }, {
     values: string[][];
     range: string;
     spreadsheetId: string;
     siteId?: string | undefined;
+    driveId?: string | undefined;
 }>;
 export type microsoftUpdateSpreadsheetParamsType = z.infer<typeof microsoftUpdateSpreadsheetParamsSchema>;
 export declare const microsoftUpdateSpreadsheetOutputSchema: z.ZodObject<{
@@ -8382,13 +8391,16 @@ export type microsoftMessageTeamsChannelOutputType = z.infer<typeof microsoftMes
 export type microsoftMessageTeamsChannelFunction = ActionFunction<microsoftMessageTeamsChannelParamsType, AuthParamsType, microsoftMessageTeamsChannelOutputType>;
 export declare const microsoftGetDocumentParamsSchema: z.ZodObject<{
     siteId: z.ZodOptional<z.ZodString>;
+    driveId: z.ZodOptional<z.ZodString>;
     documentId: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     documentId: string;
     siteId?: string | undefined;
+    driveId?: string | undefined;
 }, {
     documentId: string;
     siteId?: string | undefined;
+    driveId?: string | undefined;
 }>;
 export type microsoftGetDocumentParamsType = z.infer<typeof microsoftGetDocumentParamsSchema>;
 export declare const microsoftGetDocumentOutputSchema: z.ZodObject<{

package/dist/actions/autogen/types.js

@@ -4260,9 +4260,20 @@ export const salesforceGetReportMetadataOutputSchema = z.object({
         .optional(),
 });
 export const microsoftCreateDocumentParamsSchema = z.object({
-    siteId: z.string().describe("The ID of the site where the document will be created").optional(),
-    name: z.string().describe("The name of the new document (include extension like .docx or .xlsx)"),
-    content: z.string().describe("The content to add to the new document"),
+    siteId: z
+        .string()
+        .describe("The ID of the site where the document will be created (targets the site's default document library; ignored if driveId is provided)")
+        .optional(),
+    driveId: z
+        .string()
+        .describe("The ID of the drive (document library) to create the document in. Required to target a non-default document library; takes precedence over siteId. Can be resolved from a SharePoint URL with the getSharepointItem action")
+        .optional(),
+    name: z
+        .string()
+        .describe("The name of the new document, including the extension. Use .docx for a Word document (the content is converted into a real Word file) or a plain-text extension like .txt or .md. Other Office extensions (.doc, .xlsx, .xls, .pptx, .ppt) are not supported and will be rejected"),
+    content: z
+        .string()
+        .describe("The plain-text content of the document. When the name ends in .docx it is converted into a Word document with one paragraph per line; otherwise it is written as-is"),
     folderId: z.string().describe("The ID of the folder to create the document in (optional)").optional(),
 });
 export const microsoftCreateDocumentOutputSchema = z.object({
@@ -4273,9 +4284,18 @@ export const microsoftCreateDocumentOutputSchema = z.object({
     error: z.string().describe("The error that occurred if the document was not created successfully").optional(),
 });
 export const microsoftUpdateDocumentParamsSchema = z.object({
-    siteId: z.string().describe("The ID of the site where the document is located").optional(),
+    siteId: z
+        .string()
+        .describe("The ID of the site where the document is located (targets the site's default document library; ignored if driveId is provided)")
+        .optional(),
+    driveId: z
+        .string()
+        .describe("The ID of the drive (document library) containing the document. Required when the document is in a non-default document library; takes precedence over siteId. Can be resolved from a SharePoint URL with the getSharepointItem action")
+        .optional(),
     documentId: z.string().describe("The ID of the document"),
-    content: z.string().describe("The new content to update in the document"),
+    content: z
+        .string()
+        .describe("The new plain-text content for the document (replaces the existing content entirely). If the target file is a .docx it is converted into a Word document with one paragraph per line; other Office formats (.doc, .xlsx, .xls, .pptx, .ppt) cannot be updated"),
 });
 export const microsoftUpdateDocumentOutputSchema = z.object({
     success: z.boolean().describe("Whether the document was updated successfully"),
@@ -4286,7 +4306,14 @@ export const microsoftUpdateSpreadsheetParamsSchema = z.object({
     spreadsheetId: z.string().describe("The ID of the spreadsheet to update"),
     range: z.string().describe('The range of cells to update (e.g., "Sheet1!A1:B2")'),
     values: z.array(z.array(z.string())).describe("The values to update in the specified range"),
-    siteId: z.string().describe("The ID of the site where the spreadsheet is located").optional(),
+    siteId: z
+        .string()
+        .describe("The ID of the site where the spreadsheet is located (targets the site's default document library; ignored if driveId is provided)")
+        .optional(),
+    driveId: z
+        .string()
+        .describe("The ID of the drive (document library) containing the spreadsheet. Required when the spreadsheet is in a non-default document library; takes precedence over siteId. Can be resolved from a SharePoint URL with the getSharepointItem action")
+        .optional(),
 });
 export const microsoftUpdateSpreadsheetOutputSchema = z.object({
     success: z.boolean().describe("Whether the spreadsheet was updated successfully"),
@@ -4313,7 +4340,14 @@ export const microsoftMessageTeamsChannelOutputSchema = z.object({
     messageId: z.string().describe("The ID of the message that was sent").optional(),
 });
 export const microsoftGetDocumentParamsSchema = z.object({
-    siteId: z.string().describe("The ID of the site where the document is located (optional for OneDrive)").optional(),
+    siteId: z
+        .string()
+        .describe("The ID of the site where the document is located (optional for OneDrive; targets the site's default document library; ignored if driveId is provided)")
+        .optional(),
+    driveId: z
+        .string()
+        .describe("The ID of the drive (document library) containing the document. Required when the document is in a non-default document library; takes precedence over siteId. Can be resolved from a SharePoint URL with the getSharepointItem action")
+        .optional(),
     documentId: z.string().describe("The ID of the document to retrieve"),
 });
 export const microsoftGetDocumentOutputSchema = z.object({

package/dist/actions/providers/github/searchRepository.js

@@ -47,7 +47,7 @@ const searchRepository = (_a) => __awaiter(void 0, [_a], void 0, function* ({ pa
         name: item.name,
         path: item.path,
         sha: item.sha.slice(0, 7),
-        url: item.html_url,
+        url: item.url,
         score: item.score,
         textMatches: item.text_matches
             ? item.text_matches.map(match => {
@@ -68,7 +68,7 @@ const searchRepository = (_a) => __awaiter(void 0, [_a], void 0, function* ({ pa
         const full = commitDetails.find(c => c.data.sha === item.sha);
         return {
             sha: item.sha,
-            url: item.html_url,
+            url: item.url,
             commit: {
                 message: item.commit.message,
                 author: item.commit.author,
@@ -76,11 +76,11 @@ const searchRepository = (_a) => __awaiter(void 0, [_a], void 0, function* ({ pa
             score: item.score,
             author: (_a = item.author) !== null && _a !== void 0 ? _a : undefined,
             files: ((_b = full === null || full === void 0 ? void 0 : full.data.files) === null || _b === void 0 ? void 0 : _b.slice(0, MAX_FILES_PER_COMMIT).map(f => {
-                var _a, _b, _c;
+                var _a;
                 return ({
                     filename: f.filename,
                     status: f.status,
-                    patch: (_c = (_b = (_a = f.patch) === null || _a === void 0 ? void 0 : _a.split("\n")) === null || _b === void 0 ? void 0 : _b.slice(0, MAX_PATCH_LINES)) === null || _c === void 0 ? void 0 : _c.join("\n"),
+                    patch: (_a = f.patch) === null || _a === void 0 ? void 0 : _a.split("\n").slice(0, MAX_PATCH_LINES).join("\n"),
                 });
             })) || [],
         };
@@ -104,18 +104,18 @@ const searchRepository = (_a) => __awaiter(void 0, [_a], void 0, function* ({ pa
         const prIndex = prNumbers.indexOf(item.number);
         const files = isPR && prIndex !== -1
             ? prFiles[prIndex].data.slice(0, MAX_FILES_PER_PR).map(f => {
-                var _a, _b, _c;
+                var _a;
                 return ({
                     filename: f.filename,
                     status: f.status,
-                    patch: (_c = (_b = (_a = f.patch) === null || _a === void 0 ? void 0 : _a.split("\n")) === null || _b === void 0 ? void 0 : _b.slice(0, MAX_PATCH_LINES)) === null || _c === void 0 ? void 0 : _c.join("\n"),
+                    patch: (_a = f.patch) === null || _a === void 0 ? void 0 : _a.split("\n").slice(0, MAX_PATCH_LINES).join("\n"),
                 });
             })
             : undefined;
         return {
             number: item.number,
             title: item.title,
-            url: item.html_url,
+            html_url: item.html_url,
             state: item.state,
             isPullRequest: isPR,
             body: item.body,

package/dist/actions/providers/google-oauth/listFilesWithAssignedComments.d.ts

@@ -0,0 +1,3 @@
+import type { googleOauthListFilesWithAssignedCommentsFunction } from "../../autogen/types.js";
+declare const listFilesWithAssignedComments: googleOauthListFilesWithAssignedCommentsFunction;
+export default listFilesWithAssignedComments;

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

@@ -0,0 +1,41 @@
+import { axiosClient } from "../../util/axiosClient.js";
+import { MISSING_AUTH_TOKEN } from "../../util/missingAuthConstants.js";
+import { dedupeByIdKeepFirst, filterReadableFiles } from "./utils.js";
+const ASSIGNED_COMMENTS_QUERY = "followup='assignedcomments' and trashed=false";
+const listFilesWithAssignedComments = async ({ params, authParams, }) => {
+    if (!authParams.authToken) {
+        return { success: false, error: MISSING_AUTH_TOKEN, files: [] };
+    }
+    const { limit } = params;
+    try {
+        const allDrivesUrl = `https://www.googleapis.com/drive/v3/files?q=${encodeURIComponent(ASSIGNED_COMMENTS_QUERY)}&fields=files(id,name,mimeType,webViewLink)&supportsAllDrives=true&includeItemsFromAllDrives=true&corpora=allDrives&pageSize=100`;
+        const orgWideUrl = `https://www.googleapis.com/drive/v3/files?q=${encodeURIComponent(ASSIGNED_COMMENTS_QUERY)}&fields=files(id,name,mimeType,webViewLink)&corpora=domain&pageSize=100`;
+        const [allDrivesRes, orgWideRes] = await Promise.all([
+            axiosClient.get(allDrivesUrl, { headers: { Authorization: `Bearer ${authParams.authToken}` } }),
+            axiosClient.get(orgWideUrl, { headers: { Authorization: `Bearer ${authParams.authToken}` } }),
+        ]);
+        const rawFiles = [allDrivesRes.data.files, orgWideRes.data.files]
+            .filter(Boolean)
+            .flatMap(files => filterReadableFiles(files));
+        const files = rawFiles.map((file) => ({
+            id: file.id || "",
+            name: file.name || "",
+            mimeType: file.mimeType || "",
+            url: file.webViewLink || "",
+        }));
+        const dedupedFiles = dedupeByIdKeepFirst(files);
+        return {
+            success: true,
+            files: limit ? dedupedFiles.slice(0, limit) : dedupedFiles,
+        };
+    }
+    catch (error) {
+        console.error("Error listing files with assigned comments", error);
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : "Unknown error",
+            files: [],
+        };
+    }
+};
+export default listFilesWithAssignedComments;

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

@@ -0,0 +1,3 @@
+import type { jiraUpdateServiceDeskRequestFunction } from "../../autogen/types.js";
+declare const updateServiceDeskRequest: jiraUpdateServiceDeskRequestFunction;
+export default updateServiceDeskRequest;

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

@@ -0,0 +1,72 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { axiosClient } from "../../util/axiosClient.js";
+const updateServiceDeskRequest = (_a) => __awaiter(void 0, [_a], void 0, function* ({ params, authParams, }) {
+    const { issueId, requestTypeId, summary, description, priority, customFields } = params;
+    const { authToken, cloudId, baseUrl } = authParams;
+    if (!cloudId || !authToken) {
+        throw new Error("Valid Cloud ID and auth token are required to update service desk request");
+    }
+    // Use the regular Jira API for updating service desk requests as they are still Jira issues
+    const apiUrl = `https://api.atlassian.com/ex/jira/${cloudId}/rest/api/3/issue/${issueId}`;
+    const formattedDescription = description
+        ? {
+            type: "doc",
+            version: 1,
+            content: [
+                {
+                    type: "paragraph",
+                    content: [
+                        {
+                            type: "text",
+                            text: description,
+                        },
+                    ],
+                },
+            ],
+        }
+        : undefined;
+    const payload = {
+        fields: Object.assign(Object.assign(Object.assign(Object.assign({}, (summary && { summary })), (formattedDescription && { description: formattedDescription })), (priority && { priority: { name: priority } })), (customFields && Object.assign({}, customFields))),
+    };
+    try {
+        yield axiosClient.put(apiUrl, payload, {
+            headers: {
+                Authorization: `Bearer ${authToken}`,
+                Accept: "application/json",
+                "Content-Type": "application/json",
+            },
+        });
+        // Get the updated issue details to return current status and web link
+        const getResponse = yield axiosClient.get(apiUrl, {
+            headers: {
+                Authorization: `Bearer ${authToken}`,
+                Accept: "application/json",
+            },
+        });
+        const issueKey = getResponse.data.key;
+        const currentStatus = getResponse.data.fields.status.name;
+        const webLink = `${baseUrl}/browse/${issueKey}`;
+        return {
+            success: true,
+            issueKey,
+            webLink,
+            currentStatus,
+        };
+    }
+    catch (error) {
+        console.error("Error updating service desk request:", error);
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : "Unknown error",
+        };
+    }
+});
+export default updateServiceDeskRequest;

package/dist/actions/providers/microsoft/createDocument.js

@@ -1,6 +1,6 @@
-import { getGraphClient, validateAndSanitizeFileName } from "./utils.js";
+import { fileNameHasDocxExtension, generateDocxFromPlainText, getDrivePath, getGraphClient, getUnsupportedOfficeExtension, validateAndSanitizeFileName, } from "./utils.js";
 const createDocument = async ({ params, authParams, }) => {
-    const { folderId, name, content, siteId } = params;
+    const { folderId, name, content, siteId, driveId } = params;
     let client = undefined;
     try {
         client = await getGraphClient(authParams);
@@ -11,12 +11,21 @@ const createDocument = async ({ params, authParams, }) => {
             error: "Error while authorizing: " + (error instanceof Error ? error.message : "Unknown error"),
         };
     }
-    const apiEndpointPrefix = siteId ? `/sites/${siteId}` : "/me";
     const sanitizedFileName = validateAndSanitizeFileName(name);
-    const endpoint = `${apiEndpointPrefix}/drive/items/${folderId || "root"}:/${sanitizedFileName}:/content`;
+    const unsupportedOfficeExtension = getUnsupportedOfficeExtension(sanitizedFileName);
+    if (unsupportedOfficeExtension) {
+        return {
+            success: false,
+            error: `Cannot create "${unsupportedOfficeExtension}" files: this action writes the provided text and can only generate Word documents. Use a .docx extension for a Word document, or a plain-text extension like .txt.`,
+        };
+    }
+    const endpoint = `${getDrivePath({ driveId, siteId })}/items/${folderId || "root"}:/${sanitizedFileName}:/content`;
     try {
+        // .docx is a ZIP-of-XML container, so the text must be converted into real OOXML
+        // bytes; writing it directly would produce a file Word cannot open.
+        const body = fileNameHasDocxExtension(sanitizedFileName) ? await generateDocxFromPlainText(content) : content;
         // Create or update the document
-        const response = await client.api(endpoint).put(content);
+        const response = await client.api(endpoint).put(body);
         return {
             success: true,
             documentId: response.id,

package/dist/actions/providers/microsoft/getDocument.js

@@ -1,6 +1,6 @@
-import { getGraphClient } from "./utils.js";
+import { getDrivePath, getGraphClient } from "./utils.js";
 const getDocument = async ({ params, authParams, }) => {
-    const { siteId, documentId } = params;
+    const { siteId, driveId, documentId } = params;
     let client;
     try {
         client = await getGraphClient(authParams);
@@ -12,10 +12,7 @@ const getDocument = async ({ params, authParams, }) => {
         };
     }
     try {
-        // Construct the API endpoint
-        const endpoint = siteId
-            ? `/sites/${siteId}/drive/items/${documentId}/content`
-            : `/me/drive/items/${documentId}/content`;
+        const endpoint = `${getDrivePath({ driveId, siteId })}/items/${documentId}/content`;
         // Fetch the document content
         const response = await client.api(endpoint).get();
         return {

package/dist/actions/providers/microsoft/sendOutlookEmail.d.ts

@@ -0,0 +1,3 @@
+import type { microsoftSendOutlookEmailFunction } from "../../autogen/types.js";
+declare const sendEmail: microsoftSendOutlookEmailFunction;
+export default sendEmail;

package/dist/actions/providers/microsoft/sendOutlookEmail.js

@@ -0,0 +1,48 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { getGraphClient } from "./utils.js";
+const sendEmail = (_a) => __awaiter(void 0, [_a], void 0, function* ({ params, authParams, }) {
+    const { toRecipients, subject, body, ccRecipients, bccRecipients } = params;
+    let client = undefined;
+    try {
+        client = yield getGraphClient(authParams);
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: "Error while authorizing: " + (error instanceof Error ? error.message : "Unknown error"),
+        };
+    }
+    try {
+        const message = {
+            message: Object.assign(Object.assign({ subject, body: {
+                    contentType: "HTML",
+                    content: body,
+                }, toRecipients: toRecipients.map(email => ({ emailAddress: { address: email } })) }, (ccRecipients && ccRecipients.length > 0
+                ? { ccRecipients: ccRecipients.map(email => ({ emailAddress: { address: email } })) }
+                : {})), (bccRecipients && bccRecipients.length > 0
+                ? { bccRecipients: bccRecipients.map(email => ({ emailAddress: { address: email } })) }
+                : {})),
+            saveToSentItems: true,
+        };
+        yield client.api("/me/sendMail").post(message);
+        return {
+            success: true,
+        };
+    }
+    catch (error) {
+        console.error(error);
+        return {
+            success: false,
+            error: "Error sending email: " + (error instanceof Error ? error.message : "Unknown error"),
+        };
+    }
+});
+export default sendEmail;

package/dist/actions/providers/microsoft/updateDocument.js

@@ -1,6 +1,6 @@
-import { getGraphClient } from "./utils.js";
+import { fileNameHasDocxExtension, generateDocxFromPlainText, getDrivePath, getGraphClient, getUnsupportedOfficeExtension, } from "./utils.js";
 const updateDocument = async ({ params, authParams, }) => {
-    const { documentId, content, siteId } = params;
+    const { documentId, content, siteId, driveId } = params;
     let client = undefined;
     try {
         client = await getGraphClient(authParams);
@@ -12,11 +12,21 @@ const updateDocument = async ({ params, authParams, }) => {
         };
     }
     try {
-        // Determine the endpoint based on whether siteId is provided
-        const endpoint = siteId
-            ? `/sites/${siteId}/drive/items/${documentId}/content`
-            : `/me/drive/items/${documentId}/content`;
-        const response = await client.api(endpoint).put(content);
+        const drivePath = getDrivePath({ driveId, siteId });
+        // The target's filename decides how the content must be written: .docx is a
+        // ZIP-of-XML container, so overwriting it with raw text would corrupt it.
+        const itemMetadata = await client.api(`${drivePath}/items/${documentId}?$select=name`).get();
+        const fileName = itemMetadata?.name ?? "";
+        const unsupportedOfficeExtension = getUnsupportedOfficeExtension(fileName);
+        if (unsupportedOfficeExtension) {
+            return {
+                success: false,
+                error: `Cannot update "${unsupportedOfficeExtension}" files: this action writes the provided text and can only generate Word documents. Only .docx and plain-text files can be updated.`,
+            };
+        }
+        const body = fileNameHasDocxExtension(fileName) ? await generateDocxFromPlainText(content) : content;
+        const endpoint = `${drivePath}/items/${documentId}/content`;
+        const response = await client.api(endpoint).put(body);
         return {
             success: true,
             documentUrl: response.webUrl,

package/dist/actions/providers/microsoft/updateSpreadsheet.js

@@ -1,6 +1,6 @@
-import { getGraphClient } from "./utils.js";
+import { getDrivePath, getGraphClient } from "./utils.js";
 const updateSpreadsheet = async ({ params, authParams, }) => {
-    const { spreadsheetId, range, values, siteId } = params; // Added siteId to destructured params
+    const { spreadsheetId, range, values, siteId, driveId } = params;
     let client = undefined;
     try {
         client = await getGraphClient(authParams);
@@ -11,7 +11,6 @@ const updateSpreadsheet = async ({ params, authParams, }) => {
             error: "Error while authorizing: " + (error instanceof Error ? error.message : "Unknown error"),
         };
     }
-    const apiEndpointPrefix = siteId ? `/sites/${siteId}` : "/me";
     if (!range.includes("!")) {
         return {
             success: false,
@@ -25,7 +24,7 @@ const updateSpreadsheet = async ({ params, authParams, }) => {
             error: "Invalid range format. Both sheet name and cell range must be specified.",
         };
     }
-    const apiEndpoint = `${apiEndpointPrefix}/drive/items/${spreadsheetId}/workbook/worksheets/${sheetName}/range(address='${cellRange}')`;
+    const apiEndpoint = `${getDrivePath({ driveId, siteId })}/items/${spreadsheetId}/workbook/worksheets/${sheetName}/range(address='${cellRange}')`;
     try {
         const response = await client.api(apiEndpoint).patch({ values });
         return {

package/dist/actions/providers/microsoft/utils.d.ts

@@ -1,10 +1,27 @@
 import { Client } from "@microsoft/microsoft-graph-client";
 import type { AuthParamsType } from "../../autogen/types.js";
 export declare function getGraphClient(authParams: AuthParamsType): Promise<Client>;
+/**
+ * Builds the Graph API path prefix addressing a drive. Item IDs are scoped to a drive, so a
+ * driveId (when known) addresses the exact document library; /sites/{siteId}/drive only ever
+ * reaches the site's default library, and /me/drive the user's personal OneDrive.
+ */
+export declare function getDrivePath({ driveId, siteId }: {
+    driveId?: string;
+    siteId?: string;
+}): string;
 /**
  * Validates and sanitizes a filename for SharePoint or OneDrive.
  * @param fileName The original filename to validate and sanitize.
  * @returns A sanitized filename that is safe to use.
  */
 export declare function validateAndSanitizeFileName(fileName: string): string;
+export declare function fileNameHasDocxExtension(fileName: string): boolean;
+export declare function getUnsupportedOfficeExtension(fileName: string): string | undefined;
+/**
+ * Builds a valid .docx file from plain text, one paragraph per line. A .docx is a ZIP
+ * archive of XML parts, so text bytes written directly under a .docx name produce a
+ * corrupted document — the bytes must be generated with an OOXML writer.
+ */
+export declare function generateDocxFromPlainText(text: string): Promise<Buffer>;
 export declare const MICROSOFT_GRAPH_API_URL = "https://graph.microsoft.com/v1.0";

package/dist/actions/providers/microsoft/utils.js

@@ -1,4 +1,5 @@
 import { Client } from "@microsoft/microsoft-graph-client";
+import { Document, Packer, Paragraph, TextRun } from "docx";
 export async function getGraphClient(authParams) {
     if (!authParams.authToken) {
         throw new Error("Missing required authentication parameters");
@@ -10,6 +11,14 @@ export async function getGraphClient(authParams) {
         },
     });
 }
+/**
+ * Builds the Graph API path prefix addressing a drive. Item IDs are scoped to a drive, so a
+ * driveId (when known) addresses the exact document library; /sites/{siteId}/drive only ever
+ * reaches the site's default library, and /me/drive the user's personal OneDrive.
+ */
+export function getDrivePath({ driveId, siteId }) {
+    return driveId ? `/drives/${driveId}` : siteId ? `/sites/${siteId}/drive` : "/me/drive";
+}
 /**
  * Validates and sanitizes a filename for SharePoint or OneDrive.
  * @param fileName The original filename to validate and sanitize.
@@ -33,4 +42,24 @@ export function validateAndSanitizeFileName(fileName) {
     }
     return sanitizedFileName;
 }
+// Office formats that are binary/ZIP containers. Writing plain text bytes under these
+// extensions produces a file the corresponding Office app cannot open.
+const UNSUPPORTED_OFFICE_EXTENSIONS = [".doc", ".xlsx", ".xls", ".pptx", ".ppt"];
+export function fileNameHasDocxExtension(fileName) {
+    return fileName.toLowerCase().endsWith(".docx");
+}
+export function getUnsupportedOfficeExtension(fileName) {
+    const lowerCaseFileName = fileName.toLowerCase();
+    return UNSUPPORTED_OFFICE_EXTENSIONS.find(extension => lowerCaseFileName.endsWith(extension));
+}
+/**
+ * Builds a valid .docx file from plain text, one paragraph per line. A .docx is a ZIP
+ * archive of XML parts, so text bytes written directly under a .docx name produce a
+ * corrupted document — the bytes must be generated with an OOXML writer.
+ */
+export async function generateDocxFromPlainText(text) {
+    const paragraphs = text.split(/\r?\n/).map(line => new Paragraph({ children: [new TextRun({ text: line })] }));
+    const document = new Document({ sections: [{ properties: {}, children: paragraphs }] });
+    return Packer.toBuffer(document);
+}
 export const MICROSOFT_GRAPH_API_URL = "https://graph.microsoft.com/v1.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@credal/actions",
-  "version": "0.2.224",
+  "version": "0.2.226",
   "type": "module",
   "description": "AI Actions by Credal AI",
   "sideEffects": false,
@@ -87,7 +87,7 @@
   },
   "overrides": {
     "@xmldom/xmldom": "^0.8.13",
-    "axios": "^1.17.0",
+    "axios": "^1.18.1",
     "fast-xml-parser": "^5.7.0",
     "minimatch": "^10.2.1",
     "file-type": "^22.0.0"

package/dist/actions/groups.d.ts

@@ -1,6 +0,0 @@
-import type { ActionTemplate } from "./parse.js";
-export type ActionGroups = Record<string, {
-    description: string;
-    actions: ActionTemplate[];
-}>;
-export declare const ACTION_GROUPS: ActionGroups;

package/dist/actions/groups.js

@@ -1,220 +0,0 @@
-import { genericFillTemplateDefinition, confluenceOverwritePageDefinition, googlemapsValidateAddressDefinition, mathAddDefinition, mongoInsertMongoDocDefinition, slackSendMessageDefinition, slackGetChannelMessagesDefinition, snowflakeGetRowByFieldValueDefinition, zendeskCreateZendeskTicketDefinition, zendeskListZendeskTicketsDefinition, zendeskGetTicketDetailsDefinition, zendeskUpdateTicketStatusDefinition, zendeskAddCommentToTicketDefinition, zendeskAssignTicketDefinition, openstreetmapGetLatitudeLongitudeFromLocationDefinition, nwsGetForecastForLocationDefinition, jiraAssignJiraTicketDefinition, jiraCommentJiraTicketDefinition, jiraCreateJiraTicketDefinition, jiraGetJiraTicketDetailsDefinition, jiraGetJiraTicketHistoryDefinition, jiraUpdateJiraTicketDetailsDefinition, jiraUpdateJiraTicketStatusDefinition, googlemapsNearbysearchRestaurantsDefinition, firecrawlScrapeUrlDefinition, resendSendEmailDefinition, linkedinCreateShareLinkedinPostUrlDefinition, googleOauthCreateNewGoogleDocDefinition, xCreateShareXPostUrlDefinition, firecrawlScrapeTweetDataWithNitterDefinition, finnhubSymbolLookupDefinition, finnhubGetBasicFinancialsDefinition, confluenceFetchPageContentDefinition, snowflakeRunSnowflakeQueryDefinition, lookerEnableUserByEmailDefinition, googleOauthUpdateDocDefinition, googleOauthScheduleCalendarMeetingDefinition, googleOauthListCalendarsDefinition, googleOauthListCalendarEventsDefinition, googleOauthUpdateCalendarEventDefinition, googleOauthDeleteCalendarEventDefinition, googleOauthCreateSpreadsheetDefinition, googleOauthUpdateSpreadsheetDefinition, googleOauthCreatePresentationDefinition, googleOauthUpdatePresentationDefinition, googleOauthSearchDriveByKeywordsDefinition, googlemailSearchGmailMessagesDefinition, googlemailListGmailThreadsDefinition, googleOauthListGroupsDefinition, googleOauthGetGroupDefinition, googleOauthListGroupMembersDefinition, googleOauthHasGroupMemberDefinition, googleOauthAddGroupMemberDefinition, googleOauthDeleteGroupMemberDefinition, salesforceUpdateRecordDefinition, salesforceCreateCaseDefinition, salesforceGenerateSalesReportDefinition, salesforceGetRecordDefinition, salesforceGetSalesforceRecordsByQueryDefinition, microsoftMessageTeamsChatDefinition, microsoftMessageTeamsChannelDefinition, asanaCommentTaskDefinition, asanaCreateTaskDefinition, asanaUpdateTaskDefinition, asanaSearchTasksDefinition, githubCreateOrUpdateFileDefinition, githubCreateBranchDefinition, githubCreatePullRequestDefinition, microsoftUpdateSpreadsheetDefinition, microsoftUpdateDocumentDefinition, microsoftCreateDocumentDefinition, microsoftGetDocumentDefinition, salesforceFetchSalesforceSchemaByObjectDefinition, firecrawlDeepResearchDefinition, jiraGetJiraIssuesByQueryDefinition, githubListPullRequestsDefinition, salesforceCreateRecordDefinition, ashbyCreateNoteDefinition, ashbyGetCandidateInfoDefinition, ashbyListCandidatesDefinition, ashbyListCandidateNotesDefinition, ashbySearchCandidatesDefinition, ashbyCreateCandidateDefinition, ashbyUpdateCandidateDefinition, ashbyAddCandidateToProjectDefinition, bingGetTopNSearchResultUrlsDefinition, gongGetGongTranscriptsDefinition, kandjiGetFVRecoveryKeyForDeviceDefinition, asanaListAsanaTasksByProjectDefinition, notionSearchByTitleDefinition, asanaGetTasksDetailsDefinition, jamfGetJamfComputerInventoryDefinition, jamfGetJamfFileVaultRecoveryKeyDefinition, oktaListOktaUsersDefinition, oktaGetOktaUserDefinition, oktaListOktaUserGroupsDefinition, oktaListOktaGroupsDefinition, oktaGetOktaGroupDefinition, oktaListOktaGroupMembersDefinition, oktaRemoveUserFromGroupDefinition, oktaAddUserToGroupDefinition, oktaResetPasswordDefinition, oktaResetMFADefinition, oktaListMFADefinition, } from "./autogen/templates.js";
-export const ACTION_GROUPS = {
-    GENERIC: {
-        description: "Generic utility actions",
-        actions: [genericFillTemplateDefinition],
-    },
-    ASANA: {
-        description: "Actions for interacting with Asana",
-        actions: [
-            asanaCommentTaskDefinition,
-            asanaCreateTaskDefinition,
-            asanaUpdateTaskDefinition,
-            asanaSearchTasksDefinition,
-            asanaListAsanaTasksByProjectDefinition,
-            asanaGetTasksDetailsDefinition,
-        ],
-    },
-    SLACK_LIST_CONVERSATIONS: {
-        description: "Actions for interacting with Slack",
-        actions: [slackSendMessageDefinition, slackGetChannelMessagesDefinition],
-    },
-    CONFLUENCE: {
-        description: "Action for interacting with Confluence",
-        actions: [confluenceOverwritePageDefinition, confluenceFetchPageContentDefinition],
-    },
-    MATH_ADD: {
-        description: "Action for adding two numbers",
-        actions: [mathAddDefinition],
-    },
-    GOOGLE_MAPS: {
-        description: "Action for interacting with Google Maps",
-        actions: [googlemapsValidateAddressDefinition, googlemapsNearbysearchRestaurantsDefinition],
-    },
-    GOOGLE_DRIVE: {
-        description: "Action for interacting with Google Drive",
-        actions: [
-            googleOauthCreateNewGoogleDocDefinition,
-            googleOauthUpdateDocDefinition,
-            googleOauthCreateSpreadsheetDefinition,
-            googleOauthUpdateSpreadsheetDefinition,
-            googleOauthCreatePresentationDefinition,
-            googleOauthUpdatePresentationDefinition,
-            googleOauthSearchDriveByKeywordsDefinition,
-        ],
-    },
-    GOOGLE_CALENDAR: {
-        description: "Actions for interacting with Google Calendar",
-        actions: [
-            googleOauthScheduleCalendarMeetingDefinition,
-            googleOauthListCalendarsDefinition,
-            googleOauthListCalendarEventsDefinition,
-            googleOauthUpdateCalendarEventDefinition,
-            googleOauthDeleteCalendarEventDefinition,
-        ],
-    },
-    GMAIL: {
-        description: "Actions for interacting with Gmail",
-        actions: [googlemailSearchGmailMessagesDefinition, googlemailListGmailThreadsDefinition],
-    },
-    LINKEDIN_SHARE_POST: {
-        description: "Action for creating a share post url on linkedin",
-        actions: [linkedinCreateShareLinkedinPostUrlDefinition],
-    },
-    ZENDESK_ACTIONS: {
-        description: "Actions for interacting with Zendesk",
-        actions: [
-            zendeskCreateZendeskTicketDefinition,
-            zendeskListZendeskTicketsDefinition,
-            zendeskGetTicketDetailsDefinition,
-            zendeskUpdateTicketStatusDefinition,
-            zendeskAddCommentToTicketDefinition,
-            zendeskAssignTicketDefinition,
-        ],
-    },
-    BING_SEARCH: {
-        description: "Action for searching Bing",
-        actions: [bingGetTopNSearchResultUrlsDefinition],
-    },
-    MONGO_INSERT_DOC: {
-        description: "Action for inserting a document into a MongoDB collection",
-        actions: [mongoInsertMongoDocDefinition],
-    },
-    SNOWFLAKE_ACTIONS: {
-        description: "Action for getting content from a Snowflake table",
-        actions: [snowflakeGetRowByFieldValueDefinition, snowflakeRunSnowflakeQueryDefinition],
-    },
-    JIRA_ACTIONS: {
-        description: "Action for interacting with Jira tickets",
-        actions: [
-            jiraAssignJiraTicketDefinition,
-            jiraCreateJiraTicketDefinition,
-            jiraCommentJiraTicketDefinition,
-            jiraGetJiraTicketDetailsDefinition,
-            jiraGetJiraTicketHistoryDefinition,
-            jiraUpdateJiraTicketDetailsDefinition,
-            jiraUpdateJiraTicketStatusDefinition,
-            jiraGetJiraIssuesByQueryDefinition,
-        ],
-    },
-    OPENSTREETMAP_GET_LATITUDE_LONGITUDE_FROM_LOCATION: {
-        description: "Action for getting the latitude and longitude of a location",
-        actions: [openstreetmapGetLatitudeLongitudeFromLocationDefinition],
-    },
-    NWS_GET_FORECAST_FOR_LOCATION: {
-        description: "Action for getting the weather forecast for a location",
-        actions: [nwsGetForecastForLocationDefinition],
-    },
-    FIRECRAWL: {
-        description: "Actions for interacting with Firecrawl",
-        actions: [
-            firecrawlScrapeUrlDefinition,
-            firecrawlScrapeTweetDataWithNitterDefinition,
-            firecrawlDeepResearchDefinition,
-        ],
-    },
-    RESEND: {
-        description: "Action for sending an email",
-        actions: [resendSendEmailDefinition],
-    },
-    X: {
-        description: "Actions for interacting with X(formerly twitter)",
-        actions: [xCreateShareXPostUrlDefinition],
-    },
-    GONG: {
-        description: "Actions for interacting with Gong",
-        actions: [gongGetGongTranscriptsDefinition],
-    },
-    FINNHUB: {
-        description: "Action for interacting with Finnhub for stock market data",
-        actions: [finnhubSymbolLookupDefinition, finnhubGetBasicFinancialsDefinition],
-    },
-    JAMF: {
-        description: "Actions for interacting with Jamf",
-        actions: [jamfGetJamfComputerInventoryDefinition, jamfGetJamfFileVaultRecoveryKeyDefinition],
-    },
-    LOOKER: {
-        description: "Actions for interacting with Looker",
-        actions: [lookerEnableUserByEmailDefinition],
-    },
-    SALESFORCE: {
-        description: "Actions for interacting with Salesforce",
-        actions: [
-            salesforceUpdateRecordDefinition,
-            salesforceCreateRecordDefinition,
-            salesforceCreateCaseDefinition,
-            salesforceGenerateSalesReportDefinition,
-            salesforceGetRecordDefinition,
-            salesforceGetSalesforceRecordsByQueryDefinition,
-            salesforceFetchSalesforceSchemaByObjectDefinition,
-        ],
-    },
-    MICROSOFT: {
-        description: "Actions for interacting with Microsoft 365",
-        actions: [
-            microsoftMessageTeamsChatDefinition,
-            microsoftMessageTeamsChannelDefinition,
-            microsoftUpdateSpreadsheetDefinition,
-            microsoftUpdateDocumentDefinition,
-            microsoftCreateDocumentDefinition,
-            microsoftGetDocumentDefinition,
-        ],
-    },
-    KANDJI: {
-        description: "Actions for interacting with Kandji",
-        actions: [kandjiGetFVRecoveryKeyForDeviceDefinition],
-    },
-    GITHUB: {
-        description: "Actions for interacting with GitHub",
-        actions: [
-            githubCreateOrUpdateFileDefinition,
-            githubCreateBranchDefinition,
-            githubCreatePullRequestDefinition,
-            githubListPullRequestsDefinition,
-        ],
-    },
-    ASHBY: {
-        description: "Actions for interacting with Ashby",
-        actions: [
-            ashbyCreateNoteDefinition,
-            ashbyGetCandidateInfoDefinition,
-            ashbyListCandidatesDefinition,
-            ashbyListCandidateNotesDefinition,
-            ashbySearchCandidatesDefinition,
-            ashbyCreateCandidateDefinition,
-            ashbyUpdateCandidateDefinition,
-            ashbyAddCandidateToProjectDefinition,
-        ],
-    },
-    NOTION: {
-        description: "Actions for interacting with Notion",
-        actions: [notionSearchByTitleDefinition],
-    },
-    GOOGLE_GROUPS: {
-        description: "Google Workspace Groups management actions",
-        actions: [
-            googleOauthListGroupsDefinition,
-            googleOauthGetGroupDefinition,
-            googleOauthListGroupMembersDefinition,
-            googleOauthHasGroupMemberDefinition,
-            googleOauthAddGroupMemberDefinition,
-            googleOauthDeleteGroupMemberDefinition,
-        ],
-    },
-    OKTA: {
-        description: "Actions for interacting with Okta",
-        actions: [
-            oktaListOktaUsersDefinition,
-            oktaGetOktaUserDefinition,
-            oktaListOktaUserGroupsDefinition,
-            oktaListOktaGroupsDefinition,
-            oktaGetOktaGroupDefinition,
-            oktaListOktaGroupMembersDefinition,
-            oktaRemoveUserFromGroupDefinition,
-            oktaAddUserToGroupDefinition,
-            oktaResetPasswordDefinition,
-            oktaResetMFADefinition,
-            oktaListMFADefinition,
-        ],
-    },
-};

package/dist/actions/providers/slack/archiveChannel.d.ts

@@ -1,3 +0,0 @@
-import type { slackArchiveChannelFunction } from "../../autogen/types.js";
-declare const archiveChannel: slackArchiveChannelFunction;
-export default archiveChannel;

package/dist/actions/providers/slack/archiveChannel.js

@@ -1,35 +0,0 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import { WebClient } from "@slack/web-api";
-import { MISSING_AUTH_TOKEN } from "../../util/missingAuthConstants.js";
-const archiveChannel = (_a) => __awaiter(void 0, [_a], void 0, function* ({ params, authParams, }) {
-    if (!authParams.authToken) {
-        throw new Error(MISSING_AUTH_TOKEN);
-    }
-    try {
-        const client = new WebClient(authParams.authToken);
-        const { channelId } = params;
-        const result = yield client.conversations.archive({ channel: channelId });
-        if (!result.ok) {
-            return {
-                success: false,
-                error: result.error || "Unknown error archiving channel",
-            };
-        }
-        return { success: true };
-    }
-    catch (error) {
-        return {
-            success: false,
-            error: error instanceof Error ? error.message : "Unknown error archiving channel",
-        };
-    }
-});
-export default archiveChannel;