n8n-nodes-cala 0.3.3 → 0.4.1

package/README.md

@@ -26,13 +26,22 @@ You need a Cala API key to use this node:
 3. In n8n, create new credentials of type **Cala API**
 4. Enter your API key
 
-## Endpoint
+## Operations
 
-The node provides access to the **Knowledge Search** endpoint, which searches trusted knowledge using natural language queries.
+The node exposes a **Knowledge** resource with four operations:
 
-### Example
+| Operation | Description |
+|-----------|-------------|
+| **Search** | Answer natural language questions with sourced, researched content |
+| **Query** | Filter entities by attributes using structured dot-notation syntax |
+| **Search Entities** | Find entities by name with fuzzy matching |
+| **Get Entity** | Get the full profile of an entity by its numeric ID |
 
-**Input:** "How many students were enrolled at MIT in 2024?"
+### Search
+
+Ask a natural language question and get back a researched answer with sources.
+
+**Input:** `"How many students were enrolled at MIT in 2024?"`
 
 **Output:**
 ```json
@@ -47,7 +56,7 @@ The node provides access to the **Knowledge Search** endpoint, which searches tr
   "context": [
     {
       "id": "a1b2c3d4-5678-90ab-cdef-123456789abc",
-      "content": "In 2024, the Massachusetts Institute of Technology enrolled approximately 11,800 students: 4,600 undergraduates and 7,200 graduate students.",
+      "content": "In 2024, the Massachusetts Institute of Technology enrolled approximately 11,800 students.",
       "origins": [
         {
           "source": { "name": "MIT", "url": "https://mit.edu" },
@@ -57,12 +66,27 @@ The node provides access to the **Knowledge Search** endpoint, which searches tr
     }
   ],
   "entities": [
-    { "id": 1, "name": "MIT", "entity_type": "ORGANIZATION" },
-    { "id": 2, "name": "Massachusetts Institute of Technology", "entity_type": "ORGANIZATION" }
+    { "id": 1, "name": "MIT", "entity_type": "ORGANIZATION" }
   ]
 }
 ```
 
+### Query
+
+Filter entities by attributes using dot-notation syntax.
+
+**Input:** `"startups.location=Spain.funding>10M.funding<=50M"`
+
+### Search Entities
+
+Find entities by name (supports fuzzy matching). Returns a list of matches with IDs.
+
+**Input:** `"OpenAI"` → returns entity IDs you can pass to **Get Entity**.
+
+### Get Entity
+
+Get the full profile of an entity by its numeric ID (from Search or Search Entities results).
+
 ## Resources
 
 - [Cala Documentation](https://docs.cala.ai)

package/dist/credentials/CalaApi.credentials.d.ts

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

package/dist/credentials/CalaApi.credentials.js

@@ -19,19 +19,14 @@ class CalaApi {
                 description: 'Your Cala API key',
             },
         ];
-        this.authenticate = {
-            type: 'generic',
-            properties: {
-                headers: {
-                    'X-API-KEY': '={{$credentials.apiKey}}',
-                },
-            },
-        };
         this.test = {
             request: {
                 baseURL: 'https://api.cala.ai',
                 url: '/v1/knowledge/search',
                 method: 'POST',
+                headers: {
+                    'X-API-KEY': '={{$credentials.apiKey}}',
+                },
                 body: {
                     input: 'test',
                 },

package/dist/nodes/Cala/Cala.node.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Cala = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const BASE_URL = 'https://api.cala.ai';
 class Cala {
     constructor() {
         this.description = {
@@ -9,7 +11,7 @@ class Cala {
             icon: 'file:cala.svg',
             group: ['transform'],
             version: 1,
-            subtitle: 'Knowledge Search',
+            subtitle: '={{$parameter["operation"]}}',
             description: 'Search trusted knowledge with Cala AI',
             defaults: {
                 name: 'Cala',
@@ -23,14 +25,118 @@ class Cala {
                 },
             ],
             properties: [
+                // ── Resource ────────────────────────────────────────────────────────
+                {
+                    displayName: 'Resource',
+                    name: 'resource',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'Knowledge',
+                            value: 'knowledge',
+                        },
+                    ],
+                    default: 'knowledge',
+                },
+                // ── Operations ──────────────────────────────────────────────────────
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: {
+                        show: { resource: ['knowledge'] },
+                    },
+                    options: [
+                        {
+                            name: 'Search',
+                            value: 'search',
+                            action: 'Search knowledge',
+                            description: 'Answer natural language questions with sourced, researched content',
+                        },
+                        {
+                            name: 'Query',
+                            value: 'query',
+                            action: 'Query knowledge',
+                            description: 'Filter entities by attributes using structured dot-notation syntax',
+                        },
+                        {
+                            name: 'Search Entities',
+                            value: 'searchEntities',
+                            action: 'Search entities',
+                            description: 'Find entities by name with fuzzy matching',
+                        },
+                        {
+                            name: 'Get Entity',
+                            value: 'getEntity',
+                            action: 'Get an entity',
+                            description: 'Get the full profile of an entity by its numeric ID',
+                        },
+                    ],
+                    default: 'search',
+                },
+                // ── Knowledge › Search ──────────────────────────────────────────────
                 {
                     displayName: 'Query',
                     name: 'query',
                     type: 'string',
                     required: true,
                     default: '',
-                    placeholder: "i.e. What were Toyota's total sales in 2023?",
-                    description: 'The search query to find knowledge',
+                    placeholder: "e.g. What were Toyota's total sales in 2023?",
+                    description: 'Natural language question to search knowledge for',
+                    displayOptions: {
+                        show: { resource: ['knowledge'], operation: ['search'] },
+                    },
+                },
+                // ── Knowledge › Query ───────────────────────────────────────────────
+                {
+                    displayName: 'Query',
+                    name: 'query',
+                    type: 'string',
+                    required: true,
+                    default: '',
+                    placeholder: 'e.g. startups.location=Spain.funding>10M',
+                    description: 'Structured dot-notation query to filter entities by attributes',
+                    displayOptions: {
+                        show: { resource: ['knowledge'], operation: ['query'] },
+                    },
+                },
+                // ── Knowledge › Search Entities ─────────────────────────────────────
+                {
+                    displayName: 'Name',
+                    name: 'name',
+                    type: 'string',
+                    required: true,
+                    default: '',
+                    placeholder: 'e.g. OpenAI',
+                    description: 'Entity name to search for (supports fuzzy matching)',
+                    displayOptions: {
+                        show: { resource: ['knowledge'], operation: ['searchEntities'] },
+                    },
+                },
+                {
+                    displayName: 'Limit',
+                    name: 'limit',
+                    type: 'number',
+                    default: 20,
+                    description: 'Maximum number of results to return',
+                    typeOptions: { minValue: 1, maxValue: 100 },
+                    displayOptions: {
+                        show: { resource: ['knowledge'], operation: ['searchEntities'] },
+                    },
+                },
+                // ── Knowledge › Get Entity ──────────────────────────────────────────
+                {
+                    displayName: 'Entity ID',
+                    name: 'entityId',
+                    type: 'number',
+                    required: true,
+                    default: 0,
+                    description: 'The numeric ID of the entity to retrieve',
+                    displayOptions: {
+                        show: { resource: ['knowledge'], operation: ['getEntity'] },
+                    },
                 },
             ],
         };
@@ -40,23 +146,62 @@ class Cala {
         const returnData = [];
         const credentials = await this.getCredentials('calaApi');
         const apiKey = credentials.apiKey;
+        const headers = { 'Content-Type': 'application/json' };
+        if (apiKey) {
+            headers['X-API-KEY'] = apiKey;
+        }
+        const resource = this.getNodeParameter('resource', 0);
+        const operation = this.getNodeParameter('operation', 0);
         for (let i = 0; i < items.length; i++) {
-            const query = this.getNodeParameter('query', i);
-            const headers = {
-                'Content-Type': 'application/json',
-            };
-            if (apiKey) {
-                headers['X-API-KEY'] = apiKey;
+            let response;
+            if (resource === 'knowledge') {
+                if (operation === 'search') {
+                    const query = this.getNodeParameter('query', i);
+                    response = await this.helpers.httpRequest({
+                        method: 'POST',
+                        url: `${BASE_URL}/v1/knowledge/search`,
+                        headers,
+                        body: { input: query },
+                        json: true,
+                    });
+                }
+                else if (operation === 'query') {
+                    const query = this.getNodeParameter('query', i);
+                    response = await this.helpers.httpRequest({
+                        method: 'POST',
+                        url: `${BASE_URL}/v1/knowledge/query`,
+                        headers,
+                        body: { input: query },
+                        json: true,
+                    });
+                }
+                else if (operation === 'searchEntities') {
+                    const name = this.getNodeParameter('name', i);
+                    const limit = this.getNodeParameter('limit', i);
+                    response = await this.helpers.httpRequest({
+                        method: 'GET',
+                        url: `${BASE_URL}/v1/knowledge/entities`,
+                        headers,
+                        qs: { name, limit },
+                        json: true,
+                    });
+                }
+                else if (operation === 'getEntity') {
+                    const entityId = this.getNodeParameter('entityId', i);
+                    response = await this.helpers.httpRequest({
+                        method: 'GET',
+                        url: `${BASE_URL}/v1/knowledge/entities/${entityId}`,
+                        headers,
+                        json: true,
+                    });
+                }
+                else {
+                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Unknown operation: ${operation}`);
+                }
+            }
+            else {
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Unknown resource: ${resource}`);
             }
-            const response = await this.helpers.httpRequest({
-                method: 'POST',
-                url: 'https://api.cala.ai/v1/knowledge/search',
-                headers,
-                body: {
-                    input: query,
-                },
-                json: true,
-            });
             returnData.push({
                 json: response,
                 pairedItem: { item: i },

package/dist/nodes/Cala/Cala.node.json

@@ -0,0 +1,16 @@
+{
+  "node": "n8n-nodes-cala.cala",
+  "nodeVersion": "1.0",
+  "codexVersion": "1.0",
+  "categories": ["AI", "Data & Storage"],
+  "subcategories": {
+    "AI": ["Tools"]
+  },
+  "resources": {
+    "primaryDocumentation": [
+      {
+        "url": "https://docs.cala.ai"
+      }
+    ]
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-cala",
-  "version": "0.3.3",
+  "version": "0.4.1",
   "description": "n8n nodes for Cala AI knowledge search",
   "keywords": [
     "n8n-community-node-package",
@@ -49,10 +49,10 @@
     "typescript-eslint": "^8.53.1"
   },
   "peerDependencies": {
-    "n8n-workflow": "*"
+    "n8n-workflow": ">=1.0.0"
   },
   "engines": {
-    "node": ">=22",
+    "node": ">=18",
     "pnpm": ">=10"
   },
   "volta": {