n8n-nodes-morphopdf 1.2.4 → 1.2.5

package/dist/nodes/MorphoPdf/MorphoPdfTool.node.d.ts

@@ -0,0 +1,15 @@
+import type { INodeType, INodeTypeDescription, ISupplyDataFunctions, SupplyData } from 'n8n-workflow';
+/**
+ * MorphoPDF AI Tool Node
+ *
+ * This node provides PDF processing capabilities for AI agents.
+ * It uses DynamicStructuredTool to expose operations to LangChain-compatible agents.
+ *
+ * Unlike the regular MorphoPdf node which uses execute(), this node uses supplyData()
+ * to provide a tool that agents can call dynamically.
+ */
+export declare class MorphoPdfTool implements INodeType {
+    description: INodeTypeDescription;
+    supplyData(this: ISupplyDataFunctions, _itemIndex: number): Promise<SupplyData>;
+}
+//# sourceMappingURL=MorphoPdfTool.node.d.ts.map

package/dist/nodes/MorphoPdf/MorphoPdfTool.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MorphoPdfTool.node.d.ts","sourceRoot":"","sources":["../../../nodes/MorphoPdf/MorphoPdfTool.node.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,SAAS,EACT,oBAAoB,EACpB,oBAAoB,EACpB,UAAU,EAEX,MAAM,cAAc,CAAC;AAwFtB;;;;;;;;GAQG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC7C,WAAW,EAAE,oBAAoB,CA0C/B;IAGI,UAAU,CAAC,IAAI,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CAoHtF"}

package/dist/nodes/MorphoPdf/MorphoPdfTool.node.js

@@ -0,0 +1,207 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MorphoPdfTool = void 0;
+// eslint-disable-next-line @n8n/community-nodes/no-restricted-imports
+const tools_1 = require("@langchain/core/tools");
+const n8n_workflow_1 = require("n8n-workflow");
+const toolSchema_1 = require("./shared/toolSchema");
+const API_BASE_URL = 'https://api.morphopdf.com/v1';
+/**
+ * Build request body from tool input based on operation type
+ */
+function buildRequestBody(input) {
+    const { operation } = input;
+    switch (operation) {
+        case 'compress':
+            return {
+                url: input.inputUrl,
+                quality: input.quality || 'low',
+            };
+        case 'merge':
+            return {
+                urls: [input.inputUrl, ...(input.additionalUrls || [])],
+            };
+        case 'split':
+            return {
+                url: input.inputUrl,
+                mode: input.splitMode || 'ranges',
+                ranges: input.pageRanges || ['1-1'],
+            };
+        case 'rotate':
+            return {
+                url: input.inputUrl,
+                angle: parseInt(input.rotationAngle || '90', 10),
+            };
+        case 'watermark':
+            return {
+                url: input.inputUrl,
+                text: input.watermarkText,
+                position: input.watermarkPosition || 'center',
+                opacity: input.watermarkOpacity ?? 0.3,
+            };
+        case 'pdfToWord':
+            return {
+                url: input.inputUrl,
+            };
+        case 'pdfToExcel':
+            return {
+                url: input.inputUrl,
+            };
+        case 'pdfToImage':
+            return {
+                url: input.inputUrl,
+                format: input.imageFormat || 'png',
+                dpi: parseInt(input.dpi || '150', 10),
+            };
+        case 'wordToPdf':
+            return {
+                url: input.inputUrl,
+            };
+        case 'htmlToPdf':
+            // Use htmlContent if provided, otherwise use inputUrl
+            if (input.htmlContent) {
+                return {
+                    html: input.htmlContent,
+                };
+            }
+            return {
+                url: input.inputUrl,
+            };
+        default:
+            return { url: input.inputUrl };
+    }
+}
+/**
+ * MorphoPDF AI Tool Node
+ *
+ * This node provides PDF processing capabilities for AI agents.
+ * It uses DynamicStructuredTool to expose operations to LangChain-compatible agents.
+ *
+ * Unlike the regular MorphoPdf node which uses execute(), this node uses supplyData()
+ * to provide a tool that agents can call dynamically.
+ */
+class MorphoPdfTool {
+    description = {
+        displayName: 'MorphoPDF Tool',
+        name: 'morphoPdfTool',
+        icon: 'file:morphopdf.svg',
+        iconColor: 'blue',
+        group: ['transform'],
+        version: 1,
+        description: 'PDF processing for AI agents - merge, split, convert, compress, watermark',
+        defaults: {
+            name: 'MorphoPDF Tool',
+        },
+        usableAsTool: true,
+        codex: {
+            categories: ['AI'],
+            subcategories: {
+                AI: ['Tools'],
+                Tools: ['Recommended Tools'],
+            },
+            resources: {
+                primaryDocumentation: [{ url: 'https://docs.morphopdf.com/api' }],
+            },
+        },
+        inputs: [],
+        outputs: [n8n_workflow_1.NodeConnectionTypes.AiTool],
+        outputNames: ['Tool'],
+        credentials: [
+            {
+                name: 'morphoPdfApi',
+                required: true,
+            },
+        ],
+        properties: [
+            {
+                displayName: 'This tool exposes MorphoPDF operations to AI agents. ' +
+                    'Connect this to an AI Agent node. The agent will automatically ' +
+                    'choose the appropriate operation based on the task.',
+                name: 'notice',
+                type: 'notice',
+                default: '',
+            },
+        ],
+    };
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    async supplyData(_itemIndex) {
+        const credentials = await this.getCredentials('morphoPdfApi');
+        const apiKey = credentials.apiKey;
+        // Get reference to context for use in tool function
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const context = this;
+        const tool = new tools_1.DynamicStructuredTool({
+            name: 'morphopdf_tool',
+            description: 'Process PDF files - merge, split, compress, rotate, watermark, and convert formats. ' +
+                'Supports: compress (reduce file size), merge (combine PDFs), split (divide into parts), ' +
+                'rotate (turn pages), watermark (add text overlay), pdfToWord, pdfToExcel, pdfToImage, ' +
+                'wordToPdf, htmlToPdf. Requires public URLs for input files.',
+            schema: toolSchema_1.morphoPdfToolSchema,
+            func: async (input) => {
+                // Log input for n8n execution panel
+                const { index } = context.addInputData(n8n_workflow_1.NodeConnectionTypes.AiTool, [
+                    [{ json: input }],
+                ]);
+                try {
+                    // Validate required inputUrl for operations that need it
+                    if (input.operation !== 'htmlToPdf' && !input.inputUrl) {
+                        throw new n8n_workflow_1.NodeOperationError(context.getNode(), `inputUrl is required for ${input.operation} operation`);
+                    }
+                    // For htmlToPdf, require either inputUrl or htmlContent
+                    if (input.operation === 'htmlToPdf' && !input.inputUrl && !input.htmlContent) {
+                        throw new n8n_workflow_1.NodeOperationError(context.getNode(), 'htmlToPdf requires either inputUrl or htmlContent');
+                    }
+                    // For merge, require at least one additional URL
+                    if (input.operation === 'merge' &&
+                        (!input.additionalUrls || input.additionalUrls.length === 0)) {
+                        throw new n8n_workflow_1.NodeOperationError(context.getNode(), 'merge operation requires at least one URL in additionalUrls');
+                    }
+                    // For watermark, require watermarkText
+                    if (input.operation === 'watermark' && !input.watermarkText) {
+                        throw new n8n_workflow_1.NodeOperationError(context.getNode(), 'watermark operation requires watermarkText');
+                    }
+                    // Build API request
+                    const endpoint = toolSchema_1.operationEndpoints[input.operation];
+                    const body = buildRequestBody(input);
+                    // Make API request using httpRequest helper
+                    const response = await context.helpers.httpRequest({
+                        method: 'POST',
+                        url: `${API_BASE_URL}${endpoint}`,
+                        headers: {
+                            Authorization: `Bearer ${apiKey}`,
+                            'Content-Type': 'application/json',
+                        },
+                        body,
+                        json: true,
+                    });
+                    // Format response for LLM
+                    const result = (0, toolSchema_1.formatToolResponse)(input.operation, response);
+                    // Log output
+                    context.addOutputData(n8n_workflow_1.NodeConnectionTypes.AiTool, index, [
+                        [{ json: result }],
+                    ]);
+                    return JSON.stringify(result, null, 2);
+                }
+                catch (error) {
+                    // Handle errors gracefully - return error string instead of throwing
+                    const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
+                    const errorResult = {
+                        success: false,
+                        operation: input.operation,
+                        operationName: input.operation,
+                        message: `Operation failed: ${errorMessage}`,
+                        error: errorMessage,
+                    };
+                    // Log error output
+                    context.addOutputData(n8n_workflow_1.NodeConnectionTypes.AiTool, index, [
+                        [{ json: errorResult }],
+                    ]);
+                    return JSON.stringify(errorResult, null, 2);
+                }
+            },
+        });
+        return { response: tool };
+    }
+}
+exports.MorphoPdfTool = MorphoPdfTool;
+//# sourceMappingURL=MorphoPdfTool.node.js.map

package/dist/nodes/MorphoPdf/MorphoPdfTool.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MorphoPdfTool.node.js","sourceRoot":"","sources":["../../../nodes/MorphoPdf/MorphoPdfTool.node.ts"],"names":[],"mappings":"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"}

package/dist/nodes/MorphoPdf/shared/toolSchema.d.ts

@@ -0,0 +1,91 @@
+import { z } from 'zod';
+/**
+ * Zod schema for MorphoPDF AI Tool input
+ * Used by AI agents to process PDF files via the MorphoPDF API
+ *
+ * Design: Flat schema (no discriminated unions) for LLM compatibility.
+ * Each operation-specific parameter is optional with clear .describe() text
+ * explaining when it applies.
+ */
+export declare const morphoPdfToolSchema: z.ZodObject<{
+    operation: z.ZodEnum<["compress", "merge", "split", "rotate", "watermark", "pdfToWord", "pdfToExcel", "pdfToImage", "wordToPdf", "htmlToPdf"]>;
+    inputUrl: z.ZodOptional<z.ZodString>;
+    quality: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
+    additionalUrls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    splitMode: z.ZodOptional<z.ZodEnum<["ranges", "individual"]>>;
+    pageRanges: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    rotationAngle: z.ZodOptional<z.ZodEnum<["90", "180", "270"]>>;
+    watermarkText: z.ZodOptional<z.ZodString>;
+    watermarkPosition: z.ZodOptional<z.ZodEnum<["center", "top-left", "top-center", "top-right", "bottom-left", "bottom-center", "bottom-right"]>>;
+    watermarkOpacity: z.ZodOptional<z.ZodNumber>;
+    imageFormat: z.ZodOptional<z.ZodEnum<["png", "jpg"]>>;
+    dpi: z.ZodOptional<z.ZodEnum<["72", "96", "150", "300", "600"]>>;
+    htmlContent: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    operation: "compress" | "merge" | "rotate" | "split" | "watermark" | "pdfToExcel" | "pdfToImage" | "pdfToWord" | "htmlToPdf" | "wordToPdf";
+    quality?: "low" | "medium" | "high" | undefined;
+    splitMode?: "ranges" | "individual" | undefined;
+    watermarkText?: string | undefined;
+    watermarkPosition?: "bottom-center" | "bottom-left" | "bottom-right" | "center" | "top-center" | "top-left" | "top-right" | undefined;
+    watermarkOpacity?: number | undefined;
+    imageFormat?: "png" | "jpg" | undefined;
+    dpi?: "72" | "96" | "150" | "300" | "600" | undefined;
+    htmlContent?: string | undefined;
+    inputUrl?: string | undefined;
+    additionalUrls?: string[] | undefined;
+    pageRanges?: string[] | undefined;
+    rotationAngle?: "90" | "180" | "270" | undefined;
+}, {
+    operation: "compress" | "merge" | "rotate" | "split" | "watermark" | "pdfToExcel" | "pdfToImage" | "pdfToWord" | "htmlToPdf" | "wordToPdf";
+    quality?: "low" | "medium" | "high" | undefined;
+    splitMode?: "ranges" | "individual" | undefined;
+    watermarkText?: string | undefined;
+    watermarkPosition?: "bottom-center" | "bottom-left" | "bottom-right" | "center" | "top-center" | "top-left" | "top-right" | undefined;
+    watermarkOpacity?: number | undefined;
+    imageFormat?: "png" | "jpg" | undefined;
+    dpi?: "72" | "96" | "150" | "300" | "600" | undefined;
+    htmlContent?: string | undefined;
+    inputUrl?: string | undefined;
+    additionalUrls?: string[] | undefined;
+    pageRanges?: string[] | undefined;
+    rotationAngle?: "90" | "180" | "270" | undefined;
+}>;
+/**
+ * TypeScript type inferred from the Zod schema
+ */
+export type MorphoPdfToolInput = z.infer<typeof morphoPdfToolSchema>;
+/**
+ * API endpoint mapping for each operation
+ * Used to route requests to the correct MorphoPDF API endpoint
+ */
+export declare const operationEndpoints: Record<string, string>;
+/**
+ * Format API response for LLM consumption
+ * Transforms raw API response into a structured, readable format
+ *
+ * @param operation - The operation that was performed
+ * @param response - Raw API response from MorphoPDF
+ * @returns Formatted response object suitable for LLM output
+ */
+export declare function formatToolResponse(operation: string, response: {
+    success?: boolean;
+    downloadUrl?: string;
+    fileName?: string;
+    error?: {
+        code?: string;
+        message?: string;
+    };
+    [key: string]: unknown;
+}): {
+    success: boolean;
+    operation: string;
+    operationName: string;
+    message: string;
+    downloadUrl?: string;
+    fileName?: string;
+    error?: {
+        code?: string;
+        message?: string;
+    };
+};
+//# sourceMappingURL=toolSchema.d.ts.map

package/dist/nodes/MorphoPdf/shared/toolSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolSchema.d.ts","sourceRoot":"","sources":["../../../../nodes/MorphoPdf/shared/toolSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsK7B,CAAC;AAEJ;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAWrD,CAAC;AAkBF;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE;IACR,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,GACA;IACD,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C,CAqBA"}

package/dist/nodes/MorphoPdf/shared/toolSchema.js

@@ -0,0 +1,200 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.operationEndpoints = exports.morphoPdfToolSchema = void 0;
+exports.formatToolResponse = formatToolResponse;
+const zod_1 = require("zod");
+/**
+ * Zod schema for MorphoPDF AI Tool input
+ * Used by AI agents to process PDF files via the MorphoPDF API
+ *
+ * Design: Flat schema (no discriminated unions) for LLM compatibility.
+ * Each operation-specific parameter is optional with clear .describe() text
+ * explaining when it applies.
+ */
+exports.morphoPdfToolSchema = zod_1.z
+    .object({
+    operation: zod_1.z
+        .enum([
+        'compress',
+        'merge',
+        'split',
+        'rotate',
+        'watermark',
+        'pdfToWord',
+        'pdfToExcel',
+        'pdfToImage',
+        'wordToPdf',
+        'htmlToPdf',
+    ])
+        .describe('The PDF operation to perform. ' +
+        'compress=reduce file size, ' +
+        'merge=combine multiple PDFs into one, ' +
+        'split=divide PDF into parts, ' +
+        'rotate=turn pages by angle, ' +
+        'watermark=add text overlay, ' +
+        'pdfToWord=convert PDF to DOCX, ' +
+        'pdfToExcel=extract tables to XLSX, ' +
+        'pdfToImage=convert pages to PNG/JPG, ' +
+        'wordToPdf=convert DOCX to PDF, ' +
+        'htmlToPdf=render HTML/URL to PDF'),
+    inputUrl: zod_1.z
+        .string()
+        .url()
+        .optional()
+        .describe('Public URL of the input file. Required for all operations EXCEPT htmlToPdf when using htmlContent. ' +
+        'For compress/split/rotate/watermark: must be a PDF URL. ' +
+        'For merge: the first PDF to merge (additional URLs go in additionalUrls). ' +
+        'For pdfToWord/pdfToExcel/pdfToImage: must be a PDF URL. ' +
+        'For wordToPdf: must be a DOCX URL. ' +
+        'For htmlToPdf: must be a webpage URL (or omit if using htmlContent).'),
+    // === COMPRESS OPERATION ===
+    quality: zod_1.z
+        .enum(['low', 'medium', 'high'])
+        .optional()
+        .describe('FOR COMPRESS ONLY. Compression quality level. ' +
+        'low=smallest file size (max compression, ~50 DPI), ' +
+        'medium=balanced quality and size (~100 DPI), ' +
+        'high=best quality, larger file (~150 DPI). ' +
+        'Default: low'),
+    // === MERGE OPERATION ===
+    additionalUrls: zod_1.z
+        .array(zod_1.z.string().url())
+        .optional()
+        .describe('FOR MERGE ONLY. Array of additional PDF URLs to combine with inputUrl. ' +
+        'Minimum 1 URL required. PDFs are merged in order: inputUrl first, then these URLs. ' +
+        'Example: ["https://example.com/doc2.pdf", "https://example.com/doc3.pdf"]'),
+    // === SPLIT OPERATION ===
+    splitMode: zod_1.z
+        .enum(['ranges', 'individual'])
+        .optional()
+        .describe('FOR SPLIT ONLY. How to split the PDF. ' +
+        'ranges=split by page ranges (use pageRanges param), ' +
+        'individual=extract each specified page as separate PDF. ' +
+        'Default: ranges'),
+    pageRanges: zod_1.z
+        .array(zod_1.z.string())
+        .optional()
+        .describe('FOR SPLIT ONLY (when splitMode=ranges). Array of page range strings. ' +
+        'Each range becomes a separate PDF file. ' +
+        'Example: ["1-3", "4-6", "7-10"] creates 3 PDFs. ' +
+        'Format: "start-end" (1-based page numbers).'),
+    // === ROTATE OPERATION ===
+    rotationAngle: zod_1.z
+        .enum(['90', '180', '270'])
+        .optional()
+        .describe('FOR ROTATE ONLY. Clockwise rotation angle in degrees. ' +
+        '90=quarter turn right, 180=upside down, 270=quarter turn left. ' +
+        'Applied to all pages. Default: 90'),
+    // === WATERMARK OPERATION ===
+    watermarkText: zod_1.z
+        .string()
+        .optional()
+        .describe('FOR WATERMARK ONLY. Text to overlay on pages. ' +
+        'Example: "CONFIDENTIAL", "DRAFT", "SAMPLE". ' +
+        'Required when using watermark operation.'),
+    watermarkPosition: zod_1.z
+        .enum([
+        'center',
+        'top-left',
+        'top-center',
+        'top-right',
+        'bottom-left',
+        'bottom-center',
+        'bottom-right',
+    ])
+        .optional()
+        .describe('FOR WATERMARK ONLY. Where to place the watermark on each page. ' + 'Default: center'),
+    watermarkOpacity: zod_1.z
+        .number()
+        .min(0)
+        .max(1)
+        .optional()
+        .describe('FOR WATERMARK ONLY. Transparency of watermark (0=invisible, 1=fully opaque). ' +
+        'Typical values: 0.1-0.3 for subtle watermarks. Default: 0.3'),
+    // === PDF TO IMAGE OPERATION ===
+    imageFormat: zod_1.z
+        .enum(['png', 'jpg'])
+        .optional()
+        .describe('FOR PDF_TO_IMAGE ONLY. Output image format. ' +
+        'png=lossless, larger files, supports transparency. ' +
+        'jpg=lossy compression, smaller files. ' +
+        'Default: png'),
+    dpi: zod_1.z
+        .enum(['72', '96', '150', '300', '600'])
+        .optional()
+        .describe('FOR PDF_TO_IMAGE ONLY. Resolution in dots per inch. ' +
+        '72=screen/web preview, 96=standard web, 150=good quality, ' +
+        '300=print quality, 600=high-quality print. ' +
+        'Higher DPI = larger files. Default: 150'),
+    // === HTML TO PDF OPERATION ===
+    htmlContent: zod_1.z
+        .string()
+        .optional()
+        .describe('FOR HTML_TO_PDF ONLY. Raw HTML content to convert to PDF. ' +
+        'Use this instead of inputUrl when you have HTML as a string. ' +
+        'Example: "<html><body><h1>Hello World</h1></body></html>". ' +
+        'Either inputUrl OR htmlContent is required for htmlToPdf.'),
+})
+    .describe('MorphoPDF AI Tool - Process PDF files with various operations. ' +
+    'Supports compression, merging, splitting, rotation, watermarking, ' +
+    'and format conversions (PDF to Word/Excel/Image, Word/HTML to PDF).');
+/**
+ * API endpoint mapping for each operation
+ * Used to route requests to the correct MorphoPDF API endpoint
+ */
+exports.operationEndpoints = {
+    compress: '/pdf/compress',
+    merge: '/pdf/merge',
+    split: '/pdf/split',
+    rotate: '/pdf/rotate',
+    watermark: '/pdf/watermark',
+    pdfToWord: '/convert/pdf-to-word',
+    pdfToExcel: '/convert/pdf-to-excel',
+    pdfToImage: '/convert/pdf-to-image',
+    wordToPdf: '/convert/word-to-pdf',
+    htmlToPdf: '/convert/html-to-pdf',
+};
+/**
+ * Human-readable operation names for response formatting
+ */
+const operationNames = {
+    compress: 'PDF Compression',
+    merge: 'PDF Merge',
+    split: 'PDF Split',
+    rotate: 'PDF Rotation',
+    watermark: 'PDF Watermarking',
+    pdfToWord: 'PDF to Word Conversion',
+    pdfToExcel: 'PDF to Excel Conversion',
+    pdfToImage: 'PDF to Image Conversion',
+    wordToPdf: 'Word to PDF Conversion',
+    htmlToPdf: 'HTML to PDF Conversion',
+};
+/**
+ * Format API response for LLM consumption
+ * Transforms raw API response into a structured, readable format
+ *
+ * @param operation - The operation that was performed
+ * @param response - Raw API response from MorphoPDF
+ * @returns Formatted response object suitable for LLM output
+ */
+function formatToolResponse(operation, response) {
+    const operationName = operationNames[operation] || operation;
+    if (response.success === false || response.error) {
+        return {
+            success: false,
+            operation,
+            operationName,
+            message: `${operationName} failed: ${response.error?.message || 'Unknown error'}`,
+            error: response.error,
+        };
+    }
+    return {
+        success: true,
+        operation,
+        operationName,
+        message: `${operationName} completed successfully.`,
+        downloadUrl: response.downloadUrl,
+        fileName: response.fileName,
+    };
+}
+//# sourceMappingURL=toolSchema.js.map

package/dist/nodes/MorphoPdf/shared/toolSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolSchema.js","sourceRoot":"","sources":["../../../../nodes/MorphoPdf/shared/toolSchema.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-morphopdf",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "description": "n8n community node for MorphoPDF - Professional PDF processing and conversion",
   "keywords": [
     "n8n-community-node-package",
@@ -44,9 +44,14 @@
       "dist/credentials/MorphoPdfApi.credentials.js"
     ],
     "nodes": [
-      "dist/nodes/MorphoPdf/MorphoPdf.node.js"
+      "dist/nodes/MorphoPdf/MorphoPdf.node.js",
+      "dist/nodes/MorphoPdf/MorphoPdfTool.node.js"
     ]
   },
+  "dependencies": {
+    "@langchain/core": "^0.3.0",
+    "zod": "^3.23.0"
+  },
   "devDependencies": {
     "@n8n/node-cli": "*",
     "@types/node": "^25.1.0",