@langchain/core 0.2.15 → 0.2.16

package/dist/callbacks/manager.d.ts

@@ -93,7 +93,7 @@ export declare class CallbackManagerForChainRun extends BaseRunManager implement
 export declare class CallbackManagerForToolRun extends BaseRunManager implements BaseCallbackManagerMethods {
     getChild(tag?: string): CallbackManager;
     handleToolError(err: Error | unknown): Promise<void>;
-    handleToolEnd(output: string): Promise<void>;
+    handleToolEnd(output: any): Promise<void>;
 }
 /**
  * @example
@@ -141,6 +141,7 @@ export declare class CallbackManager extends BaseCallbackManager implements Base
     handleChainStart(chain: Serialized, inputs: ChainValues, runId?: string, runType?: string | undefined, _tags?: string[] | undefined, _metadata?: Record<string, unknown> | undefined, runName?: string | undefined): Promise<CallbackManagerForChainRun>;
     handleToolStart(tool: Serialized, input: string, runId?: string, _parentRunId?: string | undefined, _tags?: string[] | undefined, _metadata?: Record<string, unknown> | undefined, runName?: string | undefined): Promise<CallbackManagerForToolRun>;
     handleRetrieverStart(retriever: Serialized, query: string, runId?: string, _parentRunId?: string | undefined, _tags?: string[] | undefined, _metadata?: Record<string, unknown> | undefined, runName?: string | undefined): Promise<CallbackManagerForRetrieverRun>;
+    handleCustomEvent?(eventName: string, data: any, runId: string, _tags?: string[], _metadata?: Record<string, any>): Promise<any>;
     addHandler(handler: BaseCallbackHandler, inherit?: boolean): void;
     removeHandler(handler: BaseCallbackHandler): void;
     setHandlers(handlers: BaseCallbackHandler[], inherit?: boolean): void;

package/dist/callbacks/manager.js

@@ -299,6 +299,7 @@ export class CallbackManagerForToolRun extends BaseRunManager {
             }
         }, handler.awaitHandlers)));
     }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     async handleToolEnd(output) {
         await Promise.all(this.handlers.map((handler) => consumeCallback(async () => {
             if (!handler.ignoreAgent) {
@@ -496,6 +497,25 @@ export class CallbackManager extends BaseCallbackManager {
         }, handler.awaitHandlers)));
         return new CallbackManagerForRetrieverRun(runId, this.handlers, this.inheritableHandlers, this.tags, this.inheritableTags, this.metadata, this.inheritableMetadata, this._parentRunId);
     }
+    async handleCustomEvent(eventName, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    data, runId, _tags, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    _metadata) {
+        await Promise.all(this.handlers.map((handler) => consumeCallback(async () => {
+            if (!handler.ignoreCustomEvent) {
+                try {
+                    await handler.handleCustomEvent?.(eventName, data, runId, this.tags, this.metadata);
+                }
+                catch (err) {
+                    console.error(`Error in handler ${handler.constructor.name}, handleCustomEvent: ${err}`);
+                    if (handler.raiseError) {
+                        throw err;
+                    }
+                }
+            }
+        }, handler.awaitHandlers)));
+    }
     addHandler(handler, inherit = true) {
         this.handlers.push(handler);
         if (inherit) {

package/dist/language_models/base.cjs

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseLanguageModel = exports.BaseLangChain = exports.calculateMaxTokens = exports.isOpenAITool = exports.getModelContextSize = exports.getEmbeddingContextSize = exports.getModelNameForTiktoken = void 0;
-const caches_js_1 = require("../caches.cjs");
+const base_js_1 = require("../caches/base.cjs");
 const prompt_values_js_1 = require("../prompt_values.cjs");
 const utils_js_1 = require("../messages/utils.cjs");
 const async_caller_js_1 = require("../utils/async_caller.cjs");
 const tiktoken_js_1 = require("../utils/tiktoken.cjs");
-const base_js_1 = require("../runnables/base.cjs");
+const base_js_2 = require("../runnables/base.cjs");
 // https://www.npmjs.com/package/js-tiktoken
 const getModelNameForTiktoken = (modelName) => {
     if (modelName.startsWith("gpt-3.5-turbo-16k")) {
@@ -102,7 +102,7 @@ const getVerbosity = () => false;
 /**
  * Base class for language models, chains, tools.
  */
-class BaseLangChain extends base_js_1.Runnable {
+class BaseLangChain extends base_js_2.Runnable {
     get lc_attributes() {
         return {
             callbacks: undefined,
@@ -186,7 +186,7 @@ class BaseLanguageModel extends BaseLangChain {
             this.cache = params.cache;
         }
         else if (params.cache) {
-            this.cache = caches_js_1.InMemoryCache.global();
+            this.cache = base_js_1.InMemoryCache.global();
         }
         else {
             this.cache = undefined;

package/dist/language_models/base.d.ts

@@ -1,6 +1,6 @@
 import type { TiktokenModel } from "js-tiktoken/lite";
 import { z } from "zod";
-import { type BaseCache } from "../caches.js";
+import { type BaseCache } from "../caches/base.js";
 import { type BasePromptValueInterface } from "../prompt_values.js";
 import { type BaseMessage, type BaseMessageLike, type MessageContent } from "../messages/base.js";
 import { type LLMResult } from "../outputs.js";
@@ -186,7 +186,7 @@ export declare abstract class BaseLanguageModel<RunOutput = any, CallOptions ext
      * @param callOptions Call options for the model
      * @returns A unique cache key.
      */
-    protected _getSerializedCacheKeyParametersForCall({ config, ...callOptions }: CallOptions & {
+    _getSerializedCacheKeyParametersForCall({ config, ...callOptions }: CallOptions & {
         config?: RunnableConfig;
     }): string;
     /**

package/dist/language_models/base.js

@@ -1,4 +1,4 @@
-import { InMemoryCache } from "../caches.js";
+import { InMemoryCache } from "../caches/base.js";
 import { StringPromptValue, ChatPromptValue, } from "../prompt_values.js";
 import { coerceMessageLikeToMessage } from "../messages/utils.js";
 import { AsyncCaller } from "../utils/async_caller.js";

package/dist/language_models/chat_models.d.ts

@@ -5,9 +5,9 @@ import { LLMResult, ChatGenerationChunk, type ChatResult, type Generation } from
 import { BaseLanguageModel, StructuredOutputMethodOptions, ToolDefinition, type BaseLanguageModelCallOptions, type BaseLanguageModelInput, type BaseLanguageModelParams } from "./base.js";
 import { type CallbackManagerForLLMRun, type Callbacks } from "../callbacks/manager.js";
 import type { RunnableConfig } from "../runnables/config.js";
-import type { BaseCache } from "../caches.js";
-import { StructuredToolInterface } from "../tools.js";
-import { Runnable } from "../runnables/base.js";
+import type { BaseCache } from "../caches/base.js";
+import { StructuredToolInterface } from "../tools/index.js";
+import { Runnable, RunnableToolLike } from "../runnables/base.js";
 /**
  * Represents a serialized chat model.
  */
@@ -69,7 +69,7 @@ export declare abstract class BaseChatModel<CallOptions extends BaseChatModelCal
      * matching the provider's specific tool schema.
      * @param kwargs Any additional parameters to bind.
      */
-    bindTools?(tools: (StructuredToolInterface | Record<string, unknown> | ToolDefinition)[], kwargs?: Partial<CallOptions>): Runnable<BaseLanguageModelInput, OutputMessageType, CallOptions>;
+    bindTools?(tools: (StructuredToolInterface | Record<string, unknown> | ToolDefinition | RunnableToolLike)[], kwargs?: Partial<CallOptions>): Runnable<BaseLanguageModelInput, OutputMessageType, CallOptions>;
     /**
      * Invokes the chat model with a single input.
      * @param input The input for the language model.

package/dist/language_models/llms.d.ts

@@ -4,7 +4,7 @@ import { type LLMResult, type Generation, GenerationChunk } from "../outputs.js"
 import { type BaseCallbackConfig, type CallbackManagerForLLMRun, type Callbacks } from "../callbacks/manager.js";
 import { BaseLanguageModel, type BaseLanguageModelCallOptions, type BaseLanguageModelInput, type BaseLanguageModelParams } from "./base.js";
 import type { RunnableConfig } from "../runnables/config.js";
-import type { BaseCache } from "../caches.js";
+import type { BaseCache } from "../caches/base.js";
 export type SerializedLLM = {
     _model: string;
     _type: string;

package/dist/language_models/tests/chat_models.test.js

@@ -3,6 +3,8 @@ import { test } from "@jest/globals";
 import { z } from "zod";
 import { zodToJsonSchema } from "zod-to-json-schema";
 import { FakeChatModel, FakeListChatModel } from "../../utils/testing/index.js";
+import { HumanMessage } from "../../messages/human.js";
+import { getBufferString } from "../../messages/utils.js";
 test("Test ChatModel accepts array shorthand for messages", async () => {
     const model = new FakeChatModel({});
     const response = await model.invoke([["human", "Hello there!"]]);
@@ -169,3 +171,34 @@ test("Test ChatModel withStructuredOutput new syntax and includeRaw", async () =
     // No error
     console.log(response.parsed);
 });
+test("Test ChatModel can cache complex messages", async () => {
+    const model = new FakeChatModel({
+        cache: true,
+    });
+    if (!model.cache) {
+        throw new Error("Cache not enabled");
+    }
+    const contentToCache = [
+        {
+            type: "text",
+            text: "Hello there!",
+        },
+    ];
+    const humanMessage = new HumanMessage({
+        content: contentToCache,
+    });
+    const prompt = getBufferString([humanMessage]);
+    const llmKey = model._getSerializedCacheKeyParametersForCall({});
+    // Invoke model to trigger cache update
+    await model.invoke([humanMessage]);
+    const value = await model.cache.lookup(prompt, llmKey);
+    expect(value).toBeDefined();
+    if (!value)
+        return;
+    expect(value[0].text).toEqual(JSON.stringify(contentToCache, null, 2));
+    expect("message" in value[0]).toBeTruthy();
+    if (!("message" in value[0]))
+        return;
+    const cachedMsg = value[0].message;
+    expect(cachedMsg.content).toEqual(JSON.stringify(contentToCache, null, 2));
+});

package/dist/load/import_map.cjs

@@ -26,7 +26,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.vectorstores = exports.utils__types = exports.utils__tiktoken = exports.utils__testing = exports.utils__stream = exports.utils__math = exports.utils__json_schema = exports.utils__json_patch = exports.utils__hash = exports.utils__function_calling = exports.utils__env = exports.utils__chunk_array = exports.utils__async_caller = exports.tracers__tracer_langchain_v1 = exports.tracers__tracer_langchain = exports.tracers__run_collector = exports.tracers__log_stream = exports.tracers__initialize = exports.tracers__console = exports.tracers__base = exports.tools = exports.stores = exports.retrievers = exports.runnables = exports.prompt_values = exports.prompts = exports.outputs = exports.output_parsers = exports.messages = exports.memory = exports.load__serializable = exports.language_models__llms = exports.language_models__chat_models = exports.language_models__base = exports.example_selectors = exports.embeddings = exports.documents = exports.chat_history = exports.callbacks__promises = exports.callbacks__manager = exports.callbacks__base = exports.caches = exports.agents = void 0;
 exports.agents = __importStar(require("../agents.cjs"));
-exports.caches = __importStar(require("../caches.cjs"));
+exports.caches = __importStar(require("../caches/base.cjs"));
 exports.callbacks__base = __importStar(require("../callbacks/base.cjs"));
 exports.callbacks__manager = __importStar(require("../callbacks/manager.cjs"));
 exports.callbacks__promises = __importStar(require("../callbacks/promises.cjs"));
@@ -47,7 +47,7 @@ exports.prompt_values = __importStar(require("../prompt_values.cjs"));
 exports.runnables = __importStar(require("../runnables/index.cjs"));
 exports.retrievers = __importStar(require("../retrievers/index.cjs"));
 exports.stores = __importStar(require("../stores.cjs"));
-exports.tools = __importStar(require("../tools.cjs"));
+exports.tools = __importStar(require("../tools/index.cjs"));
 exports.tracers__base = __importStar(require("../tracers/base.cjs"));
 exports.tracers__console = __importStar(require("../tracers/console.cjs"));
 exports.tracers__initialize = __importStar(require("../tracers/initialize.cjs"));

package/dist/load/import_map.d.ts

@@ -1,5 +1,5 @@
 export * as agents from "../agents.js";
-export * as caches from "../caches.js";
+export * as caches from "../caches/base.js";
 export * as callbacks__base from "../callbacks/base.js";
 export * as callbacks__manager from "../callbacks/manager.js";
 export * as callbacks__promises from "../callbacks/promises.js";
@@ -20,7 +20,7 @@ export * as prompt_values from "../prompt_values.js";
 export * as runnables from "../runnables/index.js";
 export * as retrievers from "../retrievers/index.js";
 export * as stores from "../stores.js";
-export * as tools from "../tools.js";
+export * as tools from "../tools/index.js";
 export * as tracers__base from "../tracers/base.js";
 export * as tracers__console from "../tracers/console.js";
 export * as tracers__initialize from "../tracers/initialize.js";

package/dist/load/import_map.js

@@ -1,6 +1,6 @@
 // Auto-generated by `scripts/create-entrypoints.js`. Do not edit manually.
 export * as agents from "../agents.js";
-export * as caches from "../caches.js";
+export * as caches from "../caches/base.js";
 export * as callbacks__base from "../callbacks/base.js";
 export * as callbacks__manager from "../callbacks/manager.js";
 export * as callbacks__promises from "../callbacks/promises.js";
@@ -21,7 +21,7 @@ export * as prompt_values from "../prompt_values.js";
 export * as runnables from "../runnables/index.js";
 export * as retrievers from "../retrievers/index.js";
 export * as stores from "../stores.js";
-export * as tools from "../tools.js";
+export * as tools from "../tools/index.js";
 export * as tracers__base from "../tracers/base.js";
 export * as tracers__console from "../tracers/console.js";
 export * as tracers__initialize from "../tracers/initialize.js";

package/dist/messages/ai.cjs

@@ -141,6 +141,7 @@ class AIMessageChunk extends base_js_1.BaseMessageChunk {
                         name: toolCallChunk.name ?? "",
                         args: parsedArgs,
                         id: toolCallChunk.id,
+                        type: "tool_call",
                     });
                 }
                 catch (e) {
@@ -149,6 +150,7 @@ class AIMessageChunk extends base_js_1.BaseMessageChunk {
                         args: toolCallChunk.args,
                         id: toolCallChunk.id,
                         error: "Malformed args.",
+                        type: "invalid_tool_call",
                     });
                 }
             }

package/dist/messages/ai.js

@@ -136,6 +136,7 @@ export class AIMessageChunk extends BaseMessageChunk {
                         name: toolCallChunk.name ?? "",
                         args: parsedArgs,
                         id: toolCallChunk.id,
+                        type: "tool_call",
                     });
                 }
                 catch (e) {
@@ -144,6 +145,7 @@ export class AIMessageChunk extends BaseMessageChunk {
                         args: toolCallChunk.args,
                         id: toolCallChunk.id,
                         error: "Malformed args.",
+                        type: "invalid_tool_call",
                     });
                 }
             }

package/dist/messages/base.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isBaseMessageChunk = exports.isBaseMessage = exports.BaseMessageChunk = exports._mergeLists = exports._mergeDicts = exports.isOpenAIToolCallArray = exports.BaseMessage = exports.mergeContent = void 0;
+exports.isBaseMessageChunk = exports.isBaseMessage = exports.BaseMessageChunk = exports._mergeObj = exports._mergeLists = exports._mergeDicts = exports.isOpenAIToolCallArray = exports.BaseMessage = exports.mergeContent = void 0;
 const serializable_js_1 = require("../load/serializable.cjs");
 function mergeContent(firstContent, secondContent) {
     // If first content is a string
@@ -14,8 +14,10 @@ function mergeContent(firstContent, secondContent) {
         // If both are arrays
     }
     else if (Array.isArray(secondContent)) {
-        return [...firstContent, ...secondContent];
-        // If the first content is a list and second is a string
+        return (_mergeLists(firstContent, secondContent) ?? [
+            ...firstContent,
+            ...secondContent,
+        ]);
     }
     else {
         // Otherwise, add the second content as a new element of the list
@@ -154,9 +156,13 @@ right
             throw new Error(`field[${key}] already exists in the message chunk, but with a different type.`);
         }
         else if (typeof merged[key] === "string") {
-            merged[key] = merged[key] + value;
+            if (key === "type") {
+                // Do not merge 'type' fields
+                continue;
+            }
+            merged[key] += value;
         }
-        else if (!Array.isArray(merged[key]) && typeof merged[key] === "object") {
+        else if (typeof merged[key] === "object" && !Array.isArray(merged[key])) {
             merged[key] = _mergeDicts(merged[key], value);
         }
         else if (Array.isArray(merged[key])) {
@@ -194,6 +200,12 @@ function _mergeLists(left, right) {
                     merged.push(item);
                 }
             }
+            else if (typeof item === "object" &&
+                "text" in item &&
+                item.text === "") {
+                // No-op - skip empty text blocks
+                continue;
+            }
             else {
                 merged.push(item);
             }
@@ -202,6 +214,34 @@ function _mergeLists(left, right) {
     }
 }
 exports._mergeLists = _mergeLists;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function _mergeObj(left, right) {
+    if (!left && !right) {
+        throw new Error("Cannot merge two undefined objects.");
+    }
+    if (!left || !right) {
+        return left || right;
+    }
+    else if (typeof left !== typeof right) {
+        throw new Error(`Cannot merge objects of different types.\nLeft ${typeof left}\nRight ${typeof right}`);
+    }
+    else if (typeof left === "string" && typeof right === "string") {
+        return (left + right);
+    }
+    else if (Array.isArray(left) && Array.isArray(right)) {
+        return _mergeLists(left, right);
+    }
+    else if (typeof left === "object" && typeof right === "object") {
+        return _mergeDicts(left, right);
+    }
+    else if (left === right) {
+        return left;
+    }
+    else {
+        throw new Error(`Can not merge objects of different types.\nLeft ${left}\nRight ${right}`);
+    }
+}
+exports._mergeObj = _mergeObj;
 /**
  * Represents a chunk of a message, which can be concatenated with other
  * message chunks. It includes a method `_merge_kwargs_dict()` for merging

package/dist/messages/base.d.ts

@@ -130,6 +130,7 @@ export type OpenAIToolCall = ToolCall & {
 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 _mergeObj<T = any>(left: T | undefined, right: T | undefined): T;
 /**
  * Represents a chunk of a message, which can be concatenated with other
  * message chunks. It includes a method `_merge_kwargs_dict()` for merging

package/dist/messages/base.js

@@ -11,8 +11,10 @@ export function mergeContent(firstContent, secondContent) {
         // If both are arrays
     }
     else if (Array.isArray(secondContent)) {
-        return [...firstContent, ...secondContent];
-        // If the first content is a list and second is a string
+        return (_mergeLists(firstContent, secondContent) ?? [
+            ...firstContent,
+            ...secondContent,
+        ]);
     }
     else {
         // Otherwise, add the second content as a new element of the list
@@ -148,9 +150,13 @@ right
             throw new Error(`field[${key}] already exists in the message chunk, but with a different type.`);
         }
         else if (typeof merged[key] === "string") {
-            merged[key] = merged[key] + value;
+            if (key === "type") {
+                // Do not merge 'type' fields
+                continue;
+            }
+            merged[key] += value;
         }
-        else if (!Array.isArray(merged[key]) && typeof merged[key] === "object") {
+        else if (typeof merged[key] === "object" && !Array.isArray(merged[key])) {
             merged[key] = _mergeDicts(merged[key], value);
         }
         else if (Array.isArray(merged[key])) {
@@ -187,6 +193,12 @@ export function _mergeLists(left, right) {
                     merged.push(item);
                 }
             }
+            else if (typeof item === "object" &&
+                "text" in item &&
+                item.text === "") {
+                // No-op - skip empty text blocks
+                continue;
+            }
             else {
                 merged.push(item);
             }
@@ -194,6 +206,33 @@ export function _mergeLists(left, right) {
         return merged;
     }
 }
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function _mergeObj(left, right) {
+    if (!left && !right) {
+        throw new Error("Cannot merge two undefined objects.");
+    }
+    if (!left || !right) {
+        return left || right;
+    }
+    else if (typeof left !== typeof right) {
+        throw new Error(`Cannot merge objects of different types.\nLeft ${typeof left}\nRight ${typeof right}`);
+    }
+    else if (typeof left === "string" && typeof right === "string") {
+        return (left + right);
+    }
+    else if (Array.isArray(left) && Array.isArray(right)) {
+        return _mergeLists(left, right);
+    }
+    else if (typeof left === "object" && typeof right === "object") {
+        return _mergeDicts(left, right);
+    }
+    else if (left === right) {
+        return left;
+    }
+    else {
+        throw new Error(`Can not merge objects of different types.\nLeft ${left}\nRight ${right}`);
+    }
+}
 /**
  * Represents a chunk of a message, which can be concatenated with other
  * message chunks. It includes a method `_merge_kwargs_dict()` for merging

package/dist/messages/index.d.ts

@@ -6,4 +6,4 @@ export * from "./human.js";
 export * from "./system.js";
 export * from "./utils.js";
 export * from "./transformers.js";
-export { type ToolMessageFieldsWithToolCallId, ToolMessage, ToolMessageChunk, } from "./tool.js";
+export { type ToolMessageFieldsWithToolCallId, ToolMessage, ToolMessageChunk, type InvalidToolCall, } from "./tool.js";

package/dist/messages/tests/base_message.test.js

@@ -1,6 +1,6 @@
-import { test } from "@jest/globals";
+import { test, describe, it, expect } from "@jest/globals";
 import { ChatPromptTemplate } from "../../prompts/chat.js";
-import { HumanMessage, AIMessage, ToolMessage } from "../index.js";
+import { HumanMessage, AIMessage, ToolMessage, ToolMessageChunk, AIMessageChunk, } from "../index.js";
 import { load } from "../../load/index.js";
 test("Test ChatPromptTemplate can format OpenAI content image messages", async () => {
     const message = new HumanMessage({
@@ -111,3 +111,135 @@ test("Deserialisation and serialisation of messages with ID", async () => {
     expect(deserialized).toEqual(message);
     expect(deserialized.id).toBe(messageId);
 });
+test("Can concat artifact (string) of ToolMessageChunk", () => {
+    const rawOutputOne = "Hello";
+    const rawOutputTwo = " world";
+    const chunk1 = new ToolMessageChunk({
+        content: "Hello",
+        tool_call_id: "1",
+        artifact: rawOutputOne,
+    });
+    const chunk2 = new ToolMessageChunk({
+        content: " world",
+        tool_call_id: "1",
+        artifact: rawOutputTwo,
+    });
+    const concated = chunk1.concat(chunk2);
+    expect(concated.artifact).toBe(`${rawOutputOne}${rawOutputTwo}`);
+});
+test("Can concat artifact (array) of ToolMessageChunk", () => {
+    const rawOutputOne = ["Hello", " world"];
+    const rawOutputTwo = ["!!"];
+    const chunk1 = new ToolMessageChunk({
+        content: "Hello",
+        tool_call_id: "1",
+        artifact: rawOutputOne,
+    });
+    const chunk2 = new ToolMessageChunk({
+        content: " world",
+        tool_call_id: "1",
+        artifact: rawOutputTwo,
+    });
+    const concated = chunk1.concat(chunk2);
+    expect(concated.artifact).toEqual(["Hello", " world", "!!"]);
+});
+test("Can concat artifact (object) of ToolMessageChunk", () => {
+    const rawOutputOne = {
+        foo: "bar",
+    };
+    const rawOutputTwo = {
+        bar: "baz",
+    };
+    const chunk1 = new ToolMessageChunk({
+        content: "Hello",
+        tool_call_id: "1",
+        artifact: rawOutputOne,
+    });
+    const chunk2 = new ToolMessageChunk({
+        content: " world",
+        tool_call_id: "1",
+        artifact: rawOutputTwo,
+    });
+    const concated = chunk1.concat(chunk2);
+    expect(concated.artifact).toEqual({
+        foo: "bar",
+        bar: "baz",
+    });
+});
+describe("Complex AIMessageChunk concat", () => {
+    it("concatenates content arrays of strings", () => {
+        expect(new AIMessageChunk({
+            content: [{ type: "text", text: "I am" }],
+            id: "ai4",
+        }).concat(new AIMessageChunk({ content: [{ type: "text", text: " indeed." }] }))).toEqual(new AIMessageChunk({
+            id: "ai4",
+            content: [
+                { type: "text", text: "I am" },
+                { type: "text", text: " indeed." },
+            ],
+        }));
+    });
+    it("concatenates mixed content arrays", () => {
+        expect(new AIMessageChunk({
+            content: [{ index: 0, type: "text", text: "I am" }],
+        }).concat(new AIMessageChunk({ content: [{ type: "text", text: " indeed." }] }))).toEqual(new AIMessageChunk({
+            content: [
+                { index: 0, type: "text", text: "I am" },
+                { type: "text", text: " indeed." },
+            ],
+        }));
+    });
+    it("merges content arrays with same index", () => {
+        expect(new AIMessageChunk({ content: [{ index: 0, text: "I am" }] }).concat(new AIMessageChunk({ content: [{ index: 0, text: " indeed." }] }))).toEqual(new AIMessageChunk({ content: [{ index: 0, text: "I am indeed." }] }));
+    });
+    it("does not merge when one chunk is missing an index", () => {
+        expect(new AIMessageChunk({ content: [{ index: 0, text: "I am" }] }).concat(new AIMessageChunk({ content: [{ text: " indeed." }] }))).toEqual(new AIMessageChunk({
+            content: [{ index: 0, text: "I am" }, { text: " indeed." }],
+        }));
+    });
+    it("does not create a holey array when there's a gap between indexes", () => {
+        expect(new AIMessageChunk({ content: [{ index: 0, text: "I am" }] }).concat(new AIMessageChunk({ content: [{ index: 2, text: " indeed." }] }))).toEqual(new AIMessageChunk({
+            content: [
+                { index: 0, text: "I am" },
+                { index: 2, text: " indeed." },
+            ],
+        }));
+    });
+    it("does not merge content arrays with separate indexes", () => {
+        expect(new AIMessageChunk({ content: [{ index: 0, text: "I am" }] }).concat(new AIMessageChunk({ content: [{ index: 1, text: " indeed." }] }))).toEqual(new AIMessageChunk({
+            content: [
+                { index: 0, text: "I am" },
+                { index: 1, text: " indeed." },
+            ],
+        }));
+    });
+    it("merges content arrays with same index and type", () => {
+        expect(new AIMessageChunk({
+            content: [{ index: 0, text: "I am", type: "text_block" }],
+        }).concat(new AIMessageChunk({
+            content: [{ index: 0, text: " indeed.", type: "text_block" }],
+        }))).toEqual(new AIMessageChunk({
+            content: [{ index: 0, text: "I am indeed.", type: "text_block" }],
+        }));
+    });
+    it("merges content arrays with same index and different types without updating type", () => {
+        expect(new AIMessageChunk({
+            content: [{ index: 0, text: "I am", type: "text_block" }],
+        }).concat(new AIMessageChunk({
+            content: [{ index: 0, text: " indeed.", type: "text_block_delta" }],
+        }))).toEqual(new AIMessageChunk({
+            content: [{ index: 0, text: "I am indeed.", type: "text_block" }],
+        }));
+    });
+    it("concatenates empty string content and merges other fields", () => {
+        expect(new AIMessageChunk({
+            content: [{ index: 0, type: "text", text: "I am" }],
+        }).concat(new AIMessageChunk({
+            content: [{ type: "text", text: "" }],
+            response_metadata: { extra: "value" },
+        }))).toEqual(new AIMessageChunk({
+            content: [{ index: 0, type: "text", text: "I am" }],
+            response_metadata: { extra: "value" },
+        }));
+    });
+});