Skip to content

@memfork/langgraph v0.1.0

Pre-release
Pre-release

Choose a tag to compare

@Ghost-xDD Ghost-xDD released this 10 Jun 14:40
· 34 commits to main since this release

@memfork/langgraph v0.1.0

Drop-in LangGraph checkpointer that stores every graph state snapshot on Sui (via MemWal). Each LangGraph thread maps to a MemForks branch — enabling cross-agent memory merges.

Install
```bash
npm install @memfork/langgraph @memfork/core
```

Usage
```typescript
import { createMemForksCheckpointer } from "@memfork/langgraph";

const checkpointer = await createMemForksCheckpointer({
treeId: process.env.MEMFORK_TREE_ID!,
signer: process.env.MEMFORK_PRIVATE_KEY!,
memwal: {
accountId: process.env.MEMFORK_MEMWAL_ACCOUNT!,
delegateKey: process.env.MEMFORK_MEMWAL_KEY!,
},
});

const app = new StateGraph(MessagesAnnotation)
.addNode("agent", myNode)
.compile({ checkpointer });
```

What it does

  • Implements BaseCheckpointSaver — drop-in replacement for MemorySaver
  • Each put() commits serialised graph state to MemWal and anchors the blob on-chain
  • getTuple() / list() restores state via semantic recall
  • Thread IDs map to branches: thread/<thread_id>
  • proposeMerge() for cross-agent state reconciliation via on-chain resolvers
  • Zero-config: reads credentials from ~/.memfork/credentials.json or MEMFORK_* env vars

Peer dependencies

  • @langchain/core >=0.3.0
  • @langchain/langgraph >=1.0.0
  • @langchain/langgraph-checkpoint >=1.0.0

Links