@crowkis/client 0.5.0

package/langchain.js

@@ -0,0 +1,53 @@
+"use strict";
+
+// Semantic LLM cache for LangChain.js (and LangGraph.js) — drop-in.
+//
+//   const { CrowkisCache } = require("@crowkis/client/langchain");
+//   const { OpenAI } = require("@langchain/openai");
+//   const llm = new OpenAI({ cache: new CrowkisCache({ tenant: "my-app", ttl: 3600 }) });
+//
+// Unlike LangChain's built-in caches (exact match), Crowkis matches on MEANING,
+// so rephrased prompts hit the cache. Duck-typed (lookup/update) — needs no
+// @langchain/core dependency.
+
+const { CrowkisClient } = require("./index.js");
+
+class CrowkisCache {
+  constructor(options = {}) {
+    this.client = options.client || new CrowkisClient(options);
+    this.ttl = options.ttl;
+    this.threshold = options.threshold;
+  }
+
+  async lookup(prompt, llmKey) {
+    const hit = await this.client.cgetHit(prompt, {
+      model: llmKey,
+      threshold: this.threshold,
+    });
+    if (!hit) return null;
+    const text = hit.text || "";
+    try {
+      const arr = JSON.parse(text);
+      if (Array.isArray(arr)) return arr.map((t) => ({ text: String(t) }));
+    } catch (_) {
+      // stored as plain text (older value / another writer)
+    }
+    return [{ text }];
+  }
+
+  async update(prompt, llmKey, value) {
+    const texts = Array.isArray(value)
+      ? value.map((g) => (g && g.text !== undefined ? g.text : String(g)))
+      : [String(value)];
+    await this.client.cset(prompt, JSON.stringify(texts), {
+      ttl: this.ttl,
+      model: llmKey,
+    });
+  }
+
+  async clear() {
+    if (typeof this.client.cflush === "function") await this.client.cflush();
+  }
+}
+
+module.exports = { CrowkisCache };

package/memory.js

@@ -0,0 +1,50 @@
+"use strict";
+
+// Framework-agnostic long-term agent memory backed by Crowkis.
+// Works in LangGraph.js, or any agent loop. No extra dependency.
+//
+//   const { CrowkisMemory } = require("@crowkis/client/memory");
+//   const mem = new CrowkisMemory("support-bot", { user: "alice", tenant: "demo" });
+//   await mem.remember("Alice prefers email over phone");
+//   const hits = await mem.recall("how should I contact Alice?");
+
+const { CrowkisClient } = require("./index.js");
+
+class CrowkisMemory {
+  constructor(agent, options = {}) {
+    if (!agent) throw new Error("agent must be a non-empty name");
+    this.agent = agent;
+    this.user = options.user;
+    this.client = options.client || new CrowkisClient(options);
+  }
+
+  remember(fact, { ttl } = {}) {
+    return this.client.cmemset(this.agent, fact, { user: this.user, ex: ttl });
+  }
+
+  recall(query, { k = 5 } = {}) {
+    return this.client.cmemget(this.agent, query, { user: this.user, k });
+  }
+
+  extract(conversation, { ttl } = {}) {
+    return this.client.cmemextract(this.agent, conversation, { user: this.user, ex: ttl });
+  }
+
+  history(query, { k = 5 } = {}) {
+    return this.client.cmemhistory(this.agent, query, { user: this.user, k });
+  }
+
+  forget({ query, threshold } = {}) {
+    return this.client.cmemforget(this.agent, { query, user: this.user, threshold });
+  }
+
+  link(subject, relation, object) {
+    return this.client.cmemlink(this.agent, subject, relation, object, { user: this.user });
+  }
+
+  graph(entity, { depth } = {}) {
+    return this.client.cmemgraph(this.agent, entity, { user: this.user, depth });
+  }
+}
+
+module.exports = { CrowkisMemory };

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@crowkis/client",
+  "version": "0.5.0",
+  "description": "Official Node.js and TypeScript SDK for Crowkis — intelligent, Redis-compatible cache & memory for LLM apps and agents",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "exports": {
+    ".": "./index.js",
+    "./langchain": "./langchain.js",
+    "./memory": "./memory.js"
+  },
+  "license": "Apache-2.0",
+  "author": "Mohit Rohilla",
+  "keywords": ["crowkis", "llm", "cache", "semantic-cache", "agent-memory", "langchain", "langgraph", "redis"],
+  "homepage": "https://www.crowkis.com",
+  "repository": { "type": "git", "url": "https://github.com/crowkis/crowkis-sdk.git" },
+  "peerDependencies": {
+    "@grpc/grpc-js": ">=1.9.0",
+    "@grpc/proto-loader": ">=0.7.0"
+  },
+  "peerDependenciesMeta": {
+    "@grpc/grpc-js": {
+      "optional": true
+    },
+    "@grpc/proto-loader": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "langchain.js",
+    "memory.js",
+    "grpc.js",
+    "crowkis.proto",
+    "README.md"
+  ],
+  "scripts": {
+    "check": "node --check index.js"
+  }
+}