@stackflo-labs/n8n-nodes-retainr 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 stackflo-labs
+
+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,81 @@
+# @stackflo-labs/n8n-nodes-retainr
+
+[n8n](https://n8n.io/) community node for [retainr.dev](https://retainr.dev) — the AI agent memory persistence API.
+
+Give your n8n AI agents **long-term memory** that persists across workflow runs. Store facts, preferences, and context, then retrieve them with semantic search — so your agents remember what matters.
+
+## Features
+
+| Operation | Description |
+|-----------|-------------|
+| **Store** | Save a memory with scope, tags, metadata, TTL, and deduplication |
+| **Search** | Semantic similarity search across stored memories |
+| **Get Context** | Retrieve pre-formatted memory context ready for LLM system prompts |
+| **List** | Browse memories with filters (scope, user, session, tags) |
+| **Delete** | Remove memories by filter criteria |
+| **Get Workspace Info** | View plan usage, API keys, and workspace details |
+
+## Installation
+
+### n8n Cloud & Desktop
+
+1. Go to **Settings > Community Nodes**
+2. Search for `@stackflo-labs/n8n-nodes-retainr`
+3. Click **Install**
+
+### Self-hosted n8n
+
+```bash
+cd ~/.n8n
+npm install @stackflo-labs/n8n-nodes-retainr
+```
+
+Then restart n8n.
+
+## Setup
+
+1. Sign up at [retainr.dev](https://retainr.dev) and get your API key
+2. In n8n, go to **Credentials > New > Retainr API**
+3. Paste your API key (`rec_live_...`)
+4. The default Base URL (`https://api.retainr.dev`) works out of the box
+
+## Usage Examples
+
+### Store a memory after a conversation
+
+1. Add the **Retainr** node after your AI Agent
+2. Set **Resource** to `Memory`, **Operation** to `Store`
+3. Map the conversation summary to the **Content** field
+4. Set **Scope** to `User` and provide the **User ID**
+
+### Inject memory context into an LLM prompt
+
+1. Add a **Retainr** node before your AI Agent
+2. Set **Operation** to `Get Context`
+3. Use the incoming message as the **Query**
+4. Pass the `context` output into your LLM's system prompt
+
+### Deduplicate similar memories
+
+Use the **Dedup Threshold** field (e.g., `0.95`) when storing. If a sufficiently similar memory already exists, it will be updated instead of duplicated.
+
+## Memory Scopes
+
+| Scope | Use case |
+|-------|----------|
+| `session` | Single workflow run — requires `session_id` |
+| `user` | Persists across runs for one user — requires `user_id` |
+| `agent` | Shared across users for one agent — requires `agent_id` |
+| `global` | Shared across the entire workspace |
+
+## AI Agent Tool
+
+This node has `usableAsTool` enabled — you can use it directly as a tool inside n8n's **AI Agent** node, letting the agent decide when to store or recall memories autonomously.
+
+## API Documentation
+
+Full API reference: [retainr.dev/docs/api](https://retainr.dev/docs/api)
+
+## License
+
+[MIT](LICENSE)

package/dist/credentials/RetainrApi.credentials.d.ts

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

package/dist/credentials/RetainrApi.credentials.js

@@ -14,16 +14,31 @@ class RetainrApi {
                 typeOptions: { password: true },
                 default: '',
                 placeholder: 'rec_live_...',
-                description: 'Your retainr.dev API key. Get one at https://retainr.dev/dashboard',
+                description: 'Your retainr.dev API key. Create one at https://retainr.dev/dashboard.',
             },
             {
                 displayName: 'Base URL',
                 name: 'baseUrl',
                 type: 'string',
                 default: 'https://api.retainr.dev',
-                description: 'Leave as default unless using a self-hosted instance',
+                description: 'API base URL. Only change this if you run a self-hosted instance.',
             },
         ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.apiKey}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.baseUrl}}',
+                url: '/v1/workspace',
+                method: 'GET',
+            },
+        };
     }
 }
 exports.RetainrApi = RetainrApi;

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

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

package/dist/nodes/Retainr/Retainr.node.js

@@ -0,0 +1,883 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Retainr = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+class Retainr {
+    constructor() {
+        this.description = {
+            displayName: 'Retainr',
+            name: 'retainr',
+            icon: 'file:retainr.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"] + " " + $parameter["resource"]}}',
+            description: 'Store, search, and retrieve AI agent memories',
+            defaults: {
+                name: 'Retainr',
+            },
+            inputs: ['main'],
+            outputs: ['main'],
+            usableAsTool: true,
+            credentials: [
+                {
+                    name: 'retainrApi',
+                    required: true,
+                },
+            ],
+            properties: [
+                // ------------------------------------------------------------------
+                //  Resource
+                // ------------------------------------------------------------------
+                {
+                    displayName: 'Resource',
+                    name: 'resource',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'Memory',
+                            value: 'memory',
+                        },
+                        {
+                            name: 'Workspace',
+                            value: 'workspace',
+                        },
+                    ],
+                    default: 'memory',
+                },
+                // ------------------------------------------------------------------
+                //  Operations — Memory
+                // ------------------------------------------------------------------
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['memory'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: 'Delete',
+                            value: 'delete',
+                            description: 'Delete memories matching a filter',
+                            action: 'Delete memories',
+                        },
+                        {
+                            name: 'Get Context',
+                            value: 'getContext',
+                            description: 'Get pre-formatted memory context for LLM prompts',
+                            action: 'Get memory context',
+                        },
+                        {
+                            name: 'List',
+                            value: 'list',
+                            description: 'List memories with optional filters',
+                            action: 'List memories',
+                        },
+                        {
+                            name: 'Search',
+                            value: 'search',
+                            description: 'Semantic search across memories',
+                            action: 'Search memories',
+                        },
+                        {
+                            name: 'Store',
+                            value: 'store',
+                            description: 'Store a new memory',
+                            action: 'Store a memory',
+                        },
+                    ],
+                    default: 'store',
+                },
+                // ------------------------------------------------------------------
+                //  Operations — Workspace
+                // ------------------------------------------------------------------
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['workspace'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: 'Get Info',
+                            value: 'getInfo',
+                            description: 'Get workspace details, usage, and API keys',
+                            action: 'Get workspace info',
+                        },
+                    ],
+                    default: 'getInfo',
+                },
+                // ==================================================================
+                //  Fields — Memory > Store
+                // ==================================================================
+                {
+                    displayName: 'Content',
+                    name: 'content',
+                    type: 'string',
+                    typeOptions: {
+                        rows: 4,
+                    },
+                    required: true,
+                    default: '',
+                    placeholder: 'The user prefers dark mode and speaks French.',
+                    description: 'The memory content to store (max 32 768 characters)',
+                    displayOptions: {
+                        show: {
+                            resource: ['memory'],
+                            operation: ['store'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Scope',
+                    name: 'scope',
+                    type: 'options',
+                    required: true,
+                    default: 'user',
+                    description: 'Memory visibility scope',
+                    options: [
+                        {
+                            name: 'Session',
+                            value: 'session',
+                            description: 'Scoped to a single workflow run',
+                        },
+                        {
+                            name: 'User',
+                            value: 'user',
+                            description: 'Persists across runs for one user',
+                        },
+                        {
+                            name: 'Agent',
+                            value: 'agent',
+                            description: 'Shared across users for one agent',
+                        },
+                        {
+                            name: 'Global',
+                            value: 'global',
+                            description: 'Shared across the entire workspace',
+                        },
+                    ],
+                    displayOptions: {
+                        show: {
+                            resource: ['memory'],
+                            operation: ['store'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Session ID',
+                    name: 'sessionId',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    description: 'Unique identifier for the session',
+                    displayOptions: {
+                        show: {
+                            resource: ['memory'],
+                            operation: ['store'],
+                            scope: ['session'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'User ID',
+                    name: 'userId',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    description: 'Unique identifier for the user',
+                    displayOptions: {
+                        show: {
+                            resource: ['memory'],
+                            operation: ['store'],
+                            scope: ['user'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Agent ID',
+                    name: 'agentId',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    description: 'Unique identifier for the agent',
+                    displayOptions: {
+                        show: {
+                            resource: ['memory'],
+                            operation: ['store'],
+                            scope: ['agent'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Additional Fields',
+                    name: 'storeAdditionalFields',
+                    type: 'collection',
+                    placeholder: 'Add Field',
+                    default: {},
+                    displayOptions: {
+                        show: {
+                            resource: ['memory'],
+                            operation: ['store'],
+                        },
+                    },
+                    options: [
+                        {
+                            displayName: 'Dedup Threshold',
+                            name: 'dedupThreshold',
+                            type: 'number',
+                            typeOptions: {
+                                minValue: 0,
+                                numberPrecision: 2,
+                            },
+                            default: 0,
+                            description: 'Similarity threshold (0-1) for deduplication. 0 disables dedup. 0.95 is a good starting point.',
+                        },
+                        {
+                            displayName: 'Metadata',
+                            name: 'metadata',
+                            type: 'json',
+                            default: '{}',
+                            description: 'Arbitrary key-value pairs as JSON object',
+                        },
+                        {
+                            displayName: 'Namespace',
+                            name: 'namespace',
+                            type: 'string',
+                            default: '',
+                            description: 'Free-form grouping label for organizing memories',
+                        },
+                        {
+                            displayName: 'Tags',
+                            name: 'tags',
+                            type: 'string',
+                            default: '',
+                            description: 'Comma-separated list of tags for categorical filtering (max 20 tags, 64 chars each)',
+                        },
+                        {
+                            displayName: 'TTL (Seconds)',
+                            name: 'ttlSeconds',
+                            type: 'number',
+                            typeOptions: {
+                                minValue: 0,
+                            },
+                            default: 0,
+                            description: 'Time to live in seconds. 0 means no expiration. Max 31 536 000 (1 year).',
+                        },
+                    ],
+                },
+                // ==================================================================
+                //  Fields — Memory > Search
+                // ==================================================================
+                {
+                    displayName: 'Query',
+                    name: 'query',
+                    type: 'string',
+                    typeOptions: {
+                        rows: 2,
+                    },
+                    required: true,
+                    default: '',
+                    placeholder: "What are this user's preferences?",
+                    description: 'Natural language query for semantic search',
+                    displayOptions: {
+                        show: {
+                            resource: ['memory'],
+                            operation: ['search'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Additional Fields',
+                    name: 'searchAdditionalFields',
+                    type: 'collection',
+                    placeholder: 'Add Field',
+                    default: {},
+                    displayOptions: {
+                        show: {
+                            resource: ['memory'],
+                            operation: ['search'],
+                        },
+                    },
+                    options: [
+                        {
+                            displayName: 'Agent ID',
+                            name: 'agentId',
+                            type: 'string',
+                            default: '',
+                            description: 'Filter by agent ID',
+                        },
+                        {
+                            displayName: 'Limit',
+                            name: 'limit',
+                            type: 'number',
+                            typeOptions: {
+                                minValue: 1,
+                            },
+                            default: 50,
+                            description: 'Max number of results to return',
+                        },
+                        {
+                            displayName: 'Namespace',
+                            name: 'namespace',
+                            type: 'string',
+                            default: '',
+                            description: 'Filter by namespace',
+                        },
+                        {
+                            displayName: 'Scope',
+                            name: 'scope',
+                            type: 'options',
+                            options: [
+                                { name: 'Session', value: 'session' },
+                                { name: 'User', value: 'user' },
+                                { name: 'Agent', value: 'agent' },
+                                { name: 'Global', value: 'global' },
+                            ],
+                            default: 'user',
+                            description: 'Filter by scope',
+                        },
+                        {
+                            displayName: 'Session ID',
+                            name: 'sessionId',
+                            type: 'string',
+                            default: '',
+                            description: 'Filter by session ID',
+                        },
+                        {
+                            displayName: 'Tags',
+                            name: 'tags',
+                            type: 'string',
+                            default: '',
+                            description: 'Comma-separated list of tags to filter by',
+                        },
+                        {
+                            displayName: 'Threshold',
+                            name: 'threshold',
+                            type: 'number',
+                            typeOptions: {
+                                minValue: 0,
+                                numberPrecision: 2,
+                            },
+                            default: 0.5,
+                            description: 'Minimum similarity threshold (0-1)',
+                        },
+                        {
+                            displayName: 'User ID',
+                            name: 'userId',
+                            type: 'string',
+                            default: '',
+                            description: 'Filter by user ID',
+                        },
+                    ],
+                },
+                // ==================================================================
+                //  Fields — Memory > Get Context
+                // ==================================================================
+                {
+                    displayName: 'Query',
+                    name: 'query',
+                    type: 'string',
+                    typeOptions: {
+                        rows: 2,
+                    },
+                    required: true,
+                    default: '',
+                    placeholder: 'Summarize what we know about this customer',
+                    description: 'Natural language query to retrieve relevant context',
+                    displayOptions: {
+                        show: {
+                            resource: ['memory'],
+                            operation: ['getContext'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Format',
+                    name: 'format',
+                    type: 'options',
+                    default: 'system_prompt',
+                    description: 'Output format for the context block',
+                    options: [
+                        {
+                            name: 'System Prompt',
+                            value: 'system_prompt',
+                            description: 'Formatted as an LLM system prompt with header',
+                        },
+                        {
+                            name: 'Bullet List',
+                            value: 'bullet_list',
+                            description: 'Simple bulleted list of memories',
+                        },
+                        {
+                            name: 'Numbered List',
+                            value: 'numbered_list',
+                            description: 'Numbered list of memories',
+                        },
+                    ],
+                    displayOptions: {
+                        show: {
+                            resource: ['memory'],
+                            operation: ['getContext'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Additional Fields',
+                    name: 'contextAdditionalFields',
+                    type: 'collection',
+                    placeholder: 'Add Field',
+                    default: {},
+                    displayOptions: {
+                        show: {
+                            resource: ['memory'],
+                            operation: ['getContext'],
+                        },
+                    },
+                    options: [
+                        {
+                            displayName: 'Agent ID',
+                            name: 'agentId',
+                            type: 'string',
+                            default: '',
+                            description: 'Filter by agent ID',
+                        },
+                        {
+                            displayName: 'Limit',
+                            name: 'limit',
+                            type: 'number',
+                            typeOptions: {
+                                minValue: 1,
+                            },
+                            default: 50,
+                            description: 'Max number of results to return',
+                        },
+                        {
+                            displayName: 'Namespace',
+                            name: 'namespace',
+                            type: 'string',
+                            default: '',
+                            description: 'Filter by namespace',
+                        },
+                        {
+                            displayName: 'Scope',
+                            name: 'scope',
+                            type: 'options',
+                            options: [
+                                { name: 'Session', value: 'session' },
+                                { name: 'User', value: 'user' },
+                                { name: 'Agent', value: 'agent' },
+                                { name: 'Global', value: 'global' },
+                            ],
+                            default: 'user',
+                            description: 'Filter by scope',
+                        },
+                        {
+                            displayName: 'Session ID',
+                            name: 'sessionId',
+                            type: 'string',
+                            default: '',
+                            description: 'Filter by session ID',
+                        },
+                        {
+                            displayName: 'Tags',
+                            name: 'tags',
+                            type: 'string',
+                            default: '',
+                            description: 'Comma-separated list of tags to filter by',
+                        },
+                        {
+                            displayName: 'Threshold',
+                            name: 'threshold',
+                            type: 'number',
+                            typeOptions: {
+                                minValue: 0,
+                                numberPrecision: 2,
+                            },
+                            default: 0.35,
+                            description: 'Minimum similarity threshold (0-1)',
+                        },
+                        {
+                            displayName: 'User ID',
+                            name: 'userId',
+                            type: 'string',
+                            default: '',
+                            description: 'Filter by user ID',
+                        },
+                    ],
+                },
+                // ==================================================================
+                //  Fields — Memory > List
+                // ==================================================================
+                {
+                    displayName: 'Additional Fields',
+                    name: 'listAdditionalFields',
+                    type: 'collection',
+                    placeholder: 'Add Field',
+                    default: {},
+                    displayOptions: {
+                        show: {
+                            resource: ['memory'],
+                            operation: ['list'],
+                        },
+                    },
+                    options: [
+                        {
+                            displayName: 'Agent ID',
+                            name: 'agentId',
+                            type: 'string',
+                            default: '',
+                            description: 'Filter by agent ID',
+                        },
+                        {
+                            displayName: 'Limit',
+                            name: 'limit',
+                            type: 'number',
+                            typeOptions: {
+                                minValue: 1,
+                            },
+                            default: 50,
+                            description: 'Max number of results to return',
+                        },
+                        {
+                            displayName: 'Namespace',
+                            name: 'namespace',
+                            type: 'string',
+                            default: '',
+                            description: 'Filter by namespace',
+                        },
+                        {
+                            displayName: 'Offset',
+                            name: 'offset',
+                            type: 'number',
+                            typeOptions: {
+                                minValue: 0,
+                            },
+                            default: 0,
+                            description: 'Pagination offset',
+                        },
+                        {
+                            displayName: 'Scope',
+                            name: 'scope',
+                            type: 'options',
+                            options: [
+                                { name: 'Session', value: 'session' },
+                                { name: 'User', value: 'user' },
+                                { name: 'Agent', value: 'agent' },
+                                { name: 'Global', value: 'global' },
+                            ],
+                            default: 'user',
+                            description: 'Filter by scope',
+                        },
+                        {
+                            displayName: 'Session ID',
+                            name: 'sessionId',
+                            type: 'string',
+                            default: '',
+                            description: 'Filter by session ID',
+                        },
+                        {
+                            displayName: 'Tags',
+                            name: 'tags',
+                            type: 'string',
+                            default: '',
+                            description: 'Comma-separated list of tags to filter by',
+                        },
+                        {
+                            displayName: 'User ID',
+                            name: 'userId',
+                            type: 'string',
+                            default: '',
+                            description: 'Filter by user ID',
+                        },
+                    ],
+                },
+                // ==================================================================
+                //  Fields — Memory > Delete
+                // ==================================================================
+                {
+                    displayName: 'Scope',
+                    name: 'deleteScope',
+                    type: 'options',
+                    default: 'session',
+                    description: 'Scope of memories to delete. At least one filter is required.',
+                    options: [
+                        { name: 'Session', value: 'session' },
+                        { name: 'User', value: 'user' },
+                        { name: 'Agent', value: 'agent' },
+                        { name: 'Global', value: 'global' },
+                    ],
+                    displayOptions: {
+                        show: {
+                            resource: ['memory'],
+                            operation: ['delete'],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Additional Fields',
+                    name: 'deleteAdditionalFields',
+                    type: 'collection',
+                    placeholder: 'Add Field',
+                    default: {},
+                    displayOptions: {
+                        show: {
+                            resource: ['memory'],
+                            operation: ['delete'],
+                        },
+                    },
+                    options: [
+                        {
+                            displayName: 'Agent ID',
+                            name: 'agentId',
+                            type: 'string',
+                            default: '',
+                            description: 'Filter by agent ID',
+                        },
+                        {
+                            displayName: 'Namespace',
+                            name: 'namespace',
+                            type: 'string',
+                            default: '',
+                            description: 'Filter by namespace',
+                        },
+                        {
+                            displayName: 'Session ID',
+                            name: 'sessionId',
+                            type: 'string',
+                            default: '',
+                            description: 'Filter by session ID',
+                        },
+                        {
+                            displayName: 'User ID',
+                            name: 'userId',
+                            type: 'string',
+                            default: '',
+                            description: 'Filter by user ID',
+                        },
+                    ],
+                },
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const resource = this.getNodeParameter('resource', 0);
+        const operation = this.getNodeParameter('operation', 0);
+        for (let i = 0; i < items.length; i++) {
+            try {
+                const credentials = await this.getCredentials('retainrApi');
+                const baseUrl = credentials.baseUrl.replace(/\/+$/, '');
+                let responseData;
+                // --------------------------------------------------------------
+                //  Memory
+                // --------------------------------------------------------------
+                if (resource === 'memory') {
+                    if (operation === 'store') {
+                        responseData = await storeMemory.call(this, i, baseUrl);
+                    }
+                    else if (operation === 'search') {
+                        responseData = await searchMemories.call(this, i, baseUrl);
+                    }
+                    else if (operation === 'getContext') {
+                        responseData = await getContext.call(this, i, baseUrl);
+                    }
+                    else if (operation === 'list') {
+                        responseData = await listMemories.call(this, i, baseUrl);
+                    }
+                    else if (operation === 'delete') {
+                        responseData = await deleteMemories.call(this, i, baseUrl);
+                    }
+                    else {
+                        throw new Error(`Unknown operation: ${operation}`);
+                    }
+                }
+                // --------------------------------------------------------------
+                //  Workspace
+                // --------------------------------------------------------------
+                else if (resource === 'workspace') {
+                    if (operation === 'getInfo') {
+                        responseData = await getWorkspaceInfo.call(this, baseUrl);
+                    }
+                    else {
+                        throw new Error(`Unknown operation: ${operation}`);
+                    }
+                }
+                else {
+                    throw new Error(`Unknown resource: ${resource}`);
+                }
+                returnData.push({ json: responseData, pairedItem: { item: i } });
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    returnData.push({
+                        json: { error: error.message },
+                        pairedItem: { item: i },
+                    });
+                    continue;
+                }
+                throw new n8n_workflow_1.NodeApiError(this.getNode(), error, {
+                    itemIndex: i,
+                });
+            }
+        }
+        return [returnData];
+    }
+}
+exports.Retainr = Retainr;
+// ======================================================================
+//  Helper: Make an authenticated API request
+// ======================================================================
+async function apiRequest(method, baseUrl, path, body, qs) {
+    const options = {
+        method,
+        url: `${baseUrl}${path}`,
+        json: true,
+    };
+    if (body && Object.keys(body).length > 0) {
+        options.body = body;
+    }
+    if (qs && Object.keys(qs).length > 0) {
+        options.qs = qs;
+    }
+    return (await this.helpers.httpRequestWithAuthentication.call(this, 'retainrApi', options));
+}
+// ======================================================================
+//  Helper: Parse comma-separated tags into array
+// ======================================================================
+function parseTags(raw) {
+    if (!raw)
+        return [];
+    return raw
+        .split(',')
+        .map((t) => t.trim())
+        .filter(Boolean);
+}
+// ======================================================================
+//  Operation handlers
+// ======================================================================
+async function storeMemory(i, baseUrl) {
+    const content = this.getNodeParameter('content', i);
+    const scope = this.getNodeParameter('scope', i);
+    const additional = this.getNodeParameter('storeAdditionalFields', i);
+    const body = { content, scope };
+    // Scope-specific IDs
+    if (scope === 'session') {
+        body.session_id = this.getNodeParameter('sessionId', i);
+    }
+    else if (scope === 'user') {
+        body.user_id = this.getNodeParameter('userId', i);
+    }
+    else if (scope === 'agent') {
+        body.agent_id = this.getNodeParameter('agentId', i);
+    }
+    // Optional fields
+    if (additional.namespace)
+        body.namespace = additional.namespace;
+    if (additional.tags)
+        body.tags = parseTags(additional.tags);
+    if (additional.ttlSeconds)
+        body.ttl_seconds = additional.ttlSeconds;
+    if (additional.dedupThreshold) {
+        body.dedup_threshold = additional.dedupThreshold;
+    }
+    if (additional.metadata) {
+        body.metadata =
+            typeof additional.metadata === 'string'
+                ? JSON.parse(additional.metadata)
+                : additional.metadata;
+    }
+    return apiRequest.call(this, 'POST', baseUrl, '/v1/memories', body);
+}
+async function searchMemories(i, baseUrl) {
+    const query = this.getNodeParameter('query', i);
+    const additional = this.getNodeParameter('searchAdditionalFields', i);
+    const body = { query };
+    if (additional.scope)
+        body.scope = additional.scope;
+    if (additional.sessionId)
+        body.session_id = additional.sessionId;
+    if (additional.userId)
+        body.user_id = additional.userId;
+    if (additional.agentId)
+        body.agent_id = additional.agentId;
+    if (additional.namespace)
+        body.namespace = additional.namespace;
+    if (additional.tags)
+        body.tags = parseTags(additional.tags);
+    if (additional.limit)
+        body.limit = additional.limit;
+    if (additional.threshold)
+        body.threshold = additional.threshold;
+    return apiRequest.call(this, 'POST', baseUrl, '/v1/memories/search', body);
+}
+async function getContext(i, baseUrl) {
+    const query = this.getNodeParameter('query', i);
+    const format = this.getNodeParameter('format', i);
+    const additional = this.getNodeParameter('contextAdditionalFields', i);
+    const body = { query, format };
+    if (additional.scope)
+        body.scope = additional.scope;
+    if (additional.sessionId)
+        body.session_id = additional.sessionId;
+    if (additional.userId)
+        body.user_id = additional.userId;
+    if (additional.agentId)
+        body.agent_id = additional.agentId;
+    if (additional.namespace)
+        body.namespace = additional.namespace;
+    if (additional.tags)
+        body.tags = parseTags(additional.tags);
+    if (additional.limit)
+        body.limit = additional.limit;
+    if (additional.threshold)
+        body.threshold = additional.threshold;
+    return apiRequest.call(this, 'POST', baseUrl, '/v1/memories/context', body);
+}
+async function listMemories(i, baseUrl) {
+    const additional = this.getNodeParameter('listAdditionalFields', i);
+    const qs = {};
+    if (additional.scope)
+        qs.scope = additional.scope;
+    if (additional.sessionId)
+        qs.session_id = additional.sessionId;
+    if (additional.userId)
+        qs.user_id = additional.userId;
+    if (additional.agentId)
+        qs.agent_id = additional.agentId;
+    if (additional.namespace)
+        qs.namespace = additional.namespace;
+    if (additional.tags)
+        qs.tags = additional.tags;
+    if (additional.limit)
+        qs.limit = additional.limit;
+    if (additional.offset)
+        qs.offset = additional.offset;
+    return apiRequest.call(this, 'GET', baseUrl, '/v1/memories', undefined, qs);
+}
+async function deleteMemories(i, baseUrl) {
+    const scope = this.getNodeParameter('deleteScope', i);
+    const additional = this.getNodeParameter('deleteAdditionalFields', i);
+    const body = { scope };
+    if (additional.sessionId)
+        body.session_id = additional.sessionId;
+    if (additional.userId)
+        body.user_id = additional.userId;
+    if (additional.agentId)
+        body.agent_id = additional.agentId;
+    if (additional.namespace)
+        body.namespace = additional.namespace;
+    return apiRequest.call(this, 'DELETE', baseUrl, '/v1/memories', body);
+}
+async function getWorkspaceInfo(baseUrl) {
+    return apiRequest.call(this, 'GET', baseUrl, '/v1/workspace');
+}

package/dist/nodes/Retainr/retainr.svg

@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="60" height="60" viewBox="0 0 60 60" fill="none">
+  <rect width="60" height="60" rx="14" fill="#6366F1"/>
+  <g stroke="#fff" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round" fill="none">
+    <ellipse cx="30" cy="19" rx="12" ry="5"/>
+    <path d="M18 19v9c0 2.8 5.4 5 12 5s12-2.2 12-5v-9"/>
+    <path d="M18 28v9c0 2.8 5.4 5 12 5s12-2.2 12-5v-9"/>
+  </g>
+  <circle cx="30" cy="28" r="2.5" fill="#fff"/>
+</svg>

package/package.json

@@ -1,44 +1,55 @@
-{
-  "name": "@stackflo-labs/n8n-nodes-retainr",
-  "version": "0.1.0",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/stackflo-labs/n8n-nodes-retainr.git"
-  },
-  "description": "n8n community node for retainr.dev — AI agent memory persistence API",
-  "license": "MIT",
-  "author": {
-    "name": "retainr.dev"
-  },
-  "n8n": {
-    "n8nNodesApiVersion": 1,
-    "credentials": [
-      "dist/credentials/RetainrApi.credentials.js"
-    ],
-    "nodes": []
-  },
-  "main": "dist/index.js",
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "tsc"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "keywords": [
-    "n8n-community-node-package",
-    "n8n",
-    "retainr",
-    "ai-memory",
-    "agent-memory"
-  ],
-  "peerDependencies": {
-    "n8n-workflow": "*"
-  },
-  "devDependencies": {
-    "n8n-workflow": "^1.0.0",
-    "typescript": "^5.0.0"
-  }
-}
+{
+  "name": "@stackflo-labs/n8n-nodes-retainr",
+  "version": "0.2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stackflo-labs/n8n-nodes-retainr.git"
+  },
+  "description": "n8n community node for retainr.dev — AI agent memory persistence API. Store, search, and retrieve semantic memories for AI agents across workflow runs.",
+  "license": "MIT",
+  "author": {
+    "name": "stackflo-labs",
+    "url": "https://retainr.dev"
+  },
+  "homepage": "https://github.com/stackflo-labs/n8n-nodes-retainr",
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/RetainrApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/Retainr/Retainr.node.js"
+    ]
+  },
+  "main": "dist/nodes/Retainr/Retainr.node.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && copyfiles -u 1 \"src/**/*.svg\" dist",
+    "lint": "npx @n8n/scan-community-package @stackflo-labs/n8n-nodes-retainr",
+    "clean": "rimraf dist"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "n8n-community-node-package",
+    "n8n",
+    "retainr",
+    "ai-memory",
+    "agent-memory",
+    "vector-search",
+    "semantic-memory",
+    "llm",
+    "ai-agent"
+  ],
+  "peerDependencies": {
+    "n8n-workflow": ">=1.0.0"
+  },
+  "devDependencies": {
+    "copyfiles": "^2.4.1",
+    "n8n-workflow": "^1.70.0",
+    "typescript": "^5.7.0"
+  }
+}