@langchain/core 0.3.9-rc.1 → 0.3.10-rc.0

package/context.cjs

@@ -0,0 +1 @@
+module.exports = require('./dist/context.cjs');

package/context.d.cts

@@ -0,0 +1 @@
+export * from './dist/context.js'

package/context.d.ts

@@ -0,0 +1 @@
+export * from './dist/context.js'

package/context.js

@@ -0,0 +1 @@
+export * from './dist/context.js'

package/dist/callbacks/dispatch/index.cjs

@@ -1,12 +1,12 @@
 "use strict";
+/* __LC_ALLOW_ENTRYPOINT_SIDE_EFFECTS__ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.dispatchCustomEvent = void 0;
 const node_async_hooks_1 = require("node:async_hooks");
 const web_js_1 = require("./web.cjs");
 const config_js_1 = require("../../runnables/config.cjs");
 const index_js_1 = require("../../singletons/index.cjs");
-/* #__PURE__ */ index_js_1.AsyncLocalStorageProviderSingleton.initializeGlobalInstance(
-/* #__PURE__ */ new node_async_hooks_1.AsyncLocalStorage());
+index_js_1.AsyncLocalStorageProviderSingleton.initializeGlobalInstance(new node_async_hooks_1.AsyncLocalStorage());
 /**
  * Dispatch a custom event.
  *

package/dist/callbacks/dispatch/index.js

@@ -1,9 +1,9 @@
+/* __LC_ALLOW_ENTRYPOINT_SIDE_EFFECTS__ */
 import { AsyncLocalStorage } from "node:async_hooks";
 import { dispatchCustomEvent as dispatchCustomEventWeb } from "./web.js";
 import { ensureConfig } from "../../runnables/config.js";
 import { AsyncLocalStorageProviderSingleton } from "../../singletons/index.js";
-/* #__PURE__ */ AsyncLocalStorageProviderSingleton.initializeGlobalInstance(
-/* #__PURE__ */ new AsyncLocalStorage());
+AsyncLocalStorageProviderSingleton.initializeGlobalInstance(new AsyncLocalStorage());
 /**
  * Dispatch a custom event.
  *

package/dist/context.cjs

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getContextVariable = exports.setContextVariable = void 0;
+/* __LC_ALLOW_ENTRYPOINT_SIDE_EFFECTS__ */
+const node_async_hooks_1 = require("node:async_hooks");
+const index_js_1 = require("./singletons/index.cjs");
+index_js_1.AsyncLocalStorageProviderSingleton.initializeGlobalInstance(new node_async_hooks_1.AsyncLocalStorage());
+/**
+ * Set a context variable. Context variables are scoped to any
+ * child runnables called by the current runnable, or globally if set outside
+ * of any runnable.
+ *
+ * @remarks
+ * This function is only supported in environments that support AsyncLocalStorage,
+ * including Node.js, Deno, and Cloudflare Workers.
+ *
+ * @example
+ * ```ts
+ * import { RunnableLambda } from "@langchain/core/runnables";
+ * import {
+ *   getContextVariable,
+ *   setContextVariable
+ * } from "@langchain/core/context";
+ *
+ * const nested = RunnableLambda.from(() => {
+ *   // "bar" because it was set by a parent
+ *   console.log(getContextVariable("foo"));
+ *
+ *   // Override to "baz", but only for child runnables
+ *   setContextVariable("foo", "baz");
+ *
+ *   // Now "baz", but only for child runnables
+ *   return getContextVariable("foo");
+ * });
+ *
+ * const runnable = RunnableLambda.from(async () => {
+ *   // Set a context variable named "foo"
+ *   setContextVariable("foo", "bar");
+ *
+ *   const res = await nested.invoke({});
+ *
+ *   // Still "bar" since child changes do not affect parents
+ *   console.log(getContextVariable("foo"));
+ *
+ *   return res;
+ * });
+ *
+ * // undefined, because context variable has not been set yet
+ * console.log(getContextVariable("foo"));
+ *
+ * // Final return value is "baz"
+ * const result = await runnable.invoke({});
+ * ```
+ *
+ * @param name The name of the context variable.
+ * @param value The value to set.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function setContextVariable(name, value) {
+    const runTree = index_js_1.AsyncLocalStorageProviderSingleton.getInstance().getStore();
+    const contextVars = { ...runTree?.[index_js_1._CONTEXT_VARIABLES_KEY] };
+    contextVars[name] = value;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    index_js_1.AsyncLocalStorageProviderSingleton.getInstance().enterWith({
+        ...runTree,
+        [index_js_1._CONTEXT_VARIABLES_KEY]: contextVars,
+    });
+}
+exports.setContextVariable = setContextVariable;
+/**
+ * Get the value of a previously set context variable. Context variables
+ * are scoped to any child runnables called by the current runnable,
+ * or globally if set outside of any runnable.
+ *
+ * @remarks
+ * This function is only supported in environments that support AsyncLocalStorage,
+ * including Node.js, Deno, and Cloudflare Workers.
+ *
+ * @example
+ * ```ts
+ * import { RunnableLambda } from "@langchain/core/runnables";
+ * import {
+ *   getContextVariable,
+ *   setContextVariable
+ * } from "@langchain/core/context";
+ *
+ * const nested = RunnableLambda.from(() => {
+ *   // "bar" because it was set by a parent
+ *   console.log(getContextVariable("foo"));
+ *
+ *   // Override to "baz", but only for child runnables
+ *   setContextVariable("foo", "baz");
+ *
+ *   // Now "baz", but only for child runnables
+ *   return getContextVariable("foo");
+ * });
+ *
+ * const runnable = RunnableLambda.from(async () => {
+ *   // Set a context variable named "foo"
+ *   setContextVariable("foo", "bar");
+ *
+ *   const res = await nested.invoke({});
+ *
+ *   // Still "bar" since child changes do not affect parents
+ *   console.log(getContextVariable("foo"));
+ *
+ *   return res;
+ * });
+ *
+ * // undefined, because context variable has not been set yet
+ * console.log(getContextVariable("foo"));
+ *
+ * // Final return value is "baz"
+ * const result = await runnable.invoke({});
+ * ```
+ *
+ * @param name The name of the context variable.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function getContextVariable(name) {
+    const runTree = index_js_1.AsyncLocalStorageProviderSingleton.getInstance().getStore();
+    return runTree?.[index_js_1._CONTEXT_VARIABLES_KEY]?.[name];
+}
+exports.getContextVariable = getContextVariable;

package/dist/context.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Set a context variable. Context variables are scoped to any
+ * child runnables called by the current runnable, or globally if set outside
+ * of any runnable.
+ *
+ * @remarks
+ * This function is only supported in environments that support AsyncLocalStorage,
+ * including Node.js, Deno, and Cloudflare Workers.
+ *
+ * @example
+ * ```ts
+ * import { RunnableLambda } from "@langchain/core/runnables";
+ * import {
+ *   getContextVariable,
+ *   setContextVariable
+ * } from "@langchain/core/context";
+ *
+ * const nested = RunnableLambda.from(() => {
+ *   // "bar" because it was set by a parent
+ *   console.log(getContextVariable("foo"));
+ *
+ *   // Override to "baz", but only for child runnables
+ *   setContextVariable("foo", "baz");
+ *
+ *   // Now "baz", but only for child runnables
+ *   return getContextVariable("foo");
+ * });
+ *
+ * const runnable = RunnableLambda.from(async () => {
+ *   // Set a context variable named "foo"
+ *   setContextVariable("foo", "bar");
+ *
+ *   const res = await nested.invoke({});
+ *
+ *   // Still "bar" since child changes do not affect parents
+ *   console.log(getContextVariable("foo"));
+ *
+ *   return res;
+ * });
+ *
+ * // undefined, because context variable has not been set yet
+ * console.log(getContextVariable("foo"));
+ *
+ * // Final return value is "baz"
+ * const result = await runnable.invoke({});
+ * ```
+ *
+ * @param name The name of the context variable.
+ * @param value The value to set.
+ */
+export declare function setContextVariable(name: PropertyKey, value: any): void;
+/**
+ * Get the value of a previously set context variable. Context variables
+ * are scoped to any child runnables called by the current runnable,
+ * or globally if set outside of any runnable.
+ *
+ * @remarks
+ * This function is only supported in environments that support AsyncLocalStorage,
+ * including Node.js, Deno, and Cloudflare Workers.
+ *
+ * @example
+ * ```ts
+ * import { RunnableLambda } from "@langchain/core/runnables";
+ * import {
+ *   getContextVariable,
+ *   setContextVariable
+ * } from "@langchain/core/context";
+ *
+ * const nested = RunnableLambda.from(() => {
+ *   // "bar" because it was set by a parent
+ *   console.log(getContextVariable("foo"));
+ *
+ *   // Override to "baz", but only for child runnables
+ *   setContextVariable("foo", "baz");
+ *
+ *   // Now "baz", but only for child runnables
+ *   return getContextVariable("foo");
+ * });
+ *
+ * const runnable = RunnableLambda.from(async () => {
+ *   // Set a context variable named "foo"
+ *   setContextVariable("foo", "bar");
+ *
+ *   const res = await nested.invoke({});
+ *
+ *   // Still "bar" since child changes do not affect parents
+ *   console.log(getContextVariable("foo"));
+ *
+ *   return res;
+ * });
+ *
+ * // undefined, because context variable has not been set yet
+ * console.log(getContextVariable("foo"));
+ *
+ * // Final return value is "baz"
+ * const result = await runnable.invoke({});
+ * ```
+ *
+ * @param name The name of the context variable.
+ */
+export declare function getContextVariable(name: PropertyKey): any;

package/dist/context.js

@@ -0,0 +1,119 @@
+/* __LC_ALLOW_ENTRYPOINT_SIDE_EFFECTS__ */
+import { AsyncLocalStorage } from "node:async_hooks";
+import { _CONTEXT_VARIABLES_KEY, AsyncLocalStorageProviderSingleton, } from "./singletons/index.js";
+AsyncLocalStorageProviderSingleton.initializeGlobalInstance(new AsyncLocalStorage());
+/**
+ * Set a context variable. Context variables are scoped to any
+ * child runnables called by the current runnable, or globally if set outside
+ * of any runnable.
+ *
+ * @remarks
+ * This function is only supported in environments that support AsyncLocalStorage,
+ * including Node.js, Deno, and Cloudflare Workers.
+ *
+ * @example
+ * ```ts
+ * import { RunnableLambda } from "@langchain/core/runnables";
+ * import {
+ *   getContextVariable,
+ *   setContextVariable
+ * } from "@langchain/core/context";
+ *
+ * const nested = RunnableLambda.from(() => {
+ *   // "bar" because it was set by a parent
+ *   console.log(getContextVariable("foo"));
+ *
+ *   // Override to "baz", but only for child runnables
+ *   setContextVariable("foo", "baz");
+ *
+ *   // Now "baz", but only for child runnables
+ *   return getContextVariable("foo");
+ * });
+ *
+ * const runnable = RunnableLambda.from(async () => {
+ *   // Set a context variable named "foo"
+ *   setContextVariable("foo", "bar");
+ *
+ *   const res = await nested.invoke({});
+ *
+ *   // Still "bar" since child changes do not affect parents
+ *   console.log(getContextVariable("foo"));
+ *
+ *   return res;
+ * });
+ *
+ * // undefined, because context variable has not been set yet
+ * console.log(getContextVariable("foo"));
+ *
+ * // Final return value is "baz"
+ * const result = await runnable.invoke({});
+ * ```
+ *
+ * @param name The name of the context variable.
+ * @param value The value to set.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function setContextVariable(name, value) {
+    const runTree = AsyncLocalStorageProviderSingleton.getInstance().getStore();
+    const contextVars = { ...runTree?.[_CONTEXT_VARIABLES_KEY] };
+    contextVars[name] = value;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    AsyncLocalStorageProviderSingleton.getInstance().enterWith({
+        ...runTree,
+        [_CONTEXT_VARIABLES_KEY]: contextVars,
+    });
+}
+/**
+ * Get the value of a previously set context variable. Context variables
+ * are scoped to any child runnables called by the current runnable,
+ * or globally if set outside of any runnable.
+ *
+ * @remarks
+ * This function is only supported in environments that support AsyncLocalStorage,
+ * including Node.js, Deno, and Cloudflare Workers.
+ *
+ * @example
+ * ```ts
+ * import { RunnableLambda } from "@langchain/core/runnables";
+ * import {
+ *   getContextVariable,
+ *   setContextVariable
+ * } from "@langchain/core/context";
+ *
+ * const nested = RunnableLambda.from(() => {
+ *   // "bar" because it was set by a parent
+ *   console.log(getContextVariable("foo"));
+ *
+ *   // Override to "baz", but only for child runnables
+ *   setContextVariable("foo", "baz");
+ *
+ *   // Now "baz", but only for child runnables
+ *   return getContextVariable("foo");
+ * });
+ *
+ * const runnable = RunnableLambda.from(async () => {
+ *   // Set a context variable named "foo"
+ *   setContextVariable("foo", "bar");
+ *
+ *   const res = await nested.invoke({});
+ *
+ *   // Still "bar" since child changes do not affect parents
+ *   console.log(getContextVariable("foo"));
+ *
+ *   return res;
+ * });
+ *
+ * // undefined, because context variable has not been set yet
+ * console.log(getContextVariable("foo"));
+ *
+ * // Final return value is "baz"
+ * const result = await runnable.invoke({});
+ * ```
+ *
+ * @param name The name of the context variable.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function getContextVariable(name) {
+    const runTree = AsyncLocalStorageProviderSingleton.getInstance().getStore();
+    return runTree?.[_CONTEXT_VARIABLES_KEY]?.[name];
+}

package/dist/messages/ai.cjs

@@ -137,6 +137,9 @@ class AIMessageChunk extends base_js_1.BaseMessageChunk {
                 tool_calls: fields.tool_calls ?? [],
                 invalid_tool_calls: [],
                 tool_call_chunks: [],
+                usage_metadata: fields.usage_metadata !== undefined
+                    ? fields.usage_metadata
+                    : undefined,
             };
         }
         else {
@@ -172,6 +175,9 @@ class AIMessageChunk extends base_js_1.BaseMessageChunk {
                 ...fields,
                 tool_calls: toolCalls,
                 invalid_tool_calls: invalidToolCalls,
+                usage_metadata: fields.usage_metadata !== undefined
+                    ? fields.usage_metadata
+                    : undefined,
             };
         }
         // Sadly, TypeScript only allows super() calls at root if the class has
@@ -255,6 +261,41 @@ class AIMessageChunk extends base_js_1.BaseMessageChunk {
         }
         if (this.usage_metadata !== undefined ||
             chunk.usage_metadata !== undefined) {
+            const inputTokenDetails = {
+                ...((this.usage_metadata?.input_token_details?.audio !== undefined ||
+                    chunk.usage_metadata?.input_token_details?.audio !== undefined) && {
+                    audio: (this.usage_metadata?.input_token_details?.audio ?? 0) +
+                        (chunk.usage_metadata?.input_token_details?.audio ?? 0),
+                }),
+                ...((this.usage_metadata?.input_token_details?.cache_read !==
+                    undefined ||
+                    chunk.usage_metadata?.input_token_details?.cache_read !==
+                        undefined) && {
+                    cache_read: (this.usage_metadata?.input_token_details?.cache_read ?? 0) +
+                        (chunk.usage_metadata?.input_token_details?.cache_read ?? 0),
+                }),
+                ...((this.usage_metadata?.input_token_details?.cache_creation !==
+                    undefined ||
+                    chunk.usage_metadata?.input_token_details?.cache_creation !==
+                        undefined) && {
+                    cache_creation: (this.usage_metadata?.input_token_details?.cache_creation ?? 0) +
+                        (chunk.usage_metadata?.input_token_details?.cache_creation ?? 0),
+                }),
+            };
+            const outputTokenDetails = {
+                ...((this.usage_metadata?.output_token_details?.audio !== undefined ||
+                    chunk.usage_metadata?.output_token_details?.audio !== undefined) && {
+                    audio: (this.usage_metadata?.output_token_details?.audio ?? 0) +
+                        (chunk.usage_metadata?.output_token_details?.audio ?? 0),
+                }),
+                ...((this.usage_metadata?.output_token_details?.reasoning !==
+                    undefined ||
+                    chunk.usage_metadata?.output_token_details?.reasoning !==
+                        undefined) && {
+                    reasoning: (this.usage_metadata?.output_token_details?.reasoning ?? 0) +
+                        (chunk.usage_metadata?.output_token_details?.reasoning ?? 0),
+                }),
+            };
             const left = this.usage_metadata ?? {
                 input_tokens: 0,
                 output_tokens: 0,
@@ -269,6 +310,14 @@ class AIMessageChunk extends base_js_1.BaseMessageChunk {
                 input_tokens: left.input_tokens + right.input_tokens,
                 output_tokens: left.output_tokens + right.output_tokens,
                 total_tokens: left.total_tokens + right.total_tokens,
+                // Do not include `input_token_details` / `output_token_details` keys in combined fields
+                // unless their values are defined.
+                ...(Object.keys(inputTokenDetails).length > 0 && {
+                    input_token_details: inputTokenDetails,
+                }),
+                ...(Object.keys(outputTokenDetails).length > 0 && {
+                    output_token_details: outputTokenDetails,
+                }),
             };
             combinedFields.usage_metadata = usage_metadata;
         }

package/dist/messages/ai.d.ts

@@ -5,22 +5,76 @@ export type AIMessageFields = BaseMessageFields & {
     invalid_tool_calls?: InvalidToolCall[];
     usage_metadata?: UsageMetadata;
 };
+/**
+ * Breakdown of input token counts.
+ *
+ * Does not *need* to sum to full input token count. Does *not* need to have all keys.
+ */
+export type InputTokenDetails = {
+    /**
+     * Audio input tokens.
+     */
+    audio?: number;
+    /**
+     * Input tokens that were cached and there was a cache hit.
+     *
+     * Since there was a cache hit, the tokens were read from the cache.
+     * More precisely, the model state given these tokens was read from the cache.
+     */
+    cache_read?: number;
+    /**
+     * Input tokens that were cached and there was a cache miss.
+     *
+     * Since there was a cache miss, the cache was created from these tokens.
+     */
+    cache_creation?: number;
+};
+/**
+ * Breakdown of output token counts.
+ *
+ * Does *not* need to sum to full output token count. Does *not* need to have all keys.
+ */
+export type OutputTokenDetails = {
+    /**
+     * Audio output tokens
+     */
+    audio?: number;
+    /**
+     * Reasoning output tokens.
+     *
+     * Tokens generated by the model in a chain of thought process (i.e. by
+     * OpenAI's o1 models) that are not returned as part of model output.
+     */
+    reasoning?: number;
+};
 /**
  * Usage metadata for a message, such as token counts.
  */
 export type UsageMetadata = {
     /**
-     * The count of input (or prompt) tokens.
+     * Count of input (or prompt) tokens. Sum of all input token types.
      */
     input_tokens: number;
     /**
-     * The count of output (or completion) tokens
+     * Count of output (or completion) tokens. Sum of all output token types.
      */
     output_tokens: number;
     /**
-     * The total token count
+     * Total token count. Sum of input_tokens + output_tokens.
      */
     total_tokens: number;
+    /**
+     * Breakdown of input token counts.
+     *
+     * Does *not* need to sum to full input token count. Does *not* need to have all keys.
+     */
+    input_token_details?: InputTokenDetails;
+    /**
+     * Breakdown of output token counts.
+     *
+     * Does *not* need to sum to full output token count. Does *not* need to have all keys.
+     */
+    output_token_details?: OutputTokenDetails;
 };
 /**
  * Represents an AI message in a conversation.

package/dist/messages/ai.js

@@ -131,6 +131,9 @@ export class AIMessageChunk extends BaseMessageChunk {
                 tool_calls: fields.tool_calls ?? [],
                 invalid_tool_calls: [],
                 tool_call_chunks: [],
+                usage_metadata: fields.usage_metadata !== undefined
+                    ? fields.usage_metadata
+                    : undefined,
             };
         }
         else {
@@ -166,6 +169,9 @@ export class AIMessageChunk extends BaseMessageChunk {
                 ...fields,
                 tool_calls: toolCalls,
                 invalid_tool_calls: invalidToolCalls,
+                usage_metadata: fields.usage_metadata !== undefined
+                    ? fields.usage_metadata
+                    : undefined,
             };
         }
         // Sadly, TypeScript only allows super() calls at root if the class has
@@ -249,6 +255,41 @@ export class AIMessageChunk extends BaseMessageChunk {
         }
         if (this.usage_metadata !== undefined ||
             chunk.usage_metadata !== undefined) {
+            const inputTokenDetails = {
+                ...((this.usage_metadata?.input_token_details?.audio !== undefined ||
+                    chunk.usage_metadata?.input_token_details?.audio !== undefined) && {
+                    audio: (this.usage_metadata?.input_token_details?.audio ?? 0) +
+                        (chunk.usage_metadata?.input_token_details?.audio ?? 0),
+                }),
+                ...((this.usage_metadata?.input_token_details?.cache_read !==
+                    undefined ||
+                    chunk.usage_metadata?.input_token_details?.cache_read !==
+                        undefined) && {
+                    cache_read: (this.usage_metadata?.input_token_details?.cache_read ?? 0) +
+                        (chunk.usage_metadata?.input_token_details?.cache_read ?? 0),
+                }),
+                ...((this.usage_metadata?.input_token_details?.cache_creation !==
+                    undefined ||
+                    chunk.usage_metadata?.input_token_details?.cache_creation !==
+                        undefined) && {
+                    cache_creation: (this.usage_metadata?.input_token_details?.cache_creation ?? 0) +
+                        (chunk.usage_metadata?.input_token_details?.cache_creation ?? 0),
+                }),
+            };
+            const outputTokenDetails = {
+                ...((this.usage_metadata?.output_token_details?.audio !== undefined ||
+                    chunk.usage_metadata?.output_token_details?.audio !== undefined) && {
+                    audio: (this.usage_metadata?.output_token_details?.audio ?? 0) +
+                        (chunk.usage_metadata?.output_token_details?.audio ?? 0),
+                }),
+                ...((this.usage_metadata?.output_token_details?.reasoning !==
+                    undefined ||
+                    chunk.usage_metadata?.output_token_details?.reasoning !==
+                        undefined) && {
+                    reasoning: (this.usage_metadata?.output_token_details?.reasoning ?? 0) +
+                        (chunk.usage_metadata?.output_token_details?.reasoning ?? 0),
+                }),
+            };
             const left = this.usage_metadata ?? {
                 input_tokens: 0,
                 output_tokens: 0,
@@ -263,6 +304,14 @@ export class AIMessageChunk extends BaseMessageChunk {
                 input_tokens: left.input_tokens + right.input_tokens,
                 output_tokens: left.output_tokens + right.output_tokens,
                 total_tokens: left.total_tokens + right.total_tokens,
+                // Do not include `input_token_details` / `output_token_details` keys in combined fields
+                // unless their values are defined.
+                ...(Object.keys(inputTokenDetails).length > 0 && {
+                    input_token_details: inputTokenDetails,
+                }),
+                ...(Object.keys(outputTokenDetails).length > 0 && {
+                    output_token_details: outputTokenDetails,
+                }),
             };
             combinedFields.usage_metadata = usage_metadata;
         }

package/dist/messages/utils.cjs

@@ -91,7 +91,7 @@ function _constructMessageFromParams(params) {
         });
     }
     else {
-        throw new Error(`Unable to coerce message from array: only human, AI, or system message coercion is currently supported.\n\nReceived:${params}`);
+        throw new Error(`Unable to coerce message from array: only human, AI, or system message coercion is currently supported.\n\nReceived: ${JSON.stringify(params, null, 2)}`);
     }
 }
 function coerceMessageLikeToMessage(messageLike) {

package/dist/messages/utils.js

@@ -88,7 +88,7 @@ function _constructMessageFromParams(params) {
         });
     }
     else {
-        throw new Error(`Unable to coerce message from array: only human, AI, or system message coercion is currently supported.\n\nReceived:${params}`);
+        throw new Error(`Unable to coerce message from array: only human, AI, or system message coercion is currently supported.\n\nReceived: ${JSON.stringify(params, null, 2)}`);
     }
 }
 export function coerceMessageLikeToMessage(messageLike) {

package/dist/singletons/index.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AsyncLocalStorageProviderSingleton = exports.MockAsyncLocalStorage = void 0;
+exports.AsyncLocalStorageProviderSingleton = exports._CONTEXT_VARIABLES_KEY = exports.MockAsyncLocalStorage = void 0;
 /* eslint-disable @typescript-eslint/no-explicit-any */
 const langsmith_1 = require("langsmith");
 const manager_js_1 = require("../callbacks/manager.cjs");
@@ -16,6 +16,7 @@ exports.MockAsyncLocalStorage = MockAsyncLocalStorage;
 const mockAsyncLocalStorage = new MockAsyncLocalStorage();
 const TRACING_ALS_KEY = Symbol.for("ls:tracing_async_local_storage");
 const LC_CHILD_KEY = Symbol.for("lc:child_config");
+exports._CONTEXT_VARIABLES_KEY = Symbol.for("lc:context_variables");
 class AsyncLocalStorageProvider {
     getInstance() {
         return globalThis[TRACING_ALS_KEY] ?? mockAsyncLocalStorage;
@@ -30,6 +31,7 @@ class AsyncLocalStorageProvider {
     runWithConfig(config, callback, avoidCreatingRootRunTree) {
         const callbackManager = manager_js_1.CallbackManager._configureSync(config?.callbacks, undefined, config?.tags, undefined, config?.metadata);
         const storage = this.getInstance();
+        const previousValue = storage.getStore();
         const parentRunId = callbackManager?.getParentRunId();
         const langChainTracer = callbackManager?.handlers?.find((handler) => handler?.name === "langchain_tracer");
         let runTree;
@@ -45,6 +47,11 @@ class AsyncLocalStorageProvider {
         if (runTree) {
             runTree.extra = { ...runTree.extra, [LC_CHILD_KEY]: config };
         }
+        if (previousValue !== undefined &&
+            previousValue[exports._CONTEXT_VARIABLES_KEY] !== undefined) {
+            runTree[exports._CONTEXT_VARIABLES_KEY] =
+                previousValue[exports._CONTEXT_VARIABLES_KEY];
+        }
         return storage.run(runTree, callback);
     }
     initializeGlobalInstance(instance) {

package/dist/singletons/index.d.ts

@@ -6,6 +6,7 @@ export declare class MockAsyncLocalStorage implements AsyncLocalStorageInterface
     getStore(): any;
     run<T>(_store: any, callback: () => T): T;
 }
+export declare const _CONTEXT_VARIABLES_KEY: unique symbol;
 declare class AsyncLocalStorageProvider {
     getInstance(): AsyncLocalStorageInterface;
     getRunnableConfig(): any;

package/dist/singletons/index.js

@@ -12,6 +12,7 @@ export class MockAsyncLocalStorage {
 const mockAsyncLocalStorage = new MockAsyncLocalStorage();
 const TRACING_ALS_KEY = Symbol.for("ls:tracing_async_local_storage");
 const LC_CHILD_KEY = Symbol.for("lc:child_config");
+export const _CONTEXT_VARIABLES_KEY = Symbol.for("lc:context_variables");
 class AsyncLocalStorageProvider {
     getInstance() {
         return globalThis[TRACING_ALS_KEY] ?? mockAsyncLocalStorage;
@@ -26,6 +27,7 @@ class AsyncLocalStorageProvider {
     runWithConfig(config, callback, avoidCreatingRootRunTree) {
         const callbackManager = CallbackManager._configureSync(config?.callbacks, undefined, config?.tags, undefined, config?.metadata);
         const storage = this.getInstance();
+        const previousValue = storage.getStore();
         const parentRunId = callbackManager?.getParentRunId();
         const langChainTracer = callbackManager?.handlers?.find((handler) => handler?.name === "langchain_tracer");
         let runTree;
@@ -41,6 +43,11 @@ class AsyncLocalStorageProvider {
         if (runTree) {
             runTree.extra = { ...runTree.extra, [LC_CHILD_KEY]: config };
         }
+        if (previousValue !== undefined &&
+            previousValue[_CONTEXT_VARIABLES_KEY] !== undefined) {
+            runTree[_CONTEXT_VARIABLES_KEY] =
+                previousValue[_CONTEXT_VARIABLES_KEY];
+        }
         return storage.run(runTree, callback);
     }
     initializeGlobalInstance(instance) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/core",
-  "version": "0.3.9-rc.1",
+  "version": "0.3.10-rc.0",
   "description": "Core LangChain.js abstractions and schemas",
   "type": "module",
   "engines": {
@@ -37,7 +37,7 @@
     "camelcase": "6",
     "decamelize": "1.2.0",
     "js-tiktoken": "^1.0.12",
-    "langsmith": "^0.1.56",
+    "langsmith": "^0.1.64",
     "mustache": "^4.2.0",
     "p-queue": "^6.6.2",
     "p-retry": "4",
@@ -160,6 +160,15 @@
       "import": "./chat_history.js",
       "require": "./chat_history.cjs"
     },
+    "./context": {
+      "types": {
+        "import": "./context.d.ts",
+        "require": "./context.d.cts",
+        "default": "./context.d.ts"
+      },
+      "import": "./context.js",
+      "require": "./context.cjs"
+    },
     "./documents": {
       "types": {
         "import": "./documents.d.ts",
@@ -646,6 +655,10 @@
     "chat_history.js",
     "chat_history.d.ts",
     "chat_history.d.cts",
+    "context.cjs",
+    "context.js",
+    "context.d.ts",
+    "context.d.cts",
     "documents.cjs",
     "documents.js",
     "documents.d.ts",