langchain 0.1.35 → 0.2.0-rc.0

package/dist/chains/query_constructor/ir.d.ts

@@ -1,138 +1 @@
-import { VectorStore } from "@langchain/core/vectorstores";
-/**
- * Represents logical AND operator.
- */
-export type AND = "and";
-/**
- * Represents logical OR operator.
- */
-export type OR = "or";
-/**
- * Represents logical NOT operator.
- */
-export type NOT = "not";
-/**
- * Represents a logical operator which can be AND, OR, or NOT.
- */
-export type Operator = AND | OR | NOT;
-/**
- * Represents equality comparison operator.
- */
-export type EQ = "eq";
-/**
- * Represents inequality comparison operator.
- */
-export type NE = "ne";
-/**
- * Represents less than comparison operator.
- */
-export type LT = "lt";
-/**
- * Represents greater than comparison operator.
- */
-export type GT = "gt";
-/**
- * Represents less than or equal to comparison operator.
- */
-export type LTE = "lte";
-/**
- * Represents greater than or equal to comparison operator.
- */
-export type GTE = "gte";
-/**
- * Represents a comparison operator which can be EQ, NE, LT, GT, LTE, or
- * GTE.
- */
-export type Comparator = EQ | NE | LT | GT | LTE | GTE;
-export declare const Operators: {
-    [key: string]: Operator;
-};
-export declare const Comparators: {
-    [key: string]: Comparator;
-};
-/**
- * Represents the result of visiting an operation or comparison
- * expression.
- */
-export type VisitorResult = VisitorOperationResult | VisitorComparisonResult;
-/**
- * Represents the result of visiting an operation expression.
- */
-export type VisitorOperationResult = {
-    [operator: string]: VisitorResult[];
-};
-/**
- * Represents the result of visiting a comparison expression.
- */
-export type VisitorComparisonResult = {
-    [attr: string]: {
-        [comparator: string]: string | number;
-    };
-};
-/**
- * Represents the result of visiting a structured query expression.
- */
-export type VisitorStructuredQueryResult = {
-    filter?: VisitorComparisonResult | VisitorOperationResult;
-};
-/**
- * Abstract class for visiting expressions. Subclasses must implement
- * visitOperation, visitComparison, and visitStructuredQuery methods.
- */
-export declare abstract class Visitor<T extends VectorStore = VectorStore> {
-    VisitOperationOutput: object;
-    VisitComparisonOutput: object;
-    VisitStructuredQueryOutput: {
-        filter?: T["FilterType"];
-    };
-    abstract allowedOperators: Operator[];
-    abstract allowedComparators: Comparator[];
-    abstract visitOperation(operation: Operation): this["VisitOperationOutput"];
-    abstract visitComparison(comparison: Comparison): this["VisitComparisonOutput"];
-    abstract visitStructuredQuery(structuredQuery: StructuredQuery): this["VisitStructuredQueryOutput"];
-}
-/**
- * Abstract class representing an expression. Subclasses must implement
- * the exprName property and the accept method.
- */
-export declare abstract class Expression {
-    abstract exprName: "Operation" | "Comparison" | "StructuredQuery";
-    accept(visitor: Visitor): object;
-}
-/**
- * Abstract class representing a filter directive. It extends the
- * Expression class.
- */
-export declare abstract class FilterDirective extends Expression {
-}
-/**
- * Class representing a comparison filter directive. It extends the
- * FilterDirective class.
- */
-export declare class Comparison extends FilterDirective {
-    comparator: Comparator;
-    attribute: string;
-    value: string | number;
-    exprName: "Comparison";
-    constructor(comparator: Comparator, attribute: string, value: string | number);
-}
-/**
- * Class representing an operation filter directive. It extends the
- * FilterDirective class.
- */
-export declare class Operation extends FilterDirective {
-    operator: Operator;
-    args?: FilterDirective[] | undefined;
-    exprName: "Operation";
-    constructor(operator: Operator, args?: FilterDirective[] | undefined);
-}
-/**
- * Class representing a structured query expression. It extends the
- * Expression class.
- */
-export declare class StructuredQuery extends Expression {
-    query: string;
-    filter?: FilterDirective | undefined;
-    exprName: "StructuredQuery";
-    constructor(query: string, filter?: FilterDirective | undefined);
-}
+export * from "@langchain/core/structured_query";

package/dist/chains/query_constructor/ir.js

@@ -1,132 +1 @@
-export const Operators = {
-    and: "and",
-    or: "or",
-    not: "not",
-};
-export const Comparators = {
-    eq: "eq",
-    ne: "ne",
-    lt: "lt",
-    gt: "gt",
-    lte: "lte",
-    gte: "gte",
-};
-/**
- * Abstract class for visiting expressions. Subclasses must implement
- * visitOperation, visitComparison, and visitStructuredQuery methods.
- */
-export class Visitor {
-}
-/**
- * Abstract class representing an expression. Subclasses must implement
- * the exprName property and the accept method.
- */
-export class Expression {
-    accept(visitor) {
-        if (this.exprName === "Operation") {
-            return visitor.visitOperation(this);
-        }
-        else if (this.exprName === "Comparison") {
-            return visitor.visitComparison(this);
-        }
-        else if (this.exprName === "StructuredQuery") {
-            return visitor.visitStructuredQuery(this);
-        }
-        else {
-            throw new Error("Unknown Expression type");
-        }
-    }
-}
-/**
- * Abstract class representing a filter directive. It extends the
- * Expression class.
- */
-export class FilterDirective extends Expression {
-}
-/**
- * Class representing a comparison filter directive. It extends the
- * FilterDirective class.
- */
-export class Comparison extends FilterDirective {
-    constructor(comparator, attribute, value) {
-        super();
-        Object.defineProperty(this, "comparator", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: comparator
-        });
-        Object.defineProperty(this, "attribute", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: attribute
-        });
-        Object.defineProperty(this, "value", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: value
-        });
-        Object.defineProperty(this, "exprName", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "Comparison"
-        });
-    }
-}
-/**
- * Class representing an operation filter directive. It extends the
- * FilterDirective class.
- */
-export class Operation extends FilterDirective {
-    constructor(operator, args) {
-        super();
-        Object.defineProperty(this, "operator", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: operator
-        });
-        Object.defineProperty(this, "args", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: args
-        });
-        Object.defineProperty(this, "exprName", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "Operation"
-        });
-    }
-}
-/**
- * Class representing a structured query expression. It extends the
- * Expression class.
- */
-export class StructuredQuery extends Expression {
-    constructor(query, filter) {
-        super();
-        Object.defineProperty(this, "query", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: query
-        });
-        Object.defineProperty(this, "filter", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: filter
-        });
-        Object.defineProperty(this, "exprName", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "StructuredQuery"
-        });
-    }
-}
+export * from "@langchain/core/structured_query";

package/dist/chains/retrieval_qa.cjs

@@ -4,28 +4,37 @@ exports.RetrievalQAChain = void 0;
 const base_js_1 = require("./base.cjs");
 const load_js_1 = require("./question_answering/load.cjs");
 /**
+ * @deprecated This class will be removed in 0.3.0. See below for an example implementation using
+ * `createRetrievalChain`:
  * Class representing a chain for performing question-answering tasks with
  * a retrieval component.
  * @example
  * ```typescript
- * // Initialize the OpenAI model and the remote retriever with the specified configuration
- * const model = new ChatOpenAI({});
- * const retriever = new RemoteLangChainRetriever({
- *   url: "http://example.com/api",
- *   auth: { bearer: "foo" },
- *   inputKey: "message",
- *   responseKey: "response",
- * });
+ * import { createStuffDocumentsChain } from "langchain/chains/combine_documents";
+ * import { ChatPromptTemplate } from "@langchain/core/prompts";
+ * import { createRetrievalChain } from "langchain/chains/retrieval";
+ * import { MemoryVectorStore } from "langchain/vectorstores/memory";
+ *
+ * const documents = [...your documents here];
+ * const embeddings = ...your embeddings model;
+ * const llm = ...your LLM model;
  *
- * // Create a RetrievalQAChain using the model and retriever
- * const chain = RetrievalQAChain.fromLLM(model, retriever);
+ * const vectorstore = await MemoryVectorStore.fromDocuments(
+ *   documents,
+ *   embeddings
+ * );
+ * const prompt = ChatPromptTemplate.fromTemplate(`Answer the user's question: {input}`);
  *
- * // Execute the chain with a query and log the result
- * const res = await chain.call({
- *   query: "What did the president say about Justice Breyer?",
+ * const combineDocsChain = await createStuffDocumentsChain({
+ *   llm,
+ *   prompt,
  * });
- * console.log({ res });
+ * const retriever = vectorstore.asRetriever();
  *
+ * const retrievalChain = await createRetrievalChain({
+ *   combineDocsChain,
+ *   retriever,
+ * });
  * ```
  */
 class RetrievalQAChain extends base_js_1.BaseChain {

package/dist/chains/retrieval_qa.d.ts

@@ -16,28 +16,37 @@ export interface RetrievalQAChainInput extends Omit<ChainInputs, "memory"> {
     returnSourceDocuments?: boolean;
 }
 /**
+ * @deprecated This class will be removed in 0.3.0. See below for an example implementation using
+ * `createRetrievalChain`:
  * Class representing a chain for performing question-answering tasks with
  * a retrieval component.
  * @example
  * ```typescript
- * // Initialize the OpenAI model and the remote retriever with the specified configuration
- * const model = new ChatOpenAI({});
- * const retriever = new RemoteLangChainRetriever({
- *   url: "http://example.com/api",
- *   auth: { bearer: "foo" },
- *   inputKey: "message",
- *   responseKey: "response",
- * });
+ * import { createStuffDocumentsChain } from "langchain/chains/combine_documents";
+ * import { ChatPromptTemplate } from "@langchain/core/prompts";
+ * import { createRetrievalChain } from "langchain/chains/retrieval";
+ * import { MemoryVectorStore } from "langchain/vectorstores/memory";
+ *
+ * const documents = [...your documents here];
+ * const embeddings = ...your embeddings model;
+ * const llm = ...your LLM model;
  *
- * // Create a RetrievalQAChain using the model and retriever
- * const chain = RetrievalQAChain.fromLLM(model, retriever);
+ * const vectorstore = await MemoryVectorStore.fromDocuments(
+ *   documents,
+ *   embeddings
+ * );
+ * const prompt = ChatPromptTemplate.fromTemplate(`Answer the user's question: {input}`);
  *
- * // Execute the chain with a query and log the result
- * const res = await chain.call({
- *   query: "What did the president say about Justice Breyer?",
+ * const combineDocsChain = await createStuffDocumentsChain({
+ *   llm,
+ *   prompt,
  * });
- * console.log({ res });
+ * const retriever = vectorstore.asRetriever();
  *
+ * const retrievalChain = await createRetrievalChain({
+ *   combineDocsChain,
+ *   retriever,
+ * });
  * ```
  */
 export declare class RetrievalQAChain extends BaseChain implements RetrievalQAChainInput {

package/dist/chains/retrieval_qa.js

@@ -1,28 +1,37 @@
 import { BaseChain } from "./base.js";
 import { loadQAStuffChain, } from "./question_answering/load.js";
 /**
+ * @deprecated This class will be removed in 0.3.0. See below for an example implementation using
+ * `createRetrievalChain`:
  * Class representing a chain for performing question-answering tasks with
  * a retrieval component.
  * @example
  * ```typescript
- * // Initialize the OpenAI model and the remote retriever with the specified configuration
- * const model = new ChatOpenAI({});
- * const retriever = new RemoteLangChainRetriever({
- *   url: "http://example.com/api",
- *   auth: { bearer: "foo" },
- *   inputKey: "message",
- *   responseKey: "response",
- * });
+ * import { createStuffDocumentsChain } from "langchain/chains/combine_documents";
+ * import { ChatPromptTemplate } from "@langchain/core/prompts";
+ * import { createRetrievalChain } from "langchain/chains/retrieval";
+ * import { MemoryVectorStore } from "langchain/vectorstores/memory";
+ *
+ * const documents = [...your documents here];
+ * const embeddings = ...your embeddings model;
+ * const llm = ...your LLM model;
  *
- * // Create a RetrievalQAChain using the model and retriever
- * const chain = RetrievalQAChain.fromLLM(model, retriever);
+ * const vectorstore = await MemoryVectorStore.fromDocuments(
+ *   documents,
+ *   embeddings
+ * );
+ * const prompt = ChatPromptTemplate.fromTemplate(`Answer the user's question: {input}`);
  *
- * // Execute the chain with a query and log the result
- * const res = await chain.call({
- *   query: "What did the president say about Justice Breyer?",
+ * const combineDocsChain = await createStuffDocumentsChain({
+ *   llm,
+ *   prompt,
  * });
- * console.log({ res });
+ * const retriever = vectorstore.asRetriever();
  *
+ * const retrievalChain = await createRetrievalChain({
+ *   combineDocsChain,
+ *   retriever,
+ * });
  * ```
  */
 export class RetrievalQAChain extends BaseChain {

package/dist/chains/sql_db/sql_db_chain.d.ts

@@ -51,9 +51,9 @@ export declare class SqlDatabaseChain extends BaseChain {
     database: SqlDatabase;
     prompt: PromptTemplate<{
         input: any;
-        top_k: any;
         dialect: any;
         table_info: any;
+        top_k: any;
     }, any>;
     topK: number;
     inputKey: string;

package/dist/chains/sql_db/sql_db_prompt.d.ts

@@ -1,45 +1,45 @@
 import { BasePromptTemplate, PromptTemplate } from "@langchain/core/prompts";
 export declare const DEFAULT_SQL_DATABASE_PROMPT: PromptTemplate<{
     input: any;
-    top_k: any;
     dialect: any;
     table_info: any;
+    top_k: any;
 }, any>;
 export declare const SQL_POSTGRES_PROMPT: PromptTemplate<{
     input: any;
-    top_k: any;
     dialect: any;
     table_info: any;
+    top_k: any;
 }, any>;
 export declare const SQL_SQLITE_PROMPT: PromptTemplate<{
     input: any;
-    top_k: any;
     dialect: any;
     table_info: any;
+    top_k: any;
 }, any>;
 export declare const SQL_MYSQL_PROMPT: PromptTemplate<{
     input: any;
-    top_k: any;
     dialect: any;
     table_info: any;
+    top_k: any;
 }, any>;
 export declare const SQL_MSSQL_PROMPT: PromptTemplate<{
     input: any;
-    top_k: any;
     dialect: any;
     table_info: any;
+    top_k: any;
 }, any>;
 export declare const SQL_SAP_HANA_PROMPT: PromptTemplate<{
     input: any;
-    top_k: any;
     dialect: any;
     table_info: any;
+    top_k: any;
 }, any>;
 export declare const SQL_ORACLE_PROMPT: PromptTemplate<{
     input: any;
-    top_k: any;
     dialect: any;
     table_info: any;
+    top_k: any;
 }, any>;
 export type SqlDialect = "oracle" | "postgres" | "sqlite" | "mysql" | "mssql" | "sap hana";
 export declare const SQL_PROMPTS_MAP: Record<SqlDialect, BasePromptTemplate>;

package/dist/document_loaders/base.cjs

@@ -1,21 +1,17 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseDocumentLoader = void 0;
-const text_splitter_js_1 = require("../text_splitter.cjs");
-/**
- * Abstract class that provides a default implementation for the
- * loadAndSplit() method from the DocumentLoader interface. The load()
- * method is left abstract and needs to be implemented by subclasses.
- */
-class BaseDocumentLoader {
-    /**
-     * Loads the documents and splits them using a specified text splitter.
-     * @param textSplitter The TextSplitter instance to use for splitting the loaded documents. Defaults to a RecursiveCharacterTextSplitter instance.
-     * @returns A Promise that resolves with an array of Document instances, each split according to the provided TextSplitter.
-     */
-    async loadAndSplit(splitter = new text_splitter_js_1.RecursiveCharacterTextSplitter()) {
-        const docs = await this.load();
-        return splitter.splitDocuments(docs);
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
     }
-}
-exports.BaseDocumentLoader = BaseDocumentLoader;
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("@langchain/core/document_loaders/base"), exports);

package/dist/document_loaders/base.d.ts

@@ -1,27 +1 @@
-import { Document } from "@langchain/core/documents";
-import { TextSplitter } from "../text_splitter.js";
-/**
- * Interface that defines the methods for loading and splitting documents.
- */
-export interface DocumentLoader {
-    load(): Promise<Document[]>;
-    loadAndSplit(textSplitter?: TextSplitter): Promise<Document[]>;
-}
-/**
- * Abstract class that provides a default implementation for the
- * loadAndSplit() method from the DocumentLoader interface. The load()
- * method is left abstract and needs to be implemented by subclasses.
- */
-export declare abstract class BaseDocumentLoader implements DocumentLoader {
-    /**
-     * Loads the documents.
-     * @returns A Promise that resolves with an array of Document instances.
-     */
-    abstract load(): Promise<Document[]>;
-    /**
-     * Loads the documents and splits them using a specified text splitter.
-     * @param textSplitter The TextSplitter instance to use for splitting the loaded documents. Defaults to a RecursiveCharacterTextSplitter instance.
-     * @returns A Promise that resolves with an array of Document instances, each split according to the provided TextSplitter.
-     */
-    loadAndSplit(splitter?: TextSplitter): Promise<Document[]>;
-}
+export * from "@langchain/core/document_loaders/base";

package/dist/document_loaders/base.js

@@ -1,17 +1 @@
-import { RecursiveCharacterTextSplitter, } from "../text_splitter.js";
-/**
- * Abstract class that provides a default implementation for the
- * loadAndSplit() method from the DocumentLoader interface. The load()
- * method is left abstract and needs to be implemented by subclasses.
- */
-export class BaseDocumentLoader {
-    /**
-     * Loads the documents and splits them using a specified text splitter.
-     * @param textSplitter The TextSplitter instance to use for splitting the loaded documents. Defaults to a RecursiveCharacterTextSplitter instance.
-     * @returns A Promise that resolves with an array of Document instances, each split according to the provided TextSplitter.
-     */
-    async loadAndSplit(splitter = new RecursiveCharacterTextSplitter()) {
-        const docs = await this.load();
-        return splitter.splitDocuments(docs);
-    }
-}
+export * from "@langchain/core/document_loaders/base";

package/dist/document_loaders/fs/chatgpt.cjs

@@ -3,6 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ChatGPTLoader = void 0;
 const documents_1 = require("@langchain/core/documents");
 const text_js_1 = require("./text.cjs");
+const entrypoint_deprecation_js_1 = require("../../util/entrypoint_deprecation.cjs");
+/* #__PURE__ */ (0, entrypoint_deprecation_js_1.logVersion020MigrationWarning)({
+    oldEntrypointName: "document_loaders/fs/chatgpt",
+    newPackageName: "@langchain/community",
+});
 function concatenateRows(message, title) {
     /**
      * Combine message information in a readable format ready to be used.

package/dist/document_loaders/fs/chatgpt.js

@@ -1,5 +1,10 @@
 import { Document } from "@langchain/core/documents";
 import { TextLoader } from "./text.js";
+import { logVersion020MigrationWarning } from "../../util/entrypoint_deprecation.js";
+/* #__PURE__ */ logVersion020MigrationWarning({
+    oldEntrypointName: "document_loaders/fs/chatgpt",
+    newPackageName: "@langchain/community",
+});
 function concatenateRows(message, title) {
     /**
      * Combine message information in a readable format ready to be used.

package/dist/document_loaders/fs/csv.cjs

@@ -2,6 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CSVLoader = void 0;
 const text_js_1 = require("./text.cjs");
+const entrypoint_deprecation_js_1 = require("../../util/entrypoint_deprecation.cjs");
+/* #__PURE__ */ (0, entrypoint_deprecation_js_1.logVersion020MigrationWarning)({
+    oldEntrypointName: "document_loaders/fs/csv",
+    newPackageName: "@langchain/community",
+});
 /**
  * A class that extends the TextLoader class. It represents a document
  * loader that loads documents from a CSV file. It has a constructor that

package/dist/document_loaders/fs/csv.js

@@ -1,4 +1,9 @@
 import { TextLoader } from "./text.js";
+import { logVersion020MigrationWarning } from "../../util/entrypoint_deprecation.js";
+/* #__PURE__ */ logVersion020MigrationWarning({
+    oldEntrypointName: "document_loaders/fs/csv",
+    newPackageName: "@langchain/community",
+});
 /**
  * A class that extends the TextLoader class. It represents a document
  * loader that loads documents from a CSV file. It has a constructor that

package/dist/document_loaders/fs/docx.cjs

@@ -3,6 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DocxLoader = void 0;
 const documents_1 = require("@langchain/core/documents");
 const buffer_js_1 = require("./buffer.cjs");
+const entrypoint_deprecation_js_1 = require("../../util/entrypoint_deprecation.cjs");
+/* #__PURE__ */ (0, entrypoint_deprecation_js_1.logVersion020MigrationWarning)({
+    oldEntrypointName: "document_loaders/fs/docx",
+    newPackageName: "@langchain/community",
+});
 /**
  * A class that extends the `BufferLoader` class. It represents a document
  * loader that loads documents from DOCX files.

package/dist/document_loaders/fs/docx.js

@@ -1,5 +1,10 @@
 import { Document } from "@langchain/core/documents";
 import { BufferLoader } from "./buffer.js";
+import { logVersion020MigrationWarning } from "../../util/entrypoint_deprecation.js";
+/* #__PURE__ */ logVersion020MigrationWarning({
+    oldEntrypointName: "document_loaders/fs/docx",
+    newPackageName: "@langchain/community",
+});
 /**
  * A class that extends the `BufferLoader` class. It represents a document
  * loader that loads documents from DOCX files.

package/dist/document_loaders/fs/epub.cjs

@@ -3,6 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.EPubLoader = void 0;
 const documents_1 = require("@langchain/core/documents");
 const base_js_1 = require("../base.cjs");
+const entrypoint_deprecation_js_1 = require("../../util/entrypoint_deprecation.cjs");
+/* #__PURE__ */ (0, entrypoint_deprecation_js_1.logVersion020MigrationWarning)({
+    oldEntrypointName: "document_loaders/fs/epub",
+    newPackageName: "@langchain/community",
+});
 /**
  * A class that extends the `BaseDocumentLoader` class. It represents a
  * document loader that loads documents from EPUB files.