@credal/actions 0.2.225 → 0.2.226

package/dist/actions/autogen/templates.js

@@ -11492,11 +11492,11 @@ export const microsoftCreateDocumentDefinition = {
             },
             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",
@@ -11556,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",
             },
         },
     },

package/dist/actions/autogen/types.js

@@ -4268,8 +4268,12 @@ export const microsoftCreateDocumentParamsSchema = z.object({
         .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 (include extension like .docx or .xlsx)"),
-    content: z.string().describe("The content to add to the new document"),
+    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({
@@ -4289,7 +4293,9 @@ export const microsoftUpdateDocumentParamsSchema = z.object({
         .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"),

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

@@ -1,4 +1,4 @@
-import { getDrivePath, 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, driveId } = params;
     let client = undefined;
@@ -12,10 +12,20 @@ const createDocument = async ({ params, authParams, }) => {
         };
     }
     const sanitizedFileName = validateAndSanitizeFileName(name);
+    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/updateDocument.js

@@ -1,4 +1,4 @@
-import { getDrivePath, getGraphClient } from "./utils.js";
+import { fileNameHasDocxExtension, generateDocxFromPlainText, getDrivePath, getGraphClient, getUnsupportedOfficeExtension, } from "./utils.js";
 const updateDocument = async ({ params, authParams, }) => {
     const { documentId, content, siteId, driveId } = params;
     let client = undefined;
@@ -12,8 +12,21 @@ const updateDocument = async ({ params, authParams, }) => {
         };
     }
     try {
-        const endpoint = `${getDrivePath({ driveId, siteId })}/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/utils.d.ts

@@ -16,4 +16,12 @@ export declare function getDrivePath({ driveId, siteId }: {
  * @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");
@@ -41,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.225",
+  "version": "0.2.226",
   "type": "module",
   "description": "AI Actions by Credal AI",
   "sideEffects": false,