@rushdb/langchain 0.0.0-stage → 0.1.0

package/dist/vectorstores.js

@@ -0,0 +1,257 @@
+/** RushDB vector store for LangChain. */
+import { randomUUID } from 'node:crypto';
+import { Document } from '@langchain/core/documents';
+import { VectorStore } from '@langchain/core/vectorstores';
+import { clientFromEnv, createRows, deleteIds, findAll, isSelfHosted, mirror, toJson } from './connection.js';
+import { translateFilter } from './filters.js';
+export const ID_PROPERTY = 'lc_id';
+export const METADATA_PROPERTY = 'lc_metadata';
+export const METADATA_PREFIX = 'metadata';
+/** Stands in for `embeddings` when RushDB Cloud computes them. */
+const MANAGED = {
+    embedDocuments: async () => {
+        throw new Error('Managed embeddings are computed by RushDB Cloud.');
+    },
+    embedQuery: async () => {
+        throw new Error('Managed embeddings are computed by RushDB Cloud.');
+    }
+};
+/**
+ * LangChain vector store backed by RushDB, Cloud or self-hosted alike.
+ *
+ * Each document is one record of `label`: its text, its full metadata as JSON
+ * and the metadata's top-level scalar fields as filterable `metadata.<key>`
+ * properties (see the repository's `spec/README.md`). Vectors live in a RushDB
+ * external vector index created on first use.
+ *
+ * `embeddings` turn texts into vectors on every backend. `"managed"` lets
+ * RushDB Cloud compute them instead; a self-hosted engine refuses it, as it
+ * never computes embeddings.
+ */
+export class RushDBVectorStore extends VectorStore {
+    client;
+    managed;
+    label;
+    textProperty;
+    similarity;
+    hybrid;
+    textIndexConsistency;
+    indexReady = false;
+    textIndexReady = false;
+    constructor(embeddings, config = {}) {
+        super(embeddings === 'managed' ? MANAGED : embeddings, config);
+        this.client = config.client ?? clientFromEnv();
+        this.managed = embeddings === 'managed';
+        if (this.managed && isSelfHosted(this.client)) {
+            throw new Error('embedding "managed" needs RushDB Cloud: a self-hosted engine never computes ' +
+                'embeddings. Pass a LangChain Embeddings instance instead.');
+        }
+        this.label = config.label ?? 'LC_DOCUMENT';
+        this.textProperty = config.textProperty ?? 'page_content';
+        if (this.textProperty === ID_PROPERTY ||
+            this.textProperty === METADATA_PROPERTY ||
+            this.textProperty.startsWith('__')) {
+            throw new Error(`textProperty '${this.textProperty}' is reserved.`);
+        }
+        this.similarity = config.similarity ?? 'cosine';
+        this.hybrid = config.hybrid ?? false;
+        this.textIndexConsistency = config.textIndexConsistency ?? 'eventual';
+    }
+    _vectorstoreType() {
+        return 'rushdb';
+    }
+    // ── indexes ────────────────────────────────────────────────────────────
+    /** Create the vector index (and the text index when `hybrid`) if missing. */
+    async ensureIndexes(dimensions) {
+        if (!this.indexReady) {
+            await this.ensureVectorIndex(dimensions);
+            this.indexReady = true;
+        }
+        if (this.hybrid && !this.textIndexReady) {
+            await this.ensureTextIndex();
+            this.textIndexReady = true;
+        }
+    }
+    async ensureVectorIndex(dimensions) {
+        const existing = ((await this.client.ai.indexes.find()).data ?? []);
+        for (const index of existing) {
+            if (index.label !== this.label || index.propertyName !== this.textProperty)
+                continue;
+            if (this.managed && index.sourceType !== 'external')
+                return;
+            if (!this.managed &&
+                index.sourceType === 'external' &&
+                index.similarityFunction === this.similarity &&
+                (dimensions === undefined || index.dimensions === dimensions)) {
+                return;
+            }
+        }
+        const params = { label: this.label, propertyName: this.textProperty };
+        if (!this.managed) {
+            params.external = true;
+            params.dimensions = dimensions ?? (await this.embeddings.embedQuery('dimension probe')).length;
+            params.similarityFunction = this.similarity;
+        }
+        await this.client.ai.indexes.create(params);
+    }
+    async ensureTextIndex() {
+        const existing = ((await this.client.textIndexes.find()).data ?? []);
+        if (existing.some((i) => i.label === this.label && i.property === this.textProperty))
+            return;
+        await this.client.textIndexes.create({
+            label: this.label,
+            property: this.textProperty,
+            consistency: this.textIndexConsistency
+        });
+    }
+    // ── writes ─────────────────────────────────────────────────────────────
+    async addDocuments(documents, options) {
+        if (this.managed)
+            return this.write(documents, undefined, options?.ids);
+        const vectors = await this.embeddings.embedDocuments(documents.map((d) => d.pageContent));
+        return this.addVectors(vectors, documents, options);
+    }
+    async addVectors(vectors, documents, options) {
+        if (this.managed)
+            throw new Error('addVectors needs caller-computed embeddings, not managed ones.');
+        return this.write(documents, vectors, options?.ids);
+    }
+    /**
+     * Store `documents`; a document whose id already exists replaces it.
+     *
+     * New documents are written in one atomic import; records of existing ids
+     * are deleted first.
+     */
+    async write(documents, vectors, idsArg) {
+        if (idsArg && idsArg.length !== documents.length) {
+            throw new Error('ids must have one entry per document.');
+        }
+        const ids = documents.map((doc, i) => idsArg?.[i] || doc.id || randomUUID());
+        if (!documents.length)
+            return [];
+        await this.ensureIndexes(vectors?.[0]?.length);
+        const rows = documents.map((doc, i) => this.row(doc, ids[i]));
+        const entries = vectors?.map((vector) => [
+            { propertyName: this.textProperty, vector, similarityFunction: this.similarity }
+        ]);
+        await deleteIds(this.client, await this.recordIds(ids));
+        await createRows(this.client, this.label, rows, entries);
+        return ids;
+    }
+    row(doc, id) {
+        const metadata = { ...(doc.metadata ?? {}) };
+        return {
+            [ID_PROPERTY]: id,
+            [this.textProperty]: doc.pageContent,
+            [METADATA_PROPERTY]: toJson(metadata),
+            ...mirror(METADATA_PREFIX, metadata)
+        };
+    }
+    async recordIds(ids) {
+        if (!ids.length)
+            return [];
+        const rows = await findAll(this.client, {
+            labels: [this.label],
+            where: { [ID_PROPERTY]: { $in: ids } }
+        });
+        return rows.map((row) => row.__id);
+    }
+    /** Delete the documents with `ids`, or every document with `deleteAll: true`. */
+    async delete(params = {}) {
+        if (params.deleteAll) {
+            await this.client.records.delete({ labels: [this.label] });
+            return;
+        }
+        if (!params.ids)
+            throw new Error('delete needs `ids`, or `deleteAll: true`.');
+        await deleteIds(this.client, await this.recordIds(params.ids));
+    }
+    // ── reads ──────────────────────────────────────────────────────────────
+    async getByIds(ids) {
+        if (!ids.length)
+            return [];
+        const rows = await findAll(this.client, {
+            labels: [this.label],
+            where: { [ID_PROPERTY]: { $in: ids } }
+        });
+        return rows.map((row) => this.document(row));
+    }
+    document(row) {
+        const raw = row[METADATA_PROPERTY];
+        const metadata = typeof raw === 'string' && raw ? JSON.parse(raw) : {};
+        return new Document({
+            id: row[ID_PROPERTY],
+            pageContent: row[this.textProperty] ?? '',
+            metadata
+        });
+    }
+    /** The RushDB vector search request; `where` is a raw RushDB filter. */
+    searchParams(query, vector, k, filter, where) {
+        const params = { labels: [this.label], propertyName: this.textProperty, limit: k };
+        if (this.managed) {
+            params.query = query;
+        }
+        else {
+            params.queryVector = vector;
+            params.similarityFunction = this.similarity;
+        }
+        let combined = translateFilter(filter, METADATA_PREFIX);
+        if (where && Object.keys(where).length) {
+            combined = Object.keys(combined).length ? { $and: [combined, where] } : { ...where };
+        }
+        if (Object.keys(combined).length)
+            params.where = combined;
+        return params;
+    }
+    async runSearch(params) {
+        const vector = params.queryVector;
+        await this.ensureIndexes(vector?.length);
+        const result = await this.client.records.vectorSearch(params);
+        return result.data.map((record) => {
+            const row = record.data;
+            return [this.document(row), Number(row.__score ?? 0)];
+        });
+    }
+    /** Search with a LangChain `filter`, a raw RushDB `where`, or both. */
+    async searchWithScore(query, options = {}) {
+        const vector = this.managed ? undefined : await this.embeddings.embedQuery(query);
+        return this.runSearch(this.searchParams(query, vector, options.k ?? 4, options.filter, options.where));
+    }
+    async similaritySearchVectorWithScore(query, k, filter) {
+        if (this.managed)
+            throw new Error('Search by vector needs caller-computed embeddings, not managed ones.');
+        return this.runSearch(this.searchParams(undefined, query, k, filter));
+    }
+    async similaritySearchWithScore(query, k = 4, filter) {
+        return this.searchWithScore(query, { k, filter });
+    }
+    async similaritySearch(query, k = 4, filter) {
+        return (await this.searchWithScore(query, { k, filter })).map(([doc]) => doc);
+    }
+    /** Results with relevance in [0, 1] (see `relevanceFn`). */
+    async similaritySearchWithRelevanceScores(query, k = 4, filter) {
+        const relevance = relevanceFn(this.similarity);
+        return (await this.searchWithScore(query, { k, filter })).map(([doc, score]) => [doc, relevance(score)]);
+    }
+    static async fromTexts(texts, metadatas, embeddings, config = {}) {
+        const docs = texts.map((text, i) => new Document({
+            pageContent: text,
+            metadata: (Array.isArray(metadatas) ? metadatas[i] : metadatas) ?? {}
+        }));
+        return RushDBVectorStore.fromDocuments(docs, embeddings, config);
+    }
+    static async fromDocuments(docs, embeddings, config = {}) {
+        const store = new RushDBVectorStore(embeddings, config);
+        await store.addDocuments(docs);
+        return store;
+    }
+}
+/** Map an engine score (higher is closer) to a relevance in [0, 1]. */
+export function relevanceFn(similarity) {
+    if (similarity === 'cosine')
+        return (s) => (1 + s) / 2;
+    if (similarity === 'dot')
+        return (s) => 1 / (1 + Math.exp(-s));
+    return (s) => s;
+}
+//# sourceMappingURL=vectorstores.js.map

package/dist/vectorstores.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vectorstores.js","sourceRoot":"","sources":["../src/vectorstores.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,74 @@
 {
   "name": "@rushdb/langchain",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "LangChain and LangGraph integration for RushDB: vector store, hybrid retriever, long-term memory store and checkpointer, on RushDB Cloud or self-hosted",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "README.md",
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rush-db/langchain-rushdb.git",
+    "directory": "libs/js"
+  },
+  "homepage": "https://docs.rushdb.com/connect/langchain",
+  "keywords": [
+    "rushdb",
+    "langchain",
+    "langgraph",
+    "vector store",
+    "hybrid search",
+    "checkpointer",
+    "agent memory",
+    "rag",
+    "self-hosted"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "rimraf dist && tsc -p tsconfig.build.json",
+    "types:check": "tsc --noEmit",
+    "test": "vitest run",
+    "prepack": "pnpm build"
+  },
+  "dependencies": {
+    "@rushdb/javascript-sdk": "^3.3.1"
+  },
+  "peerDependencies": {
+    "@langchain/core": "^1.0.0",
+    "@langchain/langgraph-checkpoint": "^1.0.0"
+  },
+  "devDependencies": {
+    "@langchain/core": "1.3.5",
+    "@langchain/langgraph": "1.7.2",
+    "@langchain/langgraph-checkpoint": "1.2.2",
+    "@langchain/langgraph-checkpoint-validation": "1.2.0",
+    "@types/node": "^20.19.43",
+    "rimraf": "^6.1.4",
+    "typescript": "5.7.2",
+    "vitest": "^3.2.7"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild"
+    ]
+  },
+  "bugs": {
+    "url": "https://github.com/rush-db/langchain-rushdb/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}