n8n-nodes-hol-agents 1.0.0

package/README.md

@@ -0,0 +1,67 @@
+# n8n-nodes-hol-agents
+
+[![npm version](https://badge.fury.io/js/n8n-nodes-hol-agents.svg)](https://badge.fury.io/js/n8n-nodes-hol-agents)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+
+n8n community node for discovering and interacting with AI agents on the [Hashgraph Online](https://hol.org) registry.
+
+## Features
+
+- **Search Agents**: Find AI agents by capability, skill, or description
+- **Get Agent Details**: Retrieve detailed information about a specific agent
+- **Find Similar Agents**: Discover agents with similar capabilities
+
+## Installation
+
+### In n8n Desktop
+1. Go to **Settings** → **Community Nodes**
+2. Search for `n8n-nodes-hol-agents`
+3. Click **Install**
+
+### In n8n Cloud/Self-hosted
+1. Go to **Settings** → **Community Nodes**
+2. Select **Install from npm**
+3. Enter: `n8n-nodes-hol-agents`
+4. Click **Install**
+
+### Manual Installation
+```bash
+cd /path/to/n8n
+npm install n8n-nodes-hol-agents
+n8n restart
+```
+
+## Usage
+
+After installation, you'll find the **HOL Agents** node in your node palette under the "Transform" category.
+
+### Search Agents
+Search for AI agents by keyword:
+- **Query**: Search terms (e.g., "trading", "image generation")
+- **Limit**: Maximum number of results (default: 10)
+
+### Get Agent
+Retrieve details for a specific agent:
+- **UAID**: Universal Agent ID (e.g., `uaid:aid:xxx`)
+
+### Find Similar Agents
+Discover agents with similar capabilities:
+- **UAID**: Universal Agent ID to find similar agents for
+
+## About HOL
+
+Hashgraph Online is the "Trust Engine for the Agentic Internet":
+- **187K+** verified AI agents
+- **33M+** HCS operations daily
+- **Cross-protocol**: A2A, MCP, NANDA, Virtuals, ERC-8004
+
+## Links
+
+- [Website](https://hol.org)
+- [Registry](https://hol.org/registry)
+- [GitHub](https://github.com/hashgraph-online)
+- [Discord](https://discord.gg/clawd)
+
+## License
+
+Apache 2.0

package/dist/credentials/HolAgentsApi.credentials.d.ts

@@ -0,0 +1,10 @@
+import { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class HolAgentsApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}
+//# sourceMappingURL=HolAgentsApi.credentials.d.ts.map

package/dist/credentials/HolAgentsApi.credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HolAgentsApi.credentials.d.ts","sourceRoot":"","sources":["../../credentials/HolAgentsApi.credentials.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,MAAM,cAAc,CAAC;AAEtB,qBAAa,YAAa,YAAW,eAAe;IACnD,IAAI,SAAkB;IACtB,WAAW,SAAoB;IAC/B,gBAAgB,SAA0B;IAC1C,UAAU,EAAE,eAAe,EAAE,CAW3B;IAEF,YAAY,EAAE,oBAAoB,CAOhC;IAEF,IAAI,EAAE,sBAAsB,CAK1B;CACF"}

package/dist/credentials/HolAgentsApi.credentials.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HolAgentsApi = void 0;
+class HolAgentsApi {
+    name = 'holAgentsApi';
+    displayName = 'HOL Agents API';
+    documentationUrl = 'https://hol.org/docs';
+    properties = [
+        {
+            displayName: 'API Key',
+            name: 'apiKey',
+            type: 'string',
+            typeOptions: {
+                password: true,
+            },
+            default: '',
+            description: 'Optional HOL Registry API key for higher rate limits. Leave empty for public access.',
+        },
+    ];
+    authenticate = {
+        type: 'generic',
+        properties: {
+            headers: {
+                Authorization: '=Bearer {{$credentials.apiKey}}',
+            },
+        },
+    };
+    test = {
+        request: {
+            baseURL: 'https://hol.org/registry/api/v1',
+            url: '/search?limit=1',
+        },
+    };
+}
+exports.HolAgentsApi = HolAgentsApi;
+//# sourceMappingURL=HolAgentsApi.credentials.js.map

package/dist/credentials/HolAgentsApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HolAgentsApi.credentials.js","sourceRoot":"","sources":["../../credentials/HolAgentsApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,YAAY;IACxB,IAAI,GAAG,cAAc,CAAC;IACtB,WAAW,GAAG,gBAAgB,CAAC;IAC/B,gBAAgB,GAAG,sBAAsB,CAAC;IAC1C,UAAU,GAAsB;QAC/B;YACC,WAAW,EAAE,SAAS;YACtB,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE;gBACZ,QAAQ,EAAE,IAAI;aACd;YACD,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,sFAAsF;SACnG;KACD,CAAC;IAEF,YAAY,GAAyB;QACpC,IAAI,EAAE,SAAS;QACf,UAAU,EAAE;YACX,OAAO,EAAE;gBACR,aAAa,EAAE,iCAAiC;aAChD;SACD;KACD,CAAC;IAEF,IAAI,GAA2B;QAC9B,OAAO,EAAE;YACR,OAAO,EAAE,iCAAiC;YAC1C,GAAG,EAAE,iBAAiB;SACtB;KACD,CAAC;CACF;AAhCD,oCAgCC"}

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

@@ -0,0 +1,6 @@
+import { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class HolAgents implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}
+//# sourceMappingURL=HolAgents.node.d.ts.map

package/dist/nodes/HolAgents/HolAgents.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HolAgents.node.d.ts","sourceRoot":"","sources":["../../../nodes/HolAgents/HolAgents.node.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,oBAAoB,EAEpB,MAAM,cAAc,CAAC;AAEtB,qBAAa,SAAU,YAAW,SAAS;IAC1C,WAAW,EAAE,oBAAoB,CAyF/B;IAEI,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;CAqEvE"}

package/dist/nodes/HolAgents/HolAgents.node.js

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HolAgents = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+class HolAgents {
+    description = {
+        displayName: 'HOL Agents',
+        name: 'holAgents',
+        icon: 'file:hol-agents.svg',
+        group: ['transform'],
+        version: 1,
+        subtitle: '={{$parameter["operation"]}}',
+        description: 'Discover and interact with AI agents on the Hashgraph Online registry',
+        defaults: {
+            name: 'HOL Agents',
+        },
+        usableAsTool: true,
+        inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+        outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+        credentials: [
+            {
+                name: 'holAgentsApi',
+                required: false,
+            },
+        ],
+        properties: [
+            {
+                displayName: 'Operation',
+                name: 'operation',
+                type: 'options',
+                noDataExpression: true,
+                options: [
+                    {
+                        name: 'Search Agents',
+                        value: 'search',
+                        description: 'Search for AI agents by query',
+                        action: 'Search for agents',
+                    },
+                    {
+                        name: 'Get Agent',
+                        value: 'get',
+                        description: 'Get detailed information about a specific agent',
+                        action: 'Get agent details',
+                    },
+                    {
+                        name: 'Find Similar Agents',
+                        value: 'similar',
+                        description: 'Find agents similar to a given agent',
+                        action: 'Find similar agents',
+                    },
+                ],
+                default: 'search',
+            },
+            // Search parameters
+            {
+                displayName: 'Query',
+                name: 'query',
+                type: 'string',
+                default: '',
+                required: true,
+                displayOptions: {
+                    show: {
+                        operation: ['search'],
+                    },
+                },
+                description: 'Search query to find agents',
+            },
+            {
+                displayName: 'Limit',
+                name: 'limit',
+                type: 'number',
+                default: 10,
+                displayOptions: {
+                    show: {
+                        operation: ['search'],
+                    },
+                },
+                description: 'Maximum number of results to return',
+            },
+            // UAID for get/similar
+            {
+                displayName: 'Agent UAID',
+                name: 'uaid',
+                type: 'string',
+                default: '',
+                required: true,
+                displayOptions: {
+                    show: {
+                        operation: ['get', 'similar'],
+                    },
+                },
+                description: 'The Universal Agent ID (with or without uaid: prefix)',
+            },
+        ],
+    };
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const operation = this.getNodeParameter('operation', 0);
+        const baseUrl = 'https://hol.org/registry/api/v1';
+        // Get optional API key from credentials
+        let apiKey = '';
+        try {
+            const credentials = await this.getCredentials('holAgentsApi');
+            apiKey = credentials.apiKey || '';
+        }
+        catch {
+            // Credentials are optional
+        }
+        for (let i = 0; i < items.length; i++) {
+            let url = '';
+            switch (operation) {
+                case 'search': {
+                    const query = this.getNodeParameter('query', i);
+                    const limit = this.getNodeParameter('limit', i);
+                    url = `${baseUrl}/search?q=${encodeURIComponent(query)}&limit=${limit}`;
+                    break;
+                }
+                case 'get': {
+                    let uaid = this.getNodeParameter('uaid', i);
+                    if (!uaid.startsWith('uaid:')) {
+                        uaid = `uaid:${uaid}`;
+                    }
+                    url = `${baseUrl}/agents/${encodeURIComponent(uaid)}`;
+                    break;
+                }
+                case 'similar': {
+                    let uaid = this.getNodeParameter('uaid', i);
+                    if (!uaid.startsWith('uaid:')) {
+                        uaid = `uaid:${uaid}`;
+                    }
+                    url = `${baseUrl}/agents/${encodeURIComponent(uaid)}/similar`;
+                    break;
+                }
+            }
+            const headers = {
+                'Accept': 'application/json',
+                'Content-Type': 'application/json',
+                'User-Agent': 'HOL-n8n-Node/1.0',
+            };
+            if (apiKey) {
+                headers['Authorization'] = `Bearer ${apiKey}`;
+            }
+            const response = await this.helpers.httpRequest({
+                method: 'GET',
+                url,
+                headers,
+                json: true,
+            });
+            returnData.push({
+                json: response,
+                pairedItem: { item: i },
+            });
+        }
+        return [returnData];
+    }
+}
+exports.HolAgents = HolAgents;
+//# sourceMappingURL=HolAgents.node.js.map

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

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

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "n8n-nodes-hol-agents",
+  "version": "1.0.0",
+  "description": "n8n node for discovering and interacting with AI agents on the Hashgraph Online registry",
+  "keywords": [
+    "n8n",
+    "n8n-node",
+    "n8n-community-node-package",
+    "hol",
+    "hashgraph",
+    "ai-agents",
+    "agent-discovery",
+    "hedera",
+    "a2a",
+    "mcp"
+  ],
+  "license": "Apache-2.0",
+  "homepage": "https://hol.org",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/internet-dot/n8n-nodes-hol-agents.git"
+  },
+  "bugs": {
+    "url": "https://github.com/internet-dot/n8n-nodes-hol-agents/issues"
+  },
+  "author": {
+    "name": "Hashgraph Online",
+    "email": "support@hol.org",
+    "url": "https://hol.org"
+  },
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "lint": "eslint nodes credentials --ext .ts",
+    "lintfix": "eslint nodes credentials --ext .ts --fix",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/HolAgentsApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/HolAgents/HolAgents.node.js"
+    ]
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "n8n-workflow": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}