langchain 0.0.145 → 0.0.146

package/dist/chains/api/api_chain.d.ts

@@ -4,7 +4,7 @@ import { LLMChain } from "../llm_chain.js";
 import { BaseLanguageModel } from "../../base_language/index.js";
 import { CallbackManagerForChainRun } from "../../callbacks/manager.js";
 import { ChainValues } from "../../schema/index.js";
-import { BasePromptTemplate } from "../../index.js";
+import { BasePromptTemplate } from "../../prompts/base.js";
 /**
  * Interface that extends ChainInputs and defines additional input
  * parameters specific to an APIChain.

package/dist/chains/openai_functions/extraction.d.ts

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { FunctionParameters } from "../../output_parsers/openai_functions.js";
 import { LLMChain } from "../llm_chain.js";
-import { BaseChatModel } from "../../chat_models/index.js";
+import { BaseChatModel } from "../../chat_models/base.js";
 import { BaseFunctionCallOptions } from "../../base_language/index.js";
 /**
  * Function that creates an extraction chain using the provided JSON schema.

package/dist/chains/openai_functions/openapi.d.ts

@@ -3,7 +3,7 @@ import { BaseChain } from "../base.js";
 import { LLMChainInput } from "../llm_chain.js";
 import { BasePromptTemplate } from "../../prompts/base.js";
 import { SequentialChain } from "../sequential_chain.js";
-import { BaseChatModel } from "../../chat_models/index.js";
+import { BaseChatModel } from "../../chat_models/base.js";
 import { BaseFunctionCallOptions } from "../../base_language/index.js";
 /**
  * Type representing the options for creating an OpenAPI chain.

package/dist/chains/openai_functions/structured_output.d.ts

@@ -7,7 +7,7 @@ import { BasePromptTemplate } from "../../prompts/index.js";
 import { BaseLLMOutputParser } from "../../schema/output_parser.js";
 import { OutputFunctionsParser } from "../../output_parsers/openai_functions.js";
 import { ChatGeneration } from "../../schema/index.js";
-import { BaseChatModel } from "../../chat_models/index.js";
+import { BaseChatModel } from "../../chat_models/base.js";
 import { BaseFunctionCallOptions } from "../../base_language/index.js";
 /**
  * Type representing the input for creating a structured output chain. It

package/dist/chains/openai_functions/tagging.d.ts

@@ -2,7 +2,7 @@ import { z } from "zod";
 import { PromptTemplate } from "../../prompts/prompt.js";
 import { FunctionParameters } from "../../output_parsers/openai_functions.js";
 import { LLMChain, LLMChainInput } from "../llm_chain.js";
-import { BaseChatModel } from "../../chat_models/index.js";
+import { BaseChatModel } from "../../chat_models/base.js";
 import { BaseFunctionCallOptions } from "../../base_language/index.js";
 /**
  * Type representing the options for creating a tagging chain.

package/dist/chat_models/anthropic.d.ts

@@ -103,9 +103,9 @@ export declare class ChatAnthropic<CallOptions extends BaseLanguageModelCallOpti
         model: (string & {}) | "claude-2" | "claude-instant-1";
         temperature?: number | undefined;
         top_p?: number | undefined;
+        top_k?: number | undefined;
         max_tokens_to_sample: number;
         stop_sequences?: string[] | undefined;
-        top_k?: number | undefined;
         model_name: string;
     };
     /**
@@ -117,9 +117,9 @@ export declare class ChatAnthropic<CallOptions extends BaseLanguageModelCallOpti
         model: (string & {}) | "claude-2" | "claude-instant-1";
         temperature?: number | undefined;
         top_p?: number | undefined;
+        top_k?: number | undefined;
         max_tokens_to_sample: number;
         stop_sequences?: string[] | undefined;
-        top_k?: number | undefined;
         model_name: string;
     };
     _streamResponseChunks(messages: BaseMessage[], options: this["ParsedCallOptions"], runManager?: CallbackManagerForLLMRun): AsyncGenerator<ChatGenerationChunk>;

package/dist/hub.cjs

@@ -3,11 +3,25 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.pull = exports.push = void 0;
 const langchainhub_1 = require("langchainhub");
 const index_js_1 = require("./load/index.cjs");
+/**
+ * Push a prompt to the hub.
+ * If the specified repo doesn't already exist, it will be created.
+ * @param repoFullName The full name of the repo.
+ * @param runnable The prompt to push.
+ * @param options
+ * @returns The URL of the newly pushed prompt in the hub.
+ */
 async function push(repoFullName, runnable, options) {
     const client = new langchainhub_1.Client(options);
     return client.push(repoFullName, JSON.stringify(runnable), options);
 }
 exports.push = push;
+/**
+ * Pull a prompt from the hub.
+ * @param ownerRepoCommit The name of the repo containing the prompt, as well as an optional commit hash separated by a slash.
+ * @param options
+ * @returns
+ */
 async function pull(ownerRepoCommit, options) {
     const client = new langchainhub_1.Client(options);
     const result = await client.pull(ownerRepoCommit);

package/dist/hub.d.ts

@@ -1,4 +1,18 @@
 import { ClientConfiguration, HubPushOptions } from "langchainhub";
 import { Runnable } from "./schema/runnable.js";
+/**
+ * Push a prompt to the hub.
+ * If the specified repo doesn't already exist, it will be created.
+ * @param repoFullName The full name of the repo.
+ * @param runnable The prompt to push.
+ * @param options
+ * @returns The URL of the newly pushed prompt in the hub.
+ */
 export declare function push(repoFullName: string, runnable: Runnable, options?: HubPushOptions & ClientConfiguration): Promise<string>;
+/**
+ * Pull a prompt from the hub.
+ * @param ownerRepoCommit The name of the repo containing the prompt, as well as an optional commit hash separated by a slash.
+ * @param options
+ * @returns
+ */
 export declare function pull<T extends Runnable>(ownerRepoCommit: string, options?: ClientConfiguration): Promise<T>;

package/dist/hub.js

@@ -1,9 +1,23 @@
 import { Client } from "langchainhub";
 import { load } from "./load/index.js";
+/**
+ * Push a prompt to the hub.
+ * If the specified repo doesn't already exist, it will be created.
+ * @param repoFullName The full name of the repo.
+ * @param runnable The prompt to push.
+ * @param options
+ * @returns The URL of the newly pushed prompt in the hub.
+ */
 export async function push(repoFullName, runnable, options) {
     const client = new Client(options);
     return client.push(repoFullName, JSON.stringify(runnable), options);
 }
+/**
+ * Pull a prompt from the hub.
+ * @param ownerRepoCommit The name of the repo containing the prompt, as well as an optional commit hash separated by a slash.
+ * @param options
+ * @returns
+ */
 export async function pull(ownerRepoCommit, options) {
     const client = new Client(options);
     const result = await client.pull(ownerRepoCommit);

package/dist/load/import_constants.cjs

@@ -55,6 +55,7 @@ exports.optionalImportEntrypoints = [
     "langchain/vectorstores/singlestore",
     "langchain/vectorstores/tigris",
     "langchain/vectorstores/usearch",
+    "langchain/vectorstores/voy",
     "langchain/vectorstores/zep",
     "langchain/memory/zep",
     "langchain/document_loaders/web/apify_dataset",

package/dist/load/import_constants.js

@@ -52,6 +52,7 @@ export const optionalImportEntrypoints = [
     "langchain/vectorstores/singlestore",
     "langchain/vectorstores/tigris",
     "langchain/vectorstores/usearch",
+    "langchain/vectorstores/voy",
     "langchain/vectorstores/zep",
     "langchain/memory/zep",
     "langchain/document_loaders/web/apify_dataset",

package/dist/schema/index.cjs

@@ -333,35 +333,18 @@ function coerceMessageLikeToMessage(messageLike) {
     else if (isBaseMessage(messageLike)) {
         return messageLike;
     }
-    let role;
-    let content;
-    let name;
-    if (Array.isArray(messageLike)) {
-        [role, content] = messageLike;
-        name = "";
-    }
-    else {
-        role = messageLike.role;
-        content = messageLike.content;
-        name = messageLike.name;
-    }
-    if (role === "human" || role === "user") {
+    const [type, content] = messageLike;
+    if (type === "human" || type === "user") {
         return new HumanMessage({ content });
     }
-    else if (role === "ai" || role === "assistant") {
+    else if (type === "ai" || type === "assistant") {
         return new AIMessage({ content });
     }
-    else if (role === "system") {
+    else if (type === "system") {
         return new SystemMessage({ content });
     }
-    else if (role === "function") {
-        if (!name) {
-            throw new Error(`Unable to coerce function message from object: no "name" field provided.`);
-        }
-        return new FunctionMessage({ content, name });
-    }
     else {
-        return new ChatMessage({ content, role });
+        throw new Error(`Unable to coerce message from array: only human, AI, or system message coercion is currently supported.`);
     }
 }
 exports.coerceMessageLikeToMessage = coerceMessageLikeToMessage;

package/dist/schema/index.d.ts

@@ -210,11 +210,7 @@ export declare class ChatMessage extends BaseMessage implements ChatMessageField
     _getType(): MessageType;
     static isInstance(message: BaseMessage): message is ChatMessage;
 }
-export type BaseMessageLike = BaseMessage | {
-    role: MessageType | "user" | "assistant" | (string & Record<never, never>);
-    content: string;
-    name?: string;
-} | [
+export type BaseMessageLike = BaseMessage | [
     MessageType | "user" | "assistant" | (string & Record<never, never>),
     string
 ] | string;

package/dist/schema/index.js

@@ -317,35 +317,18 @@ export function coerceMessageLikeToMessage(messageLike) {
     else if (isBaseMessage(messageLike)) {
         return messageLike;
     }
-    let role;
-    let content;
-    let name;
-    if (Array.isArray(messageLike)) {
-        [role, content] = messageLike;
-        name = "";
-    }
-    else {
-        role = messageLike.role;
-        content = messageLike.content;
-        name = messageLike.name;
-    }
-    if (role === "human" || role === "user") {
+    const [type, content] = messageLike;
+    if (type === "human" || type === "user") {
         return new HumanMessage({ content });
     }
-    else if (role === "ai" || role === "assistant") {
+    else if (type === "ai" || type === "assistant") {
         return new AIMessage({ content });
     }
-    else if (role === "system") {
+    else if (type === "system") {
         return new SystemMessage({ content });
     }
-    else if (role === "function") {
-        if (!name) {
-            throw new Error(`Unable to coerce function message from object: no "name" field provided.`);
-        }
-        return new FunctionMessage({ content, name });
-    }
     else {
-        return new ChatMessage({ content, role });
+        throw new Error(`Unable to coerce message from array: only human, AI, or system message coercion is currently supported.`);
     }
 }
 /**

package/dist/types/googlevertexai-types.d.ts

@@ -1,5 +1,5 @@
 import { GoogleAuthOptions } from "google-auth-library";
-import { BaseLLMParams } from "../llms/index.js";
+import { BaseLLMParams } from "../llms/base.js";
 export interface GoogleVertexAIConnectionParams {
     /** Hostname for the API call */
     endpoint?: string;

package/dist/vectorstores/voy.cjs

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VoyVectorStore = void 0;
+const base_js_1 = require("./base.cjs");
+const document_js_1 = require("../document.cjs");
+/**
+ * Class that extends `VectorStore`. It allows to perform similarity search using
+ * Voi similarity search engine. The class requires passing Voy Client as an input parameter.
+ */
+class VoyVectorStore extends base_js_1.VectorStore {
+    _vectorstoreType() {
+        return "voi";
+    }
+    constructor(client, embeddings) {
+        super(embeddings, {});
+        Object.defineProperty(this, "client", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "numDimensions", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "docstore", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        this.client = client;
+        this.embeddings = embeddings;
+    }
+    /**
+     * Adds documents to the Voy database. The documents are embedded using embeddings provided while instantiating the class.
+     * @param documents An array of `Document` instances associated with the vectors.
+     */
+    async addDocuments(documents) {
+        const texts = documents.map(({ pageContent }) => pageContent);
+        if (documents.length === 0) {
+            return;
+        }
+        const firstVector = (await this.embeddings.embedDocuments(texts.slice(0, 1)))[0];
+        if (this.numDimensions === null) {
+            this.numDimensions = firstVector.length;
+        }
+        else if (this.numDimensions !== firstVector.length) {
+            throw new Error(`Vectors must have the same length as the number of dimensions (${this.numDimensions})`);
+        }
+        const restResults = await this.embeddings.embedDocuments(texts.slice(1));
+        await this.addVectors([firstVector, ...restResults], documents);
+    }
+    /**
+     * Adds vectors to the Voy database. The vectors are associated with
+     * the provided documents.
+     * @param vectors An array of vectors to be added to the database.
+     * @param documents An array of `Document` instances associated with the vectors.
+     */
+    async addVectors(vectors, documents) {
+        if (vectors.length === 0) {
+            return;
+        }
+        if (this.numDimensions === null) {
+            this.numDimensions = vectors[0].length;
+        }
+        if (vectors.length !== documents.length) {
+            throw new Error(`Vectors and metadata must have the same length`);
+        }
+        if (!vectors.every((v) => v.length === this.numDimensions)) {
+            throw new Error(`Vectors must have the same length as the number of dimensions (${this.numDimensions})`);
+        }
+        vectors.forEach((item, idx) => {
+            const doc = documents[idx];
+            this.docstore.push({ embeddings: item, document: doc });
+        });
+        const embeddings = this.docstore.map((item, idx) => ({
+            id: String(idx),
+            embeddings: item.embeddings,
+            title: "",
+            url: "",
+        }));
+        this.client.index({ embeddings });
+    }
+    /**
+     * Searches for vectors in the Voy database that are similar to the
+     * provided query vector.
+     * @param query The query vector.
+     * @param k The number of similar vectors to return.
+     * @returns A promise that resolves with an array of tuples, each containing a `Document` instance and a similarity score.
+     */
+    async similaritySearchVectorWithScore(query, k) {
+        if (this.numDimensions === null) {
+            throw new Error("There aren't any elements in the index yet.");
+        }
+        if (query.length !== this.numDimensions) {
+            throw new Error(`Query vector must have the same length as the number of dimensions (${this.numDimensions})`);
+        }
+        const itemsToQuery = Math.min(this.docstore.length, k);
+        if (itemsToQuery > this.docstore.length) {
+            console.warn(`k (${k}) is greater than the number of elements in the index (${this.docstore.length}), setting k to ${itemsToQuery}`);
+        }
+        const results = this.client.search(new Float32Array(query), itemsToQuery);
+        return results.neighbors.map(({ id }, idx) => [this.docstore[parseInt(id, 10)].document, idx]);
+    }
+    /**
+     * Method to delete data from the Voy index. It can delete data based
+     * on specific IDs or a filter.
+     * @param params Object that includes either an array of IDs or a filter for the data to be deleted.
+     * @returns Promise that resolves when the deletion is complete.
+     */
+    async delete(params) {
+        if (params.deleteAll === true) {
+            await this.client.clear();
+        }
+        else {
+            throw new Error(`You must provide a "deleteAll" parameter.`);
+        }
+    }
+    /**
+     * Creates a new `VoyVectorStore` instance from an array of text strings. The text
+     * strings are converted to `Document` instances and added to the Voy
+     * database.
+     * @param texts An array of text strings.
+     * @param metadatas An array of metadata objects or a single metadata object. If an array is provided, it must have the same length as the `texts` array.
+     * @param embeddings An `Embeddings` instance used to generate embeddings for the documents.
+     * @param client An instance of Voy client to use in the underlying operations.
+     * @returns A promise that resolves with a new `VoyVectorStore` instance.
+     */
+    static async fromTexts(texts, metadatas, embeddings, client) {
+        const docs = [];
+        for (let i = 0; i < texts.length; i += 1) {
+            const metadata = Array.isArray(metadatas) ? metadatas[i] : metadatas;
+            const newDoc = new document_js_1.Document({
+                pageContent: texts[i],
+                metadata,
+            });
+            docs.push(newDoc);
+        }
+        return VoyVectorStore.fromDocuments(docs, embeddings, client);
+    }
+    /**
+     * Creates a new `VoyVectorStore` instance from an array of `Document` instances.
+     * The documents are added to the Voy database.
+     * @param docs An array of `Document` instances.
+     * @param embeddings An `Embeddings` instance used to generate embeddings for the documents.
+     * @param client An instance of Voy client to use in the underlying operations.
+     * @returns A promise that resolves with a new `VoyVectorStore` instance.
+     */
+    static async fromDocuments(docs, embeddings, client) {
+        const instance = new VoyVectorStore(client, embeddings);
+        await instance.addDocuments(docs);
+        return instance;
+    }
+}
+exports.VoyVectorStore = VoyVectorStore;

package/dist/vectorstores/voy.d.ts

@@ -0,0 +1,73 @@
+import type { Voy as VoyOriginClient } from "voy-search";
+import { Embeddings } from "../embeddings/base.js";
+import { VectorStore } from "./base.js";
+import { Document } from "../document.js";
+export type VoyClient = Omit<VoyOriginClient, "remove" | "size" | "serialize" | "free">;
+/**
+ * Internal interface for storing documents mappings.
+ */
+interface InternalDoc {
+    embeddings: number[];
+    document: Document;
+}
+/**
+ * Class that extends `VectorStore`. It allows to perform similarity search using
+ * Voi similarity search engine. The class requires passing Voy Client as an input parameter.
+ */
+export declare class VoyVectorStore extends VectorStore {
+    client: VoyClient;
+    numDimensions: number | null;
+    docstore: InternalDoc[];
+    _vectorstoreType(): string;
+    constructor(client: VoyClient, embeddings: Embeddings);
+    /**
+     * Adds documents to the Voy database. The documents are embedded using embeddings provided while instantiating the class.
+     * @param documents An array of `Document` instances associated with the vectors.
+     */
+    addDocuments(documents: Document[]): Promise<void>;
+    /**
+     * Adds vectors to the Voy database. The vectors are associated with
+     * the provided documents.
+     * @param vectors An array of vectors to be added to the database.
+     * @param documents An array of `Document` instances associated with the vectors.
+     */
+    addVectors(vectors: number[][], documents: Document[]): Promise<void>;
+    /**
+     * Searches for vectors in the Voy database that are similar to the
+     * provided query vector.
+     * @param query The query vector.
+     * @param k The number of similar vectors to return.
+     * @returns A promise that resolves with an array of tuples, each containing a `Document` instance and a similarity score.
+     */
+    similaritySearchVectorWithScore(query: number[], k: number): Promise<[Document<Record<string, any>>, number][]>;
+    /**
+     * Method to delete data from the Voy index. It can delete data based
+     * on specific IDs or a filter.
+     * @param params Object that includes either an array of IDs or a filter for the data to be deleted.
+     * @returns Promise that resolves when the deletion is complete.
+     */
+    delete(params: {
+        deleteAll?: boolean;
+    }): Promise<void>;
+    /**
+     * Creates a new `VoyVectorStore` instance from an array of text strings. The text
+     * strings are converted to `Document` instances and added to the Voy
+     * database.
+     * @param texts An array of text strings.
+     * @param metadatas An array of metadata objects or a single metadata object. If an array is provided, it must have the same length as the `texts` array.
+     * @param embeddings An `Embeddings` instance used to generate embeddings for the documents.
+     * @param client An instance of Voy client to use in the underlying operations.
+     * @returns A promise that resolves with a new `VoyVectorStore` instance.
+     */
+    static fromTexts(texts: string[], metadatas: object[] | object, embeddings: Embeddings, client: VoyClient): Promise<VoyVectorStore>;
+    /**
+     * Creates a new `VoyVectorStore` instance from an array of `Document` instances.
+     * The documents are added to the Voy database.
+     * @param docs An array of `Document` instances.
+     * @param embeddings An `Embeddings` instance used to generate embeddings for the documents.
+     * @param client An instance of Voy client to use in the underlying operations.
+     * @returns A promise that resolves with a new `VoyVectorStore` instance.
+     */
+    static fromDocuments(docs: Document[], embeddings: Embeddings, client: VoyClient): Promise<VoyVectorStore>;
+}
+export {};

package/dist/vectorstores/voy.js

@@ -0,0 +1,154 @@
+import { VectorStore } from "./base.js";
+import { Document } from "../document.js";
+/**
+ * Class that extends `VectorStore`. It allows to perform similarity search using
+ * Voi similarity search engine. The class requires passing Voy Client as an input parameter.
+ */
+export class VoyVectorStore extends VectorStore {
+    _vectorstoreType() {
+        return "voi";
+    }
+    constructor(client, embeddings) {
+        super(embeddings, {});
+        Object.defineProperty(this, "client", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "numDimensions", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "docstore", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        this.client = client;
+        this.embeddings = embeddings;
+    }
+    /**
+     * Adds documents to the Voy database. The documents are embedded using embeddings provided while instantiating the class.
+     * @param documents An array of `Document` instances associated with the vectors.
+     */
+    async addDocuments(documents) {
+        const texts = documents.map(({ pageContent }) => pageContent);
+        if (documents.length === 0) {
+            return;
+        }
+        const firstVector = (await this.embeddings.embedDocuments(texts.slice(0, 1)))[0];
+        if (this.numDimensions === null) {
+            this.numDimensions = firstVector.length;
+        }
+        else if (this.numDimensions !== firstVector.length) {
+            throw new Error(`Vectors must have the same length as the number of dimensions (${this.numDimensions})`);
+        }
+        const restResults = await this.embeddings.embedDocuments(texts.slice(1));
+        await this.addVectors([firstVector, ...restResults], documents);
+    }
+    /**
+     * Adds vectors to the Voy database. The vectors are associated with
+     * the provided documents.
+     * @param vectors An array of vectors to be added to the database.
+     * @param documents An array of `Document` instances associated with the vectors.
+     */
+    async addVectors(vectors, documents) {
+        if (vectors.length === 0) {
+            return;
+        }
+        if (this.numDimensions === null) {
+            this.numDimensions = vectors[0].length;
+        }
+        if (vectors.length !== documents.length) {
+            throw new Error(`Vectors and metadata must have the same length`);
+        }
+        if (!vectors.every((v) => v.length === this.numDimensions)) {
+            throw new Error(`Vectors must have the same length as the number of dimensions (${this.numDimensions})`);
+        }
+        vectors.forEach((item, idx) => {
+            const doc = documents[idx];
+            this.docstore.push({ embeddings: item, document: doc });
+        });
+        const embeddings = this.docstore.map((item, idx) => ({
+            id: String(idx),
+            embeddings: item.embeddings,
+            title: "",
+            url: "",
+        }));
+        this.client.index({ embeddings });
+    }
+    /**
+     * Searches for vectors in the Voy database that are similar to the
+     * provided query vector.
+     * @param query The query vector.
+     * @param k The number of similar vectors to return.
+     * @returns A promise that resolves with an array of tuples, each containing a `Document` instance and a similarity score.
+     */
+    async similaritySearchVectorWithScore(query, k) {
+        if (this.numDimensions === null) {
+            throw new Error("There aren't any elements in the index yet.");
+        }
+        if (query.length !== this.numDimensions) {
+            throw new Error(`Query vector must have the same length as the number of dimensions (${this.numDimensions})`);
+        }
+        const itemsToQuery = Math.min(this.docstore.length, k);
+        if (itemsToQuery > this.docstore.length) {
+            console.warn(`k (${k}) is greater than the number of elements in the index (${this.docstore.length}), setting k to ${itemsToQuery}`);
+        }
+        const results = this.client.search(new Float32Array(query), itemsToQuery);
+        return results.neighbors.map(({ id }, idx) => [this.docstore[parseInt(id, 10)].document, idx]);
+    }
+    /**
+     * Method to delete data from the Voy index. It can delete data based
+     * on specific IDs or a filter.
+     * @param params Object that includes either an array of IDs or a filter for the data to be deleted.
+     * @returns Promise that resolves when the deletion is complete.
+     */
+    async delete(params) {
+        if (params.deleteAll === true) {
+            await this.client.clear();
+        }
+        else {
+            throw new Error(`You must provide a "deleteAll" parameter.`);
+        }
+    }
+    /**
+     * Creates a new `VoyVectorStore` instance from an array of text strings. The text
+     * strings are converted to `Document` instances and added to the Voy
+     * database.
+     * @param texts An array of text strings.
+     * @param metadatas An array of metadata objects or a single metadata object. If an array is provided, it must have the same length as the `texts` array.
+     * @param embeddings An `Embeddings` instance used to generate embeddings for the documents.
+     * @param client An instance of Voy client to use in the underlying operations.
+     * @returns A promise that resolves with a new `VoyVectorStore` instance.
+     */
+    static async fromTexts(texts, metadatas, embeddings, client) {
+        const docs = [];
+        for (let i = 0; i < texts.length; i += 1) {
+            const metadata = Array.isArray(metadatas) ? metadatas[i] : metadatas;
+            const newDoc = new Document({
+                pageContent: texts[i],
+                metadata,
+            });
+            docs.push(newDoc);
+        }
+        return VoyVectorStore.fromDocuments(docs, embeddings, client);
+    }
+    /**
+     * Creates a new `VoyVectorStore` instance from an array of `Document` instances.
+     * The documents are added to the Voy database.
+     * @param docs An array of `Document` instances.
+     * @param embeddings An `Embeddings` instance used to generate embeddings for the documents.
+     * @param client An instance of Voy client to use in the underlying operations.
+     * @returns A promise that resolves with a new `VoyVectorStore` instance.
+     */
+    static async fromDocuments(docs, embeddings, client) {
+        const instance = new VoyVectorStore(client, embeddings);
+        await instance.addDocuments(docs);
+        return instance;
+    }
+}