langchain 0.0.130 → 0.0.132

package/dist/output_parsers/expression_type_handlers/types.d.ts

@@ -1,40 +1,90 @@
+/**
+ * Represents the different types of arguments that can be used in
+ * LangChain.
+ */
 export type ArgumentsType = IdentifierType | StringLiteralType | NumericLiteralType | ArrayLiteralType | ObjectLiteralType | CallExpressionType | BooleanLiteralType;
+/**
+ * Represents the parsed types in LangChain, which can be either an
+ * ArgumentsType or a PropertyAssignmentType.
+ */
 export type ParsedType = ArgumentsType | PropertyAssignmentType;
+/**
+ * Represents an array literal in LangChain. It has a type property set to
+ * 'array_literal' and a values property which is an array of
+ * ArgumentsType.
+ */
 export type ArrayLiteralType = {
     type: "array_literal";
     values: ArgumentsType[];
 };
+/**
+ * Represents a boolean literal in LangChain. It has a type property set
+ * to 'boolean_literal' and a value property which is a boolean.
+ */
 export type BooleanLiteralType = {
     type: "boolean_literal";
     value: boolean;
 };
+/**
+ * Represents a call expression in LangChain. It has a type property set
+ * to 'call_expression', a funcCall property which can be a string or a
+ * MemberExpressionType, and an optional args property which is an array
+ * of ArgumentsType.
+ */
 export type CallExpressionType = {
     type: "call_expression";
     funcCall: string | MemberExpressionType;
     args?: ArgumentsType[];
 };
+/**
+ * Represents a numeric literal in LangChain. It has a type property set
+ * to 'numeric_literal' and a value property which is a number.
+ */
 export type NumericLiteralType = {
     type: "numeric_literal";
     value: number;
 };
+/**
+ * Represents an object literal in LangChain. It has a type property set
+ * to 'object_literal' and a values property which is an array of
+ * PropertyAssignmentType.
+ */
 export type ObjectLiteralType = {
     type: "object_literal";
     values: PropertyAssignmentType[];
 };
+/**
+ * Represents a member expression in LangChain. It has a type property set
+ * to 'member_expression', an identifier property which is a string, and a
+ * property property which is also a string.
+ */
 export type MemberExpressionType = {
     type: "member_expression";
     identifier: string;
     property: string;
 };
+/**
+ * Represents a property assignment in LangChain. It has a type property
+ * set to 'property_assignment', an identifier property which is a string,
+ * and a value property which is an ArgumentsType.
+ */
 export type PropertyAssignmentType = {
     type: "property_assignment";
     identifier: string;
     value: ArgumentsType;
 };
+/**
+ * Represents a string literal in LangChain. It has a type property set to
+ * 'string_literal' and a value property which is a string.
+ */
 export type StringLiteralType = {
     type: "string_literal";
     value: string;
 };
+/**
+ * Represents an identifier in LangChain. It has a type property set to
+ * 'identifier' and a value property which is a string.
+ */
 export type IdentifierType = {
     type: "identifier";
     value: string;

package/dist/output_parsers/fix.cjs

@@ -4,7 +4,23 @@ exports.OutputFixingParser = void 0;
 const output_parser_js_1 = require("../schema/output_parser.cjs");
 const llm_chain_js_1 = require("../chains/llm_chain.cjs");
 const prompts_js_1 = require("./prompts.cjs");
+/**
+ * Class that extends the BaseOutputParser to handle situations where the
+ * initial parsing attempt fails. It contains a retryChain for retrying
+ * the parsing process in case of a failure.
+ */
 class OutputFixingParser extends output_parser_js_1.BaseOutputParser {
+    static lc_name() {
+        return "OutputFixingParser";
+    }
+    /**
+     * Static method to create a new instance of OutputFixingParser using a
+     * given language model, parser, and optional fields.
+     * @param llm The language model to be used.
+     * @param parser The parser to be used.
+     * @param fields Optional fields which may contain a prompt.
+     * @returns A new instance of OutputFixingParser.
+     */
     static fromLLM(llm, parser, fields) {
         const prompt = fields?.prompt ?? prompts_js_1.NAIVE_FIX_PROMPT;
         const chain = new llm_chain_js_1.LLMChain({ llm, prompt });
@@ -39,6 +55,14 @@ class OutputFixingParser extends output_parser_js_1.BaseOutputParser {
         this.parser = parser;
         this.retryChain = retryChain;
     }
+    /**
+     * Method to parse the completion using the parser. If the initial parsing
+     * fails, it uses the retryChain to attempt to fix the output and retry
+     * the parsing process.
+     * @param completion The completion to be parsed.
+     * @param callbacks Optional callbacks to be used during parsing.
+     * @returns The parsed output.
+     */
     async parse(completion, callbacks) {
         try {
             return await this.parser.parse(completion, callbacks);
@@ -57,6 +81,10 @@ class OutputFixingParser extends output_parser_js_1.BaseOutputParser {
             throw e;
         }
     }
+    /**
+     * Method to get the format instructions for the parser.
+     * @returns The format instructions for the parser.
+     */
     getFormatInstructions() {
         return this.parser.getFormatInstructions();
     }

package/dist/output_parsers/fix.d.ts

@@ -3,11 +3,25 @@ import { BasePromptTemplate } from "../prompts/base.js";
 import { LLMChain } from "../chains/llm_chain.js";
 import { BaseLanguageModel } from "../base_language/index.js";
 import { Callbacks } from "../callbacks/manager.js";
+/**
+ * Class that extends the BaseOutputParser to handle situations where the
+ * initial parsing attempt fails. It contains a retryChain for retrying
+ * the parsing process in case of a failure.
+ */
 export declare class OutputFixingParser<T> extends BaseOutputParser<T> {
+    static lc_name(): string;
     lc_namespace: string[];
     lc_serializable: boolean;
     parser: BaseOutputParser<T>;
     retryChain: LLMChain;
+    /**
+     * Static method to create a new instance of OutputFixingParser using a
+     * given language model, parser, and optional fields.
+     * @param llm The language model to be used.
+     * @param parser The parser to be used.
+     * @param fields Optional fields which may contain a prompt.
+     * @returns A new instance of OutputFixingParser.
+     */
     static fromLLM<T>(llm: BaseLanguageModel, parser: BaseOutputParser<T>, fields?: {
         prompt?: BasePromptTemplate;
     }): OutputFixingParser<T>;
@@ -15,6 +29,18 @@ export declare class OutputFixingParser<T> extends BaseOutputParser<T> {
         parser: BaseOutputParser<T>;
         retryChain: LLMChain;
     });
+    /**
+     * Method to parse the completion using the parser. If the initial parsing
+     * fails, it uses the retryChain to attempt to fix the output and retry
+     * the parsing process.
+     * @param completion The completion to be parsed.
+     * @param callbacks Optional callbacks to be used during parsing.
+     * @returns The parsed output.
+     */
     parse(completion: string, callbacks?: Callbacks): Promise<T>;
+    /**
+     * Method to get the format instructions for the parser.
+     * @returns The format instructions for the parser.
+     */
     getFormatInstructions(): string;
 }

package/dist/output_parsers/fix.js

@@ -1,7 +1,23 @@
 import { BaseOutputParser, OutputParserException, } from "../schema/output_parser.js";
 import { LLMChain } from "../chains/llm_chain.js";
 import { NAIVE_FIX_PROMPT } from "./prompts.js";
+/**
+ * Class that extends the BaseOutputParser to handle situations where the
+ * initial parsing attempt fails. It contains a retryChain for retrying
+ * the parsing process in case of a failure.
+ */
 export class OutputFixingParser extends BaseOutputParser {
+    static lc_name() {
+        return "OutputFixingParser";
+    }
+    /**
+     * Static method to create a new instance of OutputFixingParser using a
+     * given language model, parser, and optional fields.
+     * @param llm The language model to be used.
+     * @param parser The parser to be used.
+     * @param fields Optional fields which may contain a prompt.
+     * @returns A new instance of OutputFixingParser.
+     */
     static fromLLM(llm, parser, fields) {
         const prompt = fields?.prompt ?? NAIVE_FIX_PROMPT;
         const chain = new LLMChain({ llm, prompt });
@@ -36,6 +52,14 @@ export class OutputFixingParser extends BaseOutputParser {
         this.parser = parser;
         this.retryChain = retryChain;
     }
+    /**
+     * Method to parse the completion using the parser. If the initial parsing
+     * fails, it uses the retryChain to attempt to fix the output and retry
+     * the parsing process.
+     * @param completion The completion to be parsed.
+     * @param callbacks Optional callbacks to be used during parsing.
+     * @returns The parsed output.
+     */
     async parse(completion, callbacks) {
         try {
             return await this.parser.parse(completion, callbacks);
@@ -54,6 +78,10 @@ export class OutputFixingParser extends BaseOutputParser {
             throw e;
         }
     }
+    /**
+     * Method to get the format instructions for the parser.
+     * @returns The format instructions for the parser.
+     */
     getFormatInstructions() {
         return this.parser.getFormatInstructions();
     }

package/dist/output_parsers/list.cjs

@@ -29,6 +29,15 @@ class CommaSeparatedListOutputParser extends ListOutputParser {
             value: true
         });
     }
+    static lc_name() {
+        return "CommaSeparatedListOutputParser";
+    }
+    /**
+     * Parses the given text into an array of strings, using a comma as the
+     * separator. If the parsing fails, throws an OutputParserException.
+     * @param text The text to parse.
+     * @returns An array of strings obtained by splitting the input text at each comma.
+     */
     async parse(text) {
         try {
             return text
@@ -40,6 +49,11 @@ class CommaSeparatedListOutputParser extends ListOutputParser {
             throw new output_parser_js_1.OutputParserException(`Could not parse output: ${text}`, text);
         }
     }
+    /**
+     * Provides instructions on the expected format of the response for the
+     * CommaSeparatedListOutputParser.
+     * @returns A string containing instructions on the expected format of the response.
+     */
     getFormatInstructions() {
         return `Your response should be a list of comma separated values, eg: \`foo, bar, baz\``;
     }
@@ -73,6 +87,13 @@ class CustomListOutputParser extends ListOutputParser {
         this.length = length;
         this.separator = separator || ",";
     }
+    /**
+     * Parses the given text into an array of strings, using the specified
+     * separator. If the parsing fails or the number of items in the list
+     * doesn't match the expected length, throws an OutputParserException.
+     * @param text The text to parse.
+     * @returns An array of strings obtained by splitting the input text at each occurrence of the specified separator.
+     */
     async parse(text) {
         try {
             const items = text
@@ -91,6 +112,12 @@ class CustomListOutputParser extends ListOutputParser {
             throw new output_parser_js_1.OutputParserException(`Could not parse output: ${text}`);
         }
     }
+    /**
+     * Provides instructions on the expected format of the response for the
+     * CustomListOutputParser, including the number of items and the
+     * separator.
+     * @returns A string containing instructions on the expected format of the response.
+     */
     getFormatInstructions() {
         return `Your response should be a list of ${this.length} items separated by "${this.separator}" (eg: \`foo${this.separator} bar${this.separator} baz\`)`;
     }

package/dist/output_parsers/list.d.ts

@@ -10,9 +10,21 @@ export declare abstract class ListOutputParser extends BaseOutputParser<string[]
  * @augments ListOutputParser
  */
 export declare class CommaSeparatedListOutputParser extends ListOutputParser {
+    static lc_name(): string;
     lc_namespace: string[];
     lc_serializable: boolean;
+    /**
+     * Parses the given text into an array of strings, using a comma as the
+     * separator. If the parsing fails, throws an OutputParserException.
+     * @param text The text to parse.
+     * @returns An array of strings obtained by splitting the input text at each comma.
+     */
     parse(text: string): Promise<string[]>;
+    /**
+     * Provides instructions on the expected format of the response for the
+     * CommaSeparatedListOutputParser.
+     * @returns A string containing instructions on the expected format of the response.
+     */
     getFormatInstructions(): string;
 }
 /**
@@ -27,6 +39,19 @@ export declare class CustomListOutputParser extends ListOutputParser {
         length?: number;
         separator?: string;
     });
+    /**
+     * Parses the given text into an array of strings, using the specified
+     * separator. If the parsing fails or the number of items in the list
+     * doesn't match the expected length, throws an OutputParserException.
+     * @param text The text to parse.
+     * @returns An array of strings obtained by splitting the input text at each occurrence of the specified separator.
+     */
     parse(text: string): Promise<string[]>;
+    /**
+     * Provides instructions on the expected format of the response for the
+     * CustomListOutputParser, including the number of items and the
+     * separator.
+     * @returns A string containing instructions on the expected format of the response.
+     */
     getFormatInstructions(): string;
 }

package/dist/output_parsers/list.js

@@ -25,6 +25,15 @@ export class CommaSeparatedListOutputParser extends ListOutputParser {
             value: true
         });
     }
+    static lc_name() {
+        return "CommaSeparatedListOutputParser";
+    }
+    /**
+     * Parses the given text into an array of strings, using a comma as the
+     * separator. If the parsing fails, throws an OutputParserException.
+     * @param text The text to parse.
+     * @returns An array of strings obtained by splitting the input text at each comma.
+     */
     async parse(text) {
         try {
             return text
@@ -36,6 +45,11 @@ export class CommaSeparatedListOutputParser extends ListOutputParser {
             throw new OutputParserException(`Could not parse output: ${text}`, text);
         }
     }
+    /**
+     * Provides instructions on the expected format of the response for the
+     * CommaSeparatedListOutputParser.
+     * @returns A string containing instructions on the expected format of the response.
+     */
     getFormatInstructions() {
         return `Your response should be a list of comma separated values, eg: \`foo, bar, baz\``;
     }
@@ -68,6 +82,13 @@ export class CustomListOutputParser extends ListOutputParser {
         this.length = length;
         this.separator = separator || ",";
     }
+    /**
+     * Parses the given text into an array of strings, using the specified
+     * separator. If the parsing fails or the number of items in the list
+     * doesn't match the expected length, throws an OutputParserException.
+     * @param text The text to parse.
+     * @returns An array of strings obtained by splitting the input text at each occurrence of the specified separator.
+     */
     async parse(text) {
         try {
             const items = text
@@ -86,6 +107,12 @@ export class CustomListOutputParser extends ListOutputParser {
             throw new OutputParserException(`Could not parse output: ${text}`);
         }
     }
+    /**
+     * Provides instructions on the expected format of the response for the
+     * CustomListOutputParser, including the number of items and the
+     * separator.
+     * @returns A string containing instructions on the expected format of the response.
+     */
     getFormatInstructions() {
         return `Your response should be a list of ${this.length} items separated by "${this.separator}" (eg: \`foo${this.separator} bar${this.separator} baz\`)`;
     }

package/dist/output_parsers/noop.cjs

@@ -2,6 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NoOpOutputParser = void 0;
 const output_parser_js_1 = require("../schema/output_parser.cjs");
+/**
+ * The NoOpOutputParser class is a type of output parser that does not
+ * perform any operations on the output. It extends the BaseOutputParser
+ * class and is part of the LangChain's output parsers module. This class
+ * is useful in scenarios where the raw output of the Large Language
+ * Models (LLMs) is required.
+ */
 class NoOpOutputParser extends output_parser_js_1.BaseOutputParser {
     constructor() {
         super(...arguments);
@@ -18,9 +25,23 @@ class NoOpOutputParser extends output_parser_js_1.BaseOutputParser {
             value: true
         });
     }
+    static lc_name() {
+        return "NoOpOutputParser";
+    }
+    /**
+     * This method takes a string as input and returns the same string as
+     * output. It does not perform any operations on the input string.
+     * @param text The input string to be parsed.
+     * @returns The same input string without any operations performed on it.
+     */
     parse(text) {
         return Promise.resolve(text);
     }
+    /**
+     * This method returns an empty string. It does not provide any formatting
+     * instructions.
+     * @returns An empty string, indicating no formatting instructions.
+     */
     getFormatInstructions() {
         return "";
     }

package/dist/output_parsers/noop.d.ts

@@ -1,7 +1,26 @@
 import { BaseOutputParser } from "../schema/output_parser.js";
+/**
+ * The NoOpOutputParser class is a type of output parser that does not
+ * perform any operations on the output. It extends the BaseOutputParser
+ * class and is part of the LangChain's output parsers module. This class
+ * is useful in scenarios where the raw output of the Large Language
+ * Models (LLMs) is required.
+ */
 export declare class NoOpOutputParser extends BaseOutputParser<string> {
+    static lc_name(): string;
     lc_namespace: string[];
     lc_serializable: boolean;
+    /**
+     * This method takes a string as input and returns the same string as
+     * output. It does not perform any operations on the input string.
+     * @param text The input string to be parsed.
+     * @returns The same input string without any operations performed on it.
+     */
     parse(text: string): Promise<string>;
+    /**
+     * This method returns an empty string. It does not provide any formatting
+     * instructions.
+     * @returns An empty string, indicating no formatting instructions.
+     */
     getFormatInstructions(): string;
 }

package/dist/output_parsers/noop.js

@@ -1,4 +1,11 @@
 import { BaseOutputParser } from "../schema/output_parser.js";
+/**
+ * The NoOpOutputParser class is a type of output parser that does not
+ * perform any operations on the output. It extends the BaseOutputParser
+ * class and is part of the LangChain's output parsers module. This class
+ * is useful in scenarios where the raw output of the Large Language
+ * Models (LLMs) is required.
+ */
 export class NoOpOutputParser extends BaseOutputParser {
     constructor() {
         super(...arguments);
@@ -15,9 +22,23 @@ export class NoOpOutputParser extends BaseOutputParser {
             value: true
         });
     }
+    static lc_name() {
+        return "NoOpOutputParser";
+    }
+    /**
+     * This method takes a string as input and returns the same string as
+     * output. It does not perform any operations on the input string.
+     * @param text The input string to be parsed.
+     * @returns The same input string without any operations performed on it.
+     */
     parse(text) {
         return Promise.resolve(text);
     }
+    /**
+     * This method returns an empty string. It does not provide any formatting
+     * instructions.
+     * @returns An empty string, indicating no formatting instructions.
+     */
     getFormatInstructions() {
         return "";
     }

package/dist/output_parsers/openai_functions.cjs

@@ -2,7 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.JsonKeyOutputFunctionsParser = exports.JsonOutputFunctionsParser = exports.OutputFunctionsParser = void 0;
 const output_parser_js_1 = require("../schema/output_parser.cjs");
+/**
+ * Class for parsing the output of an LLM. Can be configured to return
+ * only the arguments of the function call in the output.
+ */
 class OutputFunctionsParser extends output_parser_js_1.BaseLLMOutputParser {
+    static lc_name() {
+        return "OutputFunctionsParser";
+    }
     constructor(config) {
         super();
         Object.defineProperty(this, "lc_namespace", {
@@ -25,6 +32,12 @@ class OutputFunctionsParser extends output_parser_js_1.BaseLLMOutputParser {
         });
         this.argsOnly = config?.argsOnly ?? this.argsOnly;
     }
+    /**
+     * Parses the output and returns a string representation of the function
+     * call or its arguments.
+     * @param generations The output of the LLM to parse.
+     * @returns A string representation of the function call or its arguments.
+     */
     async parseResult(generations) {
         if ("message" in generations[0]) {
             const gen = generations[0];
@@ -46,7 +59,14 @@ class OutputFunctionsParser extends output_parser_js_1.BaseLLMOutputParser {
     }
 }
 exports.OutputFunctionsParser = OutputFunctionsParser;
+/**
+ * Class for parsing the output of an LLM into a JSON object. Uses an
+ * instance of `OutputFunctionsParser` to parse the output.
+ */
 class JsonOutputFunctionsParser extends output_parser_js_1.BaseLLMOutputParser {
+    static lc_name() {
+        return "JsonOutputFunctionsParser";
+    }
     constructor(config) {
         super();
         Object.defineProperty(this, "lc_namespace", {
@@ -76,6 +96,12 @@ class JsonOutputFunctionsParser extends output_parser_js_1.BaseLLMOutputParser {
         this.argsOnly = config?.argsOnly ?? this.argsOnly;
         this.outputParser = new OutputFunctionsParser(config);
     }
+    /**
+     * Parses the output and returns a JSON object. If `argsOnly` is true,
+     * only the arguments of the function call are returned.
+     * @param generations The output of the LLM to parse.
+     * @returns A JSON object representation of the function call or its arguments.
+     */
     async parseResult(generations) {
         const result = await this.outputParser.parseResult(generations);
         if (!result) {
@@ -90,7 +116,15 @@ class JsonOutputFunctionsParser extends output_parser_js_1.BaseLLMOutputParser {
     }
 }
 exports.JsonOutputFunctionsParser = JsonOutputFunctionsParser;
+/**
+ * Class for parsing the output of an LLM into a JSON object and returning
+ * a specific attribute. Uses an instance of `JsonOutputFunctionsParser`
+ * to parse the output.
+ */
 class JsonKeyOutputFunctionsParser extends output_parser_js_1.BaseLLMOutputParser {
+    static lc_name() {
+        return "JsonKeyOutputFunctionsParser";
+    }
     constructor(fields) {
         super(fields);
         Object.defineProperty(this, "lc_namespace", {
@@ -119,6 +153,12 @@ class JsonKeyOutputFunctionsParser extends output_parser_js_1.BaseLLMOutputParse
         });
         this.attrName = fields.attrName;
     }
+    /**
+     * Parses the output and returns a specific attribute of the parsed JSON
+     * object.
+     * @param generations The output of the LLM to parse.
+     * @returns The value of a specific attribute of the parsed JSON object.
+     */
     async parseResult(generations) {
         const result = await this.outputParser.parseResult(generations);
         return result[this.attrName];

package/dist/output_parsers/openai_functions.d.ts

@@ -2,17 +2,36 @@ import { JsonSchema7ObjectType } from "zod-to-json-schema/src/parsers/object.js"
 import { ChatGeneration, Generation } from "../schema/index.js";
 import { Optional } from "../types/type-utils.js";
 import { BaseLLMOutputParser } from "../schema/output_parser.js";
+/**
+ * Represents optional parameters for a function in a JSON Schema.
+ */
 export type FunctionParameters = Optional<JsonSchema7ObjectType, "additionalProperties">;
+/**
+ * Class for parsing the output of an LLM. Can be configured to return
+ * only the arguments of the function call in the output.
+ */
 export declare class OutputFunctionsParser extends BaseLLMOutputParser<string> {
+    static lc_name(): string;
     lc_namespace: string[];
     lc_serializable: boolean;
     argsOnly: boolean;
     constructor(config?: {
         argsOnly: boolean;
     });
+    /**
+     * Parses the output and returns a string representation of the function
+     * call or its arguments.
+     * @param generations The output of the LLM to parse.
+     * @returns A string representation of the function call or its arguments.
+     */
     parseResult(generations: Generation[] | ChatGeneration[]): Promise<string>;
 }
+/**
+ * Class for parsing the output of an LLM into a JSON object. Uses an
+ * instance of `OutputFunctionsParser` to parse the output.
+ */
 export declare class JsonOutputFunctionsParser extends BaseLLMOutputParser<object> {
+    static lc_name(): string;
     lc_namespace: string[];
     lc_serializable: boolean;
     outputParser: OutputFunctionsParser;
@@ -20,9 +39,21 @@ export declare class JsonOutputFunctionsParser extends BaseLLMOutputParser<objec
     constructor(config?: {
         argsOnly: boolean;
     });
+    /**
+     * Parses the output and returns a JSON object. If `argsOnly` is true,
+     * only the arguments of the function call are returned.
+     * @param generations The output of the LLM to parse.
+     * @returns A JSON object representation of the function call or its arguments.
+     */
     parseResult(generations: Generation[] | ChatGeneration[]): Promise<object>;
 }
+/**
+ * Class for parsing the output of an LLM into a JSON object and returning
+ * a specific attribute. Uses an instance of `JsonOutputFunctionsParser`
+ * to parse the output.
+ */
 export declare class JsonKeyOutputFunctionsParser<T = object> extends BaseLLMOutputParser<T> {
+    static lc_name(): string;
     lc_namespace: string[];
     lc_serializable: boolean;
     outputParser: JsonOutputFunctionsParser;
@@ -30,5 +61,11 @@ export declare class JsonKeyOutputFunctionsParser<T = object> extends BaseLLMOut
     constructor(fields: {
         attrName: string;
     });
+    /**
+     * Parses the output and returns a specific attribute of the parsed JSON
+     * object.
+     * @param generations The output of the LLM to parse.
+     * @returns The value of a specific attribute of the parsed JSON object.
+     */
     parseResult(generations: Generation[] | ChatGeneration[]): Promise<T>;
 }