Skip to content

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

Merged
nicoloboschi merged 2 commits intomainfrom
feat/n8n-integration
May 5, 2026
Merged

feat(n8n): add n8n community-node package for Hindsight memory#1364
nicoloboschi merged 2 commits intomainfrom
feat/n8n-integration

Conversation

@benfrank241
Copy link
Copy Markdown
Contributor

@benfrank241 benfrank241 commented Apr 30, 2026

Summary

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 n8n workflow alongside Slack, Sheets, OpenAI, etc. and the workflow gains persistent memory across runs.

n8n's table-stakes value is being the connective tissue between SaaS apps. Adding a Hindsight node turns every Zapier-style automation into something with state — closed support tickets remembered for future ones, sales-call summaries surfaced before the next call, etc.

Package shape

Standard 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 an operation parameter exposing retain / recall / reflect (Slack-style multi-op pattern, not three separate nodes)
  • nodes/Hindsight/hindsight.svg — node icon
  • test/ — 14 vitest unit tests covering credential metadata, node properties, per-operation field gating, budget enum values

Wiring

  • .github/workflows/test.yml: integrations-n8n filter + test-n8n-integration job (cloned from test-opencode-integration)
  • scripts/release-integration.sh: added n8n to VALID_INTEGRATIONS
  • hindsight-docs/docs-integrations/n8n.md: new docs page
  • hindsight-docs/src/data/integrations.json: entry so n8n appears on /sdks/integrations
  • hindsight-docs/static/img/icons/n8n.svg: placeholder icon

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).
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.
@benfrank241 benfrank241 marked this pull request as ready for review May 1, 2026 15:03
@nicoloboschi nicoloboschi merged commit c1eaf71 into main May 5, 2026
61 of 64 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants