langchain 0.0.170 → 0.0.172

package/dist/document_loaders/web/pdf.js

@@ -1,11 +1,10 @@
-import { getDocument, version, } from "pdf-parse/lib/pdf.js/v1.10.100/build/pdf.js";
 import { Document } from "../../document.js";
 import { BaseDocumentLoader } from "../base.js";
 /**
  * A document loader for loading data from PDFs.
  */
 export class WebPDFLoader extends BaseDocumentLoader {
-    constructor(blob, { splitPages = true } = {}) {
+    constructor(blob, { splitPages = true, pdfjs = PDFLoaderImports } = {}) {
         super();
         Object.defineProperty(this, "blob", {
             enumerable: true,
@@ -19,14 +18,22 @@ export class WebPDFLoader extends BaseDocumentLoader {
             writable: true,
             value: true
         });
+        Object.defineProperty(this, "pdfjs", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.blob = blob;
         this.splitPages = splitPages ?? this.splitPages;
+        this.pdfjs = pdfjs;
     }
     /**
      * Loads the contents of the PDF as documents.
      * @returns An array of Documents representing the retrieved data.
      */
     async load() {
+        const { getDocument, version } = await this.pdfjs();
         const parsedPdf = await getDocument({
             data: new Uint8Array(await this.blob.arrayBuffer()),
             useWorkerFetch: false,
@@ -81,3 +88,14 @@ export class WebPDFLoader extends BaseDocumentLoader {
         return documents;
     }
 }
+async function PDFLoaderImports() {
+    try {
+        const { default: mod } = await import("pdf-parse/lib/pdf.js/v1.10.100/build/pdf.js");
+        const { getDocument, version } = mod;
+        return { getDocument, version };
+    }
+    catch (e) {
+        console.error(e);
+        throw new Error("Failed to load pdf-parse. Please install it with eg. `npm install pdf-parse`.");
+    }
+}

package/dist/embeddings/openai.cjs

@@ -70,6 +70,12 @@ class OpenAIEmbeddings extends base_js_1.Embeddings {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "organization", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "client", {
             enumerable: true,
             configurable: true,
@@ -100,6 +106,9 @@ class OpenAIEmbeddings extends base_js_1.Embeddings {
         this.azureOpenAIBasePath =
             fieldsWithDefaults?.azureOpenAIBasePath ??
                 (0, env_js_1.getEnvironmentVariable)("AZURE_OPENAI_BASE_PATH");
+        this.organization =
+            fieldsWithDefaults?.configuration?.organization ??
+                (0, env_js_1.getEnvironmentVariable)("OPENAI_ORGANIZATION");
         this.modelName = fieldsWithDefaults?.modelName ?? this.modelName;
         this.batchSize =
             fieldsWithDefaults?.batchSize ?? (azureApiKey ? 1 : this.batchSize);
@@ -124,11 +133,13 @@ class OpenAIEmbeddings extends base_js_1.Embeddings {
         }
         this.clientConfig = {
             apiKey,
+            organization: this.organization,
             baseURL: configuration?.basePath,
             dangerouslyAllowBrowser: true,
             defaultHeaders: configuration?.baseOptions?.headers,
             defaultQuery: configuration?.baseOptions?.params,
             ...configuration,
+            ...fields?.configuration,
         };
     }
     /**

package/dist/embeddings/openai.d.ts

@@ -38,11 +38,13 @@ export declare class OpenAIEmbeddings extends Embeddings implements OpenAIEmbedd
     azureOpenAIApiInstanceName?: string;
     azureOpenAIApiDeploymentName?: string;
     azureOpenAIBasePath?: string;
+    organization?: string;
     private client;
     private clientConfig;
     constructor(fields?: Partial<OpenAIEmbeddingsParams> & Partial<AzureOpenAIInput> & {
         verbose?: boolean;
         openAIApiKey?: string;
+        configuration?: ClientOptions;
     }, configuration?: ClientOptions & LegacyOpenAIInput);
     /**
      * Method to generate embeddings for an array of documents. Splits the

package/dist/embeddings/openai.js

@@ -67,6 +67,12 @@ export class OpenAIEmbeddings extends Embeddings {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "organization", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "client", {
             enumerable: true,
             configurable: true,
@@ -97,6 +103,9 @@ export class OpenAIEmbeddings extends Embeddings {
         this.azureOpenAIBasePath =
             fieldsWithDefaults?.azureOpenAIBasePath ??
                 getEnvironmentVariable("AZURE_OPENAI_BASE_PATH");
+        this.organization =
+            fieldsWithDefaults?.configuration?.organization ??
+                getEnvironmentVariable("OPENAI_ORGANIZATION");
         this.modelName = fieldsWithDefaults?.modelName ?? this.modelName;
         this.batchSize =
             fieldsWithDefaults?.batchSize ?? (azureApiKey ? 1 : this.batchSize);
@@ -121,11 +130,13 @@ export class OpenAIEmbeddings extends Embeddings {
         }
         this.clientConfig = {
             apiKey,
+            organization: this.organization,
             baseURL: configuration?.basePath,
             dangerouslyAllowBrowser: true,
             defaultHeaders: configuration?.baseOptions?.headers,
             defaultQuery: configuration?.baseOptions?.params,
             ...configuration,
+            ...fields?.configuration,
         };
     }
     /**

package/dist/graphs/neo4j_graph.cjs

@@ -5,6 +5,20 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Neo4jGraph = void 0;
 const neo4j_driver_1 = __importDefault(require("neo4j-driver"));
+/**
+ * @security *Security note*: Make sure that the database connection uses credentials
+ * that are narrowly-scoped to only include necessary permissions.
+ * Failure to do so may result in data corruption or loss, since the calling
+ * code may attempt commands that would result in deletion, mutation
+ * of data if appropriately prompted or reading sensitive data if such
+ * data is present in the database.
+ * The best way to guard against such negative outcomes is to (as appropriate)
+ * limit the permissions granted to the credentials used with this tool.
+ * For example, creating read only users for the database is a good way to
+ * ensure that the calling code cannot mutate or delete data.
+ *
+ * @link See https://js.langchain.com/docs/security for more information.
+ */
 class Neo4jGraph {
     constructor({ url, username, password, database = "neo4j", }) {
         Object.defineProperty(this, "driver", {

package/dist/graphs/neo4j_graph.d.ts

@@ -4,6 +4,20 @@ interface Neo4jGraphConfig {
     password: string;
     database?: string;
 }
+/**
+ * @security *Security note*: Make sure that the database connection uses credentials
+ * that are narrowly-scoped to only include necessary permissions.
+ * Failure to do so may result in data corruption or loss, since the calling
+ * code may attempt commands that would result in deletion, mutation
+ * of data if appropriately prompted or reading sensitive data if such
+ * data is present in the database.
+ * The best way to guard against such negative outcomes is to (as appropriate)
+ * limit the permissions granted to the credentials used with this tool.
+ * For example, creating read only users for the database is a good way to
+ * ensure that the calling code cannot mutate or delete data.
+ *
+ * @link See https://js.langchain.com/docs/security for more information.
+ */
 export declare class Neo4jGraph {
     private driver;
     private database;

package/dist/graphs/neo4j_graph.js

@@ -1,4 +1,18 @@
 import neo4j from "neo4j-driver";
+/**
+ * @security *Security note*: Make sure that the database connection uses credentials
+ * that are narrowly-scoped to only include necessary permissions.
+ * Failure to do so may result in data corruption or loss, since the calling
+ * code may attempt commands that would result in deletion, mutation
+ * of data if appropriately prompted or reading sensitive data if such
+ * data is present in the database.
+ * The best way to guard against such negative outcomes is to (as appropriate)
+ * limit the permissions granted to the credentials used with this tool.
+ * For example, creating read only users for the database is a good way to
+ * ensure that the calling code cannot mutate or delete data.
+ *
+ * @link See https://js.langchain.com/docs/security for more information.
+ */
 export class Neo4jGraph {
     constructor({ url, username, password, database = "neo4j", }) {
         Object.defineProperty(this, "driver", {

package/dist/llms/googlepalm.cjs

@@ -83,6 +83,9 @@ class GooglePaLM extends base_js_1.LLM {
         if (this.topP && this.topP < 0) {
             throw new Error("`topP` must be a positive integer");
         }
+        if (this.topP && this.topP > 1) {
+            throw new Error("Google PaLM `topP` must in the range of [0,1]");
+        }
         this.topK = fields?.topK ?? this.topK;
         if (this.topK && this.topK < 0) {
             throw new Error("`topK` must be a positive integer");

package/dist/llms/googlepalm.js

@@ -80,6 +80,9 @@ export class GooglePaLM extends LLM {
         if (this.topP && this.topP < 0) {
             throw new Error("`topP` must be a positive integer");
         }
+        if (this.topP && this.topP > 1) {
+            throw new Error("Google PaLM `topP` must in the range of [0,1]");
+        }
         this.topK = fields?.topK ?? this.topK;
         if (this.topK && this.topK < 0) {
             throw new Error("`topK` must be a positive integer");

package/dist/load/import_constants.cjs

@@ -112,6 +112,7 @@ exports.optionalImportEntrypoints = [
     "langchain/chat_models/googlevertexai",
     "langchain/chat_models/googlevertexai/web",
     "langchain/chat_models/googlepalm",
+    "langchain/chat_models/llama_cpp",
     "langchain/sql_db",
     "langchain/callbacks/handlers/llmonitor",
     "langchain/output_parsers/expression",
@@ -145,6 +146,7 @@ exports.optionalImportEntrypoints = [
     "langchain/storage/ioredis",
     "langchain/storage/vercel_kv",
     "langchain/storage/upstash_redis",
+    "langchain/storage/file_system",
     "langchain/graphs/neo4j_graph",
     "langchain/hub",
     "langchain/experimental/multimodal_embeddings/googlevertexai",

package/dist/load/import_constants.js

@@ -109,6 +109,7 @@ export const optionalImportEntrypoints = [
     "langchain/chat_models/googlevertexai",
     "langchain/chat_models/googlevertexai/web",
     "langchain/chat_models/googlepalm",
+    "langchain/chat_models/llama_cpp",
     "langchain/sql_db",
     "langchain/callbacks/handlers/llmonitor",
     "langchain/output_parsers/expression",
@@ -142,6 +143,7 @@ export const optionalImportEntrypoints = [
     "langchain/storage/ioredis",
     "langchain/storage/vercel_kv",
     "langchain/storage/upstash_redis",
+    "langchain/storage/file_system",
     "langchain/graphs/neo4j_graph",
     "langchain/hub",
     "langchain/experimental/multimodal_embeddings/googlevertexai",

package/dist/load/import_map.cjs

@@ -24,14 +24,19 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.schema__output_parser = exports.schema__document = exports.schema = exports.chat_models__fake = exports.chat_models__yandex = exports.chat_models__minimax = exports.chat_models__ollama = exports.chat_models__baiduwenxin = exports.chat_models__fireworks = exports.chat_models__cloudflare_workersai = exports.chat_models__anthropic = exports.chat_models__openai = exports.chat_models__base = exports.document_transformers__openai_functions = exports.document_loaders__web__sort_xyz_blockchain = exports.document_loaders__web__serpapi = exports.document_loaders__web__searchapi = exports.document_loaders__base = exports.document = exports.memory = exports.text_splitter = exports.vectorstores__xata = exports.vectorstores__vectara = exports.vectorstores__prisma = exports.vectorstores__memory = exports.vectorstores__base = exports.prompts = exports.llms__fake = exports.llms__yandex = exports.llms__fireworks = exports.llms__ollama = exports.llms__cloudflare_workersai = exports.llms__aleph_alpha = exports.llms__ai21 = exports.llms__openai = exports.llms__base = exports.embeddings__minimax = exports.embeddings__openai = exports.embeddings__ollama = exports.embeddings__fake = exports.embeddings__cache_backed = exports.embeddings__base = exports.chains__openai_functions = exports.chains = exports.tools = exports.base_language = exports.agents__format_scratchpad = exports.agents__toolkits = exports.agents = exports.load__serializable = void 0;
-exports.runnables__remote = exports.evaluation = exports.experimental__chains__violation_of_expectations = exports.experimental__chat_models__bittensor = exports.experimental__plan_and_execute = exports.experimental__generative_agents = exports.experimental__babyagi = exports.experimental__autogpt = exports.util__time = exports.util__math = exports.storage__in_memory = exports.storage__encoder_backed = exports.stores__message__in_memory = exports.stores__file__in_memory = exports.stores__doc__in_memory = exports.cache = exports.retrievers__vespa = exports.retrievers__score_threshold = exports.retrievers__hyde = exports.retrievers__document_compressors__embeddings_filter = exports.retrievers__document_compressors__chain_extract = exports.retrievers__time_weighted = exports.retrievers__tavily_search_api = exports.retrievers__parent_document = exports.retrievers__multi_vector = exports.retrievers__multi_query = exports.retrievers__document_compressors = exports.retrievers__contextual_compression = exports.retrievers__databerry = exports.retrievers__chaindesk = exports.retrievers__remote = exports.output_parsers = exports.callbacks = exports.schema__storage = exports.schema__runnable = exports.schema__retriever = exports.schema__query_constructor = void 0;
+exports.chat_models__minimax = exports.chat_models__ollama = exports.chat_models__baiduwenxin = exports.chat_models__fireworks = exports.chat_models__cloudflare_workersai = exports.chat_models__anthropic = exports.chat_models__openai = exports.chat_models__base = exports.document_transformers__openai_functions = exports.document_loaders__web__sort_xyz_blockchain = exports.document_loaders__web__serpapi = exports.document_loaders__web__searchapi = exports.document_loaders__base = exports.document = exports.memory = exports.text_splitter = exports.vectorstores__xata = exports.vectorstores__vectara = exports.vectorstores__prisma = exports.vectorstores__memory = exports.vectorstores__base = exports.prompts = exports.llms__fake = exports.llms__yandex = exports.llms__fireworks = exports.llms__ollama = exports.llms__cloudflare_workersai = exports.llms__aleph_alpha = exports.llms__ai21 = exports.llms__openai = exports.llms__base = exports.embeddings__minimax = exports.embeddings__openai = exports.embeddings__ollama = exports.embeddings__fake = exports.embeddings__cache_backed = exports.embeddings__base = exports.chains__openai_functions = exports.chains = exports.tools__render = exports.tools = exports.base_language = exports.agents__react__output_parser = exports.agents__format_scratchpad__log_to_message = exports.agents__format_scratchpad__xml = exports.agents__format_scratchpad__log = exports.agents__format_scratchpad = exports.agents__toolkits = exports.agents = exports.load__serializable = void 0;
+exports.runnables__remote = exports.evaluation = exports.experimental__chains__violation_of_expectations = exports.experimental__chat_models__bittensor = exports.experimental__plan_and_execute = exports.experimental__generative_agents = exports.experimental__babyagi = exports.experimental__autogpt = exports.util__time = exports.util__math = exports.storage__in_memory = exports.storage__encoder_backed = exports.stores__message__in_memory = exports.stores__file__in_memory = exports.stores__doc__in_memory = exports.cache = exports.retrievers__vespa = exports.retrievers__score_threshold = exports.retrievers__hyde = exports.retrievers__document_compressors__embeddings_filter = exports.retrievers__document_compressors__chain_extract = exports.retrievers__time_weighted = exports.retrievers__tavily_search_api = exports.retrievers__parent_document = exports.retrievers__multi_vector = exports.retrievers__multi_query = exports.retrievers__document_compressors = exports.retrievers__contextual_compression = exports.retrievers__databerry = exports.retrievers__chaindesk = exports.retrievers__remote = exports.output_parsers = exports.callbacks = exports.schema__storage = exports.schema__runnable = exports.schema__retriever = exports.schema__query_constructor = exports.schema__output_parser = exports.schema__document = exports.schema = exports.chat_models__fake = exports.chat_models__yandex = void 0;
 exports.load__serializable = __importStar(require("../load/serializable.cjs"));
 exports.agents = __importStar(require("../agents/index.cjs"));
 exports.agents__toolkits = __importStar(require("../agents/toolkits/index.cjs"));
-exports.agents__format_scratchpad = __importStar(require("../agents/format_scratchpad.cjs"));
+exports.agents__format_scratchpad = __importStar(require("../agents/format_scratchpad/openai_functions.cjs"));
+exports.agents__format_scratchpad__log = __importStar(require("../agents/format_scratchpad/log.cjs"));
+exports.agents__format_scratchpad__xml = __importStar(require("../agents/format_scratchpad/xml.cjs"));
+exports.agents__format_scratchpad__log_to_message = __importStar(require("../agents/format_scratchpad/log_to_message.cjs"));
+exports.agents__react__output_parser = __importStar(require("../agents/react/output_parser.cjs"));
 exports.base_language = __importStar(require("../base_language/index.cjs"));
 exports.tools = __importStar(require("../tools/index.cjs"));
+exports.tools__render = __importStar(require("../tools/render.cjs"));
 exports.chains = __importStar(require("../chains/index.cjs"));
 exports.chains__openai_functions = __importStar(require("../chains/openai_functions/index.cjs"));
 exports.embeddings__base = __importStar(require("../embeddings/base.cjs"));

package/dist/load/import_map.d.ts

@@ -1,9 +1,14 @@
 export * as load__serializable from "../load/serializable.js";
 export * as agents from "../agents/index.js";
 export * as agents__toolkits from "../agents/toolkits/index.js";
-export * as agents__format_scratchpad from "../agents/format_scratchpad.js";
+export * as agents__format_scratchpad from "../agents/format_scratchpad/openai_functions.js";
+export * as agents__format_scratchpad__log from "../agents/format_scratchpad/log.js";
+export * as agents__format_scratchpad__xml from "../agents/format_scratchpad/xml.js";
+export * as agents__format_scratchpad__log_to_message from "../agents/format_scratchpad/log_to_message.js";
+export * as agents__react__output_parser from "../agents/react/output_parser.js";
 export * as base_language from "../base_language/index.js";
 export * as tools from "../tools/index.js";
+export * as tools__render from "../tools/render.js";
 export * as chains from "../chains/index.js";
 export * as chains__openai_functions from "../chains/openai_functions/index.js";
 export * as embeddings__base from "../embeddings/base.js";

package/dist/load/import_map.js

@@ -2,9 +2,14 @@
 export * as load__serializable from "../load/serializable.js";
 export * as agents from "../agents/index.js";
 export * as agents__toolkits from "../agents/toolkits/index.js";
-export * as agents__format_scratchpad from "../agents/format_scratchpad.js";
+export * as agents__format_scratchpad from "../agents/format_scratchpad/openai_functions.js";
+export * as agents__format_scratchpad__log from "../agents/format_scratchpad/log.js";
+export * as agents__format_scratchpad__xml from "../agents/format_scratchpad/xml.js";
+export * as agents__format_scratchpad__log_to_message from "../agents/format_scratchpad/log_to_message.js";
+export * as agents__react__output_parser from "../agents/react/output_parser.js";
 export * as base_language from "../base_language/index.js";
 export * as tools from "../tools/index.js";
+export * as tools__render from "../tools/render.js";
 export * as chains from "../chains/index.js";
 export * as chains__openai_functions from "../chains/openai_functions/index.js";
 export * as embeddings__base from "../embeddings/base.js";

package/dist/retrievers/parent_document.cjs

@@ -84,6 +84,12 @@ class ParentDocumentRetriever extends multi_vector_js_1.MultiVectorRetriever {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "childDocumentRetriever", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.vectorstore = fields.vectorstore;
         this.docstore = fields.docstore;
         this.childSplitter = fields.childSplitter;
@@ -91,9 +97,17 @@ class ParentDocumentRetriever extends multi_vector_js_1.MultiVectorRetriever {
         this.idKey = fields.idKey ?? this.idKey;
         this.childK = fields.childK;
         this.parentK = fields.parentK;
+        this.childDocumentRetriever = fields.childDocumentRetriever;
     }
     async _getRelevantDocuments(query) {
-        const subDocs = await this.vectorstore.similaritySearch(query, this.childK);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        let subDocs = [];
+        if (this.childDocumentRetriever) {
+            subDocs = await this.childDocumentRetriever.getRelevantDocuments(query);
+        }
+        else {
+            subDocs = await this.vectorstore.similaritySearch(query, this.childK);
+        }
         // Maintain order
         const parentDocIds = [];
         for (const doc of subDocs) {
@@ -109,6 +123,7 @@ class ParentDocumentRetriever extends multi_vector_js_1.MultiVectorRetriever {
     }
     /**
      * Adds documents to the docstore and vectorstores.
+     * If a retriever is provided, it will be used to add documents instead of the vectorstore.
      * @param docs The documents to add
      * @param config.ids Optional list of ids for documents. If provided should be the same
      *   length as the list of documents. Can provided if parent documents
@@ -150,7 +165,12 @@ class ParentDocumentRetriever extends multi_vector_js_1.MultiVectorRetriever {
             embeddedDocs.push(...taggedSubDocs);
             fullDocs[parentDocId] = parentDoc;
         }
-        await this.vectorstore.addDocuments(embeddedDocs);
+        if (this.childDocumentRetriever) {
+            await this.childDocumentRetriever.addDocuments(embeddedDocs);
+        }
+        else {
+            await this.vectorstore.addDocuments(embeddedDocs);
+        }
         if (addToDocstore) {
             await this.docstore.mset(Object.entries(fullDocs));
         }

package/dist/retrievers/parent_document.d.ts

@@ -1,5 +1,5 @@
 import { Document } from "../document.js";
-import { VectorStore } from "../vectorstores/base.js";
+import { VectorStore, VectorStoreRetriever } from "../vectorstores/base.js";
 import { TextSplitter } from "../text_splitter.js";
 import { MultiVectorRetriever, type MultiVectorRetrieverInput } from "./multi_vector.js";
 /**
@@ -9,6 +9,11 @@ import { MultiVectorRetriever, type MultiVectorRetrieverInput } from "./multi_ve
 export type ParentDocumentRetrieverFields = MultiVectorRetrieverInput & {
     childSplitter: TextSplitter;
     parentSplitter?: TextSplitter;
+    /**
+     * A custom retriever to use when retrieving instead of
+     * the `.similaritySearch` method of the vectorstore.
+     */
+    childDocumentRetriever?: VectorStoreRetriever<VectorStore>;
 };
 /**
  * A type of document retriever that splits input documents into smaller chunks
@@ -28,10 +33,12 @@ export declare class ParentDocumentRetriever extends MultiVectorRetriever {
     protected idKey: string;
     protected childK?: number;
     protected parentK?: number;
+    childDocumentRetriever: VectorStoreRetriever<VectorStore> | undefined;
     constructor(fields: ParentDocumentRetrieverFields);
     _getRelevantDocuments(query: string): Promise<Document[]>;
     /**
      * Adds documents to the docstore and vectorstores.
+     * If a retriever is provided, it will be used to add documents instead of the vectorstore.
      * @param docs The documents to add
      * @param config.ids Optional list of ids for documents. If provided should be the same
      *   length as the list of documents. Can provided if parent documents

package/dist/retrievers/parent_document.js

@@ -58,6 +58,12 @@ export class ParentDocumentRetriever extends MultiVectorRetriever {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "childDocumentRetriever", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.vectorstore = fields.vectorstore;
         this.docstore = fields.docstore;
         this.childSplitter = fields.childSplitter;
@@ -65,9 +71,17 @@ export class ParentDocumentRetriever extends MultiVectorRetriever {
         this.idKey = fields.idKey ?? this.idKey;
         this.childK = fields.childK;
         this.parentK = fields.parentK;
+        this.childDocumentRetriever = fields.childDocumentRetriever;
     }
     async _getRelevantDocuments(query) {
-        const subDocs = await this.vectorstore.similaritySearch(query, this.childK);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        let subDocs = [];
+        if (this.childDocumentRetriever) {
+            subDocs = await this.childDocumentRetriever.getRelevantDocuments(query);
+        }
+        else {
+            subDocs = await this.vectorstore.similaritySearch(query, this.childK);
+        }
         // Maintain order
         const parentDocIds = [];
         for (const doc of subDocs) {
@@ -83,6 +97,7 @@ export class ParentDocumentRetriever extends MultiVectorRetriever {
     }
     /**
      * Adds documents to the docstore and vectorstores.
+     * If a retriever is provided, it will be used to add documents instead of the vectorstore.
      * @param docs The documents to add
      * @param config.ids Optional list of ids for documents. If provided should be the same
      *   length as the list of documents. Can provided if parent documents
@@ -124,7 +139,12 @@ export class ParentDocumentRetriever extends MultiVectorRetriever {
             embeddedDocs.push(...taggedSubDocs);
             fullDocs[parentDocId] = parentDoc;
         }
-        await this.vectorstore.addDocuments(embeddedDocs);
+        if (this.childDocumentRetriever) {
+            await this.childDocumentRetriever.addDocuments(embeddedDocs);
+        }
+        else {
+            await this.vectorstore.addDocuments(embeddedDocs);
+        }
         if (addToDocstore) {
             await this.docstore.mset(Object.entries(fullDocs));
         }

package/dist/schema/runnable/passthrough.cjs

@@ -56,7 +56,9 @@ class RunnablePassthrough extends base_js_1.Runnable {
     async invoke(input, options) {
         return this._callWithConfig((input) => Promise.resolve(input), input, options);
     }
-    static assign(mapping) {
+    static assign(
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    mapping) {
         return new RunnableAssign(new base_js_1.RunnableMap({ steps: mapping }));
     }
 }

package/dist/schema/runnable/passthrough.js

@@ -52,7 +52,9 @@ export class RunnablePassthrough extends Runnable {
     async invoke(input, options) {
         return this._callWithConfig((input) => Promise.resolve(input), input, options);
     }
-    static assign(mapping) {
+    static assign(
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    mapping) {
         return new RunnableAssign(new RunnableMap({ steps: mapping }));
     }
 }

package/dist/sql_db.cjs

@@ -14,6 +14,8 @@ const serializable_js_1 = require("./load/serializable.cjs");
  * to read and scope to the tables that are needed.
  * Optionally, use the includesTables or ignoreTables class parameters
  * to limit which tables can/cannot be accessed.
+ *
+ * @link See https://js.langchain.com/docs/security for more information.
  */
 class SqlDatabase extends serializable_js_1.Serializable {
     toJSON() {

package/dist/sql_db.d.ts

@@ -13,6 +13,8 @@ export type { SqlDatabaseDataSourceParams, SqlDatabaseOptionsParams };
  * to read and scope to the tables that are needed.
  * Optionally, use the includesTables or ignoreTables class parameters
  * to limit which tables can/cannot be accessed.
+ *
+ * @link See https://js.langchain.com/docs/security for more information.
  */
 export declare class SqlDatabase extends Serializable implements SqlDatabaseOptionsParams, SqlDatabaseDataSourceParams {
     lc_namespace: string[];

package/dist/sql_db.js

@@ -11,6 +11,8 @@ import { Serializable } from "./load/serializable.js";
  * to read and scope to the tables that are needed.
  * Optionally, use the includesTables or ignoreTables class parameters
  * to limit which tables can/cannot be accessed.
+ *
+ * @link See https://js.langchain.com/docs/security for more information.
  */
 export class SqlDatabase extends Serializable {
     toJSON() {