Skip to content

Add langchain-dkg integration #4

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
haroldboom wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Add langchain-dkg integration #4

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 41 additions & 0 deletions integrations/langchain-dkg.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
{
"$schema": "../schema/integration.schema.json",
"schemaVersion": "0.1.0",
"slug": "langchain-dkg",
"name": "LangChain DKG Adapter",
"description": "LangChain memory and retriever components backed by OriginTrail DKG v10. Gives LangChain agents durable, verifiable, queryable memory — conversation history is stored as Knowledge Assets in Working Memory and retrieved via tri-modal search (vector + SPARQL + text).",
"category": ["working-memory", "retrieval", "python", "langchain", "rag"],
"maintainer": {
"github": "@haroldboom",
"contact": "spangers11@gmail.com"
},
"repo": "https://github.com/haroldboom/dkg-langchain",
"commit": "80392345732114b2e2d4395bcece3b1a5df5bcb5",
"license": "MIT",
"requiresDkgNodeVersion": ">=10.0.0",
"memoryLayers": ["WM", "SWM"],
"v10PrimitivesUsed": ["UAL", "KnowledgeAsset", "ContextGraph", "Assertion"],
"publicInterfacesUsed": ["http-api"],

"install": {
"kind": "manual",
"docsUrl": "https://github.com/haroldboom/dkg-langchain#readme",
"oneLiner": "pip install langchain-dkg — then set DKG_API_URL and DKG_TOKEN and import DKGChatMessageHistory, DKGMemory, or DKGRetriever."
},

"security": {
"networkEgress": [],
"writeAuthority": [
"POST /api/memory/turn",
"POST /api/assertion/{name}/promote"
],
"credentialsHandled": [],
"notes": "Communicates only with the local DKG node (default localhost:9200) — no external network egress. Credentials are read from the DKG_TOKEN environment variable or passed explicitly to DKGClient; never hardcoded. POST /api/memory/turn stores conversation turns as Knowledge Assets in Working Memory. POST /api/assertion/{name}/promote is a Curator-authority SHARE operation that moves a turn to Shared Working Memory; this is always explicit and agent-initiated, never automatic. No Verified Memory (PUBLISH) operations are performed. The package has no postinstall, install, or preinstall scripts."
},

"trustTier": "community",

"designBrief": "https://github.com/haroldboom/dkg-langchain/blob/master/DESIGN_BRIEF.md",
"promotionPath": "Every conversation turn stored via DKGChatMessageHistory returns a turnUri (UAL). The agent can call promote_to_shared(turn_uri) to SHARE the Knowledge Asset from Working Memory to Shared Working Memory via POST /api/assertion/{name}/promote — promotion is always explicit. From Shared Working Memory, a future PUBLISH call (Round 2 scope) moves the Context Graph to Verified Memory on-chain, preserving the full UAL provenance chain from original turn through to the paranet record. DKGRetriever queries the same WM/SWM graph via SPARQL SELECT, so promoted artifacts are immediately available as RAG context for downstream agents.",
"fitNotes": "Directly targets the LLM-Wiki / autoresearch direction: LangChain agents are the dominant production consumer of external memory systems, and this adapter maps Karpathy's memory taxonomy (in-context, external, team, long-term) onto the DKG v10 layer model (WM, SWM, VM). DKGRetriever is a drop-in BaseRetriever for any LangChain RAG pipeline, giving any autoresearch-style agent a verifiable, attributable upstream knowledge source."
}