From a9d78831379a77cd91d1017a5519c571e0da383c Mon Sep 17 00:00:00 2001
From: haroldboom <spangers11@gmail.com>
Date: Wed, 29 Apr 2026 07:47:09 +1000
Subject: [PATCH] Add langchain-dkg integration

---
 integrations/langchain-dkg.json | 41 +++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 integrations/langchain-dkg.json

diff --git a/integrations/langchain-dkg.json b/integrations/langchain-dkg.json
new file mode 100644
index 0000000..2e45dc5
--- /dev/null
+++ b/integrations/langchain-dkg.json
@@ -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."
+}