@langchain/core 0.2.11 → 0.2.12

package/README.md

@@ -85,7 +85,7 @@ Rather than having to write multiple implementations for all of those, LCEL allo
 
 For more check out the [LCEL docs](https://js.langchain.com/v0.2/docs/concepts#langchain-expression-language).
 
-![LangChain Stack](../docs/core_docs/static/img/langchain_stack_feb_2024.webp)
+![LangChain Stack](../docs/core_docs/static/svg/langchain_stack_062024.svg)
 
 ## 📕 Releases & Versioning
 

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

@@ -3,6 +3,23 @@ import { test } from "@jest/globals";
 import { z } from "zod";
 import { zodToJsonSchema } from "zod-to-json-schema";
 import { FakeChatModel, FakeListChatModel } from "../../utils/testing/index.js";
+test("Test ChatModel accepts array shorthand for messages", async () => {
+    const model = new FakeChatModel({});
+    const response = await model.invoke([["human", "Hello there!"]]);
+    expect(response.content).toEqual("Hello there!");
+});
+test("Test ChatModel accepts object shorthand for messages", async () => {
+    const model = new FakeChatModel({});
+    const response = await model.invoke([
+        {
+            type: "human",
+            content: "Hello there!",
+            additional_kwargs: {},
+            example: true,
+        },
+    ]);
+    expect(response.content).toEqual("Hello there!");
+});
 test("Test ChatModel uses callbacks", async () => {
     const model = new FakeChatModel({});
     let acc = "";

package/dist/messages/base.d.ts

@@ -140,7 +140,9 @@ export declare function _mergeLists(left?: any[], right?: any[]): any[] | undefi
 export declare abstract class BaseMessageChunk extends BaseMessage {
     abstract concat(chunk: BaseMessageChunk): BaseMessageChunk;
 }
-export type BaseMessageLike = BaseMessage | [
+export type BaseMessageLike = BaseMessage | ({
+    type: MessageType | "user" | "assistant" | "placeholder";
+} & BaseMessageFields & Record<string, unknown>) | [
     StringWithAutocomplete<MessageType | "user" | "assistant" | "placeholder">,
     MessageContent
 ] | string;

package/dist/messages/utils.cjs

@@ -8,6 +8,21 @@ const function_js_1 = require("./function.cjs");
 const human_js_1 = require("./human.cjs");
 const system_js_1 = require("./system.cjs");
 const tool_js_1 = require("./tool.cjs");
+function _constructMessageFromParams(params) {
+    const { type, ...rest } = params;
+    if (type === "human" || type === "user") {
+        return new human_js_1.HumanMessage(rest);
+    }
+    else if (type === "ai" || type === "assistant") {
+        return new ai_js_1.AIMessage(rest);
+    }
+    else if (type === "system") {
+        return new system_js_1.SystemMessage(rest);
+    }
+    else {
+        throw new Error(`Unable to coerce message from array: only human, AI, or system message coercion is currently supported.`);
+    }
+}
 function coerceMessageLikeToMessage(messageLike) {
     if (typeof messageLike === "string") {
         return new human_js_1.HumanMessage(messageLike);
@@ -15,18 +30,12 @@ function coerceMessageLikeToMessage(messageLike) {
     else if ((0, base_js_1.isBaseMessage)(messageLike)) {
         return messageLike;
     }
-    const [type, content] = messageLike;
-    if (type === "human" || type === "user") {
-        return new human_js_1.HumanMessage({ content });
-    }
-    else if (type === "ai" || type === "assistant") {
-        return new ai_js_1.AIMessage({ content });
-    }
-    else if (type === "system") {
-        return new system_js_1.SystemMessage({ content });
+    if (Array.isArray(messageLike)) {
+        const [type, content] = messageLike;
+        return _constructMessageFromParams({ type, content });
     }
     else {
-        throw new Error(`Unable to coerce message from array: only human, AI, or system message coercion is currently supported.`);
+        return _constructMessageFromParams(messageLike);
     }
 }
 exports.coerceMessageLikeToMessage = coerceMessageLikeToMessage;

package/dist/messages/utils.js

@@ -5,6 +5,21 @@ import { FunctionMessage, FunctionMessageChunk, } from "./function.js";
 import { HumanMessage, HumanMessageChunk } from "./human.js";
 import { SystemMessage, SystemMessageChunk } from "./system.js";
 import { ToolMessage } from "./tool.js";
+function _constructMessageFromParams(params) {
+    const { type, ...rest } = params;
+    if (type === "human" || type === "user") {
+        return new HumanMessage(rest);
+    }
+    else if (type === "ai" || type === "assistant") {
+        return new AIMessage(rest);
+    }
+    else if (type === "system") {
+        return new SystemMessage(rest);
+    }
+    else {
+        throw new Error(`Unable to coerce message from array: only human, AI, or system message coercion is currently supported.`);
+    }
+}
 export function coerceMessageLikeToMessage(messageLike) {
     if (typeof messageLike === "string") {
         return new HumanMessage(messageLike);
@@ -12,18 +27,12 @@ export function coerceMessageLikeToMessage(messageLike) {
     else if (isBaseMessage(messageLike)) {
         return messageLike;
     }
-    const [type, content] = messageLike;
-    if (type === "human" || type === "user") {
-        return new HumanMessage({ content });
-    }
-    else if (type === "ai" || type === "assistant") {
-        return new AIMessage({ content });
-    }
-    else if (type === "system") {
-        return new SystemMessage({ content });
+    if (Array.isArray(messageLike)) {
+        const [type, content] = messageLike;
+        return _constructMessageFromParams({ type, content });
     }
     else {
-        throw new Error(`Unable to coerce message from array: only human, AI, or system message coercion is currently supported.`);
+        return _constructMessageFromParams(messageLike);
     }
 }
 /**

package/dist/prompts/chat.cjs

@@ -75,33 +75,37 @@ class MessagesPlaceholder extends BaseMessagePromptTemplate {
     get inputVariables() {
         return [this.variableName];
     }
-    validateInputOrThrow(input, variableName) {
+    async formatMessages(values) {
+        const input = values[this.variableName];
         if (this.optional && !input) {
-            return false;
+            return [];
         }
         else if (!input) {
-            const error = new Error(`Error: Field "${variableName}" in prompt uses a MessagesPlaceholder, which expects an array of BaseMessages as an input value. Received: undefined`);
+            const error = new Error(`Field "${this.variableName}" in prompt uses a MessagesPlaceholder, which expects an array of BaseMessages as an input value. Received: undefined`);
             error.name = "InputFormatError";
             throw error;
         }
-        let isInputBaseMessage = false;
-        if (Array.isArray(input)) {
-            isInputBaseMessage = input.every((message) => (0, index_js_1.isBaseMessage)(message));
-        }
-        else {
-            isInputBaseMessage = (0, index_js_1.isBaseMessage)(input);
+        let formattedMessages;
+        try {
+            if (Array.isArray(input)) {
+                formattedMessages = input.map(index_js_1.coerceMessageLikeToMessage);
+            }
+            else {
+                formattedMessages = [(0, index_js_1.coerceMessageLikeToMessage)(input)];
+            }
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
         }
-        if (!isInputBaseMessage) {
+        catch (e) {
             const readableInput = typeof input === "string" ? input : JSON.stringify(input, null, 2);
-            const error = new Error(`Error: Field "${variableName}" in prompt uses a MessagesPlaceholder, which expects an array of BaseMessages as an input value. Received: ${readableInput}`);
+            const error = new Error([
+                `Field "${this.variableName}" in prompt uses a MessagesPlaceholder, which expects an array of BaseMessages or coerceable values as input.`,
+                `Received value: ${readableInput}`,
+                `Additional message: ${e.message}`,
+            ].join("\n\n"));
             error.name = "InputFormatError";
             throw error;
         }
-        return true;
-    }
-    async formatMessages(values) {
-        this.validateInputOrThrow(values[this.variableName], this.variableName);
-        return values[this.variableName] ?? [];
+        return formattedMessages;
     }
 }
 exports.MessagesPlaceholder = MessagesPlaceholder;

package/dist/prompts/chat.d.ts

@@ -50,7 +50,6 @@ export declare class MessagesPlaceholder<RunInput extends InputValues = any> ext
     constructor(variableName: Extract<keyof RunInput, string>);
     constructor(fields: MessagesPlaceholderFields<Extract<keyof RunInput, string>>);
     get inputVariables(): Extract<keyof RunInput, string>[];
-    validateInputOrThrow(input: Array<unknown> | undefined, variableName: Extract<keyof RunInput, string>): input is BaseMessage[];
     formatMessages(values: TypedPromptInputValues<RunInput>): Promise<BaseMessage[]>;
 }
 /**

package/dist/prompts/chat.js

@@ -71,33 +71,37 @@ export class MessagesPlaceholder extends BaseMessagePromptTemplate {
     get inputVariables() {
         return [this.variableName];
     }
-    validateInputOrThrow(input, variableName) {
+    async formatMessages(values) {
+        const input = values[this.variableName];
         if (this.optional && !input) {
-            return false;
+            return [];
         }
         else if (!input) {
-            const error = new Error(`Error: Field "${variableName}" in prompt uses a MessagesPlaceholder, which expects an array of BaseMessages as an input value. Received: undefined`);
+            const error = new Error(`Field "${this.variableName}" in prompt uses a MessagesPlaceholder, which expects an array of BaseMessages as an input value. Received: undefined`);
             error.name = "InputFormatError";
             throw error;
         }
-        let isInputBaseMessage = false;
-        if (Array.isArray(input)) {
-            isInputBaseMessage = input.every((message) => isBaseMessage(message));
-        }
-        else {
-            isInputBaseMessage = isBaseMessage(input);
+        let formattedMessages;
+        try {
+            if (Array.isArray(input)) {
+                formattedMessages = input.map(coerceMessageLikeToMessage);
+            }
+            else {
+                formattedMessages = [coerceMessageLikeToMessage(input)];
+            }
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
         }
-        if (!isInputBaseMessage) {
+        catch (e) {
             const readableInput = typeof input === "string" ? input : JSON.stringify(input, null, 2);
-            const error = new Error(`Error: Field "${variableName}" in prompt uses a MessagesPlaceholder, which expects an array of BaseMessages as an input value. Received: ${readableInput}`);
+            const error = new Error([
+                `Field "${this.variableName}" in prompt uses a MessagesPlaceholder, which expects an array of BaseMessages or coerceable values as input.`,
+                `Received value: ${readableInput}`,
+                `Additional message: ${e.message}`,
+            ].join("\n\n"));
             error.name = "InputFormatError";
             throw error;
         }
-        return true;
-    }
-    async formatMessages(values) {
-        this.validateInputOrThrow(values[this.variableName], this.variableName);
-        return values[this.variableName] ?? [];
+        return formattedMessages;
     }
 }
 /**

package/dist/prompts/tests/chat.test.js

@@ -258,7 +258,7 @@ test("Test MessagesPlaceholder not optional", async () => {
         variableName: "foo",
     });
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    await expect(prompt.formatMessages({})).rejects.toThrow('Error: Field "foo" in prompt uses a MessagesPlaceholder, which expects an array of BaseMessages as an input value. Received: undefined');
+    await expect(prompt.formatMessages({})).rejects.toThrow('Field "foo" in prompt uses a MessagesPlaceholder, which expects an array of BaseMessages as an input value. Received: undefined');
 });
 test("Test MessagesPlaceholder shorthand in a chat prompt template should throw for invalid syntax", async () => {
     expect(() => ChatPromptTemplate.fromMessages([["placeholder", "foo"]])).toThrow();
@@ -273,6 +273,56 @@ test("Test MessagesPlaceholder shorthand in a chat prompt template", async () =>
         new AIMessage("how r u"),
     ]);
 });
+test("Test MessagesPlaceholder shorthand in a chat prompt template with object format", async () => {
+    const prompt = ChatPromptTemplate.fromMessages([["placeholder", "{foo}"]]);
+    const messages = await prompt.formatMessages({
+        foo: [
+            {
+                type: "system",
+                content: "some initial content",
+            },
+            {
+                type: "human",
+                content: [
+                    {
+                        text: "page: 1\ndescription: One Purchase Flow\ntimestamp: '2024-06-04T14:46:46.062Z'\ntype: navigate\nscreenshot_present: true\n",
+                        type: "text",
+                    },
+                    {
+                        text: "page: 3\ndescription: intent_str=buy,mode_str=redirect,screenName_str=order-completed,\ntimestamp: '2024-06-04T14:46:58.846Z'\ntype: Screen View\nscreenshot_present: false\n",
+                        type: "text",
+                    },
+                ],
+            },
+            {
+                type: "assistant",
+                content: "some captivating response",
+            },
+        ],
+    });
+    expect(messages).toEqual([
+        new SystemMessage("some initial content"),
+        new HumanMessage({
+            content: [
+                {
+                    text: "page: 1\ndescription: One Purchase Flow\ntimestamp: '2024-06-04T14:46:46.062Z'\ntype: navigate\nscreenshot_present: true\n",
+                    type: "text",
+                },
+                {
+                    text: "page: 3\ndescription: intent_str=buy,mode_str=redirect,screenName_str=order-completed,\ntimestamp: '2024-06-04T14:46:58.846Z'\ntype: Screen View\nscreenshot_present: false\n",
+                    type: "text",
+                },
+            ],
+        }),
+        new AIMessage("some captivating response"),
+    ]);
+});
+test("Test MessagesPlaceholder with invalid shorthand should throw", async () => {
+    const prompt = ChatPromptTemplate.fromMessages([["placeholder", "{foo}"]]);
+    await expect(() => prompt.formatMessages({
+        foo: [{ badFormatting: true }],
+    })).rejects.toThrow();
+});
 test("Test using partial", async () => {
     const userPrompt = new PromptTemplate({
         template: "{foo}{bar}",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/core",
-  "version": "0.2.11",
+  "version": "0.2.12",
   "description": "Core LangChain.js abstractions and schemas",
   "type": "module",
   "engines": {