feat(n8n): add n8n community-node package for Hindsight memory (#1364)

* feat(n8n): add n8n community-node package for Hindsight memory

Adds @vectorize-io/n8n-nodes-hindsight — an n8n community node package
that exposes Hindsight retain / recall / reflect as workflow operations.
Drop the Hindsight node into any workflow alongside Slack, Sheets,
OpenAI, etc. and you have persistent memory across runs.

Package layout (n8n community-node convention):
- credentials/HindsightApi.credentials.ts: credential class
  (apiUrl + optional apiKey, /health test, Bearer auth)
- nodes/Hindsight/Hindsight.node.ts: single node with operation parameter
  exposing retain / recall / reflect (matches Slack-style multi-op nodes)
- nodes/Hindsight/hindsight.svg: node icon
- 14 unit tests (vitest) covering credential metadata, node properties,
  per-operation field gating, budget enums

Wiring:
- detect-changes filter + test-n8n-integration job in test.yml
  (cloned from test-opencode-integration shape)
- Added n8n to VALID_INTEGRATIONS in scripts/release-integration.sh
- New /sdks/integrations/n8n docs page
- Entry in integrations.json so n8n appears on the listing
- n8n.svg icon (placeholder; replace with brand-approved version)

Verified: tsc + vitest both clean (npm run build, npm test).

* feat(n8n): use Hindsight iris logo as node icon

Replaces the placeholder mark with the actual brand logo (PNG).
Updates copy-icons to ship any hindsight.* file with the build, and
ignores npm-pack tarballs.

Author: benfrank241

.github/workflows/test.yml

@@ -47,6 +47,7 @@ jobs:
       integrations-llamaindex: ${{ steps.filter.outputs.integrations-llamaindex }}
       integrations-paperclip: ${{ steps.filter.outputs.integrations-paperclip }}
       integrations-opencode: ${{ steps.filter.outputs.integrations-opencode }}
+      integrations-n8n: ${{ steps.filter.outputs.integrations-n8n }}
       integrations-cloudflare-oauth-proxy: ${{ steps.filter.outputs.integrations-cloudflare-oauth-proxy }}
       integrations-lockfiles: ${{ steps.filter.outputs.integrations-lockfiles }}
       integrations-openai-agents: ${{ steps.filter.outputs.integrations-openai-agents }}
@@ -133,6 +134,8 @@ jobs:
             - 'hindsight-integrations/paperclip/**'
           integrations-opencode:
             - 'hindsight-integrations/opencode/**'
+          integrations-n8n:
+            - 'hindsight-integrations/n8n/**'
           integrations-cloudflare-oauth-proxy:
             - 'hindsight-integrations/cloudflare-oauth-proxy/**'
           integrations-lockfiles:
@@ -527,6 +530,37 @@ jobs:
       working-directory: ./hindsight-integrations/opencode
       run: npm run build
 
+  test-n8n-integration:
+    needs: [detect-changes]
+    if: >-
+      github.event_name != 'pull_request_review' &&
+      (github.event_name == 'workflow_dispatch' ||
+      needs.detect-changes.outputs.integrations-n8n == 'true' ||
+      needs.detect-changes.outputs.ci == 'true')
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v6
+      with:
+        ref: ${{ github.event.pull_request.head.sha || '' }}
+
+    - name: Set up Node.js
+      uses: actions/setup-node@v6
+      with:
+        node-version: '22'
+
+    - name: Install dependencies
+      working-directory: ./hindsight-integrations/n8n
+      run: npm install --no-fund --no-audit
+
+    - name: Run tests
+      working-directory: ./hindsight-integrations/n8n
+      run: npm test
+
+    - name: Build
+      working-directory: ./hindsight-integrations/n8n
+      run: npm run build
+
   test-hindsight-agent-sdk:
     needs: [detect-changes]
     if: >-
@@ -3562,6 +3596,7 @@ jobs:
       - build-ai-sdk-integration
       - test-ai-sdk-integration-deno
       - test-opencode-integration
+      - test-n8n-integration
       - test-cloudflare-oauth-proxy-integration
       - build-chat-integration
       - test-paperclip-integration

hindsight-docs/docs-integrations/n8n.md

@@ -0,0 +1,87 @@
+---
+sidebar_position: 32
+title: "n8n Persistent Memory with Hindsight | Integration"
+description: "Add persistent long-term memory to any n8n workflow with Hindsight. A community node provides Retain, Recall, and Reflect operations — drop them into any workflow alongside Slack, Sheets, OpenAI, and 400+ other integrations."
+---
+
+# n8n
+
+Persistent memory for [n8n](https://n8n.io) workflows via [Hindsight](https://hindsight.vectorize.io). The `@vectorize-io/n8n-nodes-hindsight` community node package adds three operations — **Retain**, **Recall**, **Reflect** — that work alongside any other n8n node.
+
+## Why this matters
+
+n8n is the connective tissue of automation: triggers from Gmail, Slack, Sheets, Stripe, Notion; actions across 400+ apps. Until now it has been **stateless** — every workflow run starts fresh. With Hindsight nodes you can:
+
+- **Retain** every closed support ticket, sales-call summary, or form submission into a memory bank
+- **Recall** relevant context before an OpenAI / Anthropic / Cohere step so the LLM sees prior history
+- **Reflect** to ask synthesizing questions ("What do we know about this customer?") right inside a workflow
+
+## Installation
+
+In your n8n instance, go to **Settings → Community Nodes → Install** and enter:
+
+```
+@vectorize-io/n8n-nodes-hindsight
+```
+
+Or for self-hosted n8n:
+
+```bash
+cd ~/.n8n/custom
+npm install @vectorize-io/n8n-nodes-hindsight
+```
+
+Restart n8n; the **Hindsight** node appears in the node panel.
+
+## Setup
+
+1. **Sign up** at [Hindsight Cloud](https://ui.hindsight.vectorize.io/signup) (free tier) or [self-host](/developer/installation)
+2. **Get an API key** from the Hindsight dashboard
+3. **In n8n**, create a new **Hindsight API** credential with your API URL (defaults to Hindsight Cloud) and the `hsk_...` key
+
+## Operations
+
+### Retain
+
+Store content in a bank. Hindsight extracts facts asynchronously after the call returns.
+
+| Field | Description |
+|---|---|
+| Bank ID | Memory bank to store in (auto-created on first use) |
+| Content | Free text to retain |
+| Tags | Comma-separated tags |
+
+### Recall
+
+Search a bank for memories relevant to a query. Returns a `results` array.
+
+| Field | Description |
+|---|---|
+| Bank ID | Memory bank to search |
+| Query | Natural-language query |
+| Budget | `low` / `mid` / `high` |
+| Max Tokens | Cap on returned memory tokens |
+| Tags Filter | Filter by tag |
+
+### Reflect
+
+Get an LLM-synthesized answer over the bank. Returns `text`.
+
+| Field | Description |
+|---|---|
+| Bank ID | Memory bank |
+| Query | Question to answer |
+| Budget | `low` / `mid` / `high` |
+
+## Example workflows
+
+**Customer-support assistant** — every closed Zendesk ticket retains the resolution. Every new ticket starts with a recall against the bank to surface similar past issues, then passes that context to OpenAI to draft the first reply.
+
+**Sales-call coach** — Gong webhook → Hindsight Retain (call summary). Before each next prep call, recall on the prospect's name to pull every prior touchpoint, then format into the daily prep doc.
+
+**Personal Slack bot** — Slack DM trigger → Hindsight Recall on the user's question → OpenAI for the answer → Slack reply. The bot remembers every conversation across sessions.
+
+## Source
+
+- npm: [`@vectorize-io/n8n-nodes-hindsight`](https://www.npmjs.com/package/@vectorize-io/n8n-nodes-hindsight)
+- GitHub: [`hindsight-integrations/n8n`](https://github.com/vectorize-io/hindsight/tree/main/hindsight-integrations/n8n)

hindsight-docs/src/data/integrations.json

@@ -210,6 +210,16 @@
       "link": "/sdks/integrations/opencode",
       "icon": "/img/icons/opencode.svg"
     },
+    {
+      "id": "n8n",
+      "name": "n8n",
+      "description": "Persistent memory community node for n8n workflows. Retain, recall, and reflect operations drop into any workflow alongside Slack, Sheets, OpenAI, and 400+ other integrations.",
+      "type": "official",
+      "by": "hindsight",
+      "category": "framework",
+      "link": "/sdks/integrations/n8n",
+      "icon": "/img/icons/n8n.svg"
+    },
     {
       "id": "openai-agents",
       "name": "OpenAI Agents SDK",

hindsight-docs/static/img/icons/n8n.svg

@@ -0,0 +1,4 @@
+node_modules/
+dist/
+*.tsbuildinfo
+*.tgz

hindsight-integrations/n8n/.gitignore

@@ -0,0 +1,78 @@
+# @vectorize-io/n8n-nodes-hindsight
+
+[Hindsight](https://hindsight.vectorize.io) memory nodes for [n8n](https://n8n.io) — give any n8n workflow persistent long-term memory with **retain**, **recall**, and **reflect** operations.
+
+Drop a Hindsight node anywhere in a workflow to:
+
+- **Retain** facts emerging from a workflow (form submissions, CRM updates, customer chat) into a memory bank
+- **Recall** relevant context before an LLM step so the AI sees prior history
+- **Reflect** to get an LLM-synthesized answer over the bank's accumulated knowledge
+
+## Installation
+
+In n8n, go to **Settings → Community Nodes → Install** and enter:
+
+```
+@vectorize-io/n8n-nodes-hindsight
+```
+
+Or install via npm in your self-hosted n8n:
+
+```bash
+cd ~/.n8n/custom
+npm install @vectorize-io/n8n-nodes-hindsight
+```
+
+Restart n8n and the **Hindsight** node appears in the node panel.
+
+## Setup
+
+1. **Create a Hindsight account** at [Hindsight Cloud](https://ui.hindsight.vectorize.io/signup) (free tier available) — or self-host with the [Hindsight installer](https://hindsight.vectorize.io/developer/installation)
+2. **Get an API key** from the Hindsight dashboard
+3. **In n8n**, create a new **Hindsight API** credential:
+   - **API URL**: `https://api.hindsight.vectorize.io` (or your self-hosted URL)
+   - **API Key**: your `hsk_...` key (leave blank for unauthenticated self-hosted)
+
+## Operations
+
+### Retain — store content in a bank
+
+| Field | Description |
+|---|---|
+| Bank ID | The memory bank to store in (auto-created on first use) |
+| Content | Free text to retain. Hindsight extracts structured facts asynchronously |
+| Tags | Comma-separated tags applied to the stored memory |
+
+### Recall — search a bank
+
+| Field | Description |
+|---|---|
+| Bank ID | Memory bank to search |
+| Query | Natural-language query |
+| Budget | `low` / `mid` / `high` — controls retrieval depth |
+| Max Tokens | Cap on returned memory tokens |
+| Tags Filter | Filter memories by tag |
+
+Returns: `{ results: [{ text, score, ... }, ...] }`
+
+### Reflect — LLM-synthesized answer
+
+| Field | Description |
+|---|---|
+| Bank ID | Memory bank to reflect on |
+| Query | Question to answer |
+| Budget | `low` / `mid` / `high` |
+
+Returns: `{ text: "...", citations: [...] }`
+
+## Example workflows
+
+**Customer-support assistant** — every closed Zendesk ticket retains the resolution; every new ticket starts with a recall against the bank to surface similar past issues.
+
+**Sales-call coach** — Gong webhook → Hindsight Retain (call summary). Before each next prep call, recall on the prospect's name to pull every prior touchpoint.
+
+**Personal Slack bot** — Slack DM trigger → Hindsight Recall on the user's question, pass through to OpenAI node, reply.
+
+## License
+
+MIT

hindsight-integrations/n8n/README.md

@@ -0,0 +1,56 @@
+import type {
+	IAuthenticateGeneric,
+	ICredentialTestRequest,
+	ICredentialType,
+	INodeProperties,
+} from 'n8n-workflow';
+
+/**
+ * Credentials for the Hindsight memory API.
+ *
+ * Defaults to Hindsight Cloud. For self-hosted instances, change the API URL
+ * to your deployment (e.g. http://localhost:8888).
+ */
+export class HindsightApi implements ICredentialType {
+	name = 'hindsightApi';
+	displayName = 'Hindsight API';
+	documentationUrl = 'https://hindsight.vectorize.io/developer/api/quickstart';
+	properties: INodeProperties[] = [
+		{
+			displayName: 'API URL',
+			name: 'apiUrl',
+			type: 'string',
+			default: 'https://api.hindsight.vectorize.io',
+			description:
+				'Base URL of the Hindsight API. Defaults to Hindsight Cloud; change for self-hosted instances.',
+			required: true,
+		},
+		{
+			displayName: 'API Key',
+			name: 'apiKey',
+			type: 'string',
+			typeOptions: { password: true },
+			default: '',
+			description:
+				'API key for Hindsight Cloud (begins with "hsk_"). Leave blank for unauthenticated self-hosted instances.',
+		},
+	];
+
+	authenticate: IAuthenticateGeneric = {
+		type: 'generic',
+		properties: {
+			headers: {
+				Authorization: '={{ $credentials.apiKey ? "Bearer " + $credentials.apiKey : undefined }}',
+			},
+		},
+	};
+
+	// Test against /health — works for both Cloud and self-hosted
+	test: ICredentialTestRequest = {
+		request: {
+			baseURL: '={{ $credentials.apiUrl }}',
+			url: '/health',
+			method: 'GET',
+		},
+	};
+}