n8n-nodes-prompt-library 0.1.0

package/README.md

@@ -0,0 +1,53 @@
+# n8n-nodes-prompt-library
+
+n8n community node to fetch and render prompts from [n8n-library](https://github.com/your-org/n8n-library)'s prompt versioning system.
+
+## Features
+
+- **Get Prompt** - Fetch a prompt by slug (latest or specific version)
+- **List Prompts** - List all published prompts
+- **Render Prompt** - Fetch a prompt and replace `{{variable}}` template variables with values
+- **AI Tool compatible** - `usableAsTool: true` so AI agents can use this node
+
+## Installation
+
+### In n8n (community nodes)
+
+1. Go to **Settings > Community Nodes**
+2. Install `n8n-nodes-prompt-library`
+
+### Manual installation
+
+```bash
+cd ~/.n8n/custom
+npm install n8n-nodes-prompt-library
+```
+
+## Credentials
+
+| Field | Description |
+|-------|-------------|
+| Instance URL | Base URL of your n8n-library instance (e.g. `https://library.example.com`) |
+| API Key | API key from n8n-library Settings > API Keys (`n8nlib_...`) |
+
+## Operations
+
+### Get Prompt
+
+Fetches a single prompt by its slug. Optionally specify a version number (0 = latest).
+
+### List Prompts
+
+Returns all published prompts with their metadata (name, slug, description, variables, category, tags).
+
+### Render Prompt
+
+Fetches a prompt and replaces template variables. For example, if the prompt contains `{{customer_name}}`, provide a variable with name `customer_name` and value `Alice` to get the rendered output.
+
+## Example Usage
+
+```
+[Trigger] -> [Prompt Library: Render Prompt] -> [OpenAI Chat]
+```
+
+Fetch a versioned prompt with variables, then pass the rendered content to an LLM.

package/dist/credentials/PromptLibraryApi.credentials.d.ts

@@ -0,0 +1,9 @@
+import type { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class PromptLibraryApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/PromptLibraryApi.credentials.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromptLibraryApi = void 0;
+class PromptLibraryApi {
+    constructor() {
+        this.name = 'promptLibraryApi';
+        this.displayName = 'Prompt Library API';
+        this.documentationUrl = 'https://github.com/your-org/n8n-nodes-prompt-library';
+        this.properties = [
+            {
+                displayName: 'Instance URL',
+                name: 'instanceUrl',
+                type: 'string',
+                default: '',
+                placeholder: 'https://library.example.com',
+                description: 'Base URL of your n8n-library instance',
+                required: true,
+            },
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                placeholder: 'n8nlib_...',
+                description: 'API key from n8n-library Settings > API Keys',
+                required: true,
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.apiKey}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.instanceUrl}}',
+                url: '/api/public/prompts',
+                method: 'GET',
+            },
+        };
+    }
+}
+exports.PromptLibraryApi = PromptLibraryApi;

package/dist/nodes/PromptLibrary/PromptLibrary.node.d.ts

@@ -0,0 +1,11 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription, INodePropertyOptions, ILoadOptionsFunctions } from 'n8n-workflow';
+export declare class PromptLibrary implements INodeType {
+    description: INodeTypeDescription;
+    methods: {
+        loadOptions: {
+            getPrompts(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+            getVersions(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+        };
+    };
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/PromptLibrary/PromptLibrary.node.js

@@ -0,0 +1,252 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromptLibrary = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+class PromptLibrary {
+    constructor() {
+        this.description = {
+            displayName: 'Prompt Library',
+            name: 'promptLibrary',
+            icon: 'file:promptlibrary.svg',
+            group: ['input'],
+            version: 1,
+            subtitle: '={{$parameter["operation"]}}',
+            description: 'Fetch and render prompts from n8n-library',
+            defaults: {
+                name: 'Prompt Library',
+            },
+            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            usableAsTool: true,
+            credentials: [
+                {
+                    name: 'promptLibraryApi',
+                    required: true,
+                },
+            ],
+            properties: [
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'Get Prompt',
+                            value: 'getPrompt',
+                            description: 'Fetch a prompt by slug (latest or specific version)',
+                            action: 'Get a prompt',
+                        },
+                        {
+                            name: 'List Prompts',
+                            value: 'listPrompts',
+                            description: 'List all published prompts',
+                            action: 'List all prompts',
+                        },
+                        {
+                            name: 'Render Prompt',
+                            value: 'renderPrompt',
+                            description: 'Fetch a prompt and replace template variables',
+                            action: 'Render a prompt with variables',
+                        },
+                    ],
+                    default: 'getPrompt',
+                },
+                {
+                    displayName: 'Prompt',
+                    name: 'slug',
+                    type: 'options',
+                    typeOptions: {
+                        loadOptionsMethod: 'getPrompts',
+                    },
+                    required: true,
+                    default: '',
+                    description: 'Select the prompt to fetch',
+                    displayOptions: {
+                        show: {
+                            operation: ['getPrompt', 'renderPrompt'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Version',
+                    name: 'version',
+                    type: 'options',
+                    typeOptions: {
+                        loadOptionsMethod: 'getVersions',
+                        loadOptionsDependsOn: ['slug'],
+                    },
+                    required: true,
+                    default: '',
+                    description: 'Select the prompt version to fetch',
+                    displayOptions: {
+                        show: {
+                            operation: ['getPrompt', 'renderPrompt'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Variables',
+                    name: 'variables',
+                    type: 'fixedCollection',
+                    typeOptions: {
+                        multipleValues: true,
+                    },
+                    default: {},
+                    description: 'Template variables to replace in the prompt (e.g. {{customer_name}})',
+                    displayOptions: {
+                        show: {
+                            operation: ['renderPrompt'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: 'variable',
+                            displayName: 'Variable',
+                            values: [
+                                {
+                                    displayName: 'Name',
+                                    name: 'name',
+                                    type: 'string',
+                                    default: '',
+                                    description: 'Variable name (without {{ }})',
+                                },
+                                {
+                                    displayName: 'Value',
+                                    name: 'value',
+                                    type: 'string',
+                                    default: '',
+                                    description: 'Value to substitute',
+                                },
+                            ],
+                        },
+                    ],
+                },
+            ],
+        };
+        this.methods = {
+            loadOptions: {
+                async getPrompts() {
+                    const credentials = await this.getCredentials('promptLibraryApi');
+                    const options = {
+                        method: 'GET',
+                        url: `${credentials.instanceUrl.replace(/\/+$/, '')}/api/public/prompts`,
+                        json: true,
+                    };
+                    const response = await this.helpers.httpRequestWithAuthentication.call(this, 'promptLibraryApi', options);
+                    const prompts = response.prompts;
+                    if (!Array.isArray(prompts))
+                        return [];
+                    return prompts.map((p) => ({
+                        name: `${p.name} (${p.slug})`,
+                        value: p.slug,
+                        description: p.description || undefined,
+                    }));
+                },
+                async getVersions() {
+                    const slug = this.getCurrentNodeParameter('slug');
+                    if (!slug)
+                        return [];
+                    const credentials = await this.getCredentials('promptLibraryApi');
+                    const baseUrl = credentials.instanceUrl.replace(/\/+$/, '');
+                    const options = {
+                        method: 'GET',
+                        url: `${baseUrl}/api/public/prompts/${encodeURIComponent(slug)}/versions`,
+                        json: true,
+                    };
+                    const response = await this.helpers.httpRequestWithAuthentication.call(this, 'promptLibraryApi', options);
+                    const versions = response.versions;
+                    if (!Array.isArray(versions))
+                        return [];
+                    const result = [
+                        {
+                            name: 'Latest',
+                            value: 'latest',
+                            description: 'Always fetch the latest version',
+                        },
+                    ];
+                    for (const v of versions) {
+                        const version = v.version;
+                        const changeNote = v.change_note;
+                        result.push({
+                            name: `v${version}${changeNote ? ` – ${changeNote}` : ''}`,
+                            value: version,
+                        });
+                    }
+                    return result;
+                },
+            },
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const operation = this.getNodeParameter('operation', 0);
+        const credentials = await this.getCredentials('promptLibraryApi');
+        const baseUrl = credentials.instanceUrl.replace(/\/+$/, '');
+        for (let i = 0; i < items.length; i++) {
+            try {
+                if (operation === 'listPrompts') {
+                    const options = {
+                        method: 'GET',
+                        url: `${baseUrl}/api/public/prompts`,
+                        json: true,
+                    };
+                    const response = await this.helpers.httpRequestWithAuthentication.call(this, 'promptLibraryApi', options);
+                    const prompts = response.prompts;
+                    for (const prompt of prompts) {
+                        returnData.push({ json: prompt });
+                    }
+                }
+                else if (operation === 'getPrompt' || operation === 'renderPrompt') {
+                    const slug = this.getNodeParameter('slug', i);
+                    const versionParam = this.getNodeParameter('version', i, 'latest');
+                    const version = versionParam === 'latest' ? 0 : Number(versionParam);
+                    const url = version > 0
+                        ? `${baseUrl}/api/public/prompts/${encodeURIComponent(slug)}/v/${version}`
+                        : `${baseUrl}/api/public/prompts/${encodeURIComponent(slug)}`;
+                    const options = {
+                        method: 'GET',
+                        url,
+                        json: true,
+                    };
+                    const prompt = (await this.helpers.httpRequestWithAuthentication.call(this, 'promptLibraryApi', options));
+                    if (operation === 'renderPrompt') {
+                        let content = prompt.content;
+                        const variablesData = this.getNodeParameter('variables', i, {});
+                        const variablesList = variablesData.variable || [];
+                        for (const v of variablesList) {
+                            const varName = v.name;
+                            const varValue = v.value;
+                            if (varName) {
+                                const pattern = new RegExp(`\\{\\{\\s*${varName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\s*\\}\\}`, 'g');
+                                content = content.replace(pattern, varValue);
+                            }
+                        }
+                        returnData.push({
+                            json: {
+                                ...prompt,
+                                content,
+                                rendered: true,
+                            },
+                        });
+                    }
+                    else {
+                        returnData.push({ json: prompt });
+                    }
+                }
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    returnData.push({
+                        json: { error: error.message },
+                    });
+                    continue;
+                }
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), error, { itemIndex: i });
+            }
+        }
+        return [returnData];
+    }
+}
+exports.PromptLibrary = PromptLibrary;

package/dist/nodes/PromptLibrary/promptlibrary.svg

@@ -0,0 +1,31 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" fill="none">
+  <!-- Deepest doc (smallest, most faded, furthest back) -->
+  <rect x="18" y="6" width="28" height="36" rx="3" fill="#a5b4fc" opacity="0.3" transform="scale(0.82) translate(7, 4)"/>
+
+  <!-- Middle-back doc -->
+  <rect x="16" y="10" width="30" height="38" rx="3.5" fill="#818cf8" opacity="0.45" transform="scale(0.88) translate(4, 2)"/>
+
+  <!-- Middle doc -->
+  <rect x="14" y="14" width="32" height="40" rx="4" fill="#6366f1" opacity="0.6"/>
+  <rect x="19" y="20" width="18" height="2.5" rx="1.25" fill="#fff" opacity="0.5"/>
+  <rect x="19" y="25" width="14" height="2.5" rx="1.25" fill="#fff" opacity="0.4"/>
+  <rect x="19" y="30" width="16" height="2.5" rx="1.25" fill="#fff" opacity="0.35"/>
+
+  <!-- Front doc (largest, fully opaque, closest) -->
+  <rect x="12" y="18" width="36" height="42" rx="4.5" fill="#6366f1"/>
+  <!-- Subtle inner shadow/border -->
+  <rect x="12" y="18" width="36" height="42" rx="4.5" fill="none" stroke="#4f46e5" stroke-width="0.8"/>
+  <!-- Text lines -->
+  <rect x="18" y="25" width="24" height="3" rx="1.5" fill="#fff" opacity="0.9"/>
+  <rect x="18" y="31" width="19" height="3" rx="1.5" fill="#fff" opacity="0.7"/>
+  <rect x="18" y="37" width="22" height="3" rx="1.5" fill="#fff" opacity="0.6"/>
+  <rect x="18" y="43" width="15" height="3" rx="1.5" fill="#fff" opacity="0.5"/>
+  <!-- Cursor / prompt indicator -->
+  <rect x="18" y="49" width="2" height="3" rx="0.5" fill="#c7d2fe" opacity="0.8"/>
+
+  <!-- Floating sparkle/glow dots suggesting depth/space -->
+  <circle cx="50" cy="12" r="1.5" fill="#a5b4fc" opacity="0.6"/>
+  <circle cx="54" cy="20" r="1" fill="#c7d2fe" opacity="0.5"/>
+  <circle cx="8" cy="14" r="1.2" fill="#a5b4fc" opacity="0.4"/>
+  <circle cx="52" cy="8" r="0.8" fill="#e0e7ff" opacity="0.5"/>
+</svg>

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "n8n-nodes-prompt-library",
+  "version": "0.1.0",
+  "description": "n8n community node to fetch and render prompts from n8n-library's prompt versioning system",
+  "license": "MIT",
+  "keywords": [
+    "n8n-community-node-package"
+  ],
+  "scripts": {
+    "build": "tsc && cp nodes/PromptLibrary/promptlibrary.svg dist/nodes/PromptLibrary/",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/PromptLibraryApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/PromptLibrary/PromptLibrary.node.js"
+    ]
+  },
+  "devDependencies": {
+    "typescript": "~5.7.0"
+  },
+  "peerDependencies": {
+    "n8n-workflow": "*"
+  }
+}