@langchain/core 0.3.74 → 0.3.76

package/README.md

@@ -1,6 +1,6 @@
 # 🦜🍎️ @langchain/core
 
-[![CI](https://github.com/langchain-ai/langchainjs/actions/workflows/ci.yml/badge.svg)](https://github.com/langchain-ai/langchainjs/actions/workflows/ci.yml) ![npm](https://img.shields.io/npm/dm/@langchain/core) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Twitter](https://img.shields.io/twitter/url/https/twitter.com/langchainai.svg?style=social&label=Follow%20%40LangChainAI)](https://twitter.com/langchainai)
+![npm](https://img.shields.io/npm/dm/@langchain/core) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Twitter](https://img.shields.io/twitter/url/https/twitter.com/langchainai.svg?style=social&label=Follow%20%40LangChainAI)](https://twitter.com/langchainai)
 
 `@langchain/core` contains the core abstractions and schemas of LangChain.js, including base classes for language models,
 chat models, vectorstores, retrievers, and runnables.
@@ -8,7 +8,7 @@ chat models, vectorstores, retrievers, and runnables.
 ## 💾 Quick Install
 
 ```bash
-$ yarn add @langchain/core
+yarn add @langchain/core
 ```
 
 ## 🤔 What is this?
@@ -21,7 +21,7 @@ The benefit of having these abstractions is that any provider can implement the
 For example, you can install other provider-specific packages like this:
 
 ```bash
-$ yarn add @langchain/openai
+yarn add @langchain/openai
 ```
 
 And use them as follows:
@@ -72,22 +72,6 @@ leigh
 Note that for compatibility, all used LangChain packages (including the base LangChain package, which itself depends on core!) must share the same version of `@langchain/core`.
 This means that you may need to install/resolve a specific version of `@langchain/core` that matches the dependencies of your used packages.
 
-## 🔗 What is LangChain Expression Language?
-
-LangChain Core also contains LangChain Expression Language, or LCEL, a runtime that allows users to compose arbitrary sequences together and get several benefits that are important when building LLM applications.
-We call these sequences “runnables”.
-
-All runnables expose the same interface with single-invocation, batch, streaming and async methods.
-This design is useful because it is not enough to have a single sync interface when building an LLM application.
-Batch is needed for efficient processing of many inputs.
-Streaming (and streaming of intermediate steps) is needed to show the user that progress is being made.
-Async interfaces are nice when moving into production.
-Rather than having to write multiple implementations for all of those, LCEL allows you to write a runnable once and invoke it in many different ways.
-
-For more check out the [LCEL docs](https://js.langchain.com/docs/concepts/lcel).
-
-![LangChain Stack](../docs/core_docs/static/svg/langchain_stack_062024.svg)
-
 ## 📕 Releases & Versioning
 
 `@langchain/core` is currently on version `0.3.x`.

package/dist/callbacks/manager.cjs

@@ -765,9 +765,12 @@ class CallbackManager extends BaseCallbackManager {
             if (tracingV2Enabled) {
                 // handoff between langchain and langsmith/traceable
                 // override the parent run ID
-                callbackManager._parentRunId =
-                    tracer_langchain_js_1.LangChainTracer.getTraceableRunTree()?.id ??
-                        callbackManager._parentRunId;
+                const implicitRunTree = tracer_langchain_js_1.LangChainTracer.getTraceableRunTree();
+                if (implicitRunTree && callbackManager._parentRunId === undefined) {
+                    callbackManager._parentRunId = implicitRunTree.id;
+                    const tracerV2 = callbackManager.handlers.find((handler) => handler.name === "langchain_tracer");
+                    tracerV2?.updateFromRunTree(implicitRunTree);
+                }
             }
         }
         for (const { contextVar, inheritable = true, handlerClass, envVar, } of (0, context_js_1._getConfigureHooks)()) {

package/dist/callbacks/manager.js

@@ -753,9 +753,12 @@ export class CallbackManager extends BaseCallbackManager {
             if (tracingV2Enabled) {
                 // handoff between langchain and langsmith/traceable
                 // override the parent run ID
-                callbackManager._parentRunId =
-                    LangChainTracer.getTraceableRunTree()?.id ??
-                        callbackManager._parentRunId;
+                const implicitRunTree = LangChainTracer.getTraceableRunTree();
+                if (implicitRunTree && callbackManager._parentRunId === undefined) {
+                    callbackManager._parentRunId = implicitRunTree.id;
+                    const tracerV2 = callbackManager.handlers.find((handler) => handler.name === "langchain_tracer");
+                    tracerV2?.updateFromRunTree(implicitRunTree);
+                }
             }
         }
         for (const { contextVar, inheritable = true, handlerClass, envVar, } of _getConfigureHooks()) {

package/dist/embeddings.d.ts

@@ -4,7 +4,7 @@ import { AsyncCaller, AsyncCallerParams } from "./utils/async_caller.js";
  * class.
  */
 export type EmbeddingsParams = AsyncCallerParams;
-export interface EmbeddingsInterface {
+export interface EmbeddingsInterface<TOutput = number[]> {
     /**
      * An abstract method that takes an array of documents as input and
      * returns a promise that resolves to an array of vectors for each
@@ -12,20 +12,20 @@ export interface EmbeddingsInterface {
      * @param documents An array of documents to be embedded.
      * @returns A promise that resolves to an array of vectors for each document.
      */
-    embedDocuments(documents: string[]): Promise<number[][]>;
+    embedDocuments(documents: string[]): Promise<TOutput[]>;
     /**
      * An abstract method that takes a single document as input and returns a
      * promise that resolves to a vector for the query document.
      * @param document A single document to be embedded.
      * @returns A promise that resolves to a vector for the query document.
      */
-    embedQuery(document: string): Promise<number[]>;
+    embedQuery(document: string): Promise<TOutput>;
 }
 /**
  * An abstract class that provides methods for embedding documents and
  * queries using LangChain.
  */
-export declare abstract class Embeddings implements EmbeddingsInterface {
+export declare abstract class Embeddings<TOutput = number[]> implements EmbeddingsInterface<TOutput> {
     /**
      * The async caller should be used by subclasses to make any async calls,
      * which will thus benefit from the concurrency and retry logic.
@@ -39,12 +39,12 @@ export declare abstract class Embeddings implements EmbeddingsInterface {
      * @param documents An array of documents to be embedded.
      * @returns A promise that resolves to an array of vectors for each document.
      */
-    abstract embedDocuments(documents: string[]): Promise<number[][]>;
+    abstract embedDocuments(documents: string[]): Promise<TOutput[]>;
     /**
      * An abstract method that takes a single document as input and returns a
      * promise that resolves to a vector for the query document.
      * @param document A single document to be embedded.
      * @returns A promise that resolves to a vector for the query document.
      */
-    abstract embedQuery(document: string): Promise<number[]>;
+    abstract embedQuery(document: string): Promise<TOutput>;
 }

package/dist/messages/base.cjs

@@ -285,7 +285,13 @@ right
                 // Do not merge 'type' fields
                 continue;
             }
-            merged[key] += value;
+            else if (["id", "output_version", "model_provider"].includes(key)) {
+                // Keep the incoming value for these fields
+                merged[key] = value;
+            }
+            else {
+                merged[key] += value;
+            }
         }
         else if (typeof merged[key] === "object" && !Array.isArray(merged[key])) {
             merged[key] = _mergeDicts(merged[key], value);
@@ -302,7 +308,6 @@ right
     }
     return merged;
 }
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 function _mergeLists(left, right) {
     if (left === undefined && right === undefined) {
         return undefined;
@@ -314,10 +319,20 @@ function _mergeLists(left, right) {
         const merged = [...left];
         for (const item of right) {
             if (typeof item === "object" &&
+                item !== null &&
                 "index" in item &&
                 typeof item.index === "number") {
-                const toMerge = merged.findIndex((leftItem) => leftItem.index === item.index);
-                if (toMerge !== -1) {
+                const toMerge = merged.findIndex((leftItem) => leftItem !== null &&
+                    typeof leftItem === "object" &&
+                    "index" in leftItem &&
+                    leftItem.index === item.index &&
+                    // Only merge if IDs match (or both are undefined)
+                    ("id" in leftItem && "id" in item
+                        ? leftItem.id === item.id
+                        : !("id" in leftItem) && !("id" in item)));
+                if (toMerge !== -1 &&
+                    typeof merged[toMerge] === "object" &&
+                    merged[toMerge] !== null) {
                     merged[toMerge] = _mergeDicts(merged[toMerge], item);
                 }
                 else {
@@ -325,6 +340,7 @@ function _mergeLists(left, right) {
                 }
             }
             else if (typeof item === "object" &&
+                item !== null &&
                 "text" in item &&
                 item.text === "") {
                 // No-op - skip empty text blocks

package/dist/messages/base.d.ts

@@ -156,7 +156,7 @@ export type OpenAIToolCall = {
 };
 export declare function isOpenAIToolCallArray(value?: unknown): value is OpenAIToolCall[];
 export declare function _mergeDicts(left: Record<string, any>, right: Record<string, any>): Record<string, any>;
-export declare function _mergeLists(left?: any[], right?: any[]): any[] | undefined;
+export declare function _mergeLists<Content extends MessageContentComplex>(left?: Content[], right?: Content[]): Content[] | undefined;
 export declare function _mergeObj<T = any>(left: T | undefined, right: T | undefined): T;
 /**
  * Represents a chunk of a message, which can be concatenated with other

package/dist/messages/base.js

@@ -272,7 +272,13 @@ right
                 // Do not merge 'type' fields
                 continue;
             }
-            merged[key] += value;
+            else if (["id", "output_version", "model_provider"].includes(key)) {
+                // Keep the incoming value for these fields
+                merged[key] = value;
+            }
+            else {
+                merged[key] += value;
+            }
         }
         else if (typeof merged[key] === "object" && !Array.isArray(merged[key])) {
             merged[key] = _mergeDicts(merged[key], value);
@@ -289,7 +295,6 @@ right
     }
     return merged;
 }
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function _mergeLists(left, right) {
     if (left === undefined && right === undefined) {
         return undefined;
@@ -301,10 +306,20 @@ export function _mergeLists(left, right) {
         const merged = [...left];
         for (const item of right) {
             if (typeof item === "object" &&
+                item !== null &&
                 "index" in item &&
                 typeof item.index === "number") {
-                const toMerge = merged.findIndex((leftItem) => leftItem.index === item.index);
-                if (toMerge !== -1) {
+                const toMerge = merged.findIndex((leftItem) => leftItem !== null &&
+                    typeof leftItem === "object" &&
+                    "index" in leftItem &&
+                    leftItem.index === item.index &&
+                    // Only merge if IDs match (or both are undefined)
+                    ("id" in leftItem && "id" in item
+                        ? leftItem.id === item.id
+                        : !("id" in leftItem) && !("id" in item)));
+                if (toMerge !== -1 &&
+                    typeof merged[toMerge] === "object" &&
+                    merged[toMerge] !== null) {
                     merged[toMerge] = _mergeDicts(merged[toMerge], item);
                 }
                 else {
@@ -312,6 +327,7 @@ export function _mergeLists(left, right) {
                 }
             }
             else if (typeof item === "object" &&
+                item !== null &&
                 "text" in item &&
                 item.text === "") {
                 // No-op - skip empty text blocks

package/dist/messages/transformers.cjs

@@ -182,7 +182,7 @@ async function _firstMaxTokens(messages, options) {
             break;
         }
     }
-    if (idx < messagesCopy.length - 1 && partialStrategy) {
+    if (idx < messagesCopy.length && partialStrategy) {
         let includedPartial = false;
         if (Array.isArray(messagesCopy[idx].content)) {
             const excluded = messagesCopy[idx];

package/dist/messages/transformers.js

@@ -176,7 +176,7 @@ async function _firstMaxTokens(messages, options) {
             break;
         }
     }
-    if (idx < messagesCopy.length - 1 && partialStrategy) {
+    if (idx < messagesCopy.length && partialStrategy) {
         let includedPartial = false;
         if (Array.isArray(messagesCopy[idx].content)) {
             const excluded = messagesCopy[idx];

package/dist/messages/utils.cjs

@@ -13,6 +13,7 @@ const base_js_1 = require("./base.cjs");
 const chat_js_1 = require("./chat.cjs");
 const function_js_1 = require("./function.cjs");
 const human_js_1 = require("./human.cjs");
+const modifier_js_1 = require("./modifier.cjs");
 const system_js_1 = require("./system.cjs");
 const tool_js_1 = require("./tool.cjs");
 function _coerceToolCall(toolCall) {
@@ -113,6 +114,9 @@ function _constructMessageFromParams(params) {
             name: rest.name,
         });
     }
+    else if (type === "remove" && "id" in rest && typeof rest.id === "string") {
+        return new modifier_js_1.RemoveMessage({ ...rest, id: rest.id });
+    }
     else {
         const error = (0, index_js_1.addLangChainErrorFields)(new Error(`Unable to coerce message from array: only human, AI, system, developer, or tool message coercion is currently supported.\n\nReceived: ${JSON.stringify(params, null, 2)}`), "MESSAGE_COERCION_FAILURE");
         throw error;

package/dist/messages/utils.js

@@ -5,6 +5,7 @@ import { isBaseMessage, _isMessageFieldWithRole, } from "./base.js";
 import { ChatMessage, ChatMessageChunk, } from "./chat.js";
 import { FunctionMessage, FunctionMessageChunk, } from "./function.js";
 import { HumanMessage, HumanMessageChunk } from "./human.js";
+import { RemoveMessage } from "./modifier.js";
 import { SystemMessage, SystemMessageChunk } from "./system.js";
 import { ToolMessage, } from "./tool.js";
 function _coerceToolCall(toolCall) {
@@ -105,6 +106,9 @@ function _constructMessageFromParams(params) {
             name: rest.name,
         });
     }
+    else if (type === "remove" && "id" in rest && typeof rest.id === "string") {
+        return new RemoveMessage({ ...rest, id: rest.id });
+    }
     else {
         const error = addLangChainErrorFields(new Error(`Unable to coerce message from array: only human, AI, system, developer, or tool message coercion is currently supported.\n\nReceived: ${JSON.stringify(params, null, 2)}`), "MESSAGE_COERCION_FAILURE");
         throw error;

package/dist/output_parsers/structured.cjs

@@ -75,9 +75,14 @@ ${JSON.stringify((0, json_schema_js_1.toJsonSchema)(this.schema))}
      */
     async parse(text) {
         try {
-            const json = text.includes("```")
-                ? text.trim().split(/```(?:json)?/)[1]
-                : text.trim();
+            const trimmedText = text.trim();
+            const json = 
+            // first case: if back ticks appear at the start of the text
+            trimmedText.match(/^```(?:json)?\s*([\s\S]*?)```/)?.[1] ||
+                // second case: if back ticks with `json` appear anywhere in the text
+                trimmedText.match(/```json\s*([\s\S]*?)```/)?.[1] ||
+                // otherwise, return the trimmed text
+                trimmedText;
             const escapedJson = json
                 .replace(/"([^"\\]*(\\.[^"\\]*)*)"/g, (_match, capturedGroup) => {
                 const escapedInsideQuotes = capturedGroup.replace(/\n/g, "\\n");

package/dist/output_parsers/structured.js

@@ -72,9 +72,14 @@ ${JSON.stringify(toJsonSchema(this.schema))}
      */
     async parse(text) {
         try {
-            const json = text.includes("```")
-                ? text.trim().split(/```(?:json)?/)[1]
-                : text.trim();
+            const trimmedText = text.trim();
+            const json = 
+            // first case: if back ticks appear at the start of the text
+            trimmedText.match(/^```(?:json)?\s*([\s\S]*?)```/)?.[1] ||
+                // second case: if back ticks with `json` appear anywhere in the text
+                trimmedText.match(/```json\s*([\s\S]*?)```/)?.[1] ||
+                // otherwise, return the trimmed text
+                trimmedText;
             const escapedJson = json
                 .replace(/"([^"\\]*(\\.[^"\\]*)*)"/g, (_match, capturedGroup) => {
                 const escapedInsideQuotes = capturedGroup.replace(/\n/g, "\\n");

package/dist/prompts/chat.cjs

@@ -723,15 +723,21 @@ class ChatPromptTemplate extends BaseChatPromptTemplate {
                 resultMessages.push(await this._parseImagePrompts(promptMessage, allValues));
             }
             else {
-                const inputValues = promptMessage.inputVariables.reduce((acc, inputVariable) => {
-                    if (!(inputVariable in allValues) &&
-                        !(isMessagesPlaceholder(promptMessage) && promptMessage.optional)) {
-                        const error = (0, index_js_2.addLangChainErrorFields)(new Error(`Missing value for input variable \`${inputVariable.toString()}\``), "INVALID_PROMPT_INPUT");
-                        throw error;
-                    }
-                    acc[inputVariable] = allValues[inputVariable];
-                    return acc;
-                }, {});
+                let inputValues;
+                if (this.templateFormat === "mustache") {
+                    inputValues = { ...allValues };
+                }
+                else {
+                    inputValues = promptMessage.inputVariables.reduce((acc, inputVariable) => {
+                        if (!(inputVariable in allValues) &&
+                            !(isMessagesPlaceholder(promptMessage) && promptMessage.optional)) {
+                            const error = (0, index_js_2.addLangChainErrorFields)(new Error(`Missing value for input variable \`${inputVariable.toString()}\``), "INVALID_PROMPT_INPUT");
+                            throw error;
+                        }
+                        acc[inputVariable] = allValues[inputVariable];
+                        return acc;
+                    }, {});
+                }
                 const message = await promptMessage.formatMessages(inputValues);
                 resultMessages = resultMessages.concat(message);
             }

package/dist/prompts/chat.js

@@ -712,15 +712,21 @@ export class ChatPromptTemplate extends BaseChatPromptTemplate {
                 resultMessages.push(await this._parseImagePrompts(promptMessage, allValues));
             }
             else {
-                const inputValues = promptMessage.inputVariables.reduce((acc, inputVariable) => {
-                    if (!(inputVariable in allValues) &&
-                        !(isMessagesPlaceholder(promptMessage) && promptMessage.optional)) {
-                        const error = addLangChainErrorFields(new Error(`Missing value for input variable \`${inputVariable.toString()}\``), "INVALID_PROMPT_INPUT");
-                        throw error;
-                    }
-                    acc[inputVariable] = allValues[inputVariable];
-                    return acc;
-                }, {});
+                let inputValues;
+                if (this.templateFormat === "mustache") {
+                    inputValues = { ...allValues };
+                }
+                else {
+                    inputValues = promptMessage.inputVariables.reduce((acc, inputVariable) => {
+                        if (!(inputVariable in allValues) &&
+                            !(isMessagesPlaceholder(promptMessage) && promptMessage.optional)) {
+                            const error = addLangChainErrorFields(new Error(`Missing value for input variable \`${inputVariable.toString()}\``), "INVALID_PROMPT_INPUT");
+                            throw error;
+                        }
+                        acc[inputVariable] = allValues[inputVariable];
+                        return acc;
+                    }, {});
+                }
                 const message = await promptMessage.formatMessages(inputValues);
                 resultMessages = resultMessages.concat(message);
             }

package/dist/prompts/template.cjs

@@ -65,9 +65,10 @@ exports.parseFString = parseFString;
  * to make it compatible with other LangChain string parsing template formats.
  *
  * @param {mustache.TemplateSpans} template The result of parsing a mustache template with the mustache.js library.
+ * @param {string[]} context Array of section variable names for nested context
  * @returns {ParsedTemplateNode[]}
  */
-const mustacheTemplateToNodes = (template) => {
+const mustacheTemplateToNodes = (template, context = []) => {
     const nodes = [];
     for (const temp of template) {
         if (temp[0] === "name") {
@@ -80,7 +81,8 @@ const mustacheTemplateToNodes = (template) => {
             nodes.push({ type: "variable", name: temp[1] });
             // If this is a section with nested content, recursively process it
             if (temp[0] === "#" && temp.length > 4 && Array.isArray(temp[4])) {
-                const nestedNodes = mustacheTemplateToNodes(temp[4]);
+                const newContext = [...context, temp[1]];
+                const nestedNodes = mustacheTemplateToNodes(temp[4], newContext);
                 nodes.push(...nestedNodes);
             }
         }

package/dist/prompts/template.js

@@ -58,9 +58,10 @@ export const parseFString = (template) => {
  * to make it compatible with other LangChain string parsing template formats.
  *
  * @param {mustache.TemplateSpans} template The result of parsing a mustache template with the mustache.js library.
+ * @param {string[]} context Array of section variable names for nested context
  * @returns {ParsedTemplateNode[]}
  */
-const mustacheTemplateToNodes = (template) => {
+const mustacheTemplateToNodes = (template, context = []) => {
     const nodes = [];
     for (const temp of template) {
         if (temp[0] === "name") {
@@ -73,7 +74,8 @@ const mustacheTemplateToNodes = (template) => {
             nodes.push({ type: "variable", name: temp[1] });
             // If this is a section with nested content, recursively process it
             if (temp[0] === "#" && temp.length > 4 && Array.isArray(temp[4])) {
-                const nestedNodes = mustacheTemplateToNodes(temp[4]);
+                const newContext = [...context, temp[1]];
+                const nestedNodes = mustacheTemplateToNodes(temp[4], newContext);
                 nodes.push(...nestedNodes);
             }
         }

package/dist/runnables/graph_mermaid.cjs

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.drawMermaid = drawMermaid;
 exports.drawMermaidPng = drawMermaidPng;
+exports.drawMermaidImage = drawMermaidImage;
 function _escapeNodeLabel(nodeLabel) {
     // Escapes the node label for Mermaid syntax.
     return nodeLabel.replace(/[^a-zA-Z-_0-9]/g, "_");
@@ -124,10 +125,33 @@ function drawMermaid(nodes, edges, config) {
     return mermaidGraph;
 }
 /**
- * Renders Mermaid graph using the Mermaid.INK API.
+ * @deprecated Use `drawMermaidImage` instead.
  */
 async function drawMermaidPng(mermaidSyntax, config) {
-    let { backgroundColor = "white" } = config ?? {};
+    return drawMermaidImage(mermaidSyntax, {
+        ...config,
+        imageType: "png",
+    });
+}
+/**
+ * Renders Mermaid graph using the Mermaid.INK API.
+ *
+ * @example
+ * ```javascript
+ * const image = await drawMermaidImage(mermaidSyntax, {
+ *   backgroundColor: "white",
+ *   imageType: "png",
+ * });
+ * fs.writeFileSync("image.png", image);
+ * ```
+ *
+ * @param mermaidSyntax - The Mermaid syntax to render.
+ * @param config - The configuration for the image.
+ * @returns The image as a Blob.
+ */
+async function drawMermaidImage(mermaidSyntax, config) {
+    let backgroundColor = config?.backgroundColor ?? "white";
+    const imageType = config?.imageType ?? "png";
     // Use btoa for compatibility, assume ASCII
     const mermaidSyntaxEncoded = btoa(mermaidSyntax);
     // Check if the background color is a hexadecimal color code using regex
@@ -137,7 +161,7 @@ async function drawMermaidPng(mermaidSyntax, config) {
             backgroundColor = `!${backgroundColor}`;
         }
     }
-    const imageUrl = `https://mermaid.ink/img/${mermaidSyntaxEncoded}?bgColor=${backgroundColor}`;
+    const imageUrl = `https://mermaid.ink/img/${mermaidSyntaxEncoded}?bgColor=${backgroundColor}&type=${imageType}`;
     const res = await fetch(imageUrl);
     if (!res.ok) {
         throw new Error([

package/dist/runnables/graph_mermaid.d.ts

@@ -11,8 +11,32 @@ export declare function drawMermaid(nodes: Record<string, Node>, edges: Edge[],
     wrapLabelNWords?: number;
 }): string;
 /**
- * Renders Mermaid graph using the Mermaid.INK API.
+ * @deprecated Use `drawMermaidImage` instead.
  */
 export declare function drawMermaidPng(mermaidSyntax: string, config?: {
     backgroundColor?: string;
 }): Promise<Blob>;
+/**
+ * Renders Mermaid graph using the Mermaid.INK API.
+ *
+ * @example
+ * ```javascript
+ * const image = await drawMermaidImage(mermaidSyntax, {
+ *   backgroundColor: "white",
+ *   imageType: "png",
+ * });
+ * fs.writeFileSync("image.png", image);
+ * ```
+ *
+ * @param mermaidSyntax - The Mermaid syntax to render.
+ * @param config - The configuration for the image.
+ * @returns The image as a Blob.
+ */
+export declare function drawMermaidImage(mermaidSyntax: string, config?: {
+    /**
+     * The type of image to render.
+     * @default "png"
+     */
+    imageType?: "png" | "jpeg" | "webp";
+    backgroundColor?: string;
+}): Promise<Blob>;

package/dist/runnables/graph_mermaid.js

@@ -120,10 +120,33 @@ export function drawMermaid(nodes, edges, config) {
     return mermaidGraph;
 }
 /**
- * Renders Mermaid graph using the Mermaid.INK API.
+ * @deprecated Use `drawMermaidImage` instead.
  */
 export async function drawMermaidPng(mermaidSyntax, config) {
-    let { backgroundColor = "white" } = config ?? {};
+    return drawMermaidImage(mermaidSyntax, {
+        ...config,
+        imageType: "png",
+    });
+}
+/**
+ * Renders Mermaid graph using the Mermaid.INK API.
+ *
+ * @example
+ * ```javascript
+ * const image = await drawMermaidImage(mermaidSyntax, {
+ *   backgroundColor: "white",
+ *   imageType: "png",
+ * });
+ * fs.writeFileSync("image.png", image);
+ * ```
+ *
+ * @param mermaidSyntax - The Mermaid syntax to render.
+ * @param config - The configuration for the image.
+ * @returns The image as a Blob.
+ */
+export async function drawMermaidImage(mermaidSyntax, config) {
+    let backgroundColor = config?.backgroundColor ?? "white";
+    const imageType = config?.imageType ?? "png";
     // Use btoa for compatibility, assume ASCII
     const mermaidSyntaxEncoded = btoa(mermaidSyntax);
     // Check if the background color is a hexadecimal color code using regex
@@ -133,7 +156,7 @@ export async function drawMermaidPng(mermaidSyntax, config) {
             backgroundColor = `!${backgroundColor}`;
         }
     }
-    const imageUrl = `https://mermaid.ink/img/${mermaidSyntaxEncoded}?bgColor=${backgroundColor}`;
+    const imageUrl = `https://mermaid.ink/img/${mermaidSyntaxEncoded}?bgColor=${backgroundColor}&type=${imageType}`;
     const res = await fetch(imageUrl);
     if (!res.ok) {
         throw new Error([

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/core",
-  "version": "0.3.74",
+  "version": "0.3.76",
   "description": "Core LangChain.js abstractions and schemas",
   "type": "module",
   "engines": {
@@ -38,7 +38,7 @@
     "camelcase": "6",
     "decamelize": "1.2.0",
     "js-tiktoken": "^1.0.12",
-    "langsmith": "^0.3.46",
+    "langsmith": "^0.3.67",
     "mustache": "^4.2.0",
     "p-queue": "^6.6.2",
     "p-retry": "4",