@catalogicus-international/n8n-nodes-light-rag 0.1.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Catalogicus International
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,149 @@
+# @catalogicus-international/n8n-nodes-light-rag
+
+An n8n community package that exposes a LightRAG API server to regular workflows and
+AI Agents.
+
+## Nodes
+
+### LightRAG
+
+Use `LightRAG` in a regular n8n workflow. It has standard Main input and output
+connections and processes every incoming item.
+
+Choose an operation in the node UI. Operations that send JSON use the complete current
+input item (`{{$json}}`) as the request body by default. For example, an input item for
+the `Query` operation can be:
+
+```json
+{
+  "query": "What does the knowledge base say about LightRAG?",
+  "mode": "mix",
+  "include_references": true
+}
+```
+
+You can replace the Request Body expression with a manually configured object or map
+individual fields from previous nodes. Responses are emitted through the normal Main
+output and retain n8n item pairing.
+
+### LightRAG Tool
+
+Connect `LightRAG Tool` to the tool input of an n8n AI Agent. The agent supplies one
+structured object through the `request` argument.
+
+Query the knowledge base:
+
+```json
+{
+  "operation": "query",
+  "body": {
+    "query": "What does the knowledge base say about LightRAG?",
+    "mode": "mix",
+    "include_references": true,
+    "include_chunk_content": false
+  }
+}
+```
+
+Retrieve structured entities, relationships, chunks, and references without generating
+a final answer:
+
+```json
+{
+  "operation": "queryData",
+  "body": {
+    "query": "LightRAG architecture",
+    "mode": "hybrid"
+  }
+}
+```
+
+Insert text asynchronously:
+
+```json
+{
+  "operation": "insertText",
+  "body": {
+    "text": "Content to add to the knowledge base.",
+    "file_source": "agent-note.txt",
+    "chunking": {
+      "strategy": "fixed_token",
+      "params": {
+        "chunk_token_size": 1200,
+        "chunk_overlap_token_size": 100
+      }
+    }
+  }
+}
+```
+
+The response contains a `track_id`. Check processing progress with:
+
+```json
+{
+  "operation": "trackStatus",
+  "trackId": "insert_..."
+}
+```
+
+## Supported operations
+
+- `query` — `POST /query`;
+- `queryData` — `POST /query/data`;
+- `insertText` — `POST /documents/text`;
+- `insertTexts` — `POST /documents/texts`;
+- `trackStatus` — `GET /documents/track_status/{track_id}`;
+- `pipelineStatus` — `GET /documents/pipeline_status`;
+- `listDocuments` — `POST /documents/paginated`;
+- `scanDocuments` — `POST /documents/scan`;
+- `deleteDocuments` — `DELETE /documents/delete_document`;
+- `health` — `GET /health`;
+- `customRequest` — a request to any relative LightRAG API path.
+
+Example custom request:
+
+```json
+{
+  "operation": "customRequest",
+  "method": "GET",
+  "path": "documents/status_counts",
+  "queryParameters": {}
+}
+```
+
+Only relative paths are accepted, so credentials cannot be forwarded to another host.
+
+## Query modes
+
+The query operations support LightRAG modes `local`, `global`, `hybrid`, `naive`,
+`mix`, and `bypass`. `mix` is the LightRAG-recommended general-purpose mode.
+
+All request fields supported by the LightRAG API can be passed in `body`, including
+`response_type`, `top_k`, `chunk_top_k`, token budgets, keyword lists,
+`conversation_history`, `user_prompt`, reranking options, and reference options.
+
+## Credentials
+
+Create a `LightRAG API` credential:
+
+- `Base URL`: normally `http://localhost:9621`;
+- `Authentication`: `API Key`, `Bearer Token`, or `None`;
+- API key authentication is sent using `X-API-Key`;
+- include a configured reverse-proxy API prefix in the Base URL when applicable.
+
+## Development
+
+```bash
+pnpm install
+pnpm run lint
+pnpm test
+```
+
+## Resources
+
+- [LightRAG API Server documentation](https://github.com/HKUDS/LightRAG/blob/main/docs/LightRAG-API-Server.md)
+- [n8n node documentation](https://docs.n8n.io/integrations/creating-nodes/)
+
+## License
+
+[MIT](LICENSE.md)

package/dist/credentials/LightRagApi.credentials.d.ts

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

package/dist/credentials/LightRagApi.credentials.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LightRagApi = void 0;
+class LightRagApi {
+    constructor() {
+        this.name = 'lightRagApi';
+        this.displayName = 'LightRAG API';
+        this.icon = 'file:../icons/lightrag.svg';
+        this.documentationUrl = 'https://github.com/HKUDS/LightRAG/blob/main/docs/LightRAG-API-Server.md';
+        this.properties = [
+            {
+                displayName: 'Base URL',
+                name: 'baseUrl',
+                type: 'string',
+                default: 'http://localhost:9621',
+                required: true,
+                description: 'Root URL of the LightRAG API server, including an API prefix if configured',
+            },
+            {
+                displayName: 'Authentication',
+                name: 'authentication',
+                type: 'options',
+                options: [
+                    { name: 'API Key', value: 'apiKey' },
+                    { name: 'Bearer Token', value: 'bearerToken' },
+                    { name: 'None', value: 'none' },
+                ],
+                default: 'apiKey',
+            },
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                displayOptions: {
+                    show: {
+                        authentication: ['apiKey'],
+                    },
+                },
+                description: 'Value sent in the X-API-Key header',
+            },
+            {
+                displayName: 'Bearer Token',
+                name: 'bearerToken',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                displayOptions: {
+                    show: {
+                        authentication: ['bearerToken'],
+                    },
+                },
+                description: 'JWT access token obtained from the LightRAG login endpoint',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    'X-API-Key': '={{$credentials.authentication === "apiKey" ? $credentials.apiKey : undefined}}',
+                    Authorization: '={{$credentials.authentication === "bearerToken" ? "Bearer " + $credentials.bearerToken : undefined}}',
+                    Accept: 'application/json',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.baseUrl}}',
+                url: '/health',
+                method: 'GET',
+            },
+        };
+    }
+}
+exports.LightRagApi = LightRagApi;
+//# sourceMappingURL=LightRagApi.credentials.js.map

package/dist/credentials/LightRagApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LightRagApi.credentials.js","sourceRoot":"","sources":["../../credentials/LightRagApi.credentials.ts"],"names":[],"mappings":";;;AAQA,MAAa,WAAW;IAAxB;QACC,SAAI,GAAG,aAAa,CAAC;QAErB,gBAAW,GAAG,cAAc,CAAC;QAE7B,SAAI,GAAS,4BAA4B,CAAC;QAE1C,qBAAgB,GACf,yEAAyE,CAAC;QAE3E,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,uBAAuB;gBAChC,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,4EAA4E;aACzF;YACD;gBACC,WAAW,EAAE,gBAAgB;gBAC7B,IAAI,EAAE,gBAAgB;gBACtB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE;oBACR,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE;oBACpC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,EAAE;oBAC9C,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;iBAC/B;gBACD,OAAO,EAAE,QAAQ;aACjB;YACD;gBACC,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,cAAc,EAAE;oBACf,IAAI,EAAE;wBACL,cAAc,EAAE,CAAC,QAAQ,CAAC;qBAC1B;iBACD;gBACD,WAAW,EAAE,oCAAoC;aACjD;YACD;gBACC,WAAW,EAAE,cAAc;gBAC3B,IAAI,EAAE,aAAa;gBACnB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,cAAc,EAAE;oBACf,IAAI,EAAE;wBACL,cAAc,EAAE,CAAC,aAAa,CAAC;qBAC/B;iBACD;gBACD,WAAW,EAAE,4DAA4D;aACzE;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,WAAW,EACV,iFAAiF;oBAClF,aAAa,EACZ,uGAAuG;oBACxG,MAAM,EAAE,kBAAkB;iBAC1B;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,2BAA2B;gBACpC,GAAG,EAAE,SAAS;gBACd,MAAM,EAAE,KAAK;aACb;SACD,CAAC;IACH,CAAC;CAAA;AAhFD,kCAgFC"}

package/dist/icons/lightrag.svg

@@ -0,0 +1,13 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
+	<defs>
+		<linearGradient id="g" x1="8" y1="8" x2="56" y2="56" gradientUnits="userSpaceOnUse">
+			<stop stop-color="#ffd54a"/>
+			<stop offset="1" stop-color="#ff6b35"/>
+		</linearGradient>
+	</defs>
+	<rect width="64" height="64" rx="14" fill="#14171f"/>
+	<path d="M35 5 14 36h15l-2 23 23-34H35z" fill="url(#g)"/>
+	<circle cx="15" cy="18" r="4" fill="#76e4f7"/>
+	<circle cx="50" cy="48" r="4" fill="#76e4f7"/>
+	<path d="M18 20 27 27M39 39l8 7" stroke="#76e4f7" stroke-width="3" stroke-linecap="round"/>
+</svg>

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

@@ -0,0 +1,5 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class LightRag implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/LightRag/LightRag.node.js

@@ -0,0 +1,235 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LightRag = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const request_1 = require("../LightRagTool/request");
+const workflowRequest_1 = require("./workflowRequest");
+const bodyOperations = [
+    'query',
+    'queryData',
+    'insertText',
+    'insertTexts',
+    'listDocuments',
+    'deleteDocuments',
+];
+class LightRag {
+    constructor() {
+        this.description = {
+            displayName: 'LightRAG',
+            name: 'lightRag',
+            icon: 'file:../../icons/lightrag.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"]}}',
+            description: 'Query and manage LightRAG in a regular n8n workflow',
+            defaults: {
+                name: 'LightRAG',
+            },
+            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            usableAsTool: true,
+            credentials: [
+                {
+                    name: 'lightRagApi',
+                    required: true,
+                },
+            ],
+            properties: [
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'Custom Request',
+                            value: 'customRequest',
+                            description: 'Call another relative LightRAG API endpoint',
+                            action: 'Make a custom API request',
+                        },
+                        {
+                            name: 'Delete Documents',
+                            value: 'deleteDocuments',
+                            description: 'Delete documents and their associated data',
+                            action: 'Delete documents',
+                        },
+                        {
+                            name: 'Get Pipeline Status',
+                            value: 'pipelineStatus',
+                            description: 'Get the current indexing pipeline state',
+                            action: 'Get pipeline status',
+                        },
+                        {
+                            name: 'Get Track Status',
+                            value: 'trackStatus',
+                            description: 'Check document processing progress using a track ID',
+                            action: 'Get document processing status',
+                        },
+                        {
+                            name: 'Health',
+                            value: 'health',
+                            description: 'Check the LightRAG server health',
+                            action: 'Check server health',
+                        },
+                        {
+                            name: 'Insert Text',
+                            value: 'insertText',
+                            description: 'Add one text document for asynchronous indexing',
+                            action: 'Insert a text document',
+                        },
+                        {
+                            name: 'Insert Texts',
+                            value: 'insertTexts',
+                            description: 'Add multiple text documents for asynchronous indexing',
+                            action: 'Insert text documents',
+                        },
+                        {
+                            name: 'List Documents',
+                            value: 'listDocuments',
+                            description: 'Return a paginated document list',
+                            action: 'List documents',
+                        },
+                        {
+                            name: 'Query',
+                            value: 'query',
+                            description: 'Generate an answer from the knowledge base',
+                            action: 'Query the knowledge base',
+                        },
+                        {
+                            name: 'Query Data',
+                            value: 'queryData',
+                            description: 'Return retrieved entities, relationships, chunks, and references',
+                            action: 'Retrieve structured RAG data',
+                        },
+                        {
+                            name: 'Scan Documents',
+                            value: 'scanDocuments',
+                            description: 'Scan the configured input directory for new documents',
+                            action: 'Scan documents',
+                        },
+                    ],
+                    default: 'query',
+                },
+                {
+                    displayName: 'Request Body',
+                    name: 'body',
+                    type: 'json',
+                    default: '={{ $json }}',
+                    displayOptions: {
+                        show: {
+                            operation: bodyOperations,
+                        },
+                    },
+                    description: 'JSON body sent to LightRAG. By default, the complete current input item is used.',
+                },
+                {
+                    displayName: 'Track ID',
+                    name: 'trackId',
+                    type: 'string',
+                    default: '={{ $json.track_id }}',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            operation: ['trackStatus'],
+                        },
+                    },
+                    description: 'Track ID returned by an insert, upload, or scan operation',
+                },
+                {
+                    displayName: 'Method',
+                    name: 'method',
+                    type: 'options',
+                    options: [
+                        { name: 'DELETE', value: 'DELETE' },
+                        { name: 'GET', value: 'GET' },
+                        { name: 'HEAD', value: 'HEAD' },
+                        { name: 'PATCH', value: 'PATCH' },
+                        { name: 'POST', value: 'POST' },
+                        { name: 'PUT', value: 'PUT' },
+                    ],
+                    default: 'GET',
+                    displayOptions: {
+                        show: {
+                            operation: ['customRequest'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Path',
+                    name: 'path',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    placeholder: 'documents/status_counts',
+                    displayOptions: {
+                        show: {
+                            operation: ['customRequest'],
+                        },
+                    },
+                    description: 'Relative API path. Absolute URLs are rejected to protect credentials.',
+                },
+                {
+                    displayName: 'Query Parameters',
+                    name: 'queryParameters',
+                    type: 'json',
+                    default: '{}',
+                    displayOptions: {
+                        show: {
+                            operation: ['customRequest'],
+                        },
+                    },
+                    description: 'Optional URL query parameters as a JSON object',
+                },
+                {
+                    displayName: 'Request Body',
+                    name: 'customBody',
+                    type: 'json',
+                    default: '{}',
+                    displayOptions: {
+                        show: {
+                            operation: ['customRequest'],
+                            method: ['DELETE', 'PATCH', 'POST', 'PUT'],
+                        },
+                    },
+                    description: 'Optional JSON request body',
+                },
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const credentials = await this.getCredentials('lightRagApi');
+        const baseUrl = (0, request_1.normalizeBaseUrl)(credentials.baseUrl);
+        for (let itemIndex = 0; itemIndex < items.length; itemIndex++) {
+            try {
+                const operation = this.getNodeParameter('operation', itemIndex);
+                const parameters = {
+                    body: operation === 'customRequest'
+                        ? this.getNodeParameter('customBody', itemIndex, undefined)
+                        : this.getNodeParameter('body', itemIndex, undefined),
+                    method: this.getNodeParameter('method', itemIndex, undefined),
+                    path: this.getNodeParameter('path', itemIndex, undefined),
+                    queryParameters: this.getNodeParameter('queryParameters', itemIndex, undefined),
+                    trackId: this.getNodeParameter('trackId', itemIndex, undefined),
+                };
+                const request = (0, workflowRequest_1.normalizeWorkflowRequest)(operation, parameters);
+                const response = await (0, request_1.executeLightRagRequest)(this, baseUrl, request);
+                returnData.push(...(0, request_1.responseToExecutionData)(response, itemIndex));
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    returnData.push({
+                        json: { error: error instanceof Error ? error.message : String(error) },
+                        pairedItem: itemIndex,
+                    });
+                    continue;
+                }
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), error, { itemIndex });
+            }
+        }
+        return [returnData];
+    }
+}
+exports.LightRag = LightRag;
+//# sourceMappingURL=LightRag.node.js.map

package/dist/nodes/LightRag/LightRag.node.js.map

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

package/dist/nodes/LightRag/LightRag.node.json

@@ -0,0 +1,18 @@
+{
+    "node": "@catalogicus-international/n8n-nodes-light-rag.lightRag",
+    "nodeVersion": "1.0",
+    "codexVersion": "1.0",
+    "categories": ["AI", "Data & Storage"],
+    "resources": {
+        "credentialDocumentation": [
+            {
+                "url": "https://github.com/HKUDS/LightRAG/blob/main/docs/LightRAG-API-Server.md"
+            }
+        ],
+        "primaryDocumentation": [
+            {
+                "url": "https://github.com/HKUDS/LightRAG/blob/main/docs/LightRAG-API-Server.md"
+            }
+        ]
+    }
+}

package/dist/nodes/LightRag/workflowRequest.d.ts

@@ -0,0 +1,9 @@
+import { type LightRagRequestOptions } from '../LightRagTool/request';
+export interface WorkflowRequestParameters {
+    body?: unknown;
+    method?: unknown;
+    path?: unknown;
+    queryParameters?: unknown;
+    trackId?: unknown;
+}
+export declare function normalizeWorkflowRequest(operation: unknown, parameters: WorkflowRequestParameters): LightRagRequestOptions;

package/dist/nodes/LightRag/workflowRequest.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeWorkflowRequest = normalizeWorkflowRequest;
+const request_1 = require("../LightRagTool/request");
+function normalizeWorkflowRequest(operation, parameters) {
+    const request = {
+        operation: String(operation || ''),
+    };
+    if (parameters.body !== undefined) {
+        request.body = parameters.body;
+    }
+    if (parameters.trackId !== undefined) {
+        request.trackId = parameters.trackId;
+    }
+    if (parameters.method !== undefined) {
+        request.method = parameters.method;
+    }
+    if (parameters.path !== undefined) {
+        request.path = parameters.path;
+    }
+    if (parameters.queryParameters !== undefined) {
+        request.queryParameters = parameters.queryParameters;
+    }
+    return (0, request_1.normalizeToolRequest)(request);
+}
+//# sourceMappingURL=workflowRequest.js.map

package/dist/nodes/LightRag/workflowRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowRequest.js","sourceRoot":"","sources":["../../../nodes/LightRag/workflowRequest.ts"],"names":[],"mappings":";;AAWA,4DAyBC;AAnCD,qDAA4F;AAU5F,SAAgB,wBAAwB,CACvC,SAAkB,EAClB,UAAqC;IAErC,MAAM,OAAO,GAAgB;QAC5B,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;KAClC,CAAC;IAEF,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO,CAAC,IAAI,GAAG,UAAU,CAAC,IAA2B,CAAC;IACvD,CAAC;IACD,IAAI,UAAU,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,CAAC,OAAO,GAAG,UAAU,CAAC,OAA8B,CAAC;IAC7D,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,CAAC,MAAM,GAAG,UAAU,CAAC,MAA6B,CAAC;IAC3D,CAAC;IACD,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO,CAAC,IAAI,GAAG,UAAU,CAAC,IAA2B,CAAC;IACvD,CAAC;IACD,IAAI,UAAU,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QAC9C,OAAO,CAAC,eAAe,GAAG,UAAU,CAAC,eAAsC,CAAC;IAC7E,CAAC;IAED,OAAO,IAAA,8BAAoB,EAAC,OAAO,CAAC,CAAC;AACtC,CAAC"}

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

@@ -0,0 +1,5 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class LightRagTool implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/LightRagTool/LightRagTool.node.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LightRagTool = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const request_1 = require("./request");
+class LightRagTool {
+    constructor() {
+        this.description = {
+            displayName: 'LightRAG Tool',
+            name: 'lightRagTool',
+            icon: 'file:../../icons/lightrag.svg',
+            group: ['input'],
+            version: 1,
+            subtitle: 'Query and manage LightRAG from an AI Agent',
+            description: 'Let an AI Agent query and manage a LightRAG knowledge base',
+            defaults: {
+                name: 'LightRAG Tool',
+            },
+            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            usableAsTool: true,
+            credentials: [
+                {
+                    name: 'lightRagApi',
+                    required: true,
+                },
+            ],
+            properties: [
+                {
+                    displayName: 'Request',
+                    name: 'request',
+                    type: 'json',
+                    default: '={{ $fromAI("request", "A LightRAG request object. Use operation query, queryData, insertText, insertTexts, trackStatus, pipelineStatus, listDocuments, scanDocuments, deleteDocuments, health, or customRequest. Put endpoint payload fields inside body.", "json") }}',
+                    description: 'Structured LightRAG request supplied by the AI Agent. For example: {"operation":"query","body":{"query":"What is LightRAG?","mode":"mix","include_references":true}}.',
+                },
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const credentials = await this.getCredentials('lightRagApi');
+        const baseUrl = (0, request_1.normalizeBaseUrl)(credentials.baseUrl);
+        for (let itemIndex = 0; itemIndex < items.length; itemIndex++) {
+            try {
+                const request = (0, request_1.normalizeToolRequest)(this.getNodeParameter('request', itemIndex));
+                const response = await (0, request_1.executeLightRagRequest)(this, baseUrl, request);
+                returnData.push(...(0, request_1.responseToExecutionData)(response, itemIndex));
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    returnData.push({
+                        json: { error: error instanceof Error ? error.message : String(error) },
+                        pairedItem: itemIndex,
+                    });
+                    continue;
+                }
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), error, { itemIndex });
+            }
+        }
+        return [returnData];
+    }
+}
+exports.LightRagTool = LightRagTool;
+//# sourceMappingURL=LightRagTool.node.js.map

package/dist/nodes/LightRagTool/LightRagTool.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LightRagTool.node.js","sourceRoot":"","sources":["../../../nodes/LightRagTool/LightRagTool.node.ts"],"names":[],"mappings":";;;AAMA,+CAAuE;AACvE,uCAKmB;AAEnB,MAAa,YAAY;IAAzB;QACC,gBAAW,GAAyB;YACnC,WAAW,EAAE,eAAe;YAC5B,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,+BAA+B;YACrC,KAAK,EAAE,CAAC,OAAO,CAAC;YAChB,OAAO,EAAE,CAAC;YACV,QAAQ,EAAE,4CAA4C;YACtD,WAAW,EAAE,4DAA4D;YACzE,QAAQ,EAAE;gBACT,IAAI,EAAE,eAAe;aACrB;YACD,MAAM,EAAE,CAAC,kCAAmB,CAAC,IAAI,CAAC;YAClC,OAAO,EAAE,CAAC,kCAAmB,CAAC,IAAI,CAAC;YACnC,YAAY,EAAE,IAAI;YAClB,WAAW,EAAE;gBACZ;oBACC,IAAI,EAAE,aAAa;oBACnB,QAAQ,EAAE,IAAI;iBACd;aACD;YACD,UAAU,EAAE;gBACX;oBACC,WAAW,EAAE,SAAS;oBACtB,IAAI,EAAE,SAAS;oBACf,IAAI,EAAE,MAAM;oBACZ,OAAO,EACN,yQAAyQ;oBAC1Q,WAAW,EACV,uKAAuK;iBACxK;aACD;SACD,CAAC;IA4BH,CAAC;IA1BA,KAAK,CAAC,OAAO;QACZ,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAClC,MAAM,UAAU,GAAyB,EAAE,CAAC;QAC5C,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,IAAA,0BAAgB,EAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAEtD,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC;YAC/D,IAAI,CAAC;gBACJ,MAAM,OAAO,GAAG,IAAA,8BAAoB,EAAC,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;gBAClF,MAAM,QAAQ,GAAG,MAAM,IAAA,gCAAsB,EAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;gBACtE,UAAU,CAAC,IAAI,CAAC,GAAG,IAAA,iCAAuB,EAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;YAClE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,IAAI,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;oBAC3B,UAAU,CAAC,IAAI,CAAC;wBACf,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;wBACvE,UAAU,EAAE,SAAS;qBACrB,CAAC,CAAC;oBACH,SAAS;gBACV,CAAC;gBAED,MAAM,IAAI,iCAAkB,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;YACpE,CAAC;QACF,CAAC;QAED,OAAO,CAAC,UAAU,CAAC,CAAC;IACrB,CAAC;CACD;AA5DD,oCA4DC"}

package/dist/nodes/LightRagTool/LightRagTool.node.json

@@ -0,0 +1,18 @@
+{
+    "node": "@catalogicus-international/n8n-nodes-light-rag.lightRagTool",
+    "nodeVersion": "1.0",
+    "codexVersion": "1.0",
+    "categories": ["AI", "Data & Storage"],
+    "resources": {
+        "credentialDocumentation": [
+            {
+                "url": "https://github.com/HKUDS/LightRAG/blob/main/docs/LightRAG-API-Server.md"
+            }
+        ],
+        "primaryDocumentation": [
+            {
+                "url": "https://github.com/HKUDS/LightRAG/blob/main/docs/LightRAG-API-Server.md"
+            }
+        ]
+    }
+}

package/dist/nodes/LightRagTool/request.d.ts

@@ -0,0 +1,13 @@
+import type { IDataObject, IExecuteFunctions, INodeExecutionData } from 'n8n-workflow';
+export type LightRagHttpMethod = 'DELETE' | 'GET' | 'HEAD' | 'PATCH' | 'POST' | 'PUT';
+export interface LightRagRequestOptions {
+    method: LightRagHttpMethod;
+    path: string;
+    query?: IDataObject;
+    body?: IDataObject;
+}
+export declare function normalizeBaseUrl(value: unknown): string;
+export declare function parseRequestObject(value: unknown, fieldName?: string): IDataObject;
+export declare function normalizeToolRequest(value: unknown): LightRagRequestOptions;
+export declare function executeLightRagRequest(executeFunctions: IExecuteFunctions, baseUrl: string, request: LightRagRequestOptions): Promise<unknown>;
+export declare function responseToExecutionData(response: unknown, itemIndex: number): INodeExecutionData[];

package/dist/nodes/LightRagTool/request.js

@@ -0,0 +1,199 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeBaseUrl = normalizeBaseUrl;
+exports.parseRequestObject = parseRequestObject;
+exports.normalizeToolRequest = normalizeToolRequest;
+exports.executeLightRagRequest = executeLightRagRequest;
+exports.responseToExecutionData = responseToExecutionData;
+const n8n_workflow_1 = require("n8n-workflow");
+const QUERY_MODES = ['local', 'global', 'hybrid', 'naive', 'mix', 'bypass'];
+const HTTP_METHODS = ['DELETE', 'GET', 'HEAD', 'PATCH', 'POST', 'PUT'];
+function isObject(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function normalizeBaseUrl(value) {
+    const baseUrl = String(value || 'http://localhost:9621').trim().replace(/\/+$/, '');
+    if (!/^https?:\/\//i.test(baseUrl)) {
+        throw new n8n_workflow_1.ApplicationError('Base URL must start with http:// or https://');
+    }
+    return baseUrl;
+}
+function parseRequestObject(value, fieldName = 'Request') {
+    let parsed = value;
+    for (let attempt = 0; attempt < 20 && typeof parsed === 'string'; attempt++) {
+        if (!parsed.trim()) {
+            throw new n8n_workflow_1.ApplicationError(`${fieldName} must be a non-empty object`);
+        }
+        let parseErrorMessage = '';
+        try {
+            parsed = JSON.parse(parsed);
+        }
+        catch (error) {
+            parseErrorMessage = error instanceof Error ? error.message : String(error);
+        }
+        if (parseErrorMessage) {
+            throw new n8n_workflow_1.ApplicationError(`${fieldName} contains invalid JSON: ${parseErrorMessage}`);
+        }
+    }
+    if (!isObject(parsed)) {
+        throw new n8n_workflow_1.ApplicationError(`${fieldName} must resolve to an object, not an array or primitive`);
+    }
+    return parsed;
+}
+function parseOptionalObject(value, fieldName) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    return parseRequestObject(value, fieldName);
+}
+function requireString(value, fieldName, minimumLength = 1) {
+    if (typeof value !== 'string' || value.trim().length < minimumLength) {
+        throw new n8n_workflow_1.ApplicationError(`${fieldName} must be a string containing at least ${minimumLength} character${minimumLength === 1 ? '' : 's'}`);
+    }
+    return value.trim();
+}
+function normalizePath(value) {
+    const path = requireString(value, 'Path').replace(/^\/+|\/+$/g, '');
+    if (/^(?:https?:)?\/\//i.test(path)) {
+        throw new n8n_workflow_1.ApplicationError('Path must be relative to the configured LightRAG Base URL');
+    }
+    return path;
+}
+function normalizeMethod(value) {
+    const method = String(value || 'GET').trim().toUpperCase();
+    if (!HTTP_METHODS.includes(method)) {
+        throw new n8n_workflow_1.ApplicationError(`Method must be one of: ${HTTP_METHODS.join(', ')}`);
+    }
+    return method;
+}
+function normalizeQueryBody(value) {
+    const body = parseRequestObject(value, 'Query body');
+    body.query = requireString(body.query, 'Query', 3);
+    if (body.mode !== undefined && !QUERY_MODES.includes(String(body.mode))) {
+        throw new n8n_workflow_1.ApplicationError(`Query mode must be one of: ${QUERY_MODES.join(', ')}`);
+    }
+    return body;
+}
+function normalizeInsertTextBody(value) {
+    const body = parseRequestObject(value, 'Insert text body');
+    body.text = requireString(body.text, 'Text');
+    return body;
+}
+function normalizeInsertTextsBody(value) {
+    const body = parseRequestObject(value, 'Insert texts body');
+    if (!Array.isArray(body.texts) ||
+        body.texts.length === 0 ||
+        !body.texts.every((text) => typeof text === 'string' && text.trim())) {
+        throw new n8n_workflow_1.ApplicationError('Texts must be a non-empty array of non-empty strings');
+    }
+    body.texts = body.texts.map((text) => String(text).trim());
+    return body;
+}
+function normalizeDeleteDocumentsBody(value) {
+    const body = parseRequestObject(value, 'Delete documents body');
+    if (!Array.isArray(body.doc_ids) ||
+        body.doc_ids.length === 0 ||
+        !body.doc_ids.every((id) => typeof id === 'string' && id.trim())) {
+        throw new n8n_workflow_1.ApplicationError('doc_ids must be a non-empty array of document ID strings');
+    }
+    body.doc_ids = body.doc_ids.map((id) => String(id).trim());
+    return body;
+}
+function operationName(value) {
+    return String(value || '')
+        .trim()
+        .replace(/[\s_-]+/g, '')
+        .toLowerCase();
+}
+function normalizeToolRequest(value) {
+    var _a, _b, _c, _d, _e, _f;
+    const request = parseRequestObject(value);
+    const operation = operationName((_a = request.operation) !== null && _a !== void 0 ? _a : request.action);
+    const body = (_b = request.body) !== null && _b !== void 0 ? _b : request.parameters;
+    switch (operation) {
+        case 'query':
+            return { method: 'POST', path: 'query', body: normalizeQueryBody(body) };
+        case 'querydata':
+        case 'retrievedata':
+            return { method: 'POST', path: 'query/data', body: normalizeQueryBody(body) };
+        case 'inserttext':
+        case 'addtext':
+            return {
+                method: 'POST',
+                path: 'documents/text',
+                body: normalizeInsertTextBody(body),
+            };
+        case 'inserttexts':
+        case 'addtexts':
+            return {
+                method: 'POST',
+                path: 'documents/texts',
+                body: normalizeInsertTextsBody(body),
+            };
+        case 'trackstatus': {
+            const trackId = requireString((_c = request.trackId) !== null && _c !== void 0 ? _c : request.track_id, 'Track ID');
+            return {
+                method: 'GET',
+                path: `documents/track_status/${encodeURIComponent(trackId)}`,
+            };
+        }
+        case 'pipelinestatus':
+            return { method: 'GET', path: 'documents/pipeline_status' };
+        case 'listdocuments':
+            return {
+                method: 'POST',
+                path: 'documents/paginated',
+                body: (_d = parseOptionalObject(body, 'List documents body')) !== null && _d !== void 0 ? _d : {},
+            };
+        case 'scandocuments':
+        case 'scan':
+            return { method: 'POST', path: 'documents/scan', body: {} };
+        case 'deletedocuments':
+            return {
+                method: 'DELETE',
+                path: 'documents/delete_document',
+                body: normalizeDeleteDocumentsBody(body),
+            };
+        case 'health':
+            return { method: 'GET', path: 'health' };
+        case 'customrequest':
+        case 'custom':
+            return {
+                method: normalizeMethod(request.method),
+                path: normalizePath((_e = request.path) !== null && _e !== void 0 ? _e : request.resource),
+                query: parseOptionalObject((_f = request.queryParameters) !== null && _f !== void 0 ? _f : request.query, 'Query parameters'),
+                body: parseOptionalObject(body, 'Request body'),
+            };
+        default:
+            throw new n8n_workflow_1.ApplicationError('Operation must be one of: query, queryData, insertText, insertTexts, trackStatus, pipelineStatus, listDocuments, scanDocuments, deleteDocuments, health, customRequest');
+    }
+}
+async function executeLightRagRequest(executeFunctions, baseUrl, request) {
+    const options = {
+        method: request.method,
+        url: `${baseUrl}/${request.path}`,
+        json: true,
+    };
+    if (request.query !== undefined)
+        options.qs = request.query;
+    if (request.body !== undefined &&
+        request.method !== 'GET' &&
+        request.method !== 'HEAD') {
+        options.body = request.body;
+    }
+    return await executeFunctions.helpers.httpRequestWithAuthentication.call(executeFunctions, 'lightRagApi', options);
+}
+function responseToExecutionData(response, itemIndex) {
+    if (Array.isArray(response)) {
+        return response.map((item) => ({
+            json: isObject(item) ? item : { value: item },
+            pairedItem: itemIndex,
+        }));
+    }
+    return [
+        {
+            json: isObject(response) ? response : { value: response },
+            pairedItem: itemIndex,
+        },
+    ];
+}
+//# sourceMappingURL=request.js.map

package/dist/nodes/LightRagTool/request.js.map

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

package/package.json

@@ -0,0 +1,62 @@
+{
+	"name": "@catalogicus-international/n8n-nodes-light-rag",
+	"version": "0.1.0",
+	"description": "n8n workflow and AI Agent tool nodes for the LightRAG API server",
+	"license": "MIT",
+	"packageManager": "pnpm@9.15.0",
+	"homepage": "https://github.com/catalogicus-international/n8n-nodes-light-rag#readme",
+	"keywords": [
+		"lightrag",
+		"rag",
+		"ai-agent",
+		"n8n-community-node-package"
+	],
+	"author": {
+		"name": "Catalogicus International",
+		"email": "noreply@catalogicus-international.invalid"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/catalogicus-international/n8n-nodes-light-rag.git"
+	},
+	"scripts": {
+		"build": "n8n-node build",
+		"build:watch": "tsc --watch",
+		"dev": "n8n-node dev",
+		"lint": "n8n-node lint",
+		"lint:fix": "n8n-node lint --fix",
+		"test": "pnpm run build && node --test test/**/*.test.js",
+		"release": "n8n-node release",
+		"prepublishOnly": "pnpm run lint && pnpm run build"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"files": [
+		"dist/credentials",
+		"dist/icons/lightrag.svg",
+		"dist/nodes/LightRag",
+		"dist/nodes/LightRagTool"
+	],
+	"n8n": {
+		"n8nNodesApiVersion": 1,
+		"strict": true,
+		"credentials": [
+			"dist/credentials/LightRagApi.credentials.js"
+		],
+		"nodes": [
+			"dist/nodes/LightRag/LightRag.node.js",
+			"dist/nodes/LightRagTool/LightRagTool.node.js"
+		]
+	},
+	"devDependencies": {
+		"@n8n/node-cli": "*",
+		"eslint": "9.29.0",
+		"prettier": "3.8.3",
+		"release-it": "20.2.0",
+		"typescript": "5.9.3"
+	},
+	"peerDependencies": {
+		"n8n-workflow": "*"
+	}
+}