langchain 0.0.174 → 0.0.176

package/dist/llms/googlevertexai/common.cjs

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseGoogleVertexAI = void 0;
 const base_js_1 = require("../base.cjs");
+const index_js_1 = require("../../schema/index.cjs");
 /**
  * Base class for Google Vertex AI LLMs.
  * Implemented subclasses must provide a GoogleVertexAILLMConnection
@@ -57,6 +58,12 @@ class BaseGoogleVertexAI extends base_js_1.BaseLLM {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "streamedConnection", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.model = fields?.model ?? this.model;
         // Change the defaults for code models
         if (this.model.startsWith("code-gecko")) {
@@ -73,26 +80,37 @@ class BaseGoogleVertexAI extends base_js_1.BaseLLM {
     _llmType() {
         return "vertexai";
     }
+    async *_streamResponseChunks(_input, _options, _runManager) {
+        // Make the call as a streaming request
+        const instance = this.formatInstance(_input);
+        const parameters = this.formatParameters();
+        const result = await this.streamedConnection.request([instance], parameters, _options);
+        // Get the streaming parser of the response
+        const stream = result.data;
+        // Loop until the end of the stream
+        // During the loop, yield each time we get a chunk from the streaming parser
+        // that is either available or added to the queue
+        while (!stream.streamDone) {
+            const output = await stream.nextChunk();
+            const chunk = output !== null
+                ? new index_js_1.GenerationChunk(this.extractGenerationFromPrediction(output.outputs[0]))
+                : new index_js_1.GenerationChunk({
+                    text: "",
+                    generationInfo: { finishReason: "stop" },
+                });
+            yield chunk;
+        }
+    }
     async _generate(prompts, options) {
         const generations = await Promise.all(prompts.map((prompt) => this._generatePrompt(prompt, options)));
         return { generations };
     }
     async _generatePrompt(prompt, options) {
         const instance = this.formatInstance(prompt);
-        const parameters = {
-            temperature: this.temperature,
-            topK: this.topK,
-            topP: this.topP,
-            maxOutputTokens: this.maxOutputTokens,
-        };
+        const parameters = this.formatParameters();
         const result = await this.connection.request([instance], parameters, options);
         const prediction = this.extractPredictionFromResponse(result);
-        return [
-            {
-                text: prediction.content,
-                generationInfo: prediction,
-            },
-        ];
+        return [this.extractGenerationFromPrediction(prediction)];
     }
     /**
      * Formats the input instance as a text instance for the Google Vertex AI
@@ -123,13 +141,28 @@ class BaseGoogleVertexAI extends base_js_1.BaseLLM {
             ? this.formatInstanceCode(prompt)
             : this.formatInstanceText(prompt);
     }
+    formatParameters() {
+        return {
+            temperature: this.temperature,
+            topK: this.topK,
+            topP: this.topP,
+            maxOutputTokens: this.maxOutputTokens,
+        };
+    }
     /**
      * Extracts the prediction from the API response.
      * @param result The API response from which to extract the prediction.
      * @returns A TextPrediction object representing the extracted prediction.
      */
     extractPredictionFromResponse(result) {
-        return result?.data?.predictions[0];
+        return result?.data
+            ?.predictions[0];
+    }
+    extractGenerationFromPrediction(prediction) {
+        return {
+            text: prediction.content,
+            generationInfo: prediction,
+        };
     }
 }
 exports.BaseGoogleVertexAI = BaseGoogleVertexAI;

package/dist/llms/googlevertexai/common.d.ts

@@ -1,8 +1,9 @@
 import { BaseLLM } from "../base.js";
-import { Generation, LLMResult } from "../../schema/index.js";
-import { GoogleVertexAILLMConnection } from "../../util/googlevertexai-connection.js";
-import { GoogleVertexAIBaseLLMInput, GoogleVertexAIBasePrediction, GoogleVertexAILLMResponse } from "../../types/googlevertexai-types.js";
+import { Generation, GenerationChunk, LLMResult } from "../../schema/index.js";
+import { GoogleVertexAILLMConnection, GoogleVertexAILLMResponse } from "../../util/googlevertexai-connection.js";
+import { GoogleVertexAIBaseLLMInput, GoogleVertexAIBasePrediction, GoogleVertexAIModelParams } from "../../types/googlevertexai-types.js";
 import { BaseLanguageModelCallOptions } from "../../base_language/index.js";
+import { CallbackManagerForLLMRun } from "../../callbacks/index.js";
 /**
  * Interface representing the instance of text input to the Google Vertex
  * AI model.
@@ -41,9 +42,11 @@ export declare class BaseGoogleVertexAI<AuthOptions> extends BaseLLM implements
     topP: number;
     topK: number;
     protected connection: GoogleVertexAILLMConnection<BaseLanguageModelCallOptions, GoogleVertexAILLMInstance, TextPrediction, AuthOptions>;
+    protected streamedConnection: GoogleVertexAILLMConnection<BaseLanguageModelCallOptions, GoogleVertexAILLMInstance, TextPrediction, AuthOptions>;
     get lc_aliases(): Record<string, string>;
     constructor(fields?: GoogleVertexAIBaseLLMInput<AuthOptions>);
     _llmType(): string;
+    _streamResponseChunks(_input: string, _options: this["ParsedCallOptions"], _runManager?: CallbackManagerForLLMRun): AsyncGenerator<GenerationChunk>;
     _generate(prompts: string[], options: this["ParsedCallOptions"]): Promise<LLMResult>;
     _generatePrompt(prompt: string, options: this["ParsedCallOptions"]): Promise<Generation[]>;
     /**
@@ -67,11 +70,13 @@ export declare class BaseGoogleVertexAI<AuthOptions> extends BaseLLM implements
      * @returns A GoogleVertexAILLMInstance object representing the formatted instance.
      */
     formatInstance(prompt: string): GoogleVertexAILLMInstance;
+    formatParameters(): GoogleVertexAIModelParams;
     /**
      * Extracts the prediction from the API response.
      * @param result The API response from which to extract the prediction.
      * @returns A TextPrediction object representing the extracted prediction.
      */
     extractPredictionFromResponse(result: GoogleVertexAILLMResponse<TextPrediction>): TextPrediction;
+    extractGenerationFromPrediction(prediction: TextPrediction): Generation;
 }
 export {};

package/dist/llms/googlevertexai/common.js

@@ -1,4 +1,5 @@
 import { BaseLLM } from "../base.js";
+import { GenerationChunk } from "../../schema/index.js";
 /**
  * Base class for Google Vertex AI LLMs.
  * Implemented subclasses must provide a GoogleVertexAILLMConnection
@@ -54,6 +55,12 @@ export class BaseGoogleVertexAI extends BaseLLM {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "streamedConnection", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.model = fields?.model ?? this.model;
         // Change the defaults for code models
         if (this.model.startsWith("code-gecko")) {
@@ -70,26 +77,37 @@ export class BaseGoogleVertexAI extends BaseLLM {
     _llmType() {
         return "vertexai";
     }
+    async *_streamResponseChunks(_input, _options, _runManager) {
+        // Make the call as a streaming request
+        const instance = this.formatInstance(_input);
+        const parameters = this.formatParameters();
+        const result = await this.streamedConnection.request([instance], parameters, _options);
+        // Get the streaming parser of the response
+        const stream = result.data;
+        // Loop until the end of the stream
+        // During the loop, yield each time we get a chunk from the streaming parser
+        // that is either available or added to the queue
+        while (!stream.streamDone) {
+            const output = await stream.nextChunk();
+            const chunk = output !== null
+                ? new GenerationChunk(this.extractGenerationFromPrediction(output.outputs[0]))
+                : new GenerationChunk({
+                    text: "",
+                    generationInfo: { finishReason: "stop" },
+                });
+            yield chunk;
+        }
+    }
     async _generate(prompts, options) {
         const generations = await Promise.all(prompts.map((prompt) => this._generatePrompt(prompt, options)));
         return { generations };
     }
     async _generatePrompt(prompt, options) {
         const instance = this.formatInstance(prompt);
-        const parameters = {
-            temperature: this.temperature,
-            topK: this.topK,
-            topP: this.topP,
-            maxOutputTokens: this.maxOutputTokens,
-        };
+        const parameters = this.formatParameters();
         const result = await this.connection.request([instance], parameters, options);
         const prediction = this.extractPredictionFromResponse(result);
-        return [
-            {
-                text: prediction.content,
-                generationInfo: prediction,
-            },
-        ];
+        return [this.extractGenerationFromPrediction(prediction)];
     }
     /**
      * Formats the input instance as a text instance for the Google Vertex AI
@@ -120,12 +138,27 @@ export class BaseGoogleVertexAI extends BaseLLM {
             ? this.formatInstanceCode(prompt)
             : this.formatInstanceText(prompt);
     }
+    formatParameters() {
+        return {
+            temperature: this.temperature,
+            topK: this.topK,
+            topP: this.topP,
+            maxOutputTokens: this.maxOutputTokens,
+        };
+    }
     /**
      * Extracts the prediction from the API response.
      * @param result The API response from which to extract the prediction.
      * @returns A TextPrediction object representing the extracted prediction.
      */
     extractPredictionFromResponse(result) {
-        return result?.data?.predictions[0];
+        return result?.data
+            ?.predictions[0];
+    }
+    extractGenerationFromPrediction(prediction) {
+        return {
+            text: prediction.content,
+            generationInfo: prediction,
+        };
     }
 }

package/dist/llms/googlevertexai/index.cjs

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GoogleVertexAI = void 0;
-const google_auth_library_1 = require("google-auth-library");
 const googlevertexai_connection_js_1 = require("../../util/googlevertexai-connection.cjs");
 const common_js_1 = require("./common.cjs");
+const googlevertexai_gauth_js_1 = require("../../util/googlevertexai-gauth.cjs");
 /**
  * Enables calls to the Google Cloud's Vertex AI API to access
  * Large Language Models.
@@ -24,11 +24,12 @@ class GoogleVertexAI extends common_js_1.BaseGoogleVertexAI {
     }
     constructor(fields) {
         super(fields);
-        const client = new google_auth_library_1.GoogleAuth({
+        const client = new googlevertexai_gauth_js_1.GAuthClient({
             scopes: "https://www.googleapis.com/auth/cloud-platform",
             ...fields?.authOptions,
         });
-        this.connection = new googlevertexai_connection_js_1.GoogleVertexAILLMConnection({ ...fields, ...this }, this.caller, client);
+        this.connection = new googlevertexai_connection_js_1.GoogleVertexAILLMConnection({ ...fields, ...this }, this.caller, client, false);
+        this.streamedConnection = new googlevertexai_connection_js_1.GoogleVertexAILLMConnection({ ...fields, ...this }, this.caller, client, true);
     }
 }
 exports.GoogleVertexAI = GoogleVertexAI;

package/dist/llms/googlevertexai/index.js

@@ -1,6 +1,6 @@
-import { GoogleAuth } from "google-auth-library";
 import { GoogleVertexAILLMConnection } from "../../util/googlevertexai-connection.js";
 import { BaseGoogleVertexAI } from "./common.js";
+import { GAuthClient } from "../../util/googlevertexai-gauth.js";
 /**
  * Enables calls to the Google Cloud's Vertex AI API to access
  * Large Language Models.
@@ -21,10 +21,11 @@ export class GoogleVertexAI extends BaseGoogleVertexAI {
     }
     constructor(fields) {
         super(fields);
-        const client = new GoogleAuth({
+        const client = new GAuthClient({
             scopes: "https://www.googleapis.com/auth/cloud-platform",
             ...fields?.authOptions,
         });
-        this.connection = new GoogleVertexAILLMConnection({ ...fields, ...this }, this.caller, client);
+        this.connection = new GoogleVertexAILLMConnection({ ...fields, ...this }, this.caller, client, false);
+        this.streamedConnection = new GoogleVertexAILLMConnection({ ...fields, ...this }, this.caller, client, true);
     }
 }

package/dist/llms/googlevertexai/web.cjs

@@ -25,7 +25,8 @@ class GoogleVertexAI extends common_js_1.BaseGoogleVertexAI {
     constructor(fields) {
         super(fields);
         const client = new googlevertexai_webauth_js_1.WebGoogleAuth(fields?.authOptions);
-        this.connection = new googlevertexai_connection_js_1.GoogleVertexAILLMConnection({ ...fields, ...this }, this.caller, client);
+        this.connection = new googlevertexai_connection_js_1.GoogleVertexAILLMConnection({ ...fields, ...this }, this.caller, client, false);
+        this.streamedConnection = new googlevertexai_connection_js_1.GoogleVertexAILLMConnection({ ...fields, ...this }, this.caller, client, true);
     }
 }
 exports.GoogleVertexAI = GoogleVertexAI;

package/dist/llms/googlevertexai/web.js

@@ -22,6 +22,7 @@ export class GoogleVertexAI extends BaseGoogleVertexAI {
     constructor(fields) {
         super(fields);
         const client = new WebGoogleAuth(fields?.authOptions);
-        this.connection = new GoogleVertexAILLMConnection({ ...fields, ...this }, this.caller, client);
+        this.connection = new GoogleVertexAILLMConnection({ ...fields, ...this }, this.caller, client, false);
+        this.streamedConnection = new GoogleVertexAILLMConnection({ ...fields, ...this }, this.caller, client, true);
     }
 }

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/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>;
+}