@langchain/core 1.2.0-dev-1765937705265 → 1.2.0

package/dist/load/import_map.js

@@ -1,7 +1,12 @@
-import { __export } from "../_virtual/rolldown_runtime.js";
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import { src_exports } from "../index.js";
 import { agents_exports } from "../agents.js";
+import { hash_exports } from "../utils/hash.js";
+import { errors_exports } from "../errors/index.js";
 import { serializable_exports } from "./serializable.js";
 import { tool_exports } from "../messages/tool.js";
+import { caches_exports } from "../caches/index.js";
+import { uuid_exports } from "../utils/uuid/index.js";
 import { env_exports } from "../utils/env.js";
 import { base_exports } from "../callbacks/base.js";
 import { base_exports as base_exports$1 } from "../tracers/base.js";
@@ -14,51 +19,55 @@ import { stream_exports } from "../utils/stream.js";
 import { log_stream_exports } from "../tracers/log_stream.js";
 import { outputs_exports } from "../outputs.js";
 import { async_caller_exports } from "../utils/async_caller.js";
+import { standard_schema_exports } from "../utils/standard_schema.js";
 import { json_schema_exports } from "../utils/json_schema.js";
 import { graph_exports } from "../runnables/graph.js";
 import { messages_exports } from "../messages/index.js";
 import { chat_history_exports } from "../chat_history.js";
-import { embeddings_exports } from "../embeddings.js";
-import { src_exports } from "../index.js";
-import { memory_exports } from "../memory.js";
-import { prompt_values_exports } from "../prompt_values.js";
-import { stores_exports } from "../stores.js";
-import { retrievers_exports } from "../retrievers/index.js";
-import { vectorstores_exports } from "../vectorstores.js";
-import { hash_exports } from "../utils/hash.js";
-import { caches_exports } from "../caches/index.js";
+import { documents_exports } from "../documents/index.js";
 import { base_exports as base_exports$2 } from "../document_loaders/base.js";
 import { langsmith_exports } from "../document_loaders/langsmith.js";
-import { documents_exports } from "../documents/index.js";
+import { embeddings_exports } from "../embeddings.js";
 import { example_selectors_exports } from "../example_selectors/index.js";
 import { indexing_exports } from "../indexing/index.js";
+import { prompt_values_exports } from "../prompt_values.js";
 import { tiktoken_exports } from "../utils/tiktoken.js";
 import { base_exports as base_exports$3 } from "../language_models/base.js";
+import { runnables_exports } from "../runnables/index.js";
+import { json_patch_exports } from "../utils/json_patch.js";
+import { output_parsers_exports } from "../output_parsers/index.js";
+import { types_exports } from "../utils/types/index.js";
+import { structured_output_exports } from "../language_models/structured_output.js";
+import { stream_exports as stream_exports$1 } from "../language_models/stream.js";
+import { compat_exports } from "../language_models/compat.js";
 import { chat_models_exports } from "../language_models/chat_models.js";
+import { openai_completions_stream_exports } from "../language_models/openai_completions_stream.js";
+import { event_exports } from "../language_models/event.js";
 import { llms_exports } from "../language_models/llms.js";
 import { profile_exports } from "../language_models/profile.js";
-import { document_compressors_exports } from "../retrievers/document_compressors/index.js";
-import { prompts_exports } from "../prompts/index.js";
-import { runnables_exports } from "../runnables/index.js";
-import { json_patch_exports } from "../utils/json_patch.js";
-import { openai_tools_exports } from "../output_parsers/openai_tools/index.js";
-import { stream_exports as stream_exports$1 } from "../types/stream.js";
-import { run_collector_exports } from "../tracers/run_collector.js";
+import { memory_exports } from "../memory.js";
 import { openai_functions_exports } from "../output_parsers/openai_functions/index.js";
-import { chunk_array_exports } from "../utils/chunk_array.js";
-import { function_calling_exports } from "../utils/function_calling.js";
+import { openai_tools_exports } from "../output_parsers/openai_tools/index.js";
+import { prompts_exports } from "../prompts/index.js";
+import { document_compressors_exports } from "../retrievers/document_compressors/index.js";
+import { retrievers_exports } from "../retrievers/index.js";
+import { stores_exports } from "../stores.js";
 import { structured_query_exports } from "../structured_query/index.js";
+import { testing_exports } from "../testing/index.js";
 import { tools_exports } from "../tools/index.js";
-import { testing_exports } from "../utils/testing/index.js";
-import { types_exports } from "../utils/types/index.js";
+import { run_collector_exports } from "../tracers/run_collector.js";
+import { stream_exports as stream_exports$2 } from "../types/stream.js";
+import { chunk_array_exports } from "../utils/chunk_array.js";
+import { context_exports } from "../utils/context.js";
 import { event_source_parse_exports } from "../utils/event_source_parse.js";
-import { output_parsers_exports } from "../output_parsers/index.js";
 import { format_exports } from "../utils/format.js";
+import { function_calling_exports } from "../utils/function_calling.js";
 import { math_exports } from "../utils/math.js";
-
+import { ssrf_exports } from "../utils/ssrf.js";
+import { vectorstores_exports } from "../vectorstores.js";
+import { testing_exports as testing_exports$1 } from "../utils/testing/index.js";
 //#region src/load/import_map.ts
-var import_map_exports = {};
-__export(import_map_exports, {
+var import_map_exports = /* @__PURE__ */ __exportAll({
 	agents: () => agents_exports,
 	caches: () => caches_exports,
 	callbacks__base: () => base_exports,
@@ -69,13 +78,19 @@ __export(import_map_exports, {
 	document_loaders__langsmith: () => langsmith_exports,
 	documents: () => documents_exports,
 	embeddings: () => embeddings_exports,
+	errors: () => errors_exports,
 	example_selectors: () => example_selectors_exports,
 	index: () => src_exports,
 	indexing: () => indexing_exports,
 	language_models__base: () => base_exports$3,
 	language_models__chat_models: () => chat_models_exports,
+	language_models__compat: () => compat_exports,
+	language_models__event: () => event_exports,
 	language_models__llms: () => llms_exports,
+	language_models__openai_completions_stream: () => openai_completions_stream_exports,
 	language_models__profile: () => profile_exports,
+	language_models__stream: () => stream_exports$1,
+	language_models__structured_output: () => structured_output_exports,
 	load__serializable: () => serializable_exports,
 	memory: () => memory_exports,
 	messages: () => messages_exports,
@@ -93,15 +108,17 @@ __export(import_map_exports, {
 	singletons: () => singletons_exports,
 	stores: () => stores_exports,
 	structured_query: () => structured_query_exports,
+	testing: () => testing_exports,
 	tools: () => tools_exports,
 	tracers__base: () => base_exports$1,
 	tracers__console: () => console_exports,
 	tracers__log_stream: () => log_stream_exports,
 	tracers__run_collector: () => run_collector_exports,
 	tracers__tracer_langchain: () => tracer_langchain_exports,
-	types__stream: () => stream_exports$1,
+	types__stream: () => stream_exports$2,
 	utils__async_caller: () => async_caller_exports,
 	utils__chunk_array: () => chunk_array_exports,
+	utils__context: () => context_exports,
 	utils__env: () => env_exports,
 	utils__event_source_parse: () => event_source_parse_exports,
 	utils__format: () => format_exports,
@@ -110,13 +127,16 @@ __export(import_map_exports, {
 	utils__json_patch: () => json_patch_exports,
 	utils__json_schema: () => json_schema_exports,
 	utils__math: () => math_exports,
+	utils__ssrf: () => ssrf_exports,
+	utils__standard_schema: () => standard_schema_exports,
 	utils__stream: () => stream_exports,
-	utils__testing: () => testing_exports,
+	utils__testing: () => testing_exports$1,
 	utils__tiktoken: () => tiktoken_exports,
 	utils__types: () => types_exports,
+	utils__uuid: () => uuid_exports,
 	vectorstores: () => vectorstores_exports
 });
-
 //#endregion
 export { import_map_exports };
+
 //# sourceMappingURL=import_map.js.map

package/dist/load/import_map.js.map

@@ -1 +1 @@
-{"version":3,"file":"import_map.js","names":[],"sources":["../../src/load/import_map.ts"],"sourcesContent":["/** Auto-generated by import-map plugin. Do not edit manually */\n\nexport * as retrievers__document_compressors from \"../retrievers/document_compressors/index.js\";\nexport * as load__serializable from \"../load/serializable.js\";\nexport * as prompts from \"../prompts/index.js\";\nexport * as utils__hash from \"../utils/hash.js\";\nexport * as output_parsers__openai_tools from \"../output_parsers/openai_tools/index.js\";\nexport * as types__stream from \"../types/stream.js\";\nexport * as language_models__chat_models from \"../language_models/chat_models.js\";\nexport * as utils__stream from \"../utils/stream.js\";\nexport * as embeddings from \"../embeddings.js\";\nexport * as utils__json_patch from \"../utils/json_patch.js\";\nexport * as tracers__run_collector from \"../tracers/run_collector.js\";\nexport * as tracers__log_stream from \"../tracers/log_stream.js\";\nexport * as example_selectors from \"../example_selectors/index.js\";\nexport * as utils__async_caller from \"../utils/async_caller.js\";\nexport * as output_parsers__openai_functions from \"../output_parsers/openai_functions/index.js\";\nexport * as chat_history from \"../chat_history.js\";\nexport * as language_models__base from \"../language_models/base.js\";\nexport * as language_models__profile from \"../language_models/profile.js\";\nexport * as utils__chunk_array from \"../utils/chunk_array.js\";\nexport * as tracers__base from \"../tracers/base.js\";\nexport * as utils__function_calling from \"../utils/function_calling.js\";\nexport * as structured_query from \"../structured_query/index.js\";\nexport * as callbacks__promises from \"../callbacks/promises.js\";\nexport * as stores from \"../stores.js\";\nexport * as language_models__llms from \"../language_models/llms.js\";\nexport * as utils__testing from \"../utils/testing/index.js\";\nexport * as utils__json_schema from \"../utils/json_schema.js\";\nexport * as tracers__console from \"../tracers/console.js\";\nexport * as singletons from \"../singletons/index.js\";\nexport * as indexing from \"../indexing/index.js\";\nexport * as utils__types from \"../utils/types/index.js\";\nexport * as callbacks__manager from \"../callbacks/manager.js\";\nexport * as documents from \"../documents/index.js\";\nexport * as messages from \"../messages/index.js\";\nexport * as runnables__graph from \"../runnables/graph.js\";\nexport * as callbacks__base from \"../callbacks/base.js\";\nexport * as utils__event_source_parse from \"../utils/event_source_parse.js\";\nexport * as output_parsers from \"../output_parsers/index.js\";\nexport * as prompt_values from \"../prompt_values.js\";\nexport * as document_loaders__base from \"../document_loaders/base.js\";\nexport * as retrievers from \"../retrievers/index.js\";\nexport * as utils__format from \"../utils/format.js\";\nexport * as memory from \"../memory.js\";\nexport * as tracers__tracer_langchain from \"../tracers/tracer_langchain.js\";\nexport * as runnables from \"../runnables/index.js\";\nexport * as tools from \"../tools/index.js\";\nexport * as utils__env from \"../utils/env.js\";\nexport * as vectorstores from \"../vectorstores.js\";\nexport * as index from \"../index.js\";\nexport * as caches from \"../caches/index.js\";\nexport * as utils__tiktoken from \"../utils/tiktoken.js\";\nexport * as document_loaders__langsmith from \"../document_loaders/langsmith.js\";\nexport * as agents from \"../agents.js\";\nexport * as messages__tool from \"../messages/tool.js\";\nexport * as utils__math from \"../utils/math.js\";\nexport * as outputs from \"../outputs.js\";\n"],"mappings":""}
+{"version":3,"file":"import_map.js","names":[],"sources":["../../src/load/import_map.ts"],"sourcesContent":["/** Auto-generated by import-map plugin. Do not edit manually */\n\nexport * as agents from \"../agents.js\";\nexport * as caches from \"../caches/index.js\";\nexport * as callbacks__base from \"../callbacks/base.js\";\nexport * as callbacks__manager from \"../callbacks/manager.js\";\nexport * as callbacks__promises from \"../callbacks/promises.js\";\nexport * as chat_history from \"../chat_history.js\";\nexport * as document_loaders__base from \"../document_loaders/base.js\";\nexport * as document_loaders__langsmith from \"../document_loaders/langsmith.js\";\nexport * as documents from \"../documents/index.js\";\nexport * as embeddings from \"../embeddings.js\";\nexport * as errors from \"../errors/index.js\";\nexport * as example_selectors from \"../example_selectors/index.js\";\nexport * as index from \"../index.js\";\nexport * as indexing from \"../indexing/index.js\";\nexport * as language_models__base from \"../language_models/base.js\";\nexport * as language_models__chat_models from \"../language_models/chat_models.js\";\nexport * as language_models__compat from \"../language_models/compat.js\";\nexport * as language_models__event from \"../language_models/event.js\";\nexport * as language_models__llms from \"../language_models/llms.js\";\nexport * as language_models__openai_completions_stream from \"../language_models/openai_completions_stream.js\";\nexport * as language_models__profile from \"../language_models/profile.js\";\nexport * as language_models__stream from \"../language_models/stream.js\";\nexport * as language_models__structured_output from \"../language_models/structured_output.js\";\nexport * as load__serializable from \"../load/serializable.js\";\nexport * as memory from \"../memory.js\";\nexport * as messages from \"../messages/index.js\";\nexport * as messages__tool from \"../messages/tool.js\";\nexport * as output_parsers from \"../output_parsers/index.js\";\nexport * as output_parsers__openai_functions from \"../output_parsers/openai_functions/index.js\";\nexport * as output_parsers__openai_tools from \"../output_parsers/openai_tools/index.js\";\nexport * as outputs from \"../outputs.js\";\nexport * as prompt_values from \"../prompt_values.js\";\nexport * as prompts from \"../prompts/index.js\";\nexport * as retrievers__document_compressors from \"../retrievers/document_compressors/index.js\";\nexport * as retrievers from \"../retrievers/index.js\";\nexport * as runnables__graph from \"../runnables/graph.js\";\nexport * as runnables from \"../runnables/index.js\";\nexport * as singletons from \"../singletons/index.js\";\nexport * as stores from \"../stores.js\";\nexport * as structured_query from \"../structured_query/index.js\";\nexport * as testing from \"../testing/index.js\";\nexport * as tools from \"../tools/index.js\";\nexport * as tracers__base from \"../tracers/base.js\";\nexport * as tracers__console from \"../tracers/console.js\";\nexport * as tracers__log_stream from \"../tracers/log_stream.js\";\nexport * as tracers__run_collector from \"../tracers/run_collector.js\";\nexport * as tracers__tracer_langchain from \"../tracers/tracer_langchain.js\";\nexport * as types__stream from \"../types/stream.js\";\nexport * as utils__async_caller from \"../utils/async_caller.js\";\nexport * as utils__chunk_array from \"../utils/chunk_array.js\";\nexport * as utils__context from \"../utils/context.js\";\nexport * as utils__env from \"../utils/env.js\";\nexport * as utils__event_source_parse from \"../utils/event_source_parse.js\";\nexport * as utils__format from \"../utils/format.js\";\nexport * as utils__function_calling from \"../utils/function_calling.js\";\nexport * as utils__hash from \"../utils/hash.js\";\nexport * as utils__json_patch from \"../utils/json_patch.js\";\nexport * as utils__json_schema from \"../utils/json_schema.js\";\nexport * as utils__math from \"../utils/math.js\";\nexport * as utils__ssrf from \"../utils/ssrf.js\";\nexport * as utils__standard_schema from \"../utils/standard_schema.js\";\nexport * as utils__stream from \"../utils/stream.js\";\nexport * as utils__testing from \"../utils/testing/index.js\";\nexport * as utils__tiktoken from \"../utils/tiktoken.js\";\nexport * as utils__types from \"../utils/types/index.js\";\nexport * as utils__uuid from \"../utils/uuid/index.js\";\nexport * as vectorstores from \"../vectorstores.js\";\n"],"mappings":""}

package/dist/load/import_type.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"import_type.d.cts","names":["OptionalImportMap","SecretMap"],"sources":["../../src/load/import_type.d.ts"],"sourcesContent":["export interface OptionalImportMap {\n}\nexport interface SecretMap {\n}\n//# sourceMappingURL=import_type.d.ts.map"],"mappings":";UAAiBA,iBAAAA,EAAjB;AAEiBC,UAAAA,SAAAA,CAAS"}
+{"version":3,"file":"import_type.d.cts","names":[],"sources":["../../src/load/import_type.ts"],"mappings":";UAEiB,iBAAA;AAAA,UAEA,SAAA"}

package/dist/load/import_type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"import_type.d.ts","names":["OptionalImportMap","SecretMap"],"sources":["../../src/load/import_type.d.ts"],"sourcesContent":["export interface OptionalImportMap {\n}\nexport interface SecretMap {\n}\n//# sourceMappingURL=import_type.d.ts.map"],"mappings":";UAAiBA,iBAAAA,EAAjB;AAEiBC,UAAAA,SAAAA,CAAS"}
+{"version":3,"file":"import_type.d.ts","names":[],"sources":["../../src/load/import_type.ts"],"mappings":";UAEiB,iBAAA;AAAA,UAEA,SAAA"}

package/dist/load/index.cjs

@@ -1,10 +1,83 @@
-const require_map_keys = require('./map_keys.cjs');
-const require_load_serializable = require('./serializable.cjs');
-const require_utils_env = require('../utils/env.cjs');
-const require_import_constants = require('./import_constants.cjs');
-const require_import_map = require('./import_map.cjs');
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_map_keys = require("./map_keys.cjs");
+const require_validation = require("./validation.cjs");
+const require_load_serializable = require("./serializable.cjs");
+const require_utils_env = require("../utils/env.cjs");
+const require_import_constants = require("./import_constants.cjs");
+const require_import_map = require("./import_map.cjs");
 //#region src/load/index.ts
+/**
+* Load LangChain objects from JSON strings or objects.
+*
+* **WARNING: `load()` deserializes data by instantiating classes and invoking
+* constructors. Never call `load()` on untrusted or user-supplied input.**
+* Doing so can lead to insecure deserialization — including arbitrary class
+* instantiation, secret exfiltration, and server-side request forgery (SSRF).
+* Only deserialize data that originates from a trusted source you control.
+*
+* ## How it works
+*
+* Each `Serializable` LangChain object has a unique identifier (its "class path"),
+* which is a list of strings representing the module path and class name. For example:
+*
+* - `AIMessage` -> `["langchain_core", "messages", "ai", "AIMessage"]`
+* - `ChatPromptTemplate` -> `["langchain_core", "prompts", "chat", "ChatPromptTemplate"]`
+*
+* When deserializing, the class path is validated against supported namespaces.
+*
+* ## Threat model
+*
+* A serialized LangChain payload crosses a trust boundary because the manifest
+* may contain serialized objects and configuration that affect runtime behavior.
+* For example, a payload can configure a chat model with a custom `base_url`,
+* custom headers, a different model name, or other constructor arguments. These
+* are supported features, but they also mean the payload contents should be
+* treated as executable configuration rather than plain text.
+*
+* Concretely, deserialization instantiates classes, so any constructor on an
+* allowed class will run during `load()`. A crafted payload that is allowed to
+* reach an unintended class — or an intended class with attacker-controlled
+* kwargs — could cause network calls, file operations, or environment-variable
+* access while the object is being built.
+*
+* ## Security model
+*
+* The `secretsFromEnv` parameter controls whether secrets can be loaded from environment
+* variables:
+*
+* - `false` (default): Secrets must be provided in `secretsMap`. If a secret is not
+*   found, `null` is returned instead of loading from environment variables.
+* - `true`: If a secret is not found in `secretsMap`, it will be loaded from
+*   environment variables. Use this only in trusted environments.
+*
+* ### Hardening recommendations
+*
+* - **Never enable `secretsFromEnv`** unless the serialized data is fully trusted.
+*   A crafted payload can reference arbitrary environment variable names, leaking
+*   secrets to an attacker-controlled class constructor.
+* - **Keep `secretsMap` minimal.** Only include the specific secrets the serialized
+*   object actually needs.
+* - **Keep `importMap` / `optionalImportsMap` as small and static as possible.**
+*   Each entry widens the set of classes an attacker can instantiate. Never
+*   populate these maps from user input.
+*
+* ### Injection protection (escape-based)
+*
+* During serialization, plain objects that contain an `'lc'` key are escaped by wrapping
+* them: `{"__lc_escaped__": {...}}`. During deserialization, escaped objects are unwrapped
+* and returned as plain objects, NOT instantiated as LC objects.
+*
+* This is an allowlist approach: only objects explicitly produced by
+* `Serializable.toJSON()` (which are NOT escaped) are treated as LC objects;
+* everything else is user data.
+*
+* @module
+*/
+/**
+* Default maximum recursion depth for deserialization.
+* This provides protection against DoS attacks via deeply nested structures.
+*/
+const DEFAULT_MAX_DEPTH = 50;
 function combineAliasesAndInvert(constructor) {
 	const aliases = {};
 	for (let current = constructor; current && current.prototype; current = Object.getPrototypeOf(current)) Object.assign(aliases, Reflect.get(current.prototype, "lc_aliases"));
@@ -13,24 +86,42 @@ function combineAliasesAndInvert(constructor) {
 		return acc;
 	}, {});
 }
+/**
+* Recursively revive a value, handling escape markers and LC objects.
+*
+* This function handles:
+* 1. Escaped dicts - unwrapped and returned as plain objects
+* 2. LC secret objects - resolved from secretsMap or env
+* 3. LC constructor objects - instantiated
+* 4. Regular objects/arrays - recursed into
+*/
 async function reviver(value) {
-	const { optionalImportsMap = {}, optionalImportEntrypoints: optionalImportEntrypoints$1 = [], importMap = {}, secretsMap = {}, path = ["$"] } = this;
+	const { optionalImportsMap, optionalImportEntrypoints: optionalImportEntrypoints$1, importMap, secretsMap, secretsFromEnv, path, depth, maxDepth } = this;
 	const pathStr = path.join(".");
-	if (typeof value === "object" && value !== null && !Array.isArray(value) && "lc" in value && "type" in value && "id" in value && value.lc === 1 && value.type === "secret") {
-		const serialized = value;
-		const [key] = serialized.id;
+	if (depth > maxDepth) throw new Error(`Maximum recursion depth (${maxDepth}) exceeded during deserialization. This may indicate a malicious payload or you may need to increase maxDepth.`);
+	if (typeof value !== "object" || value == null) return value;
+	if (Array.isArray(value)) return Promise.all(value.map((v, i) => reviver.call({
+		...this,
+		path: [...path, `${i}`],
+		depth: depth + 1
+	}, v)));
+	const record = value;
+	if (require_validation.isEscapedObject(record)) return require_validation.unescapeValue(record);
+	if ("lc" in record && "type" in record && "id" in record && record.lc === 1 && record.type === "secret") {
+		const [key] = record.id;
 		if (key in secretsMap) return secretsMap[key];
-		else {
+		else if (secretsFromEnv) {
 			const secretValueInEnv = require_utils_env.getEnvironmentVariable(key);
 			if (secretValueInEnv) return secretValueInEnv;
-			else throw new Error(`Missing key "${key}" for ${pathStr} in load(secretsMap={})`);
 		}
-	} else if (typeof value === "object" && value !== null && !Array.isArray(value) && "lc" in value && "type" in value && "id" in value && value.lc === 1 && value.type === "not_implemented") {
-		const serialized = value;
-		const str = JSON.stringify(serialized);
+		throw new Error(`Missing secret "${key}" at ${pathStr}`);
+	}
+	if ("lc" in record && "type" in record && "id" in record && record.lc === 1 && record.type === "not_implemented") {
+		const str = JSON.stringify(record);
 		throw new Error(`Trying to load an object that doesn't implement serialization: ${pathStr} -> ${str}`);
-	} else if (typeof value === "object" && value !== null && !Array.isArray(value) && "lc" in value && "type" in value && "id" in value && "kwargs" in value && value.lc === 1) {
-		const serialized = value;
+	}
+	if ("lc" in record && "type" in record && "id" in record && "kwargs" in record && record.lc === 1 && record.type === "constructor") {
+		const serialized = record;
 		const str = JSON.stringify(serialized);
 		const [name, ...namespaceReverse] = serialized.id.slice().reverse();
 		const namespace = namespaceReverse.reverse();
@@ -38,11 +129,11 @@ async function reviver(value) {
 			langchain_core: require_import_map.import_map_exports,
 			langchain: importMap
 		};
-		let module$1 = null;
+		let module = null;
 		const optionalImportNamespaceAliases = [namespace.join("/")];
 		if (namespace[0] === "langchain_community") optionalImportNamespaceAliases.push(["langchain", ...namespace.slice(1)].join("/"));
 		const matchingNamespaceAlias = optionalImportNamespaceAliases.find((alias) => alias in optionalImportsMap);
-		if (require_import_constants.optionalImportEntrypoints.concat(optionalImportEntrypoints$1).includes(namespace.join("/")) || matchingNamespaceAlias) if (matchingNamespaceAlias !== void 0) module$1 = await optionalImportsMap[matchingNamespaceAlias];
+		if (require_import_constants.optionalImportEntrypoints.concat(optionalImportEntrypoints$1).includes(namespace.join("/")) || matchingNamespaceAlias) if (matchingNamespaceAlias !== void 0) module = await optionalImportsMap[matchingNamespaceAlias];
 		else throw new Error(`Missing key "${namespace.join("/")}" for ${pathStr} in load(optionalImportsMap={})`);
 		else {
 			let finalImportMap;
@@ -57,35 +148,82 @@ async function reviver(value) {
 				if (importMapKey in finalImportMap) break;
 				else namespace.pop();
 			} while (namespace.length > 0);
-			if (importMapKey in finalImportMap) module$1 = finalImportMap[importMapKey];
+			if (importMapKey in finalImportMap) module = finalImportMap[importMapKey];
 		}
-		if (typeof module$1 !== "object" || module$1 === null) throw new Error(`Invalid namespace: ${pathStr} -> ${str}`);
-		const builder = module$1[name] ?? Object.values(module$1).find((v) => typeof v === "function" && require_load_serializable.get_lc_unique_name(v) === name);
+		if (typeof module !== "object" || module === null) throw new Error(`Invalid namespace: ${pathStr} -> ${str}`);
+		const builder = module[name] ?? Object.values(module).find((v) => typeof v === "function" && require_load_serializable.get_lc_unique_name(v) === name);
 		if (typeof builder !== "function") throw new Error(`Invalid identifer: ${pathStr} -> ${str}`);
-		const kwargs = await reviver.call({
+		const instance = new builder(require_map_keys.mapKeys(await reviver.call({
 			...this,
-			path: [...path, "kwargs"]
-		}, serialized.kwargs);
-		if (serialized.type === "constructor") {
-			const instance = new builder(require_map_keys.mapKeys(kwargs, require_map_keys.keyFromJson, combineAliasesAndInvert(builder)));
-			Object.defineProperty(instance.constructor, "name", { value: name });
-			return instance;
-		} else throw new Error(`Invalid type: ${pathStr} -> ${str}`);
-	} else if (typeof value === "object" && value !== null) if (Array.isArray(value)) return Promise.all(value.map((v, i) => reviver.call({
+			path: [...path, "kwargs"],
+			depth: depth + 1
+		}, serialized.kwargs), require_map_keys.keyFromJson, combineAliasesAndInvert(builder)));
+		Object.defineProperty(instance.constructor, "name", { value: name });
+		return instance;
+	}
+	const result = {};
+	for (const [key, val] of Object.entries(record)) result[key] = await reviver.call({
 		...this,
-		path: [...path, `${i}`]
-	}, v)));
-	else return Object.fromEntries(await Promise.all(Object.entries(value).map(async ([key, value$1]) => [key, await reviver.call({
-		...this,
-		path: [...path, key]
-	}, value$1)])));
-	return value;
+		path: [...path, key],
+		depth: depth + 1
+	}, val);
+	return result;
 }
-async function load(text, mappings) {
+/**
+* Load a LangChain object from a JSON string.
+*
+* **WARNING — insecure deserialization risk.** This function instantiates
+* classes and invokes constructors based on the contents of `text`. If `text`
+* originates from an untrusted source, an attacker can craft a payload that
+* instantiates arbitrary allowed classes with attacker-controlled arguments,
+* potentially causing secret exfiltration, SSRF, or other side effects.
+*
+* A serialized payload should be treated as executable configuration — it can
+* configure models with custom endpoints, headers, or other constructor kwargs
+* that execute during instantiation.
+*
+* Only call `load()` on data you have produced yourself or received from a
+* fully trusted origin (e.g., your own database). **Never deserialize
+* user-supplied or network-received JSON without independent validation.**
+*
+* @param text - The JSON string to parse and load.
+* @param options - Options for loading. See {@link LoadOptions} for security guidance.
+* @returns The loaded LangChain object.
+*
+* @example
+* ```typescript
+* import { load } from "@langchain/core/load";
+* import { AIMessage } from "@langchain/core/messages";
+*
+* // Basic usage - secrets must be provided explicitly
+* const msg = await load<AIMessage>(jsonString);
+*
+* // With secrets from a map (preferred over secretsFromEnv)
+* const msg = await load<AIMessage>(jsonString, {
+*   secretsMap: { OPENAI_API_KEY: "sk-..." }
+* });
+*
+* // Allow loading secrets from environment — ONLY for fully trusted data
+* const msg = await load<AIMessage>(jsonString, {
+*   secretsFromEnv: true
+* });
+* ```
+*/
+async function load(text, options) {
 	const json = JSON.parse(text);
-	return reviver.call({ ...mappings }, json);
+	const context = {
+		optionalImportsMap: options?.optionalImportsMap ?? {},
+		optionalImportEntrypoints: options?.optionalImportEntrypoints ?? [],
+		secretsMap: options?.secretsMap ?? {},
+		secretsFromEnv: options?.secretsFromEnv ?? false,
+		importMap: options?.importMap ?? {},
+		path: ["$"],
+		depth: 0,
+		maxDepth: options?.maxDepth ?? DEFAULT_MAX_DEPTH
+	};
+	return reviver.call(context, json);
 }
-
 //#endregion
 exports.load = load;
+
 //# sourceMappingURL=index.cjs.map

package/dist/load/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["constructor: typeof Serializable","aliases: { [key: string]: string }","value: unknown","getEnvironmentVariable","coreImportMap","module:\n      | (typeof importMaps)[\"langchain_core\"][keyof (typeof importMaps)[\"langchain_core\"]]\n      | (typeof importMaps)[\"langchain\"][keyof (typeof importMaps)[\"langchain\"]]\n      | OptionalImportMap[keyof OptionalImportMap]\n      | null","defaultOptionalImportEntrypoints","optionalImportEntrypoints","module","finalImportMap:\n        | (typeof importMaps)[\"langchain\"]\n        | (typeof importMaps)[\"langchain_core\"]","importMapKey: string","get_lc_unique_name","mapKeys","keyFromJson","value","text: string","mappings?: {\n    secretsMap?: SecretMap;\n    optionalImportsMap?: OptionalImportMap;\n    optionalImportEntrypoints?: string[];\n    importMap?: Record<string, unknown>;\n  }"],"sources":["../../src/load/index.ts"],"sourcesContent":["import {\n  Serializable,\n  SerializedConstructor,\n  SerializedNotImplemented,\n  SerializedSecret,\n  get_lc_unique_name,\n} from \"./serializable.js\";\nimport { optionalImportEntrypoints as defaultOptionalImportEntrypoints } from \"./import_constants.js\";\nimport * as coreImportMap from \"./import_map.js\";\nimport type { OptionalImportMap, SecretMap } from \"./import_type.js\";\nimport { type SerializedFields, keyFromJson, mapKeys } from \"./map_keys.js\";\nimport { getEnvironmentVariable } from \"../utils/env.js\";\n\nfunction combineAliasesAndInvert(constructor: typeof Serializable) {\n  const aliases: { [key: string]: string } = {};\n  for (\n    let current = constructor;\n    current && current.prototype;\n    current = Object.getPrototypeOf(current)\n  ) {\n    Object.assign(aliases, Reflect.get(current.prototype, \"lc_aliases\"));\n  }\n  return Object.entries(aliases).reduce((acc, [key, value]) => {\n    acc[value] = key;\n    return acc;\n  }, {} as Record<string, string>);\n}\n\nasync function reviver(\n  this: {\n    optionalImportsMap?: OptionalImportMap;\n    optionalImportEntrypoints?: string[];\n    secretsMap?: SecretMap;\n    importMap?: Record<string, unknown>;\n    path?: string[];\n  },\n  value: unknown\n): Promise<unknown> {\n  const {\n    optionalImportsMap = {},\n    optionalImportEntrypoints = [],\n    importMap = {},\n    secretsMap = {},\n    path = [\"$\"],\n  } = this;\n  const pathStr = path.join(\".\");\n  if (\n    typeof value === \"object\" &&\n    value !== null &&\n    !Array.isArray(value) &&\n    \"lc\" in value &&\n    \"type\" in value &&\n    \"id\" in value &&\n    value.lc === 1 &&\n    value.type === \"secret\"\n  ) {\n    const serialized = value as SerializedSecret;\n    const [key] = serialized.id;\n    if (key in secretsMap) {\n      return secretsMap[key as keyof SecretMap];\n    } else {\n      const secretValueInEnv = getEnvironmentVariable(key);\n      if (secretValueInEnv) {\n        return secretValueInEnv;\n      } else {\n        throw new Error(\n          `Missing key \"${key}\" for ${pathStr} in load(secretsMap={})`\n        );\n      }\n    }\n  } else if (\n    typeof value === \"object\" &&\n    value !== null &&\n    !Array.isArray(value) &&\n    \"lc\" in value &&\n    \"type\" in value &&\n    \"id\" in value &&\n    value.lc === 1 &&\n    value.type === \"not_implemented\"\n  ) {\n    const serialized = value as SerializedNotImplemented;\n    const str = JSON.stringify(serialized);\n    throw new Error(\n      `Trying to load an object that doesn't implement serialization: ${pathStr} -> ${str}`\n    );\n  } else if (\n    typeof value === \"object\" &&\n    value !== null &&\n    !Array.isArray(value) &&\n    \"lc\" in value &&\n    \"type\" in value &&\n    \"id\" in value &&\n    \"kwargs\" in value &&\n    value.lc === 1\n  ) {\n    const serialized = value as SerializedConstructor;\n    const str = JSON.stringify(serialized);\n    const [name, ...namespaceReverse] = serialized.id.slice().reverse();\n    const namespace = namespaceReverse.reverse();\n    const importMaps = { langchain_core: coreImportMap, langchain: importMap };\n\n    let module:\n      | (typeof importMaps)[\"langchain_core\"][keyof (typeof importMaps)[\"langchain_core\"]]\n      | (typeof importMaps)[\"langchain\"][keyof (typeof importMaps)[\"langchain\"]]\n      | OptionalImportMap[keyof OptionalImportMap]\n      | null = null;\n\n    const optionalImportNamespaceAliases = [namespace.join(\"/\")];\n    if (namespace[0] === \"langchain_community\") {\n      optionalImportNamespaceAliases.push(\n        [\"langchain\", ...namespace.slice(1)].join(\"/\")\n      );\n    }\n    const matchingNamespaceAlias = optionalImportNamespaceAliases.find(\n      (alias) => alias in optionalImportsMap\n    );\n    if (\n      defaultOptionalImportEntrypoints\n        .concat(optionalImportEntrypoints)\n        .includes(namespace.join(\"/\")) ||\n      matchingNamespaceAlias\n    ) {\n      if (matchingNamespaceAlias !== undefined) {\n        module = await optionalImportsMap[\n          matchingNamespaceAlias as keyof typeof optionalImportsMap\n        ];\n      } else {\n        throw new Error(\n          `Missing key \"${namespace.join(\n            \"/\"\n          )}\" for ${pathStr} in load(optionalImportsMap={})`\n        );\n      }\n    } else {\n      let finalImportMap:\n        | (typeof importMaps)[\"langchain\"]\n        | (typeof importMaps)[\"langchain_core\"];\n      // Currently, we only support langchain and langchain_core imports.\n      if (namespace[0] === \"langchain\" || namespace[0] === \"langchain_core\") {\n        finalImportMap = importMaps[namespace[0]];\n        namespace.shift();\n      } else {\n        throw new Error(`Invalid namespace: ${pathStr} -> ${str}`);\n      }\n\n      // The root namespace \"langchain\" is not a valid import.\n      if (namespace.length === 0) {\n        throw new Error(`Invalid namespace: ${pathStr} -> ${str}`);\n      }\n\n      // Find the longest matching namespace.\n      let importMapKey: string;\n      do {\n        importMapKey = namespace.join(\"__\");\n        if (importMapKey in finalImportMap) {\n          break;\n        } else {\n          namespace.pop();\n        }\n      } while (namespace.length > 0);\n\n      // If no matching namespace is found, throw an error.\n      if (importMapKey in finalImportMap) {\n        module = finalImportMap[importMapKey as keyof typeof finalImportMap];\n      }\n    }\n\n    if (typeof module !== \"object\" || module === null) {\n      throw new Error(`Invalid namespace: ${pathStr} -> ${str}`);\n    }\n\n    // Extract the builder from the import map.\n    const builder =\n      // look for a named export with the same name as the class\n      module[name as keyof typeof module] ??\n      // look for an export with a lc_name property matching the class name\n      // this is necessary for classes that are minified\n      Object.values(module).find(\n        (v) =>\n          typeof v === \"function\" &&\n          get_lc_unique_name(v as typeof Serializable) === name\n      );\n    if (typeof builder !== \"function\") {\n      throw new Error(`Invalid identifer: ${pathStr} -> ${str}`);\n    }\n\n    // Recurse on the arguments, which may be serialized objects themselves\n    const kwargs = await reviver.call(\n      { ...this, path: [...path, \"kwargs\"] },\n      serialized.kwargs\n    );\n\n    // Construct the object\n    if (serialized.type === \"constructor\") {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const instance = new (builder as any)(\n        mapKeys(\n          kwargs as SerializedFields,\n          keyFromJson,\n          combineAliasesAndInvert(builder)\n        )\n      );\n\n      // Minification in severless/edge runtimes will mange the\n      // name of classes presented in traces. As the names in import map\n      // are present as-is even with minification, use these names instead\n      Object.defineProperty(instance.constructor, \"name\", { value: name });\n\n      return instance;\n    } else {\n      throw new Error(`Invalid type: ${pathStr} -> ${str}`);\n    }\n  } else if (typeof value === \"object\" && value !== null) {\n    if (Array.isArray(value)) {\n      return Promise.all(\n        value.map((v, i) =>\n          reviver.call({ ...this, path: [...path, `${i}`] }, v)\n        )\n      );\n    } else {\n      return Object.fromEntries(\n        await Promise.all(\n          Object.entries(value).map(async ([key, value]) => [\n            key,\n            await reviver.call({ ...this, path: [...path, key] }, value),\n          ])\n        )\n      );\n    }\n  }\n  return value;\n}\n\nexport async function load<T>(\n  text: string,\n  mappings?: {\n    secretsMap?: SecretMap;\n    optionalImportsMap?: OptionalImportMap;\n    optionalImportEntrypoints?: string[];\n    importMap?: Record<string, unknown>;\n  }\n): Promise<T> {\n  const json = JSON.parse(text);\n  return reviver.call({ ...mappings }, json) as Promise<T>;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["isEscapedObject","unescapeValue","serialized","getEnvironmentVariable","coreImportMap","defaultOptionalImportEntrypoints","optionalImportEntrypoints","get_lc_unique_name","mapKeys","keyFromJson"],"sources":["../../src/load/index.ts"],"sourcesContent":["/**\n * Load LangChain objects from JSON strings or objects.\n *\n * **WARNING: `load()` deserializes data by instantiating classes and invoking\n * constructors. Never call `load()` on untrusted or user-supplied input.**\n * Doing so can lead to insecure deserialization — including arbitrary class\n * instantiation, secret exfiltration, and server-side request forgery (SSRF).\n * Only deserialize data that originates from a trusted source you control.\n *\n * ## How it works\n *\n * Each `Serializable` LangChain object has a unique identifier (its \"class path\"),\n * which is a list of strings representing the module path and class name. For example:\n *\n * - `AIMessage` -> `[\"langchain_core\", \"messages\", \"ai\", \"AIMessage\"]`\n * - `ChatPromptTemplate` -> `[\"langchain_core\", \"prompts\", \"chat\", \"ChatPromptTemplate\"]`\n *\n * When deserializing, the class path is validated against supported namespaces.\n *\n * ## Threat model\n *\n * A serialized LangChain payload crosses a trust boundary because the manifest\n * may contain serialized objects and configuration that affect runtime behavior.\n * For example, a payload can configure a chat model with a custom `base_url`,\n * custom headers, a different model name, or other constructor arguments. These\n * are supported features, but they also mean the payload contents should be\n * treated as executable configuration rather than plain text.\n *\n * Concretely, deserialization instantiates classes, so any constructor on an\n * allowed class will run during `load()`. A crafted payload that is allowed to\n * reach an unintended class — or an intended class with attacker-controlled\n * kwargs — could cause network calls, file operations, or environment-variable\n * access while the object is being built.\n *\n * ## Security model\n *\n * The `secretsFromEnv` parameter controls whether secrets can be loaded from environment\n * variables:\n *\n * - `false` (default): Secrets must be provided in `secretsMap`. If a secret is not\n *   found, `null` is returned instead of loading from environment variables.\n * - `true`: If a secret is not found in `secretsMap`, it will be loaded from\n *   environment variables. Use this only in trusted environments.\n *\n * ### Hardening recommendations\n *\n * - **Never enable `secretsFromEnv`** unless the serialized data is fully trusted.\n *   A crafted payload can reference arbitrary environment variable names, leaking\n *   secrets to an attacker-controlled class constructor.\n * - **Keep `secretsMap` minimal.** Only include the specific secrets the serialized\n *   object actually needs.\n * - **Keep `importMap` / `optionalImportsMap` as small and static as possible.**\n *   Each entry widens the set of classes an attacker can instantiate. Never\n *   populate these maps from user input.\n *\n * ### Injection protection (escape-based)\n *\n * During serialization, plain objects that contain an `'lc'` key are escaped by wrapping\n * them: `{\"__lc_escaped__\": {...}}`. During deserialization, escaped objects are unwrapped\n * and returned as plain objects, NOT instantiated as LC objects.\n *\n * This is an allowlist approach: only objects explicitly produced by\n * `Serializable.toJSON()` (which are NOT escaped) are treated as LC objects;\n * everything else is user data.\n *\n * @module\n */\n\nimport {\n  Serializable,\n  SerializedConstructor,\n  SerializedNotImplemented,\n  SerializedSecret,\n  get_lc_unique_name,\n} from \"./serializable.js\";\nimport { optionalImportEntrypoints as defaultOptionalImportEntrypoints } from \"./import_constants.js\";\nimport * as coreImportMap from \"./import_map.js\";\nimport type { OptionalImportMap, SecretMap } from \"./import_type.js\";\nimport { type SerializedFields, keyFromJson, mapKeys } from \"./map_keys.js\";\nimport { getEnvironmentVariable } from \"../utils/env.js\";\nimport { isEscapedObject, unescapeValue } from \"./validation.js\";\n\n/**\n * Options for loading serialized LangChain objects.\n *\n * @remarks\n * **Security considerations:**\n *\n * Deserialization can instantiate arbitrary classes from the allowed namespaces.\n * When loading untrusted data, be aware that:\n *\n * 1. **`secretsFromEnv`**: Defaults to `false`. Setting to `true` allows the\n *    deserializer to read environment variables, which could leak secrets if\n *    the serialized data contains malicious secret references.\n *\n * 2. **`importMap` / `optionalImportsMap`**: These allow extending which classes\n *    can be instantiated. Never populate these from user input. Only include\n *    modules you explicitly trust.\n *\n * 3. **Class instantiation**: Allowed classes will have their constructors called\n *    with the deserialized kwargs. If a class performs side effects in its\n *    constructor (network calls, file I/O, etc.), those will execute.\n */\nexport interface LoadOptions {\n  /**\n   * A map of secrets to load. Keys are secret identifiers, values are the secret values.\n   *\n   * If a secret is not found in this map and `secretsFromEnv` is `false`, an error is\n   * thrown. If `secretsFromEnv` is `true`, the secret will be loaded from environment\n   * variables (if not found there either, an error is thrown).\n   */\n  secretsMap?: SecretMap;\n\n  /**\n   * Whether to load secrets from environment variables when not found in `secretsMap`.\n   *\n   * @default false\n   *\n   * @remarks\n   * **Security warning:** Setting this to `true` allows the deserializer to read\n   * environment variables, which could be a security risk if the serialized data\n   * is not trusted. Only set this to `true` when deserializing data from trusted\n   * sources (e.g., your own database, not user input).\n   */\n  secretsFromEnv?: boolean;\n\n  /**\n   * A map of optional imports. Keys are namespace paths (e.g., \"langchain_community/llms\"),\n   * values are the imported modules.\n   *\n   * @remarks\n   * **Security warning:** This extends which classes can be instantiated during\n   * deserialization. Never populate this map with values derived from user input.\n   * Only include modules that you explicitly trust and have reviewed.\n   *\n   * Classes in these modules can be instantiated with attacker-controlled kwargs\n   * if the serialized data is untrusted.\n   */\n  optionalImportsMap?: OptionalImportMap;\n\n  /**\n   * Additional optional import entrypoints to allow beyond the defaults.\n   *\n   * @remarks\n   * **Security warning:** This extends which namespace paths are considered valid\n   * for deserialization. Never populate this array with values derived from user\n   * input. Each entrypoint you add expands the attack surface for deserialization.\n   */\n  optionalImportEntrypoints?: string[];\n\n  /**\n   * Additional import map for the \"langchain\" namespace.\n   *\n   * @remarks\n   * **Security warning:** This extends which classes can be instantiated during\n   * deserialization. Never populate this map with values derived from user input.\n   * Only include modules that you explicitly trust and have reviewed.\n   *\n   * Any class exposed through this map can be instantiated with attacker-controlled\n   * kwargs if the serialized data is untrusted.\n   */\n  importMap?: Record<string, unknown>;\n\n  /**\n   * Maximum recursion depth allowed during deserialization.\n   *\n   * @default 50\n   *\n   * @remarks\n   * This limit protects against denial-of-service attacks using deeply nested\n   * JSON structures that could cause stack overflow. If your legitimate data\n   * requires deeper nesting, you can increase this limit.\n   */\n  maxDepth?: number;\n}\n\n/**\n * Default maximum recursion depth for deserialization.\n * This provides protection against DoS attacks via deeply nested structures.\n */\nconst DEFAULT_MAX_DEPTH = 50;\n\nfunction combineAliasesAndInvert(constructor: typeof Serializable) {\n  const aliases: { [key: string]: string } = {};\n  for (\n    let current = constructor;\n    current && current.prototype;\n    current = Object.getPrototypeOf(current)\n  ) {\n    Object.assign(aliases, Reflect.get(current.prototype, \"lc_aliases\"));\n  }\n  return Object.entries(aliases).reduce(\n    (acc, [key, value]) => {\n      acc[value] = key;\n      return acc;\n    },\n    {} as Record<string, string>\n  );\n}\n\ninterface ReviverContext {\n  optionalImportsMap: OptionalImportMap;\n  optionalImportEntrypoints: string[];\n  secretsMap: SecretMap;\n  secretsFromEnv: boolean;\n  importMap: Record<string, unknown>;\n  path: string[];\n  depth: number;\n  maxDepth: number;\n}\n\n/**\n * Recursively revive a value, handling escape markers and LC objects.\n *\n * This function handles:\n * 1. Escaped dicts - unwrapped and returned as plain objects\n * 2. LC secret objects - resolved from secretsMap or env\n * 3. LC constructor objects - instantiated\n * 4. Regular objects/arrays - recursed into\n */\nasync function reviver(this: ReviverContext, value: unknown): Promise<unknown> {\n  const {\n    optionalImportsMap,\n    optionalImportEntrypoints,\n    importMap,\n    secretsMap,\n    secretsFromEnv,\n    path,\n    depth,\n    maxDepth,\n  } = this;\n  const pathStr = path.join(\".\");\n\n  // Check recursion depth to prevent DoS via deeply nested structures\n  if (depth > maxDepth) {\n    throw new Error(\n      `Maximum recursion depth (${maxDepth}) exceeded during deserialization. ` +\n        `This may indicate a malicious payload or you may need to increase maxDepth.`\n    );\n  }\n\n  // If not an object, return as-is\n  if (typeof value !== \"object\" || value == null) {\n    return value;\n  }\n\n  // Handle arrays - recurse into elements\n  if (Array.isArray(value)) {\n    return Promise.all(\n      value.map((v, i) =>\n        reviver.call({ ...this, path: [...path, `${i}`], depth: depth + 1 }, v)\n      )\n    );\n  }\n\n  // It's an object - check for escape marker FIRST\n  const record = value as Record<string, unknown>;\n  if (isEscapedObject(record)) {\n    // This is an escaped user object - unwrap and return as-is (no LC processing)\n    return unescapeValue(record);\n  }\n\n  // Check for LC secret object\n  if (\n    \"lc\" in record &&\n    \"type\" in record &&\n    \"id\" in record &&\n    record.lc === 1 &&\n    record.type === \"secret\"\n  ) {\n    const serialized = record as unknown as SerializedSecret;\n    const [key] = serialized.id;\n    if (key in secretsMap) {\n      return secretsMap[key as keyof SecretMap];\n    } else if (secretsFromEnv) {\n      const secretValueInEnv = getEnvironmentVariable(key);\n      if (secretValueInEnv) {\n        return secretValueInEnv;\n      }\n    }\n    throw new Error(`Missing secret \"${key}\" at ${pathStr}`);\n  }\n\n  // Check for LC not_implemented object\n  if (\n    \"lc\" in record &&\n    \"type\" in record &&\n    \"id\" in record &&\n    record.lc === 1 &&\n    record.type === \"not_implemented\"\n  ) {\n    const serialized = record as unknown as SerializedNotImplemented;\n    const str = JSON.stringify(serialized);\n    throw new Error(\n      `Trying to load an object that doesn't implement serialization: ${pathStr} -> ${str}`\n    );\n  }\n\n  // Check for LC constructor object\n  if (\n    \"lc\" in record &&\n    \"type\" in record &&\n    \"id\" in record &&\n    \"kwargs\" in record &&\n    record.lc === 1 &&\n    record.type === \"constructor\"\n  ) {\n    const serialized = record as unknown as SerializedConstructor;\n    const str = JSON.stringify(serialized);\n    const [name, ...namespaceReverse] = serialized.id.slice().reverse();\n    const namespace = namespaceReverse.reverse();\n    const importMaps = { langchain_core: coreImportMap, langchain: importMap };\n\n    let module:\n      | (typeof importMaps)[\"langchain_core\"][keyof (typeof importMaps)[\"langchain_core\"]]\n      | (typeof importMaps)[\"langchain\"][keyof (typeof importMaps)[\"langchain\"]]\n      | OptionalImportMap[keyof OptionalImportMap]\n      | null = null;\n\n    const optionalImportNamespaceAliases = [namespace.join(\"/\")];\n    if (namespace[0] === \"langchain_community\") {\n      optionalImportNamespaceAliases.push(\n        [\"langchain\", ...namespace.slice(1)].join(\"/\")\n      );\n    }\n    const matchingNamespaceAlias = optionalImportNamespaceAliases.find(\n      (alias) => alias in optionalImportsMap\n    );\n    if (\n      defaultOptionalImportEntrypoints\n        .concat(optionalImportEntrypoints)\n        .includes(namespace.join(\"/\")) ||\n      matchingNamespaceAlias\n    ) {\n      if (matchingNamespaceAlias !== undefined) {\n        module =\n          await optionalImportsMap[\n            matchingNamespaceAlias as keyof typeof optionalImportsMap\n          ];\n      } else {\n        throw new Error(\n          `Missing key \"${namespace.join(\n            \"/\"\n          )}\" for ${pathStr} in load(optionalImportsMap={})`\n        );\n      }\n    } else {\n      let finalImportMap:\n        | (typeof importMaps)[\"langchain\"]\n        | (typeof importMaps)[\"langchain_core\"];\n      // Currently, we only support langchain and langchain_core imports.\n      if (namespace[0] === \"langchain\" || namespace[0] === \"langchain_core\") {\n        finalImportMap = importMaps[namespace[0]];\n        namespace.shift();\n      } else {\n        throw new Error(`Invalid namespace: ${pathStr} -> ${str}`);\n      }\n\n      // The root namespace \"langchain\" is not a valid import.\n      if (namespace.length === 0) {\n        throw new Error(`Invalid namespace: ${pathStr} -> ${str}`);\n      }\n\n      // Find the longest matching namespace.\n      let importMapKey: string;\n      do {\n        importMapKey = namespace.join(\"__\");\n        if (importMapKey in finalImportMap) {\n          break;\n        } else {\n          namespace.pop();\n        }\n      } while (namespace.length > 0);\n\n      // If no matching namespace is found, throw an error.\n      if (importMapKey in finalImportMap) {\n        module = finalImportMap[importMapKey as keyof typeof finalImportMap];\n      }\n    }\n\n    if (typeof module !== \"object\" || module === null) {\n      throw new Error(`Invalid namespace: ${pathStr} -> ${str}`);\n    }\n\n    // Extract the builder from the import map.\n    const builder =\n      // look for a named export with the same name as the class\n      module[name as keyof typeof module] ??\n      // look for an export with a lc_name property matching the class name\n      // this is necessary for classes that are minified\n      Object.values(module).find(\n        (v) =>\n          typeof v === \"function\" &&\n          get_lc_unique_name(v as typeof Serializable) === name\n      );\n    if (typeof builder !== \"function\") {\n      throw new Error(`Invalid identifer: ${pathStr} -> ${str}`);\n    }\n\n    // Recurse on the arguments, which may be serialized objects themselves\n    const kwargs = await reviver.call(\n      { ...this, path: [...path, \"kwargs\"], depth: depth + 1 },\n      serialized.kwargs\n    );\n\n    // Construct the object\n    // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n    const instance = new (builder as any)(\n      mapKeys(\n        kwargs as SerializedFields,\n        keyFromJson,\n        combineAliasesAndInvert(builder)\n      )\n    );\n\n    // Minification in severless/edge runtimes will mange the\n    // name of classes presented in traces. As the names in import map\n    // are present as-is even with minification, use these names instead\n    Object.defineProperty(instance.constructor, \"name\", { value: name });\n\n    return instance;\n  }\n\n  // Regular object - recurse into values\n  const result: Record<string, unknown> = {};\n  for (const [key, val] of Object.entries(record)) {\n    result[key] = await reviver.call(\n      { ...this, path: [...path, key], depth: depth + 1 },\n      val\n    );\n  }\n  return result;\n}\n\n/**\n * Load a LangChain object from a JSON string.\n *\n * **WARNING — insecure deserialization risk.** This function instantiates\n * classes and invokes constructors based on the contents of `text`. If `text`\n * originates from an untrusted source, an attacker can craft a payload that\n * instantiates arbitrary allowed classes with attacker-controlled arguments,\n * potentially causing secret exfiltration, SSRF, or other side effects.\n *\n * A serialized payload should be treated as executable configuration — it can\n * configure models with custom endpoints, headers, or other constructor kwargs\n * that execute during instantiation.\n *\n * Only call `load()` on data you have produced yourself or received from a\n * fully trusted origin (e.g., your own database). **Never deserialize\n * user-supplied or network-received JSON without independent validation.**\n *\n * @param text - The JSON string to parse and load.\n * @param options - Options for loading. See {@link LoadOptions} for security guidance.\n * @returns The loaded LangChain object.\n *\n * @example\n * ```typescript\n * import { load } from \"@langchain/core/load\";\n * import { AIMessage } from \"@langchain/core/messages\";\n *\n * // Basic usage - secrets must be provided explicitly\n * const msg = await load<AIMessage>(jsonString);\n *\n * // With secrets from a map (preferred over secretsFromEnv)\n * const msg = await load<AIMessage>(jsonString, {\n *   secretsMap: { OPENAI_API_KEY: \"sk-...\" }\n * });\n *\n * // Allow loading secrets from environment — ONLY for fully trusted data\n * const msg = await load<AIMessage>(jsonString, {\n *   secretsFromEnv: true\n * });\n * ```\n */\nexport async function load<T>(text: string, options?: LoadOptions): Promise<T> {\n  const json = JSON.parse(text);\n\n  const context: ReviverContext = {\n    optionalImportsMap: options?.optionalImportsMap ?? {},\n    optionalImportEntrypoints: options?.optionalImportEntrypoints ?? [],\n    secretsMap: options?.secretsMap ?? {},\n    secretsFromEnv: options?.secretsFromEnv ?? false,\n    importMap: options?.importMap ?? {},\n    path: [\"$\"],\n    depth: 0,\n    maxDepth: options?.maxDepth ?? DEFAULT_MAX_DEPTH,\n  };\n\n  return reviver.call(context, json) as Promise<T>;\n}\n"],"mappings":"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"}