@memberjunction/core-actions 5.23.0 → 5.25.0

package/dist/custom/utilities/artifact-builder-service.js

@@ -0,0 +1,338 @@
+import { DEFAULT_PDF_OPTIONS, renderPDFFromNodes } from './pdf-renderer.js';
+import { DEFAULT_WORD_OPTIONS, renderDocxFromSections } from './docx-renderer.js';
+import { renderExcelFromSheets } from './xlsx-renderer.js';
+// ── TTL ───────────────────────────────────────────────────────────────────────
+const TTL_MS = 30 * 60 * 1000; // 30 minutes
+const CLEANUP_INTERVAL_MS = 5 * 60 * 1000; // Check every 5 minutes
+// ── Service ───────────────────────────────────────────────────────────────────
+/**
+ * Singleton service managing in-progress documents.
+ * Each document is identified by a UUID handle and persists across agent turns
+ * within the same Node.js process.
+ */
+export class ArtifactBuilderService {
+    static { this._instance = null; }
+    constructor() {
+        this.documents = new Map();
+        this.cleanupTimer = null;
+        this.startCleanupTimer();
+    }
+    static get Instance() {
+        if (!ArtifactBuilderService._instance) {
+            ArtifactBuilderService._instance = new ArtifactBuilderService();
+        }
+        return ArtifactBuilderService._instance;
+    }
+    // ── Lifecycle ─────────────────────────────────────────────────────────────
+    /**
+     * Create a new in-progress document and return its handle.
+     */
+    CreateDocument(documentType, fileName, options) {
+        const handle = crypto.randomUUID();
+        const defaultFileName = this.defaultFileName(documentType);
+        const doc = {
+            handle,
+            documentType,
+            fileName: fileName || defaultFileName,
+            options: options || {},
+            sections: [],
+            createdAt: new Date(),
+            lastModifiedAt: new Date(),
+        };
+        this.documents.set(handle, doc);
+        return handle;
+    }
+    /**
+     * Add content operations as a new section to an existing document.
+     * Returns the section ID(s) created.
+     */
+    AddContent(handle, operations) {
+        const doc = this.getDocument(handle);
+        const sectionId = crypto.randomUUID();
+        doc.sections.push({ id: sectionId, operations });
+        doc.lastModifiedAt = new Date();
+        return [sectionId];
+    }
+    /**
+     * Get a preview of the document's current state.
+     */
+    GetPreview(handle) {
+        const doc = this.getDocument(handle);
+        return {
+            handle: doc.handle,
+            documentType: doc.documentType,
+            fileName: doc.fileName,
+            sectionCount: doc.sections.length,
+            sections: doc.sections.map(s => ({
+                id: s.id,
+                operationCount: s.operations.length,
+                summary: this.summarizeSection(s),
+            })),
+            totalOperations: doc.sections.reduce((sum, s) => sum + s.operations.length, 0),
+        };
+    }
+    /**
+     * Replace a section's content by ID.
+     */
+    ReplaceSection(handle, sectionId, operations) {
+        const doc = this.getDocument(handle);
+        const section = doc.sections.find(s => s.id === sectionId);
+        if (!section) {
+            throw new Error(`Section "${sectionId}" not found in document "${handle}"`);
+        }
+        section.operations = operations;
+        doc.lastModifiedAt = new Date();
+    }
+    /**
+     * Remove a section by ID.
+     */
+    RemoveSection(handle, sectionId) {
+        const doc = this.getDocument(handle);
+        const index = doc.sections.findIndex(s => s.id === sectionId);
+        if (index === -1) {
+            throw new Error(`Section "${sectionId}" not found in document "${handle}"`);
+        }
+        doc.sections.splice(index, 1);
+        doc.lastModifiedAt = new Date();
+    }
+    /**
+     * Render the accumulated document to a binary buffer.
+     * The handle is disposed after finalization.
+     */
+    async Finalize(handle) {
+        const doc = this.getDocument(handle);
+        if (doc.sections.length === 0) {
+            throw new Error(`Cannot finalize an empty document (handle: "${handle}")`);
+        }
+        const allOperations = doc.sections.flatMap(s => s.operations);
+        let buffer;
+        let mimeType;
+        switch (doc.documentType) {
+            case 'pdf':
+                buffer = await this.finalizePDF(allOperations, doc.options.pdf);
+                mimeType = 'application/pdf';
+                break;
+            case 'docx':
+                buffer = await this.finalizeDocx(allOperations, doc.options.word);
+                mimeType = 'application/vnd.openxmlformats-officedocument.wordprocessingml.document';
+                break;
+            case 'xlsx':
+                buffer = await this.finalizeXlsx(allOperations, doc.options.excel);
+                mimeType = 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet';
+                break;
+            default:
+                throw new Error(`Unsupported document type: ${doc.documentType}`);
+        }
+        const fileName = doc.fileName;
+        this.documents.delete(handle);
+        return { buffer, fileName, mimeType };
+    }
+    /**
+     * Dispose a document handle without finalizing.
+     */
+    Dispose(handle) {
+        this.documents.delete(handle);
+    }
+    /**
+     * Check if a handle exists.
+     */
+    HasDocument(handle) {
+        return this.documents.has(handle);
+    }
+    // ── Finalization renderers ────────────────────────────────────────────────
+    async finalizePDF(operations, pdfOpts) {
+        const options = { ...DEFAULT_PDF_OPTIONS, ...pdfOpts };
+        const nodes = this.operationsToPDFNodes(operations);
+        return renderPDFFromNodes(nodes, options);
+    }
+    async finalizeDocx(operations, wordOpts) {
+        const options = { ...DEFAULT_WORD_OPTIONS, ...wordOpts };
+        const sections = this.operationsToDocxSections(operations);
+        return renderDocxFromSections(sections, options);
+    }
+    async finalizeXlsx(operations, excelOpts) {
+        const sheets = this.operationsToSheets(operations);
+        if (sheets.length === 0) {
+            throw new Error('No sheet operations found. Excel documents require at least one "sheet" operation.');
+        }
+        const result = await renderExcelFromSheets(sheets, excelOpts || {});
+        return result.buffer;
+    }
+    // ── Operation → renderer format converters ────────────────────────────────
+    operationsToPDFNodes(operations) {
+        const nodes = [];
+        for (const op of operations) {
+            switch (op.type) {
+                case 'heading':
+                    nodes.push({ type: 'heading', level: op.level, text: op.text });
+                    break;
+                case 'paragraph':
+                    nodes.push({ type: 'paragraph', text: op.text, bold: op.bold, italic: op.italic });
+                    break;
+                case 'table':
+                    nodes.push({ type: 'table', headers: op.headers, rows: op.rows });
+                    break;
+                case 'list':
+                    nodes.push({ type: 'list', items: op.items, ordered: op.ordered ?? false });
+                    break;
+                case 'image':
+                    nodes.push({ type: 'image', src: op.src, alt: op.caption });
+                    break;
+                case 'hr':
+                    nodes.push({ type: 'hr' });
+                    break;
+                case 'pageBreak':
+                    // pdfkit doesn't have a direct page break node; use hr as separator
+                    nodes.push({ type: 'br' });
+                    break;
+                // Skip Excel-specific operations in PDF
+                case 'sheet':
+                case 'formula':
+                    break;
+            }
+        }
+        return nodes;
+    }
+    operationsToDocxSections(operations) {
+        const sections = [];
+        let currentSection = { content: [] };
+        for (const op of operations) {
+            switch (op.type) {
+                case 'heading':
+                    // Headings start new sections
+                    if (currentSection.heading || (currentSection.content?.length ?? 0) > 0) {
+                        sections.push(currentSection);
+                    }
+                    currentSection = {
+                        heading: op.text,
+                        level: op.level,
+                        content: [],
+                    };
+                    break;
+                case 'paragraph':
+                    currentSection.content = currentSection.content ?? [];
+                    currentSection.content.push({
+                        type: 'paragraph',
+                        text: op.text,
+                        bold: op.bold,
+                        italic: op.italic,
+                        align: op.align,
+                    });
+                    break;
+                case 'table':
+                    currentSection.content = currentSection.content ?? [];
+                    currentSection.content.push({
+                        type: 'table',
+                        headers: op.headers,
+                        rows: op.rows,
+                    });
+                    break;
+                case 'list':
+                    currentSection.content = currentSection.content ?? [];
+                    currentSection.content.push({
+                        type: 'list',
+                        items: op.items,
+                        ordered: op.ordered ?? false,
+                    });
+                    break;
+                case 'image':
+                    currentSection.content = currentSection.content ?? [];
+                    currentSection.content.push({
+                        type: 'image',
+                        url: op.src,
+                        width: op.width,
+                        height: op.height,
+                        caption: op.caption,
+                    });
+                    break;
+                // Skip page breaks, hr, and Excel-specific ops for DOCX
+                case 'pageBreak':
+                case 'hr':
+                case 'sheet':
+                case 'formula':
+                    break;
+            }
+        }
+        // Push remaining section
+        if (currentSection.heading || (currentSection.content?.length ?? 0) > 0) {
+            sections.push(currentSection);
+        }
+        return sections;
+    }
+    operationsToSheets(operations) {
+        const sheets = [];
+        const formulasBySheet = new Map();
+        // Collect formulas first
+        for (const op of operations) {
+            if (op.type === 'formula') {
+                const existing = formulasBySheet.get(op.sheet) || [];
+                existing.push({ cell: op.cell, formula: op.formula });
+                formulasBySheet.set(op.sheet, existing);
+            }
+        }
+        // Build sheets
+        for (const op of operations) {
+            if (op.type === 'sheet') {
+                const sheet = {
+                    name: op.name,
+                    data: op.data,
+                    headers: op.headers,
+                    columnWidths: op.columnWidths,
+                };
+                const formulas = formulasBySheet.get(op.name);
+                if (formulas) {
+                    sheet.formulas = formulas;
+                }
+                sheets.push(sheet);
+            }
+        }
+        return sheets;
+    }
+    // ── Helpers ───────────────────────────────────────────────────────────────
+    getDocument(handle) {
+        const doc = this.documents.get(handle);
+        if (!doc) {
+            throw new Error(`Document handle "${handle}" not found. It may have been finalized or expired.`);
+        }
+        return doc;
+    }
+    defaultFileName(documentType) {
+        switch (documentType) {
+            case 'pdf': return 'document.pdf';
+            case 'docx': return 'document.docx';
+            case 'xlsx': return 'workbook.xlsx';
+        }
+    }
+    summarizeSection(section) {
+        const ops = section.operations;
+        if (ops.length === 0)
+            return '(empty)';
+        const typeCounts = {};
+        for (const op of ops) {
+            typeCounts[op.type] = (typeCounts[op.type] || 0) + 1;
+        }
+        const parts = Object.entries(typeCounts).map(([type, count]) => count === 1 ? type : `${count} ${type}s`);
+        // Include first heading text if present
+        const firstHeading = ops.find(op => op.type === 'heading');
+        if (firstHeading && firstHeading.type === 'heading') {
+            return `"${firstHeading.text}" — ${parts.join(', ')}`;
+        }
+        return parts.join(', ');
+    }
+    // ── TTL cleanup ───────────────────────────────────────────────────────────
+    startCleanupTimer() {
+        this.cleanupTimer = setInterval(() => {
+            const now = Date.now();
+            for (const [handle, doc] of this.documents) {
+                if (now - doc.lastModifiedAt.getTime() > TTL_MS) {
+                    this.documents.delete(handle);
+                }
+            }
+        }, CLEANUP_INTERVAL_MS);
+        // Don't prevent Node.js from exiting
+        if (this.cleanupTimer && typeof this.cleanupTimer === 'object' && 'unref' in this.cleanupTimer) {
+            this.cleanupTimer.unref();
+        }
+    }
+}
+//# sourceMappingURL=artifact-builder-service.js.map

package/dist/custom/utilities/artifact-builder-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-builder-service.js","sourceRoot":"","sources":["../../../src/custom/utilities/artifact-builder-service.ts"],"names":[],"mappings":"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"}

package/dist/custom/utilities/base-file-handler.d.ts

@@ -25,7 +25,7 @@ export declare abstract class BaseFileHandlerAction extends BaseAction {
         source: 'storage' | 'url' | 'direct';
     }>;
     /**
-     * Load file from MJ Storage (Document Libraries)
+     * Load file from MJ Storage (MJ: Files entity)
      */
     private loadFromMJStorage;
     /**
@@ -33,9 +33,31 @@ export declare abstract class BaseFileHandlerAction extends BaseAction {
      */
     private loadFromURL;
     /**
-     * Save file to MJ Storage
+     * Save file to MJ Storage. Uploads the content to a FileStorageAccount
+     * and creates the corresponding MJ: Files entity record.
+     *
+     * @param content - File content as string or Buffer
+     * @param fileName - Name for the file
+     * @param mimeType - MIME type of the file
+     * @param params - Action parameters (for contextUser)
+     * @param storageAccountName - Optional: name of the storage account to use (falls back to first active)
+     * @param storagePath - Optional: custom storage path prefix (falls back to `artifacts/{date}/{uuid}/`)
+     * @returns The ID of the newly created MJ: Files record
+     */
+    protected saveToMJStorage(content: string | Buffer, fileName: string, mimeType: string, params: RunActionParams, storageAccountName?: string, storagePath?: string): Promise<string>;
+    /**
+     * Finds a FileStorageAccount by name using the engine's cached metadata.
+     */
+    private loadStorageAccountByName;
+    /**
+     * Resolves a storage account ID from the agent's resolution chain (via Context)
+     * or falls back to the first active account via FileStorageEngine.
+     */
+    private resolveStorageAccountId;
+    /**
+     * Initializes a storage driver for the given file using the engine's cached metadata.
      */
-    protected saveToMJStorage(content: string | Buffer, fileName: string, mimeType: string, params: RunActionParams): Promise<string>;
+    private initializeDriverForFile;
     /**
      * Extract parameter value by name (case-insensitive)
      */

package/dist/custom/utilities/base-file-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-file-handler.d.ts","sourceRoot":"","sources":["../../../src/custom/utilities/base-file-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG/D;;;;;;GAMG;AACH,8BAAsB,qBAAsB,SAAQ,UAAU;IAC1D;;;;;;;;;OASG;cACa,cAAc,CAC1B,MAAM,EAAE,eAAe,EACvB,aAAa,EAAE,MAAM,EACrB,aAAa,GAAE,MAAiB,EAChC,YAAY,GAAE,MAAkB,GACjC,OAAO,CAAC;QACP,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;QACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAC;KACxC,CAAC;IAyBF;;OAEG;YACW,iBAAiB;IAiC/B;;OAEG;YACW,WAAW;IAgDzB;;OAEG;cACa,eAAe,CAC3B,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,eAAe,GACxB,OAAO,CAAC,MAAM,CAAC;IA4BlB;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,GAAG,GAAG;IAKxE;;OAEG;IACH,SAAS,CAAC,eAAe,CAAC,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAE,OAAe,GAAG,OAAO;IAM7G;;OAEG;IACH,SAAS,CAAC,eAAe,CAAC,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAE,MAAU,GAAG,MAAM;CAM1G"}
+{"version":3,"file":"base-file-handler.d.ts","sourceRoot":"","sources":["../../../src/custom/utilities/base-file-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAK/D;;;;;;GAMG;AACH,8BAAsB,qBAAsB,SAAQ,UAAU;IAC1D;;;;;;;;;OASG;cACa,cAAc,CAC1B,MAAM,EAAE,eAAe,EACvB,aAAa,EAAE,MAAM,EACrB,aAAa,GAAE,MAAiB,EAChC,YAAY,GAAE,MAAkB,GACjC,OAAO,CAAC;QACP,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;QACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAC;KACxC,CAAC;IAyBF;;OAEG;YACW,iBAAiB;IAkC/B;;OAEG;YACW,WAAW;IAgDzB;;;;;;;;;;;OAWG;cACa,eAAe,CAC3B,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,eAAe,EACvB,kBAAkB,CAAC,EAAE,MAAM,EAC3B,WAAW,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC;IAiClB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAQhC;;;OAGG;YACW,uBAAuB;IAarC;;OAEG;YACW,uBAAuB;IASrC;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,GAAG,GAAG;IAKxE;;OAEG;IACH,SAAS,CAAC,eAAe,CAAC,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAE,OAAe,GAAG,OAAO;IAM7G;;OAEG;IACH,SAAS,CAAC,eAAe,CAAC,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAE,MAAU,GAAG,MAAM;CAM1G"}

package/dist/custom/utilities/base-file-handler.js

@@ -1,5 +1,6 @@
 import { BaseAction } from "@memberjunction/actions";
-import { Metadata, RunView } from "@memberjunction/core";
+import { RunView } from "@memberjunction/core";
+import { FileStorageEngine } from "@memberjunction/storage";
 /**
  * Base class for actions that handle file inputs from multiple sources
  * Provides common functionality for loading files from:
@@ -40,26 +41,27 @@ export class BaseFileHandlerAction extends BaseAction {
         throw new Error(`No input provided. Please provide ${fileParamName}, ${urlParamName}, or ${dataParamName}`);
     }
     /**
-     * Load file from MJ Storage (Document Libraries)
+     * Load file from MJ Storage (MJ: Files entity)
      */
     async loadFromMJStorage(fileId, params) {
         try {
             const rv = new RunView();
-            const result = await rv.RunView({
-                EntityName: 'Document Libraries',
+            const fileResult = await rv.RunView({
+                EntityName: 'MJ: Files',
                 ExtraFilter: `ID = '${fileId}'`,
                 ResultType: 'entity_object'
             }, params.ContextUser);
-            if (!result.Success || !result.Results || result.Results.length === 0) {
-                throw new Error(`File not found in Document Libraries: ${fileId}`);
+            if (!fileResult.Success || fileResult.Results.length === 0) {
+                throw new Error(`File not found in MJ: Files: ${fileId}`);
             }
-            const doc = result.Results[0];
-            // Get the actual file content (this would need implementation based on your storage provider)
-            // For now, returning the file info - actual implementation would fetch from storage
+            const file = fileResult.Results[0];
+            const driver = await this.initializeDriverForFile(file, params);
+            const objectName = file.ProviderKey ?? file.Name;
+            const content = await driver.GetObject({ fullPath: objectName });
             return {
-                content: '', // TODO: Implement actual file retrieval based on storage provider
-                fileName: doc.Get('FileName'),
-                mimeType: doc.Get('MimeType'),
+                content,
+                fileName: file.Name,
+                mimeType: file.ContentType ?? undefined,
                 source: 'storage'
             };
         }
@@ -108,31 +110,82 @@ export class BaseFileHandlerAction extends BaseAction {
         }
     }
     /**
-     * Save file to MJ Storage
+     * Save file to MJ Storage. Uploads the content to a FileStorageAccount
+     * and creates the corresponding MJ: Files entity record.
+     *
+     * @param content - File content as string or Buffer
+     * @param fileName - Name for the file
+     * @param mimeType - MIME type of the file
+     * @param params - Action parameters (for contextUser)
+     * @param storageAccountName - Optional: name of the storage account to use (falls back to first active)
+     * @param storagePath - Optional: custom storage path prefix (falls back to `artifacts/{date}/{uuid}/`)
+     * @returns The ID of the newly created MJ: Files record
      */
-    async saveToMJStorage(content, fileName, mimeType, params) {
+    async saveToMJStorage(content, fileName, mimeType, params, storageAccountName, storagePath) {
         try {
-            const md = new Metadata();
-            const doc = await md.GetEntityObject('Document Libraries', params.ContextUser);
-            if (!doc) {
-                throw new Error('Failed to create Document Library entity');
+            await FileStorageEngine.Instance.Config(false, params.ContextUser);
+            // Resolve storage account ID
+            let storageAccountId;
+            if (storageAccountName) {
+                const account = this.loadStorageAccountByName(storageAccountName);
+                storageAccountId = account.ID;
             }
-            doc.Set('FileName', fileName);
-            doc.Set('MimeType', mimeType);
-            // TODO: Set appropriate fields based on your Document Libraries schema
-            // doc.Set('FileSize', Buffer.byteLength(content));
-            // doc.Set('StorageProvider', 'default');
-            const saveResult = await doc.Save();
-            if (!saveResult) {
-                throw new Error('Failed to save document to library');
+            else {
+                storageAccountId = await this.resolveStorageAccountId(params);
             }
-            // TODO: Actually store the file content to the storage provider
-            return doc.Get('ID');
+            const buffer = Buffer.isBuffer(content) ? content : Buffer.from(content);
+            const pathPrefix = storagePath
+                ? storagePath.replace(/\/+$/, '')
+                : undefined;
+            const result = await FileStorageEngine.Instance.UploadFile({
+                content: buffer,
+                fileName,
+                mimeType,
+                contextUser: params.ContextUser,
+                storageAccountId,
+                pathPrefix
+            });
+            return result.FileID;
         }
         catch (error) {
             throw new Error(`Failed to save file to storage: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
+    /**
+     * Finds a FileStorageAccount by name using the engine's cached metadata.
+     */
+    loadStorageAccountByName(accountName) {
+        const account = FileStorageEngine.Instance.GetAccountByName(accountName);
+        if (!account) {
+            throw new Error(`FileStorageAccount "${accountName}" not found. Check account name or use default.`);
+        }
+        return account;
+    }
+    /**
+     * Resolves a storage account ID from the agent's resolution chain (via Context)
+     * or falls back to the first active account via FileStorageEngine.
+     */
+    async resolveStorageAccountId(params) {
+        // Check for agent-resolved storage account ID (passed via Context by BaseAgent)
+        const context = params.Context;
+        const resolvedId = context?.__resolvedStorageAccountId;
+        if (resolvedId) {
+            return resolvedId.toString();
+        }
+        // Fallback: pick first active via engine
+        const resolved = FileStorageEngine.Instance.ResolveStorageAccount();
+        return resolved?.account.ID;
+    }
+    /**
+     * Initializes a storage driver for the given file using the engine's cached metadata.
+     */
+    async initializeDriverForFile(file, params) {
+        const accounts = FileStorageEngine.Instance.GetAccountsByProviderID(file.ProviderID);
+        if (accounts.length === 0) {
+            throw new Error(`No FileStorageAccount found for ProviderID ${file.ProviderID}`);
+        }
+        return FileStorageEngine.Instance.GetDriver(accounts[0].ID, params.ContextUser);
+    }
     /**
      * Extract parameter value by name (case-insensitive)
      */

package/dist/custom/utilities/base-file-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-file-handler.js","sourceRoot":"","sources":["../../../src/custom/utilities/base-file-handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base-file-handler.js","sourceRoot":"","sources":["../../../src/custom/utilities/base-file-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,OAAgB,qBAAsB,SAAQ,UAAU;IAC1D;;;;;;;;;OASG;IACO,KAAK,CAAC,cAAc,CAC1B,MAAuB,EACvB,aAAqB,EACrB,gBAAwB,QAAQ,EAChC,eAAuB,SAAS;QAOhC,sCAAsC;QACtC,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,aAAa,CAAC,WAAW,EAAE,CAAC,CAAC;QACzG,IAAI,WAAW,EAAE,KAAK,EAAE,CAAC;YACrB,OAAO,MAAM,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC,CAAC;QAC9E,CAAC;QAED,oBAAoB;QACpB,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;QACzG,IAAI,YAAY,EAAE,KAAK,EAAE,CAAC;YACtB,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjE,CAAC;QAED,wBAAwB;QACxB,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,aAAa,CAAC,WAAW,EAAE,CAAC,CAAC;QACvG,IAAI,SAAS,EAAE,KAAK,EAAE,CAAC;YACnB,OAAO;gBACH,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,QAAQ,EAAE;gBACnC,MAAM,EAAE,QAAQ;aACnB,CAAC;QACN,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,qCAAqC,aAAa,KAAK,YAAY,QAAQ,aAAa,EAAE,CAAC,CAAC;IAChH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,iBAAiB,CAAC,MAAc,EAAE,MAAuB;QAMnE,IAAI,CAAC;YACD,MAAM,EAAE,GAAG,IAAI,OAAO,EAAE,CAAC;YACzB,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,OAAO,CAAe;gBAC9C,UAAU,EAAE,WAAW;gBACvB,WAAW,EAAE,SAAS,MAAM,GAAG;gBAC/B,UAAU,EAAE,eAAe;aAC9B,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;YAEvB,IAAI,CAAC,UAAU,CAAC,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzD,MAAM,IAAI,KAAK,CAAC,gCAAgC,MAAM,EAAE,CAAC,CAAC;YAC9D,CAAC;YAED,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAChE,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,CAAC;YACjD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;YAEjE,OAAO;gBACH,OAAO;gBACP,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,QAAQ,EAAE,IAAI,CAAC,WAAW,IAAI,SAAS;gBACvC,MAAM,EAAE,SAAS;aACpB,CAAC;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,qCAAqC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACnH,CAAC;IACL,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,WAAW,CAAC,GAAW;QAMjC,IAAI,CAAC;YACD,eAAe;YACf,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACjD,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;YAC9D,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YACvE,CAAC;YAED,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YACzD,MAAM,kBAAkB,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;YACvE,IAAI,QAA4B,CAAC;YAEjC,yDAAyD;YACzD,IAAI,kBAAkB,EAAE,CAAC;gBACrB,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;gBACjF,IAAI,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;oBACpB,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBAC7C,CAAC;YACL,CAAC;YAED,+CAA+C;YAC/C,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACZ,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YAChD,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAEtC,OAAO;gBACH,OAAO;gBACP,QAAQ;gBACR,QAAQ,EAAE,WAAW,IAAI,SAAS;gBAClC,MAAM,EAAE,KAAK;aAChB,CAAC;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,iCAAiC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC/G,CAAC;IACL,CAAC;IAED;;;;;;;;;;;OAWG;IACO,KAAK,CAAC,eAAe,CAC3B,OAAwB,EACxB,QAAgB,EAChB,QAAgB,EAChB,MAAuB,EACvB,kBAA2B,EAC3B,WAAoB;QAEpB,IAAI,CAAC;YACD,MAAM,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;YAEnE,6BAA6B;YAC7B,IAAI,gBAAoC,CAAC;YACzC,IAAI,kBAAkB,EAAE,CAAC;gBACrB,MAAM,OAAO,GAAG,IAAI,CAAC,wBAAwB,CAAC,kBAAkB,CAAC,CAAC;gBAClE,gBAAgB,GAAG,OAAO,CAAC,EAAE,CAAC;YAClC,CAAC;iBAAM,CAAC;gBACJ,gBAAgB,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC;YAClE,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzE,MAAM,UAAU,GAAG,WAAW;gBAC1B,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;gBACjC,CAAC,CAAC,SAAS,CAAC;YAEhB,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,QAAQ,CAAC,UAAU,CAAC;gBACvD,OAAO,EAAE,MAAM;gBACf,QAAQ;gBACR,QAAQ;gBACR,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,gBAAgB;gBAChB,UAAU;aACb,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC,MAAM,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,mCAAmC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjH,CAAC;IACL,CAAC;IAED;;OAEG;IACK,wBAAwB,CAAC,WAAmB;QAChD,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;QACzE,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,uBAAuB,WAAW,iDAAiD,CAAC,CAAC;QACzG,CAAC;QACD,OAAO,OAAO,CAAC;IACnB,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,uBAAuB,CAAC,MAAuB;QACzD,gFAAgF;QAChF,MAAM,OAAO,GAAG,MAAM,CAAC,OAA8C,CAAC;QACtE,MAAM,UAAU,GAAG,OAAO,EAAE,0BAA0B,CAAC;QACvD,IAAI,UAAU,EAAE,CAAC;YACb,OAAO,UAAU,CAAC,QAAQ,EAAE,CAAC;QACjC,CAAC;QAED,yCAAyC;QACzC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,QAAQ,CAAC,qBAAqB,EAAE,CAAC;QACpE,OAAO,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;IAChC,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,uBAAuB,CAAC,IAAkB,EAAE,MAAuB;QAC7E,MAAM,QAAQ,GAAG,iBAAiB,CAAC,QAAQ,CAAC,uBAAuB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,8CAA8C,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QACrF,CAAC;QAED,OAAO,iBAAiB,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IACpF,CAAC;IAED;;OAEG;IACO,aAAa,CAAC,MAAuB,EAAE,SAAiB;QAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/F,OAAO,KAAK,EAAE,KAAK,CAAC;IACxB,CAAC;IAED;;OAEG;IACO,eAAe,CAAC,MAAuB,EAAE,SAAiB,EAAE,eAAwB,KAAK;QAC/F,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACpD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,YAAY,CAAC;QAC/D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC;IAClD,CAAC;IAED;;OAEG;IACO,eAAe,CAAC,MAAuB,EAAE,SAAiB,EAAE,eAAuB,CAAC;QAC1F,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACpD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,YAAY,CAAC;QAC/D,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3C,CAAC;CACJ"}

package/dist/custom/utilities/docx-renderer.d.ts

@@ -0,0 +1,61 @@
+export interface WordOptions {
+    pageSize: 'Letter' | 'A4';
+    orientation: 'portrait' | 'landscape';
+    margins: {
+        top: number;
+        bottom: number;
+        left: number;
+        right: number;
+    };
+    defaultFontSize: number;
+    defaultFont: string;
+}
+export type DocxContentItem = {
+    type: 'paragraph';
+    text: string;
+    bold?: boolean;
+    italic?: boolean;
+    align?: string;
+} | {
+    type: 'list';
+    items: string[];
+    ordered: boolean;
+} | {
+    type: 'table';
+    headers: string[];
+    rows: string[][];
+} | {
+    type: 'image';
+    url: string;
+    width?: number;
+    height?: number;
+    caption?: string;
+};
+export interface DocxSection {
+    heading?: string;
+    level?: number;
+    content?: DocxContentItem[];
+}
+export declare const DEFAULT_WORD_OPTIONS: WordOptions;
+/** A raw item as an agent might send it — either a content item or a section wrapper */
+type RawSectionItem = Record<string, unknown>;
+/**
+ * Render an array of DocxSection to a DOCX buffer.
+ */
+export declare function renderDocxFromSections(sections: DocxSection[], options: WordOptions): Promise<Buffer>;
+/**
+ * Accepts both formats agents may produce:
+ *
+ * Structured (canonical):
+ *   [{ heading: "Title", level: 1, content: [{ type: "paragraph", text: "..." }] }]
+ *
+ * Flat (what most LLM agents naturally emit):
+ *   [{ type: "heading", level: 1, text: "Title" }, { type: "paragraph", text: "..." }]
+ */
+export declare function normalizeSections(items: RawSectionItem[]): DocxSection[];
+/**
+ * Lightweight HTML → structured sections converter using htmlparser2.
+ */
+export declare function htmlToSections(html: string): DocxSection[];
+export {};
+//# sourceMappingURL=docx-renderer.d.ts.map

package/dist/custom/utilities/docx-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docx-renderer.d.ts","sourceRoot":"","sources":["../../../src/custom/utilities/docx-renderer.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,WAAW;IACxB,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,UAAU,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,eAAe,GACrB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACrF;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAExF,MAAM,WAAW,WAAW;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;CAC/B;AAED,eAAO,MAAM,oBAAoB,EAAE,WAMlC,CAAC;AAEF,wFAAwF;AACxF,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAI9C;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAmC3G;AA4JD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,WAAW,EAAE,CASxE;AAsFD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CA6E1D"}