langchain 0.3.0-rc.0 → 0.3.1

package/README.md

@@ -34,10 +34,10 @@ LangChain is written in TypeScript and can be used in:
 - **Reason**: rely on a language model to reason (about how to answer based on provided context, what actions to take, etc.)
 
 This framework consists of several parts.
-- **Open-source libraries**: Build your applications using LangChain's open-source [building blocks](https://js.langchain.com/v0.2/docs/concepts#langchain-expression-language), [components](https://js.langchain.com/v0.2/docs/concepts), and [third-party integrations](https://js.langchain.com/v0.2/docs/integrations/platforms/).
-Use [LangGraph.js](https://js.langchain.com/v0.2/docs/concepts/#langgraphjs) to build stateful agents with first-class streaming and human-in-the-loop support.
+- **Open-source libraries**: Build your applications using LangChain's open-source [building blocks](https://js.langchain.com/docs/concepts#langchain-expression-language), [components](https://js.langchain.com/docs/concepts), and [third-party integrations](https://js.langchain.com/docs/integrations/platforms/).
+Use [LangGraph.js](https://js.langchain.com/docs/concepts/#langgraphjs) to build stateful agents with first-class streaming and human-in-the-loop support.
 - **Productionization**: Use [LangSmith](https://docs.smith.langchain.com/) to inspect, monitor and evaluate your chains, so that you can continuously optimize and deploy with confidence.
-- **Deployment**: Turn your LangGraph applications into production-ready APIs and Assistants with [LangGraph Cloud](https://langchain-ai.github.io/langgraph/cloud/) (currently Python-only).
+- **Deployment**: Turn your LangGraph applications into production-ready APIs and Assistants with [LangGraph Cloud](https://langchain-ai.github.io/langgraph/cloud/).
 
 The LangChain libraries themselves are made up of several different packages.
 - **[`@langchain/core`](https://github.com/langchain-ai/langchainjs/blob/main/langchain-core)**: Base abstractions and LangChain Expression Language.
@@ -53,13 +53,13 @@ This library aims to assist in the development of those types of applications. C
 
 **❓Question Answering over specific documents**
 
-- [Documentation](https://js.langchain.com/v0.2/docs/tutorials/rag)
+- [Documentation](https://js.langchain.com/docs/tutorials/rag)
 - End-to-end Example: [Doc-Chatbot](https://github.com/dissorial/doc-chatbot)
 
 
 **💬 Chatbots**
 
-- [Documentation](https://js.langchain.com/v0.2/docs/how_to/#chatbots)
+- [Documentation](https://js.langchain.com/docs/how_to/#chatbots)
 - End-to-end Example: [Chat-LangChain](https://github.com/langchain-ai/chat-langchainjs)
 
 ## 🚀 How does LangChain help?
@@ -82,15 +82,15 @@ Data Augmented Generation involves specific types of chains that first interact
 
 **🤖 Agents:**
 
-Agents allow an LLM autonomy over how a task is accomplished. Agents make decisions about which Actions to take, then take that Action, observe the result, and repeat until the task is complete. LangChain provides a [standard interface for agents](https://js.langchain.com/v0.2/docs/concepts/#agents), along with [LangGraph.js](https://github.com/langchain-ai/langgraphjs/) for building custom agents.
+Agents allow an LLM autonomy over how a task is accomplished. Agents make decisions about which Actions to take, then take that Action, observe the result, and repeat until the task is complete. LangChain provides a [standard interface for agents](https://js.langchain.com/docs/concepts/#agents), along with [LangGraph.js](https://github.com/langchain-ai/langgraphjs/) for building custom agents.
 
 ## 📖 Documentation
 
 Please see [here](https://js.langchain.com) for full documentation, which includes:
 
-- [Getting started](https://js.langchain.com/v0.2/docs/introduction): installation, setting up the environment, simple examples
-- Overview of the [interfaces](https://js.langchain.com/v0.2/docs/how_to/lcel_cheatsheet/), [modules](https://js.langchain.com/v0.2/docs/concepts) and [integrations](https://js.langchain.com/v0.2/docs/integrations/platforms/)
-- [Tutorial](https://js.langchain.com/v0.2/docs/tutorials/) walkthroughs
+- [Getting started](https://js.langchain.com/docs/introduction): installation, setting up the environment, simple examples
+- Overview of the [interfaces](https://js.langchain.com/docs/how_to/lcel_cheatsheet/), [modules](https://js.langchain.com/docs/concepts) and [integrations](https://js.langchain.com/docs/integrations/platforms/)
+- [Tutorial](https://js.langchain.com/docs/tutorials/) walkthroughs
 - [Reference](https://api.js.langchain.com): full API docs
 
 ## 💁 Contributing

package/dist/agents/chat/index.cjs

@@ -11,7 +11,7 @@ const DEFAULT_HUMAN_MESSAGE_TEMPLATE = "{input}\n\n{agent_scratchpad}";
  * Agent for the MRKL chain.
  * @augments Agent
  *
- * @deprecated Use the {@link https://v02.api.js.langchain.com/functions/langchain.agents.createStructuredChatAgent.html | createStructuredChatAgent method instead}.
+ * @deprecated Use the {@link https://api.js.langchain.com/functions/langchain.agents.createStructuredChatAgent.html | createStructuredChatAgent method instead}.
  */
 class ChatAgent extends agent_js_1.Agent {
     static lc_name() {

package/dist/agents/chat/index.d.ts

@@ -33,7 +33,7 @@ export type ChatAgentInput = Optional<AgentInput, "outputParser">;
  * Agent for the MRKL chain.
  * @augments Agent
  *
- * @deprecated Use the {@link https://v02.api.js.langchain.com/functions/langchain.agents.createStructuredChatAgent.html | createStructuredChatAgent method instead}.
+ * @deprecated Use the {@link https://api.js.langchain.com/functions/langchain.agents.createStructuredChatAgent.html | createStructuredChatAgent method instead}.
  */
 export declare class ChatAgent extends Agent {
     static lc_name(): string;

package/dist/agents/chat/index.js

@@ -8,7 +8,7 @@ const DEFAULT_HUMAN_MESSAGE_TEMPLATE = "{input}\n\n{agent_scratchpad}";
  * Agent for the MRKL chain.
  * @augments Agent
  *
- * @deprecated Use the {@link https://v02.api.js.langchain.com/functions/langchain.agents.createStructuredChatAgent.html | createStructuredChatAgent method instead}.
+ * @deprecated Use the {@link https://api.js.langchain.com/functions/langchain.agents.createStructuredChatAgent.html | createStructuredChatAgent method instead}.
  */
 export class ChatAgent extends Agent {
     static lc_name() {

package/dist/agents/chat_convo/index.cjs

@@ -11,7 +11,7 @@ const prompt_js_1 = require("./prompt.cjs");
  * Agent for the MRKL chain.
  * @augments Agent
  *
- * @deprecated Use the {@link https://v02.api.js.langchain.com/functions/langchain.agents.createStructuredChatAgent.html | createStructuredChatAgent method instead}.
+ * @deprecated Use the {@link https://api.js.langchain.com/functions/langchain.agents.createStructuredChatAgent.html | createStructuredChatAgent method instead}.
  */
 class ChatConversationalAgent extends agent_js_1.Agent {
     static lc_name() {

package/dist/agents/chat_convo/index.d.ts

@@ -30,7 +30,7 @@ export type ChatConversationalAgentInput = Optional<AgentInput, "outputParser">;
  * Agent for the MRKL chain.
  * @augments Agent
  *
- * @deprecated Use the {@link https://v02.api.js.langchain.com/functions/langchain.agents.createStructuredChatAgent.html | createStructuredChatAgent method instead}.
+ * @deprecated Use the {@link https://api.js.langchain.com/functions/langchain.agents.createStructuredChatAgent.html | createStructuredChatAgent method instead}.
  */
 export declare class ChatConversationalAgent extends Agent {
     static lc_name(): string;

package/dist/agents/chat_convo/index.js

@@ -8,7 +8,7 @@ import { PREFIX_END, DEFAULT_PREFIX, DEFAULT_SUFFIX, TEMPLATE_TOOL_RESPONSE, } f
  * Agent for the MRKL chain.
  * @augments Agent
  *
- * @deprecated Use the {@link https://v02.api.js.langchain.com/functions/langchain.agents.createStructuredChatAgent.html | createStructuredChatAgent method instead}.
+ * @deprecated Use the {@link https://api.js.langchain.com/functions/langchain.agents.createStructuredChatAgent.html | createStructuredChatAgent method instead}.
  */
 export class ChatConversationalAgent extends Agent {
     static lc_name() {

package/dist/agents/mrkl/index.cjs

@@ -32,7 +32,7 @@ const prompt_js_1 = require("./prompt.cjs");
  * });
  * ```
  *
- * @deprecated Use the {@link https://v02.api.js.langchain.com/functions/langchain.agents.createReactAgent.html | createReactAgent method instead}.
+ * @deprecated Use the {@link https://api.js.langchain.com/functions/langchain.agents.createReactAgent.html | createReactAgent method instead}.
  */
 class ZeroShotAgent extends agent_js_1.Agent {
     static lc_name() {

package/dist/agents/mrkl/index.d.ts

@@ -46,7 +46,7 @@ export type ZeroShotAgentInput = Optional<AgentInput, "outputParser">;
  * });
  * ```
  *
- * @deprecated Use the {@link https://v02.api.js.langchain.com/functions/langchain.agents.createReactAgent.html | createReactAgent method instead}.
+ * @deprecated Use the {@link https://api.js.langchain.com/functions/langchain.agents.createReactAgent.html | createReactAgent method instead}.
  */
 export declare class ZeroShotAgent extends Agent {
     static lc_name(): string;

package/dist/agents/mrkl/index.js

@@ -29,7 +29,7 @@ import { FORMAT_INSTRUCTIONS, PREFIX, SUFFIX } from "./prompt.js";
  * });
  * ```
  *
- * @deprecated Use the {@link https://v02.api.js.langchain.com/functions/langchain.agents.createReactAgent.html | createReactAgent method instead}.
+ * @deprecated Use the {@link https://api.js.langchain.com/functions/langchain.agents.createReactAgent.html | createReactAgent method instead}.
  */
 export class ZeroShotAgent extends Agent {
     static lc_name() {

package/dist/agents/openai_functions/index.cjs

@@ -35,7 +35,7 @@ exports._formatIntermediateSteps = _formatIntermediateSteps;
  * extends the Agent class and provides additional functionality specific
  * to the OpenAIAgent type.
  *
- * @deprecated Use the {@link https://v02.api.js.langchain.com/functions/langchain.agents.createOpenAIFunctionsAgent.html | createOpenAIFunctionsAgent method instead}.
+ * @deprecated Use the {@link https://api.js.langchain.com/functions/langchain.agents.createOpenAIFunctionsAgent.html | createOpenAIFunctionsAgent method instead}.
  */
 class OpenAIAgent extends agent_js_1.Agent {
     static lc_name() {

package/dist/agents/openai_functions/index.d.ts

@@ -29,7 +29,7 @@ export interface OpenAIAgentCreatePromptArgs {
  * extends the Agent class and provides additional functionality specific
  * to the OpenAIAgent type.
  *
- * @deprecated Use the {@link https://v02.api.js.langchain.com/functions/langchain.agents.createOpenAIFunctionsAgent.html | createOpenAIFunctionsAgent method instead}.
+ * @deprecated Use the {@link https://api.js.langchain.com/functions/langchain.agents.createOpenAIFunctionsAgent.html | createOpenAIFunctionsAgent method instead}.
  */
 export declare class OpenAIAgent extends Agent {
     static lc_name(): string;

package/dist/agents/openai_functions/index.js

@@ -31,7 +31,7 @@ export function _formatIntermediateSteps(intermediateSteps) {
  * extends the Agent class and provides additional functionality specific
  * to the OpenAIAgent type.
  *
- * @deprecated Use the {@link https://v02.api.js.langchain.com/functions/langchain.agents.createOpenAIFunctionsAgent.html | createOpenAIFunctionsAgent method instead}.
+ * @deprecated Use the {@link https://api.js.langchain.com/functions/langchain.agents.createOpenAIFunctionsAgent.html | createOpenAIFunctionsAgent method instead}.
  */
 export class OpenAIAgent extends Agent {
     static lc_name() {

package/dist/agents/structured_chat/index.cjs

@@ -15,7 +15,7 @@ const log_js_1 = require("../format_scratchpad/log.cjs");
 /**
  * Agent that interoperates with Structured Tools using React logic.
  * @augments Agent
- * @deprecated Use the {@link https://v02.api.js.langchain.com/functions/langchain.agents.createStructuredChatAgent.html | createStructuredChatAgent method instead}.
+ * @deprecated Use the {@link https://api.js.langchain.com/functions/langchain.agents.createStructuredChatAgent.html | createStructuredChatAgent method instead}.
  */
 class StructuredChatAgent extends agent_js_1.Agent {
     static lc_name() {

package/dist/agents/structured_chat/index.d.ts

@@ -31,7 +31,7 @@ export type StructuredChatAgentInput = Optional<AgentInput, "outputParser">;
 /**
  * Agent that interoperates with Structured Tools using React logic.
  * @augments Agent
- * @deprecated Use the {@link https://v02.api.js.langchain.com/functions/langchain.agents.createStructuredChatAgent.html | createStructuredChatAgent method instead}.
+ * @deprecated Use the {@link https://api.js.langchain.com/functions/langchain.agents.createStructuredChatAgent.html | createStructuredChatAgent method instead}.
  */
 export declare class StructuredChatAgent extends Agent {
     static lc_name(): string;

package/dist/agents/structured_chat/index.js

@@ -12,7 +12,7 @@ import { formatLogToString } from "../format_scratchpad/log.js";
 /**
  * Agent that interoperates with Structured Tools using React logic.
  * @augments Agent
- * @deprecated Use the {@link https://v02.api.js.langchain.com/functions/langchain.agents.createStructuredChatAgent.html | createStructuredChatAgent method instead}.
+ * @deprecated Use the {@link https://api.js.langchain.com/functions/langchain.agents.createStructuredChatAgent.html | createStructuredChatAgent method instead}.
  */
 export class StructuredChatAgent extends Agent {
     static lc_name() {

package/dist/agents/xml/index.cjs

@@ -12,7 +12,7 @@ const xml_js_1 = require("../format_scratchpad/xml.cjs");
 /**
  * Class that represents an agent that uses XML tags.
  *
- * @deprecated Use the {@link https://v02.api.js.langchain.com/functions/langchain.agents.createXmlAgent.html | createXmlAgent method instead}.
+ * @deprecated Use the {@link https://api.js.langchain.com/functions/langchain.agents.createXmlAgent.html | createXmlAgent method instead}.
  */
 class XMLAgent extends agent_js_1.BaseSingleActionAgent {
     static lc_name() {

package/dist/agents/xml/index.d.ts

@@ -18,7 +18,7 @@ export interface XMLAgentInput {
 /**
  * Class that represents an agent that uses XML tags.
  *
- * @deprecated Use the {@link https://v02.api.js.langchain.com/functions/langchain.agents.createXmlAgent.html | createXmlAgent method instead}.
+ * @deprecated Use the {@link https://api.js.langchain.com/functions/langchain.agents.createXmlAgent.html | createXmlAgent method instead}.
  */
 export declare class XMLAgent extends BaseSingleActionAgent implements XMLAgentInput {
     static lc_name(): string;

package/dist/agents/xml/index.js

@@ -9,7 +9,7 @@ import { formatXml } from "../format_scratchpad/xml.js";
 /**
  * Class that represents an agent that uses XML tags.
  *
- * @deprecated Use the {@link https://v02.api.js.langchain.com/functions/langchain.agents.createXmlAgent.html | createXmlAgent method instead}.
+ * @deprecated Use the {@link https://api.js.langchain.com/functions/langchain.agents.createXmlAgent.html | createXmlAgent method instead}.
  */
 export class XMLAgent extends BaseSingleActionAgent {
     static lc_name() {

package/dist/chains/load.cjs

@@ -27,7 +27,7 @@ const loadChainFromFile = async (file, path, values = {}) => {
  * const chain = await loadChain("/path/to/chain.json");
  * ```
  *
- * @deprecated Use newer {@link https://v02.api.js.langchain.com/functions/langchain.load.load.html | load method}.
+ * @deprecated Use newer {@link https://api.js.langchain.com/functions/langchain.load.load.html | load method}.
  */
 const loadChain = async (uri, values = {}) => {
     const hubResult = await (0, hub_js_1.loadFromHub)(uri, loadChainFromFile, "chains", new Set(["json", "yaml"]), values);

package/dist/chains/load.d.ts

@@ -18,6 +18,6 @@ import { LoadValues } from "../util/load.js";
  * const chain = await loadChain("/path/to/chain.json");
  * ```
  *
- * @deprecated Use newer {@link https://v02.api.js.langchain.com/functions/langchain.load.load.html | load method}.
+ * @deprecated Use newer {@link https://api.js.langchain.com/functions/langchain.load.load.html | load method}.
  */
 export declare const loadChain: (uri: string, values?: LoadValues) => Promise<BaseChain>;

package/dist/chains/load.js

@@ -24,7 +24,7 @@ const loadChainFromFile = async (file, path, values = {}) => {
  * const chain = await loadChain("/path/to/chain.json");
  * ```
  *
- * @deprecated Use newer {@link https://v02.api.js.langchain.com/functions/langchain.load.load.html | load method}.
+ * @deprecated Use newer {@link https://api.js.langchain.com/functions/langchain.load.load.html | load method}.
  */
 export const loadChain = async (uri, values = {}) => {
     const hubResult = await loadFromHub(uri, loadChainFromFile, "chains", new Set(["json", "yaml"]), values);

package/dist/chains/openai_functions/structured_output.cjs

@@ -102,7 +102,7 @@ class FunctionCallStructuredOutputParser extends output_parsers_1.BaseLLMOutputP
 }
 exports.FunctionCallStructuredOutputParser = FunctionCallStructuredOutputParser;
 /**
- * @deprecated Use {@link https://v02.api.js.langchain.com/functions/langchain.chains_openai_functions.createStructuredOutputRunnable.html | createStructuredOutputRunnable} instead
+ * @deprecated Use {@link https://api.js.langchain.com/functions/langchain.chains_openai_functions.createStructuredOutputRunnable.html | createStructuredOutputRunnable} instead
  * Create a chain that returns output matching a JSON Schema.
  * @param input Object that includes all LLMChainInput fields except "outputParser"
  * as well as an additional required "outputSchema" JSON Schema object.
@@ -138,7 +138,7 @@ function createStructuredOutputChain(input) {
     });
 }
 exports.createStructuredOutputChain = createStructuredOutputChain;
-/** @deprecated Use {@link https://v02.api.js.langchain.com/functions/langchain.chains_openai_functions.createStructuredOutputRunnable.html | createStructuredOutputRunnable} instead */
+/** @deprecated Use {@link https://api.js.langchain.com/functions/langchain.chains_openai_functions.createStructuredOutputRunnable.html | createStructuredOutputRunnable} instead */
 function createStructuredOutputChainFromZod(zodSchema, input) {
     return createStructuredOutputChain({
         ...input,

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

@@ -49,12 +49,12 @@ export declare class FunctionCallStructuredOutputParser<T extends z.AnyZodObject
     parseResult(generations: ChatGeneration[]): Promise<any>;
 }
 /**
- * @deprecated Use {@link https://v02.api.js.langchain.com/functions/langchain.chains_openai_functions.createStructuredOutputRunnable.html | createStructuredOutputRunnable} instead
+ * @deprecated Use {@link https://api.js.langchain.com/functions/langchain.chains_openai_functions.createStructuredOutputRunnable.html | createStructuredOutputRunnable} instead
  * Create a chain that returns output matching a JSON Schema.
  * @param input Object that includes all LLMChainInput fields except "outputParser"
  * as well as an additional required "outputSchema" JSON Schema object.
  * @returns OpenAPIChain
  */
 export declare function createStructuredOutputChain<T extends z.AnyZodObject = z.AnyZodObject>(input: StructuredOutputChainInput<T>): LLMChain<any, BaseChatModel<BaseFunctionCallOptions, import("@langchain/core/messages").BaseMessageChunk> | ChatOpenAI<BaseFunctionCallOptions>>;
-/** @deprecated Use {@link https://v02.api.js.langchain.com/functions/langchain.chains_openai_functions.createStructuredOutputRunnable.html | createStructuredOutputRunnable} instead */
+/** @deprecated Use {@link https://api.js.langchain.com/functions/langchain.chains_openai_functions.createStructuredOutputRunnable.html | createStructuredOutputRunnable} instead */
 export declare function createStructuredOutputChainFromZod<T extends z.AnyZodObject>(zodSchema: T, input: Omit<StructuredOutputChainInput<T>, "outputSchema">): LLMChain<any, BaseChatModel<BaseFunctionCallOptions, import("@langchain/core/messages").BaseMessageChunk> | ChatOpenAI<BaseFunctionCallOptions>>;

package/dist/chains/openai_functions/structured_output.js

@@ -98,7 +98,7 @@ export class FunctionCallStructuredOutputParser extends BaseLLMOutputParser {
     }
 }
 /**
- * @deprecated Use {@link https://v02.api.js.langchain.com/functions/langchain.chains_openai_functions.createStructuredOutputRunnable.html | createStructuredOutputRunnable} instead
+ * @deprecated Use {@link https://api.js.langchain.com/functions/langchain.chains_openai_functions.createStructuredOutputRunnable.html | createStructuredOutputRunnable} instead
  * Create a chain that returns output matching a JSON Schema.
  * @param input Object that includes all LLMChainInput fields except "outputParser"
  * as well as an additional required "outputSchema" JSON Schema object.
@@ -133,7 +133,7 @@ export function createStructuredOutputChain(input) {
         ...rest,
     });
 }
-/** @deprecated Use {@link https://v02.api.js.langchain.com/functions/langchain.chains_openai_functions.createStructuredOutputRunnable.html | createStructuredOutputRunnable} instead */
+/** @deprecated Use {@link https://api.js.langchain.com/functions/langchain.chains_openai_functions.createStructuredOutputRunnable.html | createStructuredOutputRunnable} instead */
 export function createStructuredOutputChainFromZod(zodSchema, input) {
     return createStructuredOutputChain({
         ...input,

package/dist/chains/serde.d.ts

@@ -4,7 +4,7 @@ import { SerializedBasePromptTemplate } from "@langchain/core/prompts";
  * Represents the serialized form of an LLMChain. It includes properties
  * such as `_type`, `llm`, and `prompt`.
  *
- * @deprecated Use newer {@link https://v02.api.js.langchain.com/functions/langchain.load.load.html | serialization methods}.
+ * @deprecated Use newer {@link https://api.js.langchain.com/functions/langchain.load.load.html | serialization methods}.
  */
 export type SerializedLLMChain = {
     _type: "llm_chain";
@@ -16,7 +16,7 @@ export type SerializedLLMChain = {
  * properties such as `_type`, `input_variables`, `output_variables`, and
  * `chains`.
  *
- * @deprecated Use newer {@link https://v02.api.js.langchain.com/functions/langchain.load.load.html | serialization methods}.
+ * @deprecated Use newer {@link https://api.js.langchain.com/functions/langchain.load.load.html | serialization methods}.
  */
 export type SerializedSequentialChain = {
     _type: "sequential_chain";
@@ -28,7 +28,7 @@ export type SerializedSequentialChain = {
  * Represents the serialized form of a SimpleSequentialChain. It includes
  * properties such as `_type` and `chains`.
  *
- * @deprecated Use newer {@link https://v02.api.js.langchain.com/functions/langchain.load.load.html | serialization methods}.
+ * @deprecated Use newer {@link https://api.js.langchain.com/functions/langchain.load.load.html | serialization methods}.
  */
 export type SerializedSimpleSequentialChain = {
     _type: "simple_sequential_chain";
@@ -38,7 +38,7 @@ export type SerializedSimpleSequentialChain = {
  * Represents the serialized form of a VectorDBQAChain. It includes
  * properties such as `_type`, `k`, and `combine_documents_chain`.
  *
- * @deprecated Use newer {@link https://v02.api.js.langchain.com/functions/langchain.load.load.html | serialization methods}.
+ * @deprecated Use newer {@link https://api.js.langchain.com/functions/langchain.load.load.html | serialization methods}.
  */
 export type SerializedVectorDBQAChain = {
     _type: "vector_db_qa";
@@ -50,7 +50,7 @@ export type SerializedVectorDBQAChain = {
  * such as `_type`, `api_request_chain`, `api_answer_chain`, and
  * `api_docs`.
  *
- * @deprecated Use newer {@link https://v02.api.js.langchain.com/functions/langchain.load.load.html | serialization methods}.
+ * @deprecated Use newer {@link https://api.js.langchain.com/functions/langchain.load.load.html | serialization methods}.
  */
 export type SerializedAPIChain = {
     _type: "api_chain";
@@ -62,7 +62,7 @@ export type SerializedAPIChain = {
  * Represents the serialized form of a StuffDocumentsChain. It includes
  * properties such as `_type` and `llm_chain`.
  *
- * @deprecated Use newer {@link https://v02.api.js.langchain.com/functions/langchain.load.load.html | serialization methods}.
+ * @deprecated Use newer {@link https://api.js.langchain.com/functions/langchain.load.load.html | serialization methods}.
  */
 export type SerializedStuffDocumentsChain = {
     _type: "stuff_documents_chain";
@@ -73,7 +73,7 @@ export type SerializedStuffDocumentsChain = {
  * properties such as `_type`, `k`, `combine_documents_chain`, and
  * `question_generator`.
  *
- * @deprecated Use newer {@link https://v02.api.js.langchain.com/functions/langchain.load.load.html | serialization methods}.
+ * @deprecated Use newer {@link https://api.js.langchain.com/functions/langchain.load.load.html | serialization methods}.
  */
 export type SerializedChatVectorDBQAChain = {
     _type: "chat-vector-db";
@@ -86,7 +86,7 @@ export type SerializedChatVectorDBQAChain = {
  * includes properties such as `_type`, `llm_chain`, and
  * `combine_document_chain`.
  *
- * @deprecated Use newer {@link https://v02.api.js.langchain.com/functions/langchain.load.load.html | serialization methods}.
+ * @deprecated Use newer {@link https://api.js.langchain.com/functions/langchain.load.load.html | serialization methods}.
  */
 export type SerializedMapReduceDocumentsChain = {
     _type: "map_reduce_documents_chain";
@@ -97,7 +97,7 @@ export type SerializedMapReduceDocumentsChain = {
  * Represents the serialized form of a RefineDocumentsChain. It includes
  * properties such as `_type`, `llm_chain`, and `refine_llm_chain`.
  *
- * @deprecated Use newer {@link https://v02.api.js.langchain.com/functions/langchain.load.load.html | serialization methods}.
+ * @deprecated Use newer {@link https://api.js.langchain.com/functions/langchain.load.load.html | serialization methods}.
  */
 export type SerializedRefineDocumentsChain = {
     _type: "refine_documents_chain";
@@ -108,7 +108,7 @@ export type SerializedRefineDocumentsChain = {
  * Represents the serialized form of an AnalyzeDocumentChain. It includes
  * properties such as `_type` and `combine_document_chain`.
  *
- * @deprecated Use newer {@link https://v02.api.js.langchain.com/functions/langchain.load.load.html | serialization methods}.
+ * @deprecated Use newer {@link https://api.js.langchain.com/functions/langchain.load.load.html | serialization methods}.
  */
 export type SerializedAnalyzeDocumentChain = {
     _type: "analyze_document_chain";
@@ -119,7 +119,7 @@ export type SerializedAnalyzeDocumentChain = {
  * includes properties such as `_type`, `critiqueRequest`,
  * `revisionRequest`, and `name`.
  *
- * @deprecated Use newer {@link https://v02.api.js.langchain.com/functions/langchain.load.load.html | serialization methods}.
+ * @deprecated Use newer {@link https://api.js.langchain.com/functions/langchain.load.load.html | serialization methods}.
  */
 export type SerializedConstitutionalPrinciple = {
     _type: "constitutional_principle";
@@ -145,6 +145,6 @@ export type SerializedConstitutionalChain = {
  * Represents the serialized form of a BaseChain. It can be one of the
  * above serialized chain types.
  *
- * @deprecated Use newer {@link https://v02.api.js.langchain.com/functions/langchain.load.load.html | serialization methods}.
+ * @deprecated Use newer {@link https://api.js.langchain.com/functions/langchain.load.load.html | serialization methods}.
  */
 export type SerializedBaseChain = SerializedLLMChain | SerializedSequentialChain | SerializedSimpleSequentialChain | SerializedVectorDBQAChain | SerializedAPIChain | SerializedStuffDocumentsChain | SerializedChatVectorDBQAChain | SerializedMapReduceDocumentsChain | SerializedAnalyzeDocumentChain | SerializedRefineDocumentsChain | SerializedConstitutionalChain;

package/dist/experimental/plan_and_execute/agent_executor.cjs

@@ -102,7 +102,7 @@ class PlanAndExecuteAgentExecutor extends base_js_1.BaseChain {
      */
     static getDefaultStepExecutor({ llm, tools, humanMessageTemplate = prompt_js_1.DEFAULT_STEP_EXECUTOR_HUMAN_CHAT_MESSAGE_TEMPLATE, }) {
         let agent;
-        if (isDynamicStructuredTool(tools[0])) {
+        if (tools.length > 0 && isDynamicStructuredTool(tools[0])) {
             agent = index_js_2.StructuredChatAgent.fromLLMAndTools(llm, tools, {
                 humanMessageTemplate,
                 inputVariables: ["previous_steps", "current_step", "agent_scratchpad"],

package/dist/experimental/plan_and_execute/agent_executor.js

@@ -98,7 +98,7 @@ export class PlanAndExecuteAgentExecutor extends BaseChain {
      */
     static getDefaultStepExecutor({ llm, tools, humanMessageTemplate = DEFAULT_STEP_EXECUTOR_HUMAN_CHAT_MESSAGE_TEMPLATE, }) {
         let agent;
-        if (isDynamicStructuredTool(tools[0])) {
+        if (tools.length > 0 && isDynamicStructuredTool(tools[0])) {
             agent = StructuredChatAgent.fromLLMAndTools(llm, tools, {
                 humanMessageTemplate,
                 inputVariables: ["previous_steps", "current_step", "agent_scratchpad"],

package/dist/output_parsers/openai_tools.cjs

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.JsonOutputKeyToolsParser = exports.JsonOutputToolsParser = void 0;
 const output_parsers_1 = require("@langchain/core/output_parsers");
 /**
- * Class for parsing the output of a tool-calling LLM into a JSON object.
+ * @deprecated Import from "@langchain/core/output_parsers/openai_tools"
  */
 class JsonOutputToolsParser extends output_parsers_1.BaseLLMOutputParser {
     static lc_name() {
@@ -74,10 +74,8 @@ class JsonOutputToolsParser extends output_parsers_1.BaseLLMOutputParser {
 }
 exports.JsonOutputToolsParser = JsonOutputToolsParser;
 /**
- * Class for parsing the output of a tool-calling LLM into a JSON object if you are
- * expecting only a single tool to be called.
+ * @deprecated Import from "@langchain/core/output_parsers/openai_tools"
  */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 class JsonOutputKeyToolsParser extends output_parsers_1.BaseLLMOutputParser {
     static lc_name() {
         return "JsonOutputKeyToolsParser";

package/dist/output_parsers/openai_tools.d.ts

@@ -1,5 +1,8 @@
 import { BaseLLMOutputParser } from "@langchain/core/output_parsers";
 import type { ChatGeneration } from "@langchain/core/outputs";
+/**
+ * @deprecated Import from "@langchain/core/output_parsers/openai_tools"
+ */
 export type ParsedToolCall = {
     id?: string;
     type: string;
@@ -9,12 +12,15 @@ export type ParsedToolCall = {
     /** @deprecated Use `args` instead. Will be removed in 0.2.0. */
     arguments: Record<string, any>;
 };
+/**
+ * @deprecated Import from "@langchain/core/output_parsers/openai_tools"
+ */
 export type JsonOutputToolsParserParams = {
     /** Whether to return the tool call id. */
     returnId?: boolean;
 };
 /**
- * Class for parsing the output of a tool-calling LLM into a JSON object.
+ * @deprecated Import from "@langchain/core/output_parsers/openai_tools"
  */
 export declare class JsonOutputToolsParser extends BaseLLMOutputParser<ParsedToolCall[]> {
     static lc_name(): string;
@@ -37,8 +43,7 @@ export type JsonOutputKeyToolsParserParams = {
     returnId?: boolean;
 };
 /**
- * Class for parsing the output of a tool-calling LLM into a JSON object if you are
- * expecting only a single tool to be called.
+ * @deprecated Import from "@langchain/core/output_parsers/openai_tools"
  */
 export declare class JsonOutputKeyToolsParser extends BaseLLMOutputParser<any> {
     static lc_name(): string;

package/dist/output_parsers/openai_tools.js

@@ -1,6 +1,6 @@
 import { BaseLLMOutputParser } from "@langchain/core/output_parsers";
 /**
- * Class for parsing the output of a tool-calling LLM into a JSON object.
+ * @deprecated Import from "@langchain/core/output_parsers/openai_tools"
  */
 export class JsonOutputToolsParser extends BaseLLMOutputParser {
     static lc_name() {
@@ -70,10 +70,8 @@ export class JsonOutputToolsParser extends BaseLLMOutputParser {
     }
 }
 /**
- * Class for parsing the output of a tool-calling LLM into a JSON object if you are
- * expecting only a single tool to be called.
+ * @deprecated Import from "@langchain/core/output_parsers/openai_tools"
  */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 export class JsonOutputKeyToolsParser extends BaseLLMOutputParser {
     static lc_name() {
         return "JsonOutputKeyToolsParser";

package/dist/retrievers/multi_query.d.ts

@@ -11,6 +11,7 @@ interface LineList {
 export type MultiDocs = Document<Record<string, any>>[];
 export interface MultiQueryRetrieverInput extends BaseRetrieverInput {
     retriever: BaseRetrieverInterface;
+    /** @deprecated Pass a custom prompt into `.fromLLM` instead. */
     llmChain: LLMChain<LineList>;
     queryCount?: number;
     parserKey?: string;

package/dist/storage/file_system.cjs

@@ -51,6 +51,11 @@ const stores_1 = require("@langchain/core/stores");
  *   await store.mdelete([key]);
  * }
  * ```
+ *
+ * @security **Security Notice** This file store
+ * can alter any text file in the provided directory and any subfolders.
+ * Make sure that the path you specify when initializing the store is free
+ * of other files.
  */
 class LocalFileStore extends stores_1.BaseStore {
     constructor(fields) {
@@ -75,6 +80,10 @@ class LocalFileStore extends stores_1.BaseStore {
      * @returns Promise that resolves to the parsed file content.
      */
     async getParsedFile(key) {
+        // Validate the key to prevent path traversal
+        if (!/^[a-zA-Z0-9_\-:.]+$/.test(key)) {
+            throw new Error("Invalid key. Only alphanumeric characters, underscores, hyphens, colons, and periods are allowed.");
+        }
         try {
             const fileContent = await fs.readFile(this.getFullPath(key));
             if (!fileContent) {
@@ -111,11 +120,20 @@ class LocalFileStore extends stores_1.BaseStore {
     getFullPath(key) {
         try {
             const keyAsTxtFile = `${key}.txt`;
-            const fullPath = path.join(this.rootPath, keyAsTxtFile);
+            // Validate the key to prevent path traversal
+            if (!/^[a-zA-Z0-9_.\-/]+$/.test(key)) {
+                throw new Error(`Invalid characters in key: ${key}`);
+            }
+            const fullPath = path.resolve(this.rootPath, keyAsTxtFile);
+            const commonPath = path.resolve(this.rootPath);
+            if (!fullPath.startsWith(commonPath)) {
+                throw new Error(`Invalid key: ${key}. Key should be relative to the root path. ` +
+                    `Root path: ${this.rootPath}, Full path: ${fullPath}`);
+            }
             return fullPath;
         }
         catch (e) {
-            throw new Error(`Error getting full path for key: ${key}.\nError: ${JSON.stringify(e)}`);
+            throw new Error(`Error getting full path for key: ${key}.\nError: ${String(e)}`);
         }
     }
     /**

package/dist/storage/file_system.d.ts

@@ -23,6 +23,11 @@ import { BaseStore } from "@langchain/core/stores";
  *   await store.mdelete([key]);
  * }
  * ```
+ *
+ * @security **Security Notice** This file store
+ * can alter any text file in the provided directory and any subfolders.
+ * Make sure that the path you specify when initializing the store is free
+ * of other files.
  */
 export declare class LocalFileStore extends BaseStore<string, Uint8Array> {
     lc_namespace: string[];

package/dist/storage/file_system.js

@@ -25,6 +25,11 @@ import { BaseStore } from "@langchain/core/stores";
  *   await store.mdelete([key]);
  * }
  * ```
+ *
+ * @security **Security Notice** This file store
+ * can alter any text file in the provided directory and any subfolders.
+ * Make sure that the path you specify when initializing the store is free
+ * of other files.
  */
 export class LocalFileStore extends BaseStore {
     constructor(fields) {
@@ -49,6 +54,10 @@ export class LocalFileStore extends BaseStore {
      * @returns Promise that resolves to the parsed file content.
      */
     async getParsedFile(key) {
+        // Validate the key to prevent path traversal
+        if (!/^[a-zA-Z0-9_\-:.]+$/.test(key)) {
+            throw new Error("Invalid key. Only alphanumeric characters, underscores, hyphens, colons, and periods are allowed.");
+        }
         try {
             const fileContent = await fs.readFile(this.getFullPath(key));
             if (!fileContent) {
@@ -85,11 +94,20 @@ export class LocalFileStore extends BaseStore {
     getFullPath(key) {
         try {
             const keyAsTxtFile = `${key}.txt`;
-            const fullPath = path.join(this.rootPath, keyAsTxtFile);
+            // Validate the key to prevent path traversal
+            if (!/^[a-zA-Z0-9_.\-/]+$/.test(key)) {
+                throw new Error(`Invalid characters in key: ${key}`);
+            }
+            const fullPath = path.resolve(this.rootPath, keyAsTxtFile);
+            const commonPath = path.resolve(this.rootPath);
+            if (!fullPath.startsWith(commonPath)) {
+                throw new Error(`Invalid key: ${key}. Key should be relative to the root path. ` +
+                    `Root path: ${this.rootPath}, Full path: ${fullPath}`);
+            }
             return fullPath;
         }
         catch (e) {
-            throw new Error(`Error getting full path for key: ${key}.\nError: ${JSON.stringify(e)}`);
+            throw new Error(`Error getting full path for key: ${key}.\nError: ${String(e)}`);
         }
     }
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langchain",
-  "version": "0.3.0-rc.0",
+  "version": "0.3.1",
   "description": "Typescript bindings for langchain",
   "type": "module",
   "engines": {
@@ -411,15 +411,15 @@
   "devDependencies": {
     "@faker-js/faker": "^7.6.0",
     "@jest/globals": "^29.5.0",
-    "@langchain/anthropic": "^0.2.8",
-    "@langchain/aws": "^0.0.5",
-    "@langchain/cohere": "^0.2.1",
+    "@langchain/anthropic": "*",
+    "@langchain/aws": "*",
+    "@langchain/cohere": "*",
     "@langchain/core": "workspace:*",
-    "@langchain/google-genai": "^0.0.26",
-    "@langchain/google-vertexai": "~0.0",
-    "@langchain/groq": "^0.0.15",
-    "@langchain/mistralai": "^0.0.26",
-    "@langchain/ollama": "^0.0.2",
+    "@langchain/google-genai": "*",
+    "@langchain/google-vertexai": "*",
+    "@langchain/groq": "*",
+    "@langchain/mistralai": "*",
+    "@langchain/ollama": "*",
     "@langchain/scripts": ">=0.1.0 <0.2.0",
     "@swc/core": "^1.3.90",
     "@swc/jest": "^0.2.29",
@@ -462,7 +462,7 @@
     "@langchain/aws": "*",
     "@langchain/cohere": "*",
     "@langchain/community": "*",
-    "@langchain/core": ">=0.2.21 <0.4.0 || 0.3.0-rc.0",
+    "@langchain/core": ">=0.2.21 <0.4.0",
     "@langchain/google-genai": "*",
     "@langchain/google-vertexai": "*",
     "@langchain/groq": "*",
@@ -519,12 +519,12 @@
     }
   },
   "dependencies": {
-    "@langchain/openai": ">=0.1.0 <0.3.0 || 0.3.0-rc.0",
-    "@langchain/textsplitters": ">=0.0.0 <0.2.0 || 0.1.0-rc.0",
+    "@langchain/openai": ">=0.1.0 <0.4.0",
+    "@langchain/textsplitters": ">=0.0.0 <0.2.0",
     "js-tiktoken": "^1.0.12",
     "js-yaml": "^4.1.0",
     "jsonpointer": "^5.0.1",
-    "langsmith": "~0.1.40",
+    "langsmith": "^0.1.56-rc.1",
     "openapi-types": "^12.1.3",
     "p-retry": "4",
     "uuid": "^10.0.0",