langchain 0.2.17 → 0.2.19

package/dist/agents/executor.cjs

@@ -364,10 +364,17 @@ class AgentExecutor extends base_js_1.BaseChain {
             writable: true,
             value: false
         });
+        Object.defineProperty(this, "handleToolRuntimeErrors", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.agent = agent;
         this.tools = input.tools;
         this.handleParsingErrors =
             input.handleParsingErrors ?? this.handleParsingErrors;
+        this.handleToolRuntimeErrors = input.handleToolRuntimeErrors;
         this.returnOnlyOutputs = returnOnlyOutputs;
         if (this.agent._agentActionType() === "multi") {
             for (const tool of this.tools) {
@@ -481,6 +488,7 @@ class AgentExecutor extends base_js_1.BaseChain {
                     if (typeof observation !== "string") {
                         throw new Error("Received unsupported non-string response from tool call.");
                     }
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
                 }
                 catch (e) {
                     // eslint-disable-next-line no-instanceof/no-instanceof
@@ -501,6 +509,9 @@ class AgentExecutor extends base_js_1.BaseChain {
                         observation = await new ExceptionTool().call(observation, runManager?.getChild());
                         return { action, observation: observation ?? "" };
                     }
+                    else if (this.handleToolRuntimeErrors !== undefined) {
+                        observation = this.handleToolRuntimeErrors(e);
+                    }
                 }
                 return { action, observation: observation ?? "" };
             }));

package/dist/agents/executor.d.ts

@@ -86,6 +86,7 @@ export interface AgentExecutorInput extends ChainInputs {
     maxIterations?: number;
     earlyStoppingMethod?: StoppingMethod;
     handleParsingErrors?: boolean | string | ((e: OutputParserException | ToolInputParsingException) => string);
+    handleToolRuntimeErrors?: (e: Error) => string;
 }
 export type AgentExecutorOutput = ChainValues;
 /**
@@ -135,6 +136,7 @@ export declare class AgentExecutor extends BaseChain<ChainValues, AgentExecutorO
       as an observation.
      */
     handleParsingErrors: boolean | string | ((e: OutputParserException | ToolInputParsingException) => string);
+    handleToolRuntimeErrors?: (e: Error) => string;
     get inputKeys(): string[];
     get outputKeys(): string[];
     constructor(input: AgentExecutorInput);

package/dist/agents/executor.js

@@ -359,10 +359,17 @@ export class AgentExecutor extends BaseChain {
             writable: true,
             value: false
         });
+        Object.defineProperty(this, "handleToolRuntimeErrors", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.agent = agent;
         this.tools = input.tools;
         this.handleParsingErrors =
             input.handleParsingErrors ?? this.handleParsingErrors;
+        this.handleToolRuntimeErrors = input.handleToolRuntimeErrors;
         this.returnOnlyOutputs = returnOnlyOutputs;
         if (this.agent._agentActionType() === "multi") {
             for (const tool of this.tools) {
@@ -476,6 +483,7 @@ export class AgentExecutor extends BaseChain {
                     if (typeof observation !== "string") {
                         throw new Error("Received unsupported non-string response from tool call.");
                     }
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
                 }
                 catch (e) {
                     // eslint-disable-next-line no-instanceof/no-instanceof
@@ -496,6 +504,9 @@ export class AgentExecutor extends BaseChain {
                         observation = await new ExceptionTool().call(observation, runManager?.getChild());
                         return { action, observation: observation ?? "" };
                     }
+                    else if (this.handleToolRuntimeErrors !== undefined) {
+                        observation = this.handleToolRuntimeErrors(e);
+                    }
                 }
                 return { action, observation: observation ?? "" };
             }));

package/dist/agents/react/output_parser.cjs

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReActSingleInputOutputParser = void 0;
 const prompts_1 = require("@langchain/core/prompts");
+const output_parsers_1 = require("@langchain/core/output_parsers");
 const types_js_1 = require("../types.cjs");
 const prompt_js_1 = require("./prompt.cjs");
 const FINAL_ANSWER_ACTION = "Final Answer:";
@@ -74,7 +75,7 @@ class ReActSingleInputOutputParser extends types_js_1.AgentActionOutputParser {
         const actionMatch = text.match(regex);
         if (actionMatch) {
             if (includesAnswer) {
-                throw new Error(`${FINAL_ANSWER_AND_PARSABLE_ACTION_ERROR_MESSAGE}: ${text}`);
+                throw new output_parsers_1.OutputParserException(`${FINAL_ANSWER_AND_PARSABLE_ACTION_ERROR_MESSAGE}: ${text}`);
             }
             const action = actionMatch[1];
             const actionInput = actionMatch[2];
@@ -94,7 +95,7 @@ class ReActSingleInputOutputParser extends types_js_1.AgentActionOutputParser {
                 log: text,
             };
         }
-        throw new Error(`Could not parse LLM output: ${text}`);
+        throw new output_parsers_1.OutputParserException(`Could not parse LLM output: ${text}`);
     }
     /**
      * Returns the format instructions as a string. If the 'raw' option is

package/dist/agents/react/output_parser.js

@@ -1,4 +1,5 @@
 import { renderTemplate } from "@langchain/core/prompts";
+import { OutputParserException } from "@langchain/core/output_parsers";
 import { AgentActionOutputParser } from "../types.js";
 import { FORMAT_INSTRUCTIONS } from "./prompt.js";
 const FINAL_ANSWER_ACTION = "Final Answer:";
@@ -71,7 +72,7 @@ export class ReActSingleInputOutputParser extends AgentActionOutputParser {
         const actionMatch = text.match(regex);
         if (actionMatch) {
             if (includesAnswer) {
-                throw new Error(`${FINAL_ANSWER_AND_PARSABLE_ACTION_ERROR_MESSAGE}: ${text}`);
+                throw new OutputParserException(`${FINAL_ANSWER_AND_PARSABLE_ACTION_ERROR_MESSAGE}: ${text}`);
             }
             const action = actionMatch[1];
             const actionInput = actionMatch[2];
@@ -91,7 +92,7 @@ export class ReActSingleInputOutputParser extends AgentActionOutputParser {
                 log: text,
             };
         }
-        throw new Error(`Could not parse LLM output: ${text}`);
+        throw new OutputParserException(`Could not parse LLM output: ${text}`);
     }
     /**
      * Returns the format instructions as a string. If the 'raw' option is

package/dist/chains/conversational_retrieval_chain.cjs

@@ -13,7 +13,7 @@ Chat History:
 Follow Up Input: {question}
 Standalone question:`;
 /**
- * @deprecated This class will be removed in 0.3.0. See below for an example implementation using
+ * @deprecated This class will be removed in 1.0.0. See below for an example implementation using
  * `createRetrievalChain`.
  *
  * Class for conducting conversational question-answering tasks with a

package/dist/chains/conversational_retrieval_chain.d.ts

@@ -21,7 +21,7 @@ export interface ConversationalRetrievalQAChainInput extends ChainInputs {
     inputKey?: string;
 }
 /**
- * @deprecated This class will be removed in 0.3.0. See below for an example implementation using
+ * @deprecated This class will be removed in 1.0.0. See below for an example implementation using
  * `createRetrievalChain`.
  *
  * Class for conducting conversational question-answering tasks with a

package/dist/chains/conversational_retrieval_chain.js

@@ -10,7 +10,7 @@ Chat History:
 Follow Up Input: {question}
 Standalone question:`;
 /**
- * @deprecated This class will be removed in 0.3.0. See below for an example implementation using
+ * @deprecated This class will be removed in 1.0.0. See below for an example implementation using
  * `createRetrievalChain`.
  *
  * Class for conducting conversational question-answering tasks with a

package/dist/chains/llm_chain.cjs

@@ -29,7 +29,7 @@ function _getLanguageModel(llmLike) {
     }
 }
 /**
- * @deprecated This class will be removed in 0.3.0. Use the LangChain Expression Language (LCEL) instead.
+ * @deprecated This class will be removed in 1.0.0. Use the LangChain Expression Language (LCEL) instead.
  * See the example below for how to use LCEL with the LLMChain class:
  *
  * Chain to run queries against LLMs.

package/dist/chains/llm_chain.d.ts

@@ -29,7 +29,7 @@ export interface LLMChainInput<T extends string | object = string, Model extends
     outputKey?: string;
 }
 /**
- * @deprecated This class will be removed in 0.3.0. Use the LangChain Expression Language (LCEL) instead.
+ * @deprecated This class will be removed in 1.0.0. Use the LangChain Expression Language (LCEL) instead.
  * See the example below for how to use LCEL with the LLMChain class:
  *
  * Chain to run queries against LLMs.

package/dist/chains/llm_chain.js

@@ -26,7 +26,7 @@ function _getLanguageModel(llmLike) {
     }
 }
 /**
- * @deprecated This class will be removed in 0.3.0. Use the LangChain Expression Language (LCEL) instead.
+ * @deprecated This class will be removed in 1.0.0. Use the LangChain Expression Language (LCEL) instead.
  * See the example below for how to use LCEL with the LLMChain class:
  *
  * Chain to run queries against LLMs.

package/dist/chains/openai_functions/openapi.cjs

@@ -133,7 +133,9 @@ function convertOpenAPISchemaToJSONSchema(schema, spec) {
             }
             // eslint-disable-next-line no-param-reassign
             jsonSchema.properties[propertyName] = convertOpenAPISchemaToJSONSchema(openAPIProperty, spec);
-            if (openAPIProperty.required && jsonSchema.required !== undefined) {
+            if ((openAPIProperty.required ||
+                schema.required?.includes(propertyName)) &&
+                jsonSchema.required !== undefined) {
                 jsonSchema.required.push(propertyName);
             }
             return jsonSchema;

package/dist/chains/openai_functions/openapi.js

@@ -130,7 +130,9 @@ export function convertOpenAPISchemaToJSONSchema(schema, spec) {
             }
             // eslint-disable-next-line no-param-reassign
             jsonSchema.properties[propertyName] = convertOpenAPISchemaToJSONSchema(openAPIProperty, spec);
-            if (openAPIProperty.required && jsonSchema.required !== undefined) {
+            if ((openAPIProperty.required ||
+                schema.required?.includes(propertyName)) &&
+                jsonSchema.required !== undefined) {
                 jsonSchema.required.push(propertyName);
             }
             return jsonSchema;

package/dist/chains/retrieval_qa.cjs

@@ -4,7 +4,7 @@ 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
+ * @deprecated This class will be removed in 1.0.0. See below for an example implementation using
  * `createRetrievalChain`:
  * Class representing a chain for performing question-answering tasks with
  * a retrieval component.

package/dist/chains/retrieval_qa.d.ts

@@ -16,7 +16,7 @@ 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
+ * @deprecated This class will be removed in 1.0.0. See below for an example implementation using
  * `createRetrievalChain`:
  * Class representing a chain for performing question-answering tasks with
  * a retrieval component.

package/dist/chains/retrieval_qa.js

@@ -1,7 +1,7 @@
 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
+ * @deprecated This class will be removed in 1.0.0. See below for an example implementation using
  * `createRetrievalChain`:
  * Class representing a chain for performing question-answering tasks with
  * a retrieval component.

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.2.17",
+  "version": "0.2.19",
   "description": "Typescript bindings for langchain",
   "type": "module",
   "engines": {
@@ -584,9 +584,9 @@
     "prepack": "yarn build",
     "release": "release-it --only-version --config .release-it.json",
     "test": "NODE_OPTIONS=--experimental-vm-modules jest --testPathIgnorePatterns=\\.int\\.test.ts --testTimeout 30000 --maxWorkers=50%",
-    "test:watch": "yarn run build:deps && NODE_OPTIONS=--experimental-vm-modules jest --watch --testPathIgnorePatterns=\\.int\\.test.ts",
-    "test:integration": "yarn run build:deps && NODE_OPTIONS=--experimental-vm-modules jest --testPathPattern=\\.int\\.test.ts --testTimeout 100000 --maxWorkers=50%",
-    "test:single": "yarn run build:deps && NODE_OPTIONS=--experimental-vm-modules yarn run jest --config jest.config.cjs --testTimeout 100000",
+    "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch --testPathIgnorePatterns=\\.int\\.test.ts",
+    "test:integration": "NODE_OPTIONS=--experimental-vm-modules jest --testPathPattern=\\.int\\.test.ts --testTimeout 100000 --maxWorkers=50%",
+    "test:single": "NODE_OPTIONS=--experimental-vm-modules yarn run jest --config jest.config.cjs --testTimeout 100000",
     "format": "prettier --config .prettierrc --write \"src\"",
     "format:check": "prettier --config .prettierrc --check \"src\""
   },
@@ -600,7 +600,7 @@
     "@aws-sdk/types": "^3.357.0",
     "@azure/storage-blob": "^12.15.0",
     "@browserbasehq/sdk": "^1.1.5",
-    "@cloudflare/workers-types": "^4.20230922.0",
+    "@cloudflare/workers-types": "^4.20240909.0",
     "@faker-js/faker": "^7.6.0",
     "@gomomento/sdk": "^1.51.1",
     "@gomomento/sdk-core": "^1.51.1",
@@ -609,7 +609,7 @@
     "@langchain/aws": "^0.0.5",
     "@langchain/cohere": "^0.2.1",
     "@langchain/google-genai": "^0.0.26",
-    "@langchain/google-vertexai": "^0.0.26",
+    "@langchain/google-vertexai": "~0.0",
     "@langchain/groq": "^0.0.15",
     "@langchain/mistralai": "^0.0.26",
     "@langchain/ollama": "^0.0.2",
@@ -670,7 +670,7 @@
     "playwright": "^1.32.1",
     "prettier": "^2.8.3",
     "puppeteer": "^22.0.0",
-    "pyodide": "^0.24.1",
+    "pyodide": "^0.26.2",
     "redis": "^4.6.6",
     "release-it": "^17.6.0",
     "rimraf": "^5.0.1",
@@ -735,7 +735,7 @@
     "peggy": "^3.0.2",
     "playwright": "*",
     "puppeteer": "*",
-    "pyodide": "^0.24.1",
+    "pyodide": ">=0.24.1 <0.27.0",
     "redis": "*",
     "sonix-speech-recognition": "*",
     "srt-parser-2": "*",