langchain 0.0.173 → 0.0.175

package/dist/callbacks/manager.cjs

@@ -504,7 +504,8 @@ class CallbackManager extends BaseCallbackManager {
                 ? localHandlers.map(ensureHandler)
                 : localHandlers?.handlers, false);
         }
-        const verboseEnabled = (0, env_js_1.getEnvironmentVariable)("LANGCHAIN_VERBOSE") || options?.verbose;
+        const verboseEnabled = (0, env_js_1.getEnvironmentVariable)("LANGCHAIN_VERBOSE") === "true" ||
+            options?.verbose;
         const tracingV2Enabled = (0, env_js_1.getEnvironmentVariable)("LANGCHAIN_TRACING_V2") === "true";
         const tracingEnabled = tracingV2Enabled ||
             ((0, env_js_1.getEnvironmentVariable)("LANGCHAIN_TRACING") ?? false);

package/dist/callbacks/manager.js

@@ -495,7 +495,8 @@ export class CallbackManager extends BaseCallbackManager {
                 ? localHandlers.map(ensureHandler)
                 : localHandlers?.handlers, false);
         }
-        const verboseEnabled = getEnvironmentVariable("LANGCHAIN_VERBOSE") || options?.verbose;
+        const verboseEnabled = getEnvironmentVariable("LANGCHAIN_VERBOSE") === "true" ||
+            options?.verbose;
         const tracingV2Enabled = getEnvironmentVariable("LANGCHAIN_TRACING_V2") === "true";
         const tracingEnabled = tracingV2Enabled ||
             (getEnvironmentVariable("LANGCHAIN_TRACING") ?? false);

package/dist/load/import_constants.cjs

@@ -41,6 +41,7 @@ exports.optionalImportEntrypoints = [
     "langchain/prompts/load",
     "langchain/vectorstores/analyticdb",
     "langchain/vectorstores/cassandra",
+    "langchain/vectorstores/convex",
     "langchain/vectorstores/elasticsearch",
     "langchain/vectorstores/cloudflare_vectorize",
     "langchain/vectorstores/closevector/web",
@@ -133,6 +134,7 @@ exports.optionalImportEntrypoints = [
     "langchain/cache/upstash_redis",
     "langchain/stores/doc/gcs",
     "langchain/stores/file/node",
+    "langchain/stores/message/convex",
     "langchain/stores/message/cloudflare_d1",
     "langchain/stores/message/dynamodb",
     "langchain/stores/message/firestore",
@@ -143,12 +145,14 @@ exports.optionalImportEntrypoints = [
     "langchain/stores/message/upstash_redis",
     "langchain/stores/message/planetscale",
     "langchain/stores/message/xata",
+    "langchain/storage/convex",
     "langchain/storage/ioredis",
     "langchain/storage/vercel_kv",
     "langchain/storage/upstash_redis",
     "langchain/storage/file_system",
     "langchain/graphs/neo4j_graph",
     "langchain/hub",
+    "langchain/util/convex",
     "langchain/experimental/multimodal_embeddings/googlevertexai",
     "langchain/experimental/chat_models/anthropic_functions",
     "langchain/experimental/llms/bittensor",

package/dist/load/import_constants.js

@@ -38,6 +38,7 @@ export const optionalImportEntrypoints = [
     "langchain/prompts/load",
     "langchain/vectorstores/analyticdb",
     "langchain/vectorstores/cassandra",
+    "langchain/vectorstores/convex",
     "langchain/vectorstores/elasticsearch",
     "langchain/vectorstores/cloudflare_vectorize",
     "langchain/vectorstores/closevector/web",
@@ -130,6 +131,7 @@ export const optionalImportEntrypoints = [
     "langchain/cache/upstash_redis",
     "langchain/stores/doc/gcs",
     "langchain/stores/file/node",
+    "langchain/stores/message/convex",
     "langchain/stores/message/cloudflare_d1",
     "langchain/stores/message/dynamodb",
     "langchain/stores/message/firestore",
@@ -140,12 +142,14 @@ export const optionalImportEntrypoints = [
     "langchain/stores/message/upstash_redis",
     "langchain/stores/message/planetscale",
     "langchain/stores/message/xata",
+    "langchain/storage/convex",
     "langchain/storage/ioredis",
     "langchain/storage/vercel_kv",
     "langchain/storage/upstash_redis",
     "langchain/storage/file_system",
     "langchain/graphs/neo4j_graph",
     "langchain/hub",
+    "langchain/util/convex",
     "langchain/experimental/multimodal_embeddings/googlevertexai",
     "langchain/experimental/chat_models/anthropic_functions",
     "langchain/experimental/llms/bittensor",

package/dist/memory/index.cjs

@@ -1,11 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConversationSummaryBufferMemory = exports.CombinedMemory = exports.ENTITY_MEMORY_CONVERSATION_TEMPLATE = exports.EntityMemory = exports.VectorStoreRetrieverMemory = exports.MotorheadMemory = exports.ChatMessageHistory = exports.BaseChatMemory = exports.BufferWindowMemory = exports.BaseConversationSummaryMemory = exports.ConversationSummaryMemory = exports.getBufferString = exports.getInputValue = exports.BaseMemory = exports.BufferMemory = void 0;
+exports.ConversationSummaryBufferMemory = exports.CombinedMemory = exports.ENTITY_MEMORY_CONVERSATION_TEMPLATE = exports.EntityMemory = exports.VectorStoreRetrieverMemory = exports.MotorheadMemory = exports.ChatMessageHistory = exports.BaseChatMemory = exports.BufferWindowMemory = exports.BaseConversationSummaryMemory = exports.ConversationSummaryMemory = exports.getBufferString = exports.getOutputValue = exports.getInputValue = exports.BaseMemory = exports.BufferMemory = void 0;
 var buffer_memory_js_1 = require("./buffer_memory.cjs");
 Object.defineProperty(exports, "BufferMemory", { enumerable: true, get: function () { return buffer_memory_js_1.BufferMemory; } });
 var base_js_1 = require("./base.cjs");
 Object.defineProperty(exports, "BaseMemory", { enumerable: true, get: function () { return base_js_1.BaseMemory; } });
 Object.defineProperty(exports, "getInputValue", { enumerable: true, get: function () { return base_js_1.getInputValue; } });
+Object.defineProperty(exports, "getOutputValue", { enumerable: true, get: function () { return base_js_1.getOutputValue; } });
 Object.defineProperty(exports, "getBufferString", { enumerable: true, get: function () { return base_js_1.getBufferString; } });
 var summary_js_1 = require("./summary.cjs");
 Object.defineProperty(exports, "ConversationSummaryMemory", { enumerable: true, get: function () { return summary_js_1.ConversationSummaryMemory; } });

package/dist/memory/index.d.ts

@@ -1,5 +1,5 @@
 export { BufferMemory, type BufferMemoryInput } from "./buffer_memory.js";
-export { BaseMemory, getInputValue, getBufferString, type InputValues, type OutputValues, type MemoryVariables, } from "./base.js";
+export { BaseMemory, getInputValue, getOutputValue, getBufferString, type InputValues, type OutputValues, type MemoryVariables, } from "./base.js";
 export { ConversationSummaryMemory, type ConversationSummaryMemoryInput, BaseConversationSummaryMemory, type BaseConversationSummaryMemoryInput, } from "./summary.js";
 export { BufferWindowMemory, type BufferWindowMemoryInput, } from "./buffer_window_memory.js";
 export { BaseChatMemory, type BaseChatMemoryInput } from "./chat_memory.js";

package/dist/memory/index.js

@@ -1,5 +1,5 @@
 export { BufferMemory } from "./buffer_memory.js";
-export { BaseMemory, getInputValue, getBufferString, } from "./base.js";
+export { BaseMemory, getInputValue, getOutputValue, getBufferString, } from "./base.js";
 export { ConversationSummaryMemory, BaseConversationSummaryMemory, } from "./summary.js";
 export { BufferWindowMemory, } from "./buffer_window_memory.js";
 export { BaseChatMemory } from "./chat_memory.js";

package/dist/prompts/selectors/SemanticSimilarityExampleSelector.cjs

@@ -15,18 +15,12 @@ function sortedValues(values) {
 class SemanticSimilarityExampleSelector extends base_js_1.BaseExampleSelector {
     constructor(data) {
         super(data);
-        Object.defineProperty(this, "vectorStore", {
+        Object.defineProperty(this, "vectorStoreRetriever", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "k", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: 4
-        });
         Object.defineProperty(this, "exampleKeys", {
             enumerable: true,
             configurable: true,
@@ -39,17 +33,20 @@ class SemanticSimilarityExampleSelector extends base_js_1.BaseExampleSelector {
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "filter", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.vectorStore = data.vectorStore;
-        this.k = data.k ?? 4;
         this.exampleKeys = data.exampleKeys;
         this.inputKeys = data.inputKeys;
-        this.filter = data.filter;
+        if (data.vectorStore !== undefined) {
+            this.vectorStoreRetriever = data.vectorStore.asRetriever({
+                k: data.k ?? 4,
+                filter: data.filter,
+            });
+        }
+        else if (data.vectorStoreRetriever) {
+            this.vectorStoreRetriever = data.vectorStoreRetriever;
+        }
+        else {
+            throw new Error(`You must specify one of "vectorStore" and "vectorStoreRetriever".`);
+        }
     }
     /**
      * Method that adds a new example to the vectorStore. The example is
@@ -60,7 +57,7 @@ class SemanticSimilarityExampleSelector extends base_js_1.BaseExampleSelector {
     async addExample(example) {
         const inputKeys = this.inputKeys ?? Object.keys(example);
         const stringExample = sortedValues(inputKeys.reduce((acc, key) => ({ ...acc, [key]: example[key] }), {})).join(" ");
-        await this.vectorStore.addDocuments([
+        await this.vectorStoreRetriever.addDocuments([
             new document_js_1.Document({
                 pageContent: stringExample,
                 metadata: example,
@@ -77,7 +74,7 @@ class SemanticSimilarityExampleSelector extends base_js_1.BaseExampleSelector {
     async selectExamples(inputVariables) {
         const inputKeys = this.inputKeys ?? Object.keys(inputVariables);
         const query = sortedValues(inputKeys.reduce((acc, key) => ({ ...acc, [key]: inputVariables[key] }), {})).join(" ");
-        const exampleDocs = await this.vectorStore.similaritySearch(query, this.k, this.filter);
+        const exampleDocs = await this.vectorStoreRetriever.invoke(query);
         const examples = exampleDocs.map((doc) => doc.metadata);
         if (this.exampleKeys) {
             // If example keys are provided, filter examples to those keys.

package/dist/prompts/selectors/SemanticSimilarityExampleSelector.d.ts

@@ -1,28 +1,34 @@
 import { Embeddings } from "../../embeddings/base.js";
-import { VectorStore } from "../../vectorstores/base.js";
+import { VectorStore, VectorStoreRetriever } from "../../vectorstores/base.js";
 import { Example } from "../../schema/index.js";
 import { BaseExampleSelector } from "../base.js";
 /**
  * Interface for the input data of the SemanticSimilarityExampleSelector
  * class.
  */
-export interface SemanticSimilarityExampleSelectorInput<V extends VectorStore = VectorStore> {
+export type SemanticSimilarityExampleSelectorInput<V extends VectorStore = VectorStore> = {
     vectorStore: V;
     k?: number;
     filter?: V["FilterType"];
     exampleKeys?: string[];
     inputKeys?: string[];
-}
+    vectorStoreRetriever?: never;
+} | {
+    vectorStoreRetriever: VectorStoreRetriever<V>;
+    exampleKeys?: string[];
+    inputKeys?: string[];
+    vectorStore?: never;
+    k?: never;
+    filter?: never;
+};
 /**
  * Class that selects examples based on semantic similarity. It extends
  * the BaseExampleSelector class.
  */
 export declare class SemanticSimilarityExampleSelector<V extends VectorStore = VectorStore> extends BaseExampleSelector {
-    vectorStore: V;
-    k: number;
+    vectorStoreRetriever: VectorStoreRetriever<V>;
     exampleKeys?: string[];
     inputKeys?: string[];
-    filter?: V["FilterType"];
     constructor(data: SemanticSimilarityExampleSelectorInput<V>);
     /**
      * Method that adds a new example to the vectorStore. The example is

package/dist/prompts/selectors/SemanticSimilarityExampleSelector.js

@@ -12,18 +12,12 @@ function sortedValues(values) {
 export class SemanticSimilarityExampleSelector extends BaseExampleSelector {
     constructor(data) {
         super(data);
-        Object.defineProperty(this, "vectorStore", {
+        Object.defineProperty(this, "vectorStoreRetriever", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "k", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: 4
-        });
         Object.defineProperty(this, "exampleKeys", {
             enumerable: true,
             configurable: true,
@@ -36,17 +30,20 @@ export class SemanticSimilarityExampleSelector extends BaseExampleSelector {
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "filter", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.vectorStore = data.vectorStore;
-        this.k = data.k ?? 4;
         this.exampleKeys = data.exampleKeys;
         this.inputKeys = data.inputKeys;
-        this.filter = data.filter;
+        if (data.vectorStore !== undefined) {
+            this.vectorStoreRetriever = data.vectorStore.asRetriever({
+                k: data.k ?? 4,
+                filter: data.filter,
+            });
+        }
+        else if (data.vectorStoreRetriever) {
+            this.vectorStoreRetriever = data.vectorStoreRetriever;
+        }
+        else {
+            throw new Error(`You must specify one of "vectorStore" and "vectorStoreRetriever".`);
+        }
     }
     /**
      * Method that adds a new example to the vectorStore. The example is
@@ -57,7 +54,7 @@ export class SemanticSimilarityExampleSelector extends BaseExampleSelector {
     async addExample(example) {
         const inputKeys = this.inputKeys ?? Object.keys(example);
         const stringExample = sortedValues(inputKeys.reduce((acc, key) => ({ ...acc, [key]: example[key] }), {})).join(" ");
-        await this.vectorStore.addDocuments([
+        await this.vectorStoreRetriever.addDocuments([
             new Document({
                 pageContent: stringExample,
                 metadata: example,
@@ -74,7 +71,7 @@ export class SemanticSimilarityExampleSelector extends BaseExampleSelector {
     async selectExamples(inputVariables) {
         const inputKeys = this.inputKeys ?? Object.keys(inputVariables);
         const query = sortedValues(inputKeys.reduce((acc, key) => ({ ...acc, [key]: inputVariables[key] }), {})).join(" ");
-        const exampleDocs = await this.vectorStore.similaritySearch(query, this.k, this.filter);
+        const exampleDocs = await this.vectorStoreRetriever.invoke(query);
         const examples = exampleDocs.map((doc) => doc.metadata);
         if (this.exampleKeys) {
             // If example keys are provided, filter examples to those keys.

package/dist/storage/convex.cjs

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConvexKVStore = void 0;
+// eslint-disable-next-line import/no-extraneous-dependencies
+const server_1 = require("convex/server");
+const storage_js_1 = require("../schema/storage.cjs");
+/**
+ * Class that extends the BaseStore class to interact with a Convex
+ * database. It provides methods for getting, setting, and deleting key value pairs,
+ * as well as yielding keys from the database.
+ */
+class ConvexKVStore extends storage_js_1.BaseStore {
+    constructor(config) {
+        super(config);
+        Object.defineProperty(this, "lc_namespace", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: ["langchain", "storage", "convex"]
+        });
+        Object.defineProperty(this, "ctx", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "table", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "index", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "keyField", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "valueField", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "upsert", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "lookup", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "deleteMany", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.ctx = config.ctx;
+        this.table = config.table ?? "cache";
+        this.index = config.index ?? "byKey";
+        this.keyField = config.keyField ?? "key";
+        this.valueField = config.valueField ?? "value";
+        this.upsert =
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            config.upsert ?? (0, server_1.makeFunctionReference)("langchain/db:upsert");
+        this.lookup =
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            config.lookup ?? (0, server_1.makeFunctionReference)("langchain/db:lookup");
+        this.deleteMany =
+            config.deleteMany ??
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                (0, server_1.makeFunctionReference)("langchain/db:deleteMany");
+    }
+    /**
+     * Gets multiple keys from the Convex database.
+     * @param keys Array of keys to be retrieved.
+     * @returns An array of retrieved values.
+     */
+    async mget(keys) {
+        return (await Promise.all(keys.map(async (key) => {
+            const found = (await this.ctx.runQuery(this.lookup, {
+                table: this.table,
+                index: this.index,
+                keyField: this.keyField,
+                key,
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            }));
+            return found.length > 0 ? found[0][this.valueField] : undefined;
+        })));
+    }
+    /**
+     * Sets multiple keys in the Convex database.
+     * @param keyValuePairs Array of key-value pairs to be set.
+     * @returns Promise that resolves when all keys have been set.
+     */
+    async mset(keyValuePairs) {
+        // TODO: Remove chunking when Convex handles the concurrent requests correctly
+        const PAGE_SIZE = 16;
+        for (let i = 0; i < keyValuePairs.length; i += PAGE_SIZE) {
+            await Promise.all(keyValuePairs.slice(i, i + PAGE_SIZE).map(([key, value]) => this.ctx.runMutation(this.upsert, {
+                table: this.table,
+                index: this.index,
+                keyField: this.keyField,
+                key,
+                document: { [this.keyField]: key, [this.valueField]: value },
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            })));
+        }
+    }
+    /**
+     * Deletes multiple keys from the Convex database.
+     * @param keys Array of keys to be deleted.
+     * @returns Promise that resolves when all keys have been deleted.
+     */
+    async mdelete(keys) {
+        await Promise.all(keys.map((key) => this.ctx.runMutation(this.deleteMany, {
+            table: this.table,
+            index: this.index,
+            keyField: this.keyField,
+            key,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        })));
+    }
+    /**
+     * Yields keys from the Convex database.
+     * @param prefix Optional prefix to filter the keys.
+     * @returns An AsyncGenerator that yields keys from the Convex database.
+     */
+    // eslint-disable-next-line require-yield
+    async *yieldKeys(_prefix) {
+        throw new Error("yieldKeys not implemented yet for ConvexKVStore");
+    }
+}
+exports.ConvexKVStore = ConvexKVStore;

package/dist/storage/convex.d.ts

@@ -0,0 +1,85 @@
+import { FieldPaths, FunctionReference, GenericActionCtx, GenericDataModel, NamedTableInfo, TableNamesInDataModel, VectorIndexNames } from "convex/server";
+import { Value } from "convex/values";
+import { BaseStore } from "../schema/storage.js";
+/**
+ * Type that defines the config required to initialize the
+ * ConvexKVStore class. It includes the table name,
+ * index name, field name.
+ */
+export type ConvexKVStoreConfig<DataModel extends GenericDataModel, TableName extends TableNamesInDataModel<DataModel>, IndexName extends VectorIndexNames<NamedTableInfo<DataModel, TableName>>, KeyFieldName extends FieldPaths<NamedTableInfo<DataModel, TableName>>, ValueFieldName extends FieldPaths<NamedTableInfo<DataModel, TableName>>, UpsertMutation extends FunctionReference<"mutation", "internal", {
+    table: string;
+    document: object;
+}>, LookupQuery extends FunctionReference<"query", "internal", {
+    table: string;
+    index: string;
+    keyField: string;
+    key: string;
+}, object[]>, DeleteManyMutation extends FunctionReference<"mutation", "internal", {
+    table: string;
+    index: string;
+    keyField: string;
+    key: string;
+}>> = {
+    readonly ctx: GenericActionCtx<DataModel>;
+    readonly table?: TableName;
+    readonly index?: IndexName;
+    readonly keyField?: KeyFieldName;
+    readonly valueField?: ValueFieldName;
+    readonly upsert?: UpsertMutation;
+    readonly lookup?: LookupQuery;
+    readonly deleteMany?: DeleteManyMutation;
+};
+/**
+ * Class that extends the BaseStore class to interact with a Convex
+ * database. It provides methods for getting, setting, and deleting key value pairs,
+ * as well as yielding keys from the database.
+ */
+export declare class ConvexKVStore<T extends Value, DataModel extends GenericDataModel, TableName extends TableNamesInDataModel<DataModel>, IndexName extends VectorIndexNames<NamedTableInfo<DataModel, TableName>>, KeyFieldName extends FieldPaths<NamedTableInfo<DataModel, TableName>>, ValueFieldName extends FieldPaths<NamedTableInfo<DataModel, TableName>>, UpsertMutation extends FunctionReference<"mutation", "internal", {
+    table: string;
+    document: object;
+}>, LookupQuery extends FunctionReference<"query", "internal", {
+    table: string;
+    index: string;
+    keyField: string;
+    key: string;
+}, object[]>, DeleteManyMutation extends FunctionReference<"mutation", "internal", {
+    table: string;
+    index: string;
+    keyField: string;
+    key: string;
+}>> extends BaseStore<string, T> {
+    lc_namespace: string[];
+    private readonly ctx;
+    private readonly table;
+    private readonly index;
+    private readonly keyField;
+    private readonly valueField;
+    private readonly upsert;
+    private readonly lookup;
+    private readonly deleteMany;
+    constructor(config: ConvexKVStoreConfig<DataModel, TableName, IndexName, KeyFieldName, ValueFieldName, UpsertMutation, LookupQuery, DeleteManyMutation>);
+    /**
+     * Gets multiple keys from the Convex database.
+     * @param keys Array of keys to be retrieved.
+     * @returns An array of retrieved values.
+     */
+    mget(keys: string[]): Promise<(T | undefined)[]>;
+    /**
+     * Sets multiple keys in the Convex database.
+     * @param keyValuePairs Array of key-value pairs to be set.
+     * @returns Promise that resolves when all keys have been set.
+     */
+    mset(keyValuePairs: [string, T][]): Promise<void>;
+    /**
+     * Deletes multiple keys from the Convex database.
+     * @param keys Array of keys to be deleted.
+     * @returns Promise that resolves when all keys have been deleted.
+     */
+    mdelete(keys: string[]): Promise<void>;
+    /**
+     * Yields keys from the Convex database.
+     * @param prefix Optional prefix to filter the keys.
+     * @returns An AsyncGenerator that yields keys from the Convex database.
+     */
+    yieldKeys(_prefix?: string): AsyncGenerator<string>;
+}

package/dist/storage/convex.js

@@ -0,0 +1,141 @@
+// eslint-disable-next-line import/no-extraneous-dependencies
+import { makeFunctionReference, } from "convex/server";
+import { BaseStore } from "../schema/storage.js";
+/**
+ * Class that extends the BaseStore class to interact with a Convex
+ * database. It provides methods for getting, setting, and deleting key value pairs,
+ * as well as yielding keys from the database.
+ */
+export class ConvexKVStore extends BaseStore {
+    constructor(config) {
+        super(config);
+        Object.defineProperty(this, "lc_namespace", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: ["langchain", "storage", "convex"]
+        });
+        Object.defineProperty(this, "ctx", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "table", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "index", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "keyField", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "valueField", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "upsert", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "lookup", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "deleteMany", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.ctx = config.ctx;
+        this.table = config.table ?? "cache";
+        this.index = config.index ?? "byKey";
+        this.keyField = config.keyField ?? "key";
+        this.valueField = config.valueField ?? "value";
+        this.upsert =
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            config.upsert ?? makeFunctionReference("langchain/db:upsert");
+        this.lookup =
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            config.lookup ?? makeFunctionReference("langchain/db:lookup");
+        this.deleteMany =
+            config.deleteMany ??
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                makeFunctionReference("langchain/db:deleteMany");
+    }
+    /**
+     * Gets multiple keys from the Convex database.
+     * @param keys Array of keys to be retrieved.
+     * @returns An array of retrieved values.
+     */
+    async mget(keys) {
+        return (await Promise.all(keys.map(async (key) => {
+            const found = (await this.ctx.runQuery(this.lookup, {
+                table: this.table,
+                index: this.index,
+                keyField: this.keyField,
+                key,
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            }));
+            return found.length > 0 ? found[0][this.valueField] : undefined;
+        })));
+    }
+    /**
+     * Sets multiple keys in the Convex database.
+     * @param keyValuePairs Array of key-value pairs to be set.
+     * @returns Promise that resolves when all keys have been set.
+     */
+    async mset(keyValuePairs) {
+        // TODO: Remove chunking when Convex handles the concurrent requests correctly
+        const PAGE_SIZE = 16;
+        for (let i = 0; i < keyValuePairs.length; i += PAGE_SIZE) {
+            await Promise.all(keyValuePairs.slice(i, i + PAGE_SIZE).map(([key, value]) => this.ctx.runMutation(this.upsert, {
+                table: this.table,
+                index: this.index,
+                keyField: this.keyField,
+                key,
+                document: { [this.keyField]: key, [this.valueField]: value },
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            })));
+        }
+    }
+    /**
+     * Deletes multiple keys from the Convex database.
+     * @param keys Array of keys to be deleted.
+     * @returns Promise that resolves when all keys have been deleted.
+     */
+    async mdelete(keys) {
+        await Promise.all(keys.map((key) => this.ctx.runMutation(this.deleteMany, {
+            table: this.table,
+            index: this.index,
+            keyField: this.keyField,
+            key,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        })));
+    }
+    /**
+     * Yields keys from the Convex database.
+     * @param prefix Optional prefix to filter the keys.
+     * @returns An AsyncGenerator that yields keys from the Convex database.
+     */
+    // eslint-disable-next-line require-yield
+    async *yieldKeys(_prefix) {
+        throw new Error("yieldKeys not implemented yet for ConvexKVStore");
+    }
+}