@ctera/n8n-nodes-ctera-ai 0.1.2 → 0.4.0

package/LICENSE

@@ -1,24 +1,24 @@
-MIT License
-
-Copyright (c) 2025 CTERA Networks
-
-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.
-
-
-
+MIT License
+
+Copyright (c) 2025 CTERA Networks
+
+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

@@ -1,58 +1,68 @@
-# n8n-nodes-ctera-ai
-
-n8n community node for CTERA AI MCP integration - enables semantic search, chat, and expert discovery.
-
-[n8n](https://n8n.io/) is a workflow automation platform.
-
-## Installation
-
-```bash
-cd ~/.n8n/nodes
-npm install @ctera/n8n-nodes-ctera-ai
-```
-
-Then restart n8n. The **CTERA Data Intelligence** node will appear in your node list.
-
-## Operations
-
-- **List Experts** - Get all available AI experts (knowledge bases)
-- **Semantic Search** - Search within an expert's knowledge base
-- **Chat** - Have a conversation with an AI expert
-
-## Credentials
-
-**1. Log into Admin UI** with your SSO credentials
-
-**2. Generate MCP Bearer Token:**
-
-Navigate to the MCP Tokens section in Admin UI, or use the API:
-
-```bash
-curl -k -X POST "https://YOUR_ADMIN_URL/admin/api/mcp-tokens/generate" \
-  -H "Cookie: connect.sid=YOUR_SESSION_COOKIE" \
-  -H "Content-Type: application/json" \
-  -d '{"days": 30}' | jq -r .token
-```
-
-**3. Configure in n8n:**
-
-- **MCP Server URL**: `https://mcp.your-domain.com`
-- **Bearer Token**: Paste the token from step 2
-- **Ignore SSL Issues**: Enable for self-signed certificates
-
-## Example Use Cases
-
-- **Daily Intelligence Reports** - Schedule searches across experts for recent updates
-- **Q&A Chatbots** - Build webhook-based chatbots using the Chat operation
-- **Document Discovery** - Monitor for new content and send notifications
-
-## Resources
-
-- [n8n Community Nodes](https://docs.n8n.io/integrations/community-nodes/)
-- [GitHub Issues](https://github.com/ctera/ctera-n8n-nodes/issues)
-
-## License
-
-[MIT](LICENSE) - See [PUBLISH.md](PUBLISH.md) for publishing guidelines.
-
-
+# n8n-nodes-ctera
+
+n8n community nodes for CTERA integration - filesystem operations and AI-powered data intelligence.
+
+## Installation
+
+```bash
+cd ~/.n8n/nodes
+npm install @ctera/n8n-nodes-ctera
+```
+
+Restart n8n after installation.
+
+## Nodes
+
+### CTERA Filesystem
+
+Perform storage operations on CTERA Portal via MCP:
+- **File**: Read, write, copy, move, rename, delete
+- **Directory**: List, create, delete, walk, recover
+- **Links**: Public sharing links and permalinks
+- **Versions**: File version history
+
+Supports OAuth2 (Entra ID / Azure AD) authentication.
+
+**[Detailed Documentation →](nodes/CteraFilesystem/README.md)**
+
+### CTERA Data Intelligence
+
+Interact with CTERA AI experts for semantic search and knowledge retrieval:
+- **List Experts**: Discover available knowledge bases
+- **Semantic Search**: Retrieve text chunks for RAG workflows
+- **File Search**: Search files with metadata filters
+- **Chat**: Get AI-generated answers
+
+**[Detailed Documentation →](nodes/CteraAi/README.md)**
+
+## Credentials
+
+| Credential | Used By | Description |
+|------------|---------|-------------|
+| CTERA Portal OAuth2 API | Filesystem | Entra ID / Azure AD SSO authentication |
+| CTERA AI MCP API | Data Intelligence | MCP bearer token authentication |
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Link for local development
+npm link
+cd ~/.n8n/nodes && npm link @ctera/n8n-nodes-ctera
+```
+
+## Publishing
+
+See [PUBLISH.md](PUBLISH.md) for npm publishing guidelines.
+
+## License
+
+[MIT](LICENSE)

package/dist/credentials/CteraFilesystemApi.credentials.d.ts

@@ -0,0 +1,7 @@
+import { ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class CteraFilesystemApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+}

package/dist/credentials/CteraFilesystemApi.credentials.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CteraFilesystemApi = void 0;
+class CteraFilesystemApi {
+    constructor() {
+        this.name = 'cteraFilesystemApi';
+        this.displayName = 'CTERA Filesystem API';
+        this.documentationUrl = 'https://github.com/ctera/ctera-n8n-nodes#readme';
+        this.properties = [
+            {
+                displayName: 'MCP Server URL',
+                name: 'serverUrl',
+                type: 'string',
+                default: '',
+                required: true,
+                placeholder: 'https://mcp.your-domain.com',
+                description: 'The base URL of your CTERA MCP server (e.g., https://mcp.example.com)',
+            },
+            {
+                displayName: 'Bearer Token (JWT)',
+                name: 'bearerToken',
+                type: 'string',
+                typeOptions: {
+                    password: true,
+                },
+                default: '',
+                required: true,
+                description: 'Portal JWT token for authentication. Generate via Portal Settings → API Tokens, or using: curl -k "https://<portal>/api/tokens/generate?oid=<oid>&email=<email>"',
+            },
+            {
+                displayName: 'Ignore SSL Issues',
+                name: 'allowUnauthorizedCerts',
+                type: 'boolean',
+                default: false,
+                description: 'Whether to connect even if SSL certificate validation fails (use for self-signed certificates)',
+            },
+        ];
+    }
+}
+exports.CteraFilesystemApi = CteraFilesystemApi;

package/dist/credentials/CteraPortalOAuth2Api.credentials.d.ts

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

package/dist/credentials/CteraPortalOAuth2Api.credentials.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CteraPortalOAuth2Api = void 0;
+class CteraPortalOAuth2Api {
+    constructor() {
+        this.name = 'cteraPortalOAuth2Api';
+        this.extends = ['oAuth2Api'];
+        this.displayName = 'CTERA Portal OAuth2 API';
+        this.documentationUrl = 'https://github.com/ctera/ctera-n8n-nodes#oauth2-setup';
+        this.properties = [
+            {
+                displayName: 'Portal URL',
+                name: 'portalUrl',
+                type: 'string',
+                default: '',
+                required: true,
+                placeholder: 'https://your-portal.ctera.com',
+                description: 'Base URL of your CTERA Portal',
+            },
+            {
+                displayName: 'Grant Type',
+                name: 'grantType',
+                type: 'hidden',
+                default: 'authorizationCode',
+            },
+            {
+                displayName: 'Authorization URL',
+                name: 'authUrl',
+                type: 'string',
+                default: '',
+                required: true,
+                placeholder: 'https://login.microsoftonline.com/YOUR-TENANT-ID/oauth2/v2.0/authorize',
+                description: 'Azure AD authorization endpoint. Replace YOUR-TENANT-ID with your Azure tenant ID',
+            },
+            {
+                displayName: 'Access Token URL',
+                name: 'accessTokenUrl',
+                type: 'string',
+                default: '',
+                required: true,
+                placeholder: 'https://login.microsoftonline.com/YOUR-TENANT-ID/oauth2/v2.0/token',
+                description: 'Azure AD token endpoint. Replace YOUR-TENANT-ID with your Azure tenant ID',
+            },
+            {
+                displayName: 'API Scope',
+                name: 'apiScope',
+                type: 'string',
+                default: '',
+                required: true,
+                placeholder: 'api://YOUR-CLIENT-ID/access',
+                description: 'Your Azure AD API scope (e.g., api://client-id/access or api://client-id/claudeai). This is required for v2.0 tokens.',
+            },
+            {
+                displayName: 'Scope',
+                name: 'scope',
+                type: 'hidden',
+                default: '={{$self.apiScope}} openid profile offline_access',
+            },
+            {
+                displayName: 'Auth URI Query Parameters',
+                name: 'authQueryParameters',
+                type: 'hidden',
+                default: '',
+            },
+            {
+                displayName: 'Authentication',
+                name: 'authentication',
+                type: 'hidden',
+                default: 'body',
+            },
+            {
+                displayName: 'Ignore SSL Issues',
+                name: 'allowUnauthorizedCerts',
+                type: 'boolean',
+                default: false,
+                description: 'Whether to connect even if SSL certificate validation fails (use for self-signed certificates)',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.oauthTokenData.access_token}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.portalUrl}}/_SRV/MCP',
+                url: '/mcp',
+                method: 'POST',
+                body: {
+                    jsonrpc: '2.0',
+                    method: 'tools/call',
+                    params: {
+                        name: 'ctera_portal_who_am_i',
+                        arguments: {},
+                    },
+                    id: 1,
+                },
+                skipSslCertificateValidation: '={{$credentials.allowUnauthorizedCerts}}',
+            },
+        };
+    }
+}
+exports.CteraPortalOAuth2Api = CteraPortalOAuth2Api;

package/dist/nodes/CteraAi/CteraAi.node.js

@@ -53,6 +53,11 @@ class CteraAi {
                             value: 'search',
                             description: 'Retrieve raw text chunks for Retrieval-Augmented Generation',
                         },
+                        {
+                            name: 'File Search (Files & Metadata)',
+                            value: 'fileSearch',
+                            description: 'Search files and return metadata with optional snippets',
+                        },
                         {
                             name: 'Chat (Generative Answer)',
                             value: 'chat',
@@ -130,6 +135,80 @@ class CteraAi {
                         },
                     ],
                 },
+                {
+                    displayName: 'File Search Options',
+                    name: 'fileSearchOptions',
+                    type: 'collection',
+                    placeholder: 'Add Option',
+                    default: {},
+                    displayOptions: {
+                        show: {
+                            operation: ['fileSearch'],
+                        },
+                    },
+                    options: [
+                        {
+                            displayName: 'Limit',
+                            name: 'limit',
+                            type: 'number',
+                            default: 100,
+                            description: 'Maximum number of results to return',
+                            typeOptions: {
+                                minValue: 1,
+                                maxValue: 250,
+                            },
+                        },
+                        {
+                            displayName: 'Offset',
+                            name: 'offset',
+                            type: 'number',
+                            default: 0,
+                            description: 'Pagination offset',
+                            typeOptions: {
+                                minValue: 0,
+                            },
+                        },
+                        {
+                            displayName: 'Sort By',
+                            name: 'sort_by',
+                            type: 'options',
+                            options: [
+                                {
+                                    name: 'Relevance',
+                                    value: 'relevance',
+                                },
+                                {
+                                    name: 'Modified Date',
+                                    value: 'modified_at',
+                                },
+                                {
+                                    name: 'Created Date',
+                                    value: 'created_at',
+                                },
+                                {
+                                    name: 'Name',
+                                    value: 'name',
+                                },
+                            ],
+                            default: 'relevance',
+                            description: 'Sort order for results',
+                        },
+                        {
+                            displayName: 'Include Snippet',
+                            name: 'include_snippet',
+                            type: 'boolean',
+                            default: false,
+                            description: 'Whether to return text snippet per file',
+                        },
+                        {
+                            displayName: 'Include Markdown',
+                            name: 'include_markdown',
+                            type: 'boolean',
+                            default: false,
+                            description: 'Whether to return full markdown body per file',
+                        },
+                    ],
+                },
             ],
         };
     }
@@ -170,6 +249,28 @@ class CteraAi {
                         params.window_size = additionalOptions.window_size;
                     }
                 }
+                else if (operation === 'fileSearch') {
+                    toolName = 'expert_file_search';
+                    serverUrl = this.getNodeParameter('expertEndpointUrl', i);
+                    const query = this.getNodeParameter('query', i);
+                    const fileSearchOptions = this.getNodeParameter('fileSearchOptions', i, {});
+                    params.query = query;
+                    if (fileSearchOptions.limit !== undefined) {
+                        params.limit = fileSearchOptions.limit;
+                    }
+                    if (fileSearchOptions.offset !== undefined) {
+                        params.offset = fileSearchOptions.offset;
+                    }
+                    if (fileSearchOptions.sort_by) {
+                        params.sort_by = fileSearchOptions.sort_by;
+                    }
+                    if (fileSearchOptions.include_snippet !== undefined) {
+                        params.include_snippet = fileSearchOptions.include_snippet;
+                    }
+                    if (fileSearchOptions.include_markdown !== undefined) {
+                        params.include_markdown = fileSearchOptions.include_markdown;
+                    }
+                }
                 else if (operation === 'chat') {
                     toolName = 'expert_chat';
                     serverUrl = this.getNodeParameter('expertEndpointUrl', i);
@@ -230,15 +331,69 @@ class CteraAi {
                 else {
                     result = parsedResponse.result;
                 }
-                returnData.push({
-                    json: {
-                        ...items[i].json,
-                        operation,
-                        toolName,
-                        result,
-                    },
-                    pairedItem: { item: i },
-                });
+                // Handle fileSearch with fan-out pattern - each hit becomes a separate item
+                if (operation === 'fileSearch' && result && result.hits && Array.isArray(result.hits)) {
+                    // Map snake_case to camelCase for n8n conventions
+                    for (const hit of result.hits) {
+                        returnData.push({
+                            json: {
+                                ...items[i].json,
+                                operation,
+                                toolName,
+                                // Map to camelCase field names
+                                fileId: hit.id,
+                                name: hit.name,
+                                path: hit.path,
+                                sizeBytes: hit.size_bytes,
+                                mimeType: hit.mime_type,
+                                createdAt: hit.created_at,
+                                modifiedAt: hit.modified_at,
+                                storageSystem: hit.storage_system,
+                                bucketOrShare: hit.bucket_or_share,
+                                score: hit.score,
+                                standardMetadata: hit.standard_metadata,
+                                customMetadata: hit.custom_metadata,
+                                snippet: hit.snippet,
+                                markdownBody: hit.markdown_body,
+                                // Include pagination info from response
+                                _meta: {
+                                    total: result.total,
+                                    limit: result.limit,
+                                    offset: result.offset,
+                                },
+                            },
+                            pairedItem: { item: i },
+                        });
+                    }
+                    // If no hits, still return an item indicating empty results
+                    if (result.hits.length === 0) {
+                        returnData.push({
+                            json: {
+                                ...items[i].json,
+                                operation,
+                                toolName,
+                                result: [],
+                                _meta: {
+                                    total: result.total || 0,
+                                    limit: result.limit || 0,
+                                    offset: result.offset || 0,
+                                },
+                            },
+                            pairedItem: { item: i },
+                        });
+                    }
+                }
+                else {
+                    returnData.push({
+                        json: {
+                            ...items[i].json,
+                            operation,
+                            toolName,
+                            result,
+                        },
+                        pairedItem: { item: i },
+                    });
+                }
             }
             catch (error) {
                 if (this.continueOnFail()) {

package/dist/nodes/CteraAi/ctera.svg

@@ -1,13 +1,13 @@
-<svg viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
-    <g clip-path="url(#ub91fxv4ea)" transform="scale(1.15) translate(-1.8, -1.8)">
-        <path d="M20 0H4a4 4 0 0 0-4 4v16a4 4 0 0 0 4 4h16a4 4 0 0 0 4-4V4a4 4 0 0 0-4-4z" fill="#4F5CE5"/>
-        <path d="M20.373 15.297a8.941 8.941 0 0 1-2.01 3.066A8.98 8.98 0 0 1 12 21a8.883 8.883 0 0 1-3.297-.627 8.942 8.942 0 0 1-3.066-2.01A8.981 8.981 0 0 1 3 12c0-1.163.22-2.277.627-3.297a8.943 8.943 0 0 1 2.01-3.066A8.982 8.982 0 0 1 12 3c1.163 0 2.277.22 3.297.627a8.943 8.943 0 0 1 3.066 2.01l-1.65 1.65A6.668 6.668 0 0 0 12 5.333a6.663 6.663 0 0 0-4.713 1.953A6.668 6.668 0 0 0 5.333 12a6.664 6.664 0 0 0 1.953 4.713A6.668 6.668 0 0 0 12 18.667a6.662 6.662 0 0 0 4.713-1.953 6.667 6.667 0 0 0 1.49-2.27l2.17.853z" fill="#fff" stroke="#4F5CE5" stroke-width=".667" stroke-miterlimit="10"/>
-        <path d="M18.203 14.443a6.668 6.668 0 0 1-3.543 3.67 6.608 6.608 0 0 1-2.66.554 6.669 6.669 0 0 1-6.113-4.007A6.607 6.607 0 0 1 5.333 12 6.668 6.668 0 0 1 9.34 5.887 6.607 6.607 0 0 1 12 5.333a6.667 6.667 0 0 1 4.713 1.953L14.71 9.29A3.818 3.818 0 0 0 12 8.167c-.543 0-1.06.113-1.53.316A3.85 3.85 0 0 0 8.167 12c0 .543.113 1.06.316 1.53a3.847 3.847 0 0 0 5.047 1.987 3.848 3.848 0 0 0 2.037-2.114l2.636 1.04z" fill="#fff" stroke="#4F5CE5" stroke-width=".667" stroke-miterlimit="10"/>
-        <path d="M13.874 12c0 .13-.08.247-.204.292l-1.006.372-.37 1.007a.31.31 0 0 1-.584 0l-.373-1.007-1.007-.371a.31.31 0 0 1 0-.583l1.007-.373.37-1.008a.31.31 0 0 1 .584 0l.373 1.008 1.007.37a.308.308 0 0 1 .203.293z" fill="#fff"/>
-    </g>
-    <defs>
-        <clipPath id="ub91fxv4ea">
-            <path fill="#fff" d="M0 0h24v24H0z"/>
-        </clipPath>
-    </defs>
-</svg>
+<svg viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+    <g clip-path="url(#ub91fxv4ea)" transform="scale(1.15) translate(-1.8, -1.8)">
+        <path d="M20 0H4a4 4 0 0 0-4 4v16a4 4 0 0 0 4 4h16a4 4 0 0 0 4-4V4a4 4 0 0 0-4-4z" fill="#4F5CE5"/>
+        <path d="M20.373 15.297a8.941 8.941 0 0 1-2.01 3.066A8.98 8.98 0 0 1 12 21a8.883 8.883 0 0 1-3.297-.627 8.942 8.942 0 0 1-3.066-2.01A8.981 8.981 0 0 1 3 12c0-1.163.22-2.277.627-3.297a8.943 8.943 0 0 1 2.01-3.066A8.982 8.982 0 0 1 12 3c1.163 0 2.277.22 3.297.627a8.943 8.943 0 0 1 3.066 2.01l-1.65 1.65A6.668 6.668 0 0 0 12 5.333a6.663 6.663 0 0 0-4.713 1.953A6.668 6.668 0 0 0 5.333 12a6.664 6.664 0 0 0 1.953 4.713A6.668 6.668 0 0 0 12 18.667a6.662 6.662 0 0 0 4.713-1.953 6.667 6.667 0 0 0 1.49-2.27l2.17.853z" fill="#fff" stroke="#4F5CE5" stroke-width=".667" stroke-miterlimit="10"/>
+        <path d="M18.203 14.443a6.668 6.668 0 0 1-3.543 3.67 6.608 6.608 0 0 1-2.66.554 6.669 6.669 0 0 1-6.113-4.007A6.607 6.607 0 0 1 5.333 12 6.668 6.668 0 0 1 9.34 5.887 6.607 6.607 0 0 1 12 5.333a6.667 6.667 0 0 1 4.713 1.953L14.71 9.29A3.818 3.818 0 0 0 12 8.167c-.543 0-1.06.113-1.53.316A3.85 3.85 0 0 0 8.167 12c0 .543.113 1.06.316 1.53a3.847 3.847 0 0 0 5.047 1.987 3.848 3.848 0 0 0 2.037-2.114l2.636 1.04z" fill="#fff" stroke="#4F5CE5" stroke-width=".667" stroke-miterlimit="10"/>
+        <path d="M13.874 12c0 .13-.08.247-.204.292l-1.006.372-.37 1.007a.31.31 0 0 1-.584 0l-.373-1.007-1.007-.371a.31.31 0 0 1 0-.583l1.007-.373.37-1.008a.31.31 0 0 1 .584 0l.373 1.008 1.007.37a.308.308 0 0 1 .203.293z" fill="#fff"/>
+    </g>
+    <defs>
+        <clipPath id="ub91fxv4ea">
+            <path fill="#fff" d="M0 0h24v24H0z"/>
+        </clipPath>
+    </defs>
+</svg>

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

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