@langchain/core 0.2.18-rc.0 → 0.2.19

package/dist/messages/tool.js

@@ -1,4 +1,4 @@
-import { BaseMessage, BaseMessageChunk, mergeContent, _mergeDicts, _mergeObj, } from "./base.js";
+import { BaseMessage, BaseMessageChunk, mergeContent, _mergeDicts, _mergeObj, _mergeStatus, } from "./base.js";
 /**
  * Represents a tool message in a conversation.
  */
@@ -16,6 +16,16 @@ export class ToolMessage extends BaseMessage {
             fields = { content: fields, name, tool_call_id: tool_call_id };
         }
         super(fields);
+        /**
+         * Status of the tool invocation.
+         * @version 0.2.19
+         */
+        Object.defineProperty(this, "status", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "tool_call_id", {
             enumerable: true,
             configurable: true,
@@ -38,6 +48,7 @@ export class ToolMessage extends BaseMessage {
         });
         this.tool_call_id = fields.tool_call_id;
         this.artifact = fields.artifact;
+        this.status = fields.status;
     }
     _getType() {
         return "tool";
@@ -66,6 +77,16 @@ export class ToolMessageChunk extends BaseMessageChunk {
             writable: true,
             value: void 0
         });
+        /**
+         * Status of the tool invocation.
+         * @version 0.2.19
+         */
+        Object.defineProperty(this, "status", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         /**
          * Artifact of the Tool execution which is not meant to be sent to the model.
          *
@@ -82,6 +103,7 @@ export class ToolMessageChunk extends BaseMessageChunk {
         });
         this.tool_call_id = fields.tool_call_id;
         this.artifact = fields.artifact;
+        this.status = fields.status;
     }
     static lc_name() {
         return "ToolMessageChunk";
@@ -97,6 +119,7 @@ export class ToolMessageChunk extends BaseMessageChunk {
             artifact: _mergeObj(this.artifact, chunk.artifact),
             tool_call_id: this.tool_call_id,
             id: this.id ?? chunk.id,
+            status: _mergeStatus(this.status, chunk.status),
         });
     }
     get _printableFields() {

package/dist/messages/utils.cjs

@@ -121,7 +121,7 @@ function mapStoredMessageToChatMessage(message) {
                 throw new Error("Tool call ID must be defined for tool messages");
             }
             return new tool_js_1.ToolMessage(storedMessage.data);
-        case "chat": {
+        case "generic": {
             if (storedMessage.data.role === undefined) {
                 throw new Error("Role must be defined for chat messages");
             }

package/dist/messages/utils.js

@@ -116,7 +116,7 @@ export function mapStoredMessageToChatMessage(message) {
                 throw new Error("Tool call ID must be defined for tool messages");
             }
             return new ToolMessage(storedMessage.data);
-        case "chat": {
+        case "generic": {
             if (storedMessage.data.role === undefined) {
                 throw new Error("Role must be defined for chat messages");
             }

package/dist/output_parsers/string.cjs

@@ -62,6 +62,7 @@ class StringOutputParser extends transform_js_1.BaseTransformOutputParser {
     _messageContentComplexToString(content) {
         switch (content.type) {
             case "text":
+            case "text_delta":
                 if ("text" in content) {
                     // Type guard for MessageContentText
                     return this._textContentToString(content);

package/dist/output_parsers/string.js

@@ -59,6 +59,7 @@ export class StringOutputParser extends BaseTransformOutputParser {
     _messageContentComplexToString(content) {
         switch (content.type) {
             case "text":
+            case "text_delta":
                 if ("text" in content) {
                     // Type guard for MessageContentText
                     return this._textContentToString(content);

package/dist/runnables/base.cjs

@@ -834,9 +834,7 @@ class RunnableBinding extends Runnable {
     async stream(input, options) {
         return this.bound.stream(input, await this._mergeConfig((0, config_js_1.ensureConfig)(options), this.kwargs));
     }
-    async *transform(
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    generator, options) {
+    async *transform(generator, options) {
         yield* this.bound.transform(generator, await this._mergeConfig((0, config_js_1.ensureConfig)(options), this.kwargs));
     }
     streamEvents(input, options, streamOptions) {

package/dist/runnables/base.js

@@ -826,9 +826,7 @@ export class RunnableBinding extends Runnable {
     async stream(input, options) {
         return this.bound.stream(input, await this._mergeConfig(ensureConfig(options), this.kwargs));
     }
-    async *transform(
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    generator, options) {
+    async *transform(generator, options) {
         yield* this.bound.transform(generator, await this._mergeConfig(ensureConfig(options), this.kwargs));
     }
     streamEvents(input, options, streamOptions) {

package/dist/runnables/remote.cjs

@@ -46,7 +46,7 @@ function revive(obj) {
                     content: obj.content,
                 });
             }
-            if (obj.type === "ChatMessage" || obj.type === "chat") {
+            if (obj.type === "ChatMessage" || obj.type === "generic") {
                 return new index_js_2.ChatMessage({
                     content: obj.content,
                     role: obj.role,
@@ -62,6 +62,7 @@ function revive(obj) {
                 return new index_js_2.ToolMessage({
                     content: obj.content,
                     tool_call_id: obj.tool_call_id,
+                    status: obj.status,
                 });
             }
             if (obj.type === "AIMessage" || obj.type === "ai") {
@@ -95,6 +96,7 @@ function revive(obj) {
                 return new index_js_2.ToolMessageChunk({
                     content: obj.content,
                     tool_call_id: obj.tool_call_id,
+                    status: obj.status,
                 });
             }
             if (obj.type === "AIMessageChunk") {

package/dist/runnables/remote.js

@@ -43,7 +43,7 @@ function revive(obj) {
                     content: obj.content,
                 });
             }
-            if (obj.type === "ChatMessage" || obj.type === "chat") {
+            if (obj.type === "ChatMessage" || obj.type === "generic") {
                 return new ChatMessage({
                     content: obj.content,
                     role: obj.role,
@@ -59,6 +59,7 @@ function revive(obj) {
                 return new ToolMessage({
                     content: obj.content,
                     tool_call_id: obj.tool_call_id,
+                    status: obj.status,
                 });
             }
             if (obj.type === "AIMessage" || obj.type === "ai") {
@@ -92,6 +93,7 @@ function revive(obj) {
                 return new ToolMessageChunk({
                     content: obj.content,
                     tool_call_id: obj.tool_call_id,
+                    status: obj.status,
                 });
             }
             if (obj.type === "AIMessageChunk") {

package/dist/tools/index.cjs

@@ -9,6 +9,7 @@ const tool_js_1 = require("../messages/tool.cjs");
 const index_js_1 = require("../singletons/index.cjs");
 const utils_js_1 = require("./utils.cjs");
 Object.defineProperty(exports, "ToolInputParsingException", { enumerable: true, get: function () { return utils_js_1.ToolInputParsingException; } });
+const is_zod_schema_js_1 = require("../utils/types/is_zod_schema.cjs");
 /**
  * Base class for Tools that accept input of any shape defined by a Zod schema.
  */
@@ -94,6 +95,7 @@ class StructuredTool extends base_js_1.BaseLangChain {
         let result;
         try {
             result = await this._call(parsed, runManager, config);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
         }
         catch (e) {
             await runManager?.handleToolError(e);
@@ -210,6 +212,9 @@ exports.DynamicTool = DynamicTool;
  * description, designed to work with structured data. It extends the
  * StructuredTool class and overrides the _call method to execute the
  * provided function when the tool is called.
+ *
+ * Schema can be passed as Zod or JSON schema. The tool will not validate
+ * input if JSON schema is passed.
  */
 class DynamicStructuredTool extends StructuredTool {
     static lc_name() {
@@ -245,7 +250,7 @@ class DynamicStructuredTool extends StructuredTool {
         this.description = fields.description;
         this.func = fields.func;
         this.returnDirect = fields.returnDirect ?? this.returnDirect;
-        this.schema = fields.schema;
+        this.schema = ((0, is_zod_schema_js_1.isZodSchema)(fields.schema) ? fields.schema : zod_1.z.object({}));
     }
     /**
      * @deprecated Use .invoke() instead. Will be removed in 0.3.0.
@@ -260,6 +265,7 @@ class DynamicStructuredTool extends StructuredTool {
         return super.call(arg, config, tags);
     }
     _call(arg, runManager, parentConfig) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         return this.func(arg, runManager, parentConfig);
     }
 }
@@ -279,18 +285,20 @@ function tool(func, fields) {
     // If the schema is not provided, or it's a string schema, create a DynamicTool
     if (!fields.schema || !("shape" in fields.schema) || !fields.schema.shape) {
         return new DynamicTool({
-            name: fields.name,
+            ...fields,
             description: fields.description ??
                 fields.schema?.description ??
                 `${fields.name} tool`,
-            responseFormat: fields.responseFormat,
-            func,
+            // TS doesn't restrict the type here based on the guard above
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            func: func,
         });
     }
     const description = fields.description ?? fields.schema.description ?? `${fields.name} tool`;
     return new DynamicStructuredTool({
-        name: fields.name,
+        ...fields,
         description,
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         schema: fields.schema,
         // TODO: Consider moving into DynamicStructuredTool constructor
         func: async (input, runManager, config) => {
@@ -300,6 +308,8 @@ function tool(func, fields) {
                 });
                 void index_js_1.AsyncLocalStorageProviderSingleton.getInstance().run(childConfig, async () => {
                     try {
+                        // TS doesn't restrict the type here based on the guard above
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
                         resolve(func(input, childConfig));
                     }
                     catch (e) {
@@ -308,7 +318,6 @@ function tool(func, fields) {
                 });
             });
         },
-        responseFormat: fields.responseFormat,
     });
 }
 exports.tool = tool;

package/dist/tools/index.d.ts

@@ -141,9 +141,9 @@ export interface DynamicToolInput extends BaseDynamicToolInput {
 /**
  * Interface for the input parameters of the DynamicStructuredTool class.
  */
-export interface DynamicStructuredToolInput<T extends ZodObjectAny = ZodObjectAny> extends BaseDynamicToolInput {
-    func: (input: BaseDynamicToolInput["responseFormat"] extends "content_and_artifact" ? ToolCall : z.infer<T>, runManager?: CallbackManagerForToolRun, config?: RunnableConfig) => Promise<ToolReturnType>;
-    schema: T;
+export interface DynamicStructuredToolInput<T extends ZodObjectAny | Record<string, any> = ZodObjectAny> extends BaseDynamicToolInput {
+    func: (input: BaseDynamicToolInput["responseFormat"] extends "content_and_artifact" ? ToolCall : T extends ZodObjectAny ? z.infer<T> : T, runManager?: CallbackManagerForToolRun, config?: RunnableConfig) => Promise<ToolReturnType>;
+    schema: T extends ZodObjectAny ? T : T;
 }
 /**
  * A tool that can be created dynamically from a function, name, and description.
@@ -166,21 +166,24 @@ export declare class DynamicTool extends Tool {
  * description, designed to work with structured data. It extends the
  * StructuredTool class and overrides the _call method to execute the
  * provided function when the tool is called.
+ *
+ * Schema can be passed as Zod or JSON schema. The tool will not validate
+ * input if JSON schema is passed.
  */
-export declare class DynamicStructuredTool<T extends ZodObjectAny = ZodObjectAny> extends StructuredTool<T> {
+export declare class DynamicStructuredTool<T extends ZodObjectAny | Record<string, any> = ZodObjectAny> extends StructuredTool<T extends ZodObjectAny ? T : ZodObjectAny> {
     static lc_name(): string;
     name: string;
     description: string;
     func: DynamicStructuredToolInput<T>["func"];
-    schema: T;
+    schema: T extends ZodObjectAny ? T : ZodObjectAny;
     constructor(fields: DynamicStructuredToolInput<T>);
     /**
      * @deprecated Use .invoke() instead. Will be removed in 0.3.0.
      */
-    call(arg: z.output<T> | ToolCall, configArg?: RunnableConfig | Callbacks, 
+    call(arg: (T extends ZodObjectAny ? z.output<T> : T) | ToolCall, configArg?: RunnableConfig | Callbacks, 
     /** @deprecated */
     tags?: string[]): Promise<ToolReturnType>;
-    protected _call(arg: z.output<T> | ToolCall, runManager?: CallbackManagerForToolRun, parentConfig?: RunnableConfig): Promise<ToolReturnType>;
+    protected _call(arg: (T extends ZodObjectAny ? z.output<T> : T) | ToolCall, runManager?: CallbackManagerForToolRun, parentConfig?: RunnableConfig): Promise<ToolReturnType>;
 }
 /**
  * Abstract base class for toolkits in LangChain. Toolkits are collections
@@ -193,9 +196,11 @@ export declare abstract class BaseToolkit {
 }
 /**
  * Parameters for the tool function.
- * @template {ZodObjectAny | z.ZodString = ZodObjectAny} RunInput The input schema for the tool. Either any Zod object, or a Zod string.
+ * Schema can be provided as Zod or JSON schema.
+ * If you pass JSON schema, tool inputs will not be validated.
+ * @template {ZodObjectAny | z.ZodString | Record<string, any> = ZodObjectAny} RunInput The input schema for the tool. Either any Zod object, a Zod string, or JSON schema.
  */
-interface ToolWrapperParams<RunInput extends ZodObjectAny | z.ZodString = ZodObjectAny> extends ToolParams {
+interface ToolWrapperParams<RunInput extends ZodObjectAny | z.ZodString | Record<string, any> = ZodObjectAny> extends ToolParams {
     /**
      * The name of the tool. If using with an LLM, this
      * will be passed as the tool name.
@@ -226,8 +231,11 @@ interface ToolWrapperParams<RunInput extends ZodObjectAny | z.ZodString = ZodObj
 /**
  * Creates a new StructuredTool instance with the provided function, name, description, and schema.
  *
+ * Schema can be provided as Zod or JSON schema.
+ * If you pass JSON schema, tool inputs will not be validated.
+ *
  * @function
- * @template {ZodObjectAny | z.ZodString = ZodObjectAny} T The input schema for the tool. Either any Zod object, or a Zod string.
+ * @template {ZodObjectAny | z.ZodString | Record<string, any> = ZodObjectAny} T The input schema for the tool. Either any Zod object, a Zod string, or JSON schema instance.
  *
  * @param {RunnableFunc<z.output<T>, ToolReturnType>} func - The function to invoke when the tool is called.
  * @param {ToolWrapperParams<T>} fields - An object containing the following properties:
@@ -237,5 +245,6 @@ interface ToolWrapperParams<RunInput extends ZodObjectAny | z.ZodString = ZodObj
  *
  * @returns {DynamicStructuredTool<T>} A new StructuredTool instance.
  */
-export declare function tool<T extends z.ZodString = z.ZodString>(func: RunnableFunc<z.output<T>, ToolReturnType>, fields: ToolWrapperParams<T>): DynamicTool;
-export declare function tool<T extends ZodObjectAny = ZodObjectAny>(func: RunnableFunc<z.output<T>, ToolReturnType>, fields: ToolWrapperParams<T>): DynamicStructuredTool<T>;
+export declare function tool<T extends z.ZodString>(func: RunnableFunc<z.output<T>, ToolReturnType>, fields: ToolWrapperParams<T>): DynamicTool;
+export declare function tool<T extends ZodObjectAny>(func: RunnableFunc<z.output<T>, ToolReturnType>, fields: ToolWrapperParams<T>): DynamicStructuredTool<T>;
+export declare function tool<T extends Record<string, any>>(func: RunnableFunc<T, ToolReturnType>, fields: ToolWrapperParams<T>): DynamicStructuredTool<T>;

package/dist/tools/index.js

@@ -5,6 +5,7 @@ import { ensureConfig, patchConfig, } from "../runnables/config.js";
 import { ToolMessage } from "../messages/tool.js";
 import { AsyncLocalStorageProviderSingleton } from "../singletons/index.js";
 import { _isToolCall, ToolInputParsingException } from "./utils.js";
+import { isZodSchema } from "../utils/types/is_zod_schema.js";
 export { ToolInputParsingException };
 /**
  * Base class for Tools that accept input of any shape defined by a Zod schema.
@@ -91,6 +92,7 @@ export class StructuredTool extends BaseLangChain {
         let result;
         try {
             result = await this._call(parsed, runManager, config);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
         }
         catch (e) {
             await runManager?.handleToolError(e);
@@ -204,6 +206,9 @@ export class DynamicTool extends Tool {
  * description, designed to work with structured data. It extends the
  * StructuredTool class and overrides the _call method to execute the
  * provided function when the tool is called.
+ *
+ * Schema can be passed as Zod or JSON schema. The tool will not validate
+ * input if JSON schema is passed.
  */
 export class DynamicStructuredTool extends StructuredTool {
     static lc_name() {
@@ -239,7 +244,7 @@ export class DynamicStructuredTool extends StructuredTool {
         this.description = fields.description;
         this.func = fields.func;
         this.returnDirect = fields.returnDirect ?? this.returnDirect;
-        this.schema = fields.schema;
+        this.schema = (isZodSchema(fields.schema) ? fields.schema : z.object({}));
     }
     /**
      * @deprecated Use .invoke() instead. Will be removed in 0.3.0.
@@ -254,6 +259,7 @@ export class DynamicStructuredTool extends StructuredTool {
         return super.call(arg, config, tags);
     }
     _call(arg, runManager, parentConfig) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         return this.func(arg, runManager, parentConfig);
     }
 }
@@ -271,18 +277,20 @@ export function tool(func, fields) {
     // If the schema is not provided, or it's a string schema, create a DynamicTool
     if (!fields.schema || !("shape" in fields.schema) || !fields.schema.shape) {
         return new DynamicTool({
-            name: fields.name,
+            ...fields,
             description: fields.description ??
                 fields.schema?.description ??
                 `${fields.name} tool`,
-            responseFormat: fields.responseFormat,
-            func,
+            // TS doesn't restrict the type here based on the guard above
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            func: func,
         });
     }
     const description = fields.description ?? fields.schema.description ?? `${fields.name} tool`;
     return new DynamicStructuredTool({
-        name: fields.name,
+        ...fields,
         description,
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         schema: fields.schema,
         // TODO: Consider moving into DynamicStructuredTool constructor
         func: async (input, runManager, config) => {
@@ -292,6 +300,8 @@ export function tool(func, fields) {
                 });
                 void AsyncLocalStorageProviderSingleton.getInstance().run(childConfig, async () => {
                     try {
+                        // TS doesn't restrict the type here based on the guard above
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
                         resolve(func(input, childConfig));
                     }
                     catch (e) {
@@ -300,7 +310,6 @@ export function tool(func, fields) {
                 });
             });
         },
-        responseFormat: fields.responseFormat,
     });
 }
 function _formatToolOutput(params) {

package/dist/utils/testing/index.cjs

@@ -3,7 +3,8 @@
 /* eslint-disable @typescript-eslint/no-explicit-any */
 /* eslint-disable @typescript-eslint/no-unused-vars */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SingleRunExtractor = exports.SyntheticEmbeddings = exports.FakeEmbeddings = exports.FakeTool = exports.FakeTracer = exports.FakeListChatMessageHistory = exports.FakeChatMessageHistory = exports.FakeListChatModel = exports.FakeRetriever = exports.FakeStreamingChatModel = exports.FakeChatModel = exports.FakeStreamingLLM = exports.FakeLLM = exports.FakeRunnable = exports.FakeSplitIntoListParser = void 0;
+exports.FakeVectorStore = exports.SingleRunExtractor = exports.SyntheticEmbeddings = exports.FakeEmbeddings = exports.FakeTool = exports.FakeTracer = exports.FakeListChatMessageHistory = exports.FakeChatMessageHistory = exports.FakeListChatModel = exports.FakeRetriever = exports.FakeStreamingChatModel = exports.FakeChatModel = exports.FakeStreamingLLM = exports.FakeLLM = exports.FakeRunnable = exports.FakeSplitIntoListParser = void 0;
+const ml_distance_1 = require("ml-distance");
 const chat_history_js_1 = require("../../chat_history.cjs");
 const document_js_1 = require("../../documents/document.cjs");
 const chat_models_js_1 = require("../../language_models/chat_models.cjs");
@@ -16,6 +17,7 @@ const base_js_2 = require("../../runnables/base.cjs");
 const index_js_3 = require("../../tools/index.cjs");
 const base_js_3 = require("../../tracers/base.cjs");
 const embeddings_js_1 = require("../../embeddings.cjs");
+const vectorstores_js_1 = require("../../vectorstores.cjs");
 /**
  * Parser for comma-separated values. It splits the input text by commas
  * and trims the resulting values.
@@ -307,7 +309,7 @@ class FakeListChatModel extends chat_models_js_1.BaseChatModel {
     static lc_name() {
         return "FakeListChatModel";
     }
-    constructor({ responses, sleep }) {
+    constructor({ responses, sleep, emitCustomEvent }) {
         super({});
         Object.defineProperty(this, "responses", {
             enumerable: true,
@@ -327,8 +329,15 @@ class FakeListChatModel extends chat_models_js_1.BaseChatModel {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "emitCustomEvent", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
         this.responses = responses;
         this.sleep = sleep;
+        this.emitCustomEvent = emitCustomEvent ?? this.emitCustomEvent;
     }
     _combineLLMOutput() {
         return [];
@@ -336,8 +345,13 @@ class FakeListChatModel extends chat_models_js_1.BaseChatModel {
     _llmType() {
         return "fake-list";
     }
-    async _generate(_messages, options) {
+    async _generate(_messages, options, runManager) {
         await this._sleepIfRequested();
+        if (this.emitCustomEvent) {
+            await runManager?.handleCustomEvent("some_test_event", {
+                someval: true,
+            });
+        }
         if (options?.stop?.length) {
             return {
                 generations: [this._formatGeneration(options.stop[0])],
@@ -361,6 +375,11 @@ class FakeListChatModel extends chat_models_js_1.BaseChatModel {
     async *_streamResponseChunks(_messages, _options, runManager) {
         const response = this._currentResponse();
         this._incrementResponse();
+        if (this.emitCustomEvent) {
+            await runManager?.handleCustomEvent("some_test_event", {
+                someval: true,
+            });
+        }
         for await (const text of response) {
             await this._sleepIfRequested();
             const chunk = this._createResponseChunk(text);
@@ -636,3 +655,142 @@ class SingleRunExtractor extends base_js_3.BaseTracer {
     }
 }
 exports.SingleRunExtractor = SingleRunExtractor;
+/**
+ * Class that extends `VectorStore` to store vectors in memory. Provides
+ * methods for adding documents, performing similarity searches, and
+ * creating instances from texts, documents, or an existing index.
+ */
+class FakeVectorStore extends vectorstores_js_1.VectorStore {
+    _vectorstoreType() {
+        return "memory";
+    }
+    constructor(embeddings, { similarity, ...rest } = {}) {
+        super(embeddings, rest);
+        Object.defineProperty(this, "memoryVectors", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "similarity", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.similarity = similarity ?? ml_distance_1.similarity.cosine;
+    }
+    /**
+     * Method to add documents to the memory vector store. It extracts the
+     * text from each document, generates embeddings for them, and adds the
+     * resulting vectors to the store.
+     * @param documents Array of `Document` instances to be added to the store.
+     * @returns Promise that resolves when all documents have been added.
+     */
+    async addDocuments(documents) {
+        const texts = documents.map(({ pageContent }) => pageContent);
+        return this.addVectors(await this.embeddings.embedDocuments(texts), documents);
+    }
+    /**
+     * Method to add vectors to the memory vector store. It creates
+     * `MemoryVector` instances for each vector and document pair and adds
+     * them to the store.
+     * @param vectors Array of vectors to be added to the store.
+     * @param documents Array of `Document` instances corresponding to the vectors.
+     * @returns Promise that resolves when all vectors have been added.
+     */
+    async addVectors(vectors, documents) {
+        const memoryVectors = vectors.map((embedding, idx) => ({
+            content: documents[idx].pageContent,
+            embedding,
+            metadata: documents[idx].metadata,
+        }));
+        this.memoryVectors = this.memoryVectors.concat(memoryVectors);
+    }
+    /**
+     * Method to perform a similarity search in the memory vector store. It
+     * calculates the similarity between the query vector and each vector in
+     * the store, sorts the results by similarity, and returns the top `k`
+     * results along with their scores.
+     * @param query Query vector to compare against the vectors in the store.
+     * @param k Number of top results to return.
+     * @param filter Optional filter function to apply to the vectors before performing the search.
+     * @returns Promise that resolves with an array of tuples, each containing a `Document` and its similarity score.
+     */
+    async similaritySearchVectorWithScore(query, k, filter) {
+        const filterFunction = (memoryVector) => {
+            if (!filter) {
+                return true;
+            }
+            const doc = new document_js_1.Document({
+                metadata: memoryVector.metadata,
+                pageContent: memoryVector.content,
+            });
+            return filter(doc);
+        };
+        const filteredMemoryVectors = this.memoryVectors.filter(filterFunction);
+        const searches = filteredMemoryVectors
+            .map((vector, index) => ({
+            similarity: this.similarity(query, vector.embedding),
+            index,
+        }))
+            .sort((a, b) => (a.similarity > b.similarity ? -1 : 0))
+            .slice(0, k);
+        const result = searches.map((search) => [
+            new document_js_1.Document({
+                metadata: filteredMemoryVectors[search.index].metadata,
+                pageContent: filteredMemoryVectors[search.index].content,
+            }),
+            search.similarity,
+        ]);
+        return result;
+    }
+    /**
+     * Static method to create a `FakeVectorStore` instance from an array of
+     * texts. It creates a `Document` for each text and metadata pair, and
+     * adds them to the store.
+     * @param texts Array of texts to be added to the store.
+     * @param metadatas Array or single object of metadata corresponding to the texts.
+     * @param embeddings `Embeddings` instance used to generate embeddings for the texts.
+     * @param dbConfig Optional `FakeVectorStoreArgs` to configure the `FakeVectorStore` instance.
+     * @returns Promise that resolves with a new `FakeVectorStore` instance.
+     */
+    static async fromTexts(texts, metadatas, embeddings, dbConfig) {
+        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 FakeVectorStore.fromDocuments(docs, embeddings, dbConfig);
+    }
+    /**
+     * Static method to create a `FakeVectorStore` instance from an array of
+     * `Document` instances. It adds the documents to the store.
+     * @param docs Array of `Document` instances to be added to the store.
+     * @param embeddings `Embeddings` instance used to generate embeddings for the documents.
+     * @param dbConfig Optional `FakeVectorStoreArgs` to configure the `FakeVectorStore` instance.
+     * @returns Promise that resolves with a new `FakeVectorStore` instance.
+     */
+    static async fromDocuments(docs, embeddings, dbConfig) {
+        const instance = new this(embeddings, dbConfig);
+        await instance.addDocuments(docs);
+        return instance;
+    }
+    /**
+     * Static method to create a `FakeVectorStore` instance from an existing
+     * index. It creates a new `FakeVectorStore` instance without adding any
+     * documents or vectors.
+     * @param embeddings `Embeddings` instance used to generate embeddings for the documents.
+     * @param dbConfig Optional `FakeVectorStoreArgs` to configure the `FakeVectorStore` instance.
+     * @returns Promise that resolves with a new `FakeVectorStore` instance.
+     */
+    static async fromExistingIndex(embeddings, dbConfig) {
+        const instance = new this(embeddings, dbConfig);
+        return instance;
+    }
+}
+exports.FakeVectorStore = FakeVectorStore;