Skip to content

feat(flowise): add Flowise integration with Hindsight memory tools#1436

Open
benfrank241 wants to merge 4 commits into
mainfrom
feat/flowise-integration
Open

feat(flowise): add Flowise integration with Hindsight memory tools#1436
benfrank241 wants to merge 4 commits into
mainfrom
feat/flowise-integration

Conversation

@benfrank241
Copy link
Copy Markdown
Contributor

Summary

Three Flowise Tool nodes — Hindsight Retain, Hindsight Recall, Hindsight Reflect — that drop into any chatflow or agent flow. Each node returns a LangChain DynamicStructuredTool from init(), so it slots into Flowise's tool sockets and any LangChain agent. One shared hindsightApi credential for all three.

Source files use the upstream-relative imports verbatim (../../../src/Interface, ../src/Interface) so they copy 1:1 into FlowiseAI/Flowise/packages/components/ for the submission PR. A local src/Interface.ts shim mirrors the upstream API so the files compile and unit-test outside the Flowise monorepo.

Distribution

Flowise has no n8n-style community-node mechanism — every node lives inside FlowiseAI/Flowise/packages/components/ of the main repo. The user-facing ship event is an upstream PR (same path the existing Mem0 integration used). This PR is the source-of-truth copy in our monorepo plus the standard wiring; the upstream submission is a follow-up tracked separately.

Test plan

  • npm install && npm test — 17/17 vitest tests pass
  • npx tsc --noEmit — clean
  • CI: new test-flowise-integration job (Node 22, npm install + tsc + vitest)
  • Live end-to-end inside a Flowise dev fork (post-merge): copy nodes/credentials into FlowiseAI/Flowise/packages/components/, pnpm build, pnpm start, build a chatflow with all three tools, verify retain/recall via the Hindsight API
  • Open upstream PR to FlowiseAI/Flowise (follow-up issue)
  • v0.2 follow-up: Hindsight Memory node implementing LangChain BaseChatMemory (direct competition with Mem0's existing Memory node)

Files

  • hindsight-integrations/flowise/ — source-of-truth copy (3 tool nodes, 1 credential, vitest setup, README, CHANGELOG)
  • .github/workflows/test.yml — paths-filter, outputs, test-flowise-integration job, summary needs
  • scripts/release-integration.shflowise added to VALID_INTEGRATIONS
  • hindsight-docs/docs-integrations/flowise.md — new docs page
  • hindsight-docs/src/data/integrations.json — listing entry
  • hindsight-docs/static/img/icons/flowise.png — real Flowise logo

🤖 Generated with Claude Code

@benfrank241 benfrank241 closed this May 4, 2026
@benfrank241 benfrank241 reopened this May 6, 2026
@benfrank241 benfrank241 force-pushed the feat/flowise-integration branch from b13d8ec to fb26688 Compare May 6, 2026 14:40
@benfrank241 benfrank241 marked this pull request as ready for review May 7, 2026 17:13
@benfrank241 benfrank241 force-pushed the feat/flowise-integration branch from 5af4ae6 to 7b2232d Compare May 28, 2026 20:31
Adds three Flowise Tool nodes — Hindsight Retain, Hindsight Recall,
Hindsight Reflect — that drop into any chatflow or agent flow alongside
the standard LangChain tools. Each node returns a DynamicStructuredTool
from init(), so it slots into Flowise's tool sockets and any LangChain
agent.

- One shared hindsightApi credential (apiUrl + optional apiKey) for all
  three nodes
- Source files use upstream-relative imports (`../../../src/Interface`
  and `../src/Interface`) and copy 1:1 into Flowise's
  packages/components/ tree at submission time. A local src/Interface.ts
  shim mirrors the upstream API so the files compile and unit-test
  outside the Flowise monorepo.
- 17 vitest unit tests covering INode metadata, credential shape, and
  init() returning a Tool that forwards to the Hindsight client with the
  expected arguments
- test-flowise-integration CI job (Node 22, npm install + tsc + vitest),
  flowise added to release-integration.sh, docs page at
  /sdks/integrations/flowise, integrations.json listing, real Flowise
  logo

Distribution model: Flowise has no community-node mechanism, so the
user-facing ship event is an upstream PR to FlowiseAI/Flowise (same path
Mem0 used). This commit prepares the source-of-truth copy and standard
wiring; the upstream submission is a follow-up.
@benfrank241 benfrank241 force-pushed the feat/flowise-integration branch from 7b2232d to 4ee6b45 Compare May 29, 2026 19:56
Replaces the placeholder gradient-square hindsight.svg shipped in the
HindsightRetain/Recall/Reflect node directories with the canonical
Hindsight favicon (transparent PNG, square-padded to 186x186 so Flowise's
icon slot renders it without distortion). Updates this.icon in the three
node classes from "hindsight.svg" to "hindsight.png" and the matching
test assertion in tests/nodes.test.ts.
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.

1 participant