@langchain/core 0.3.6 → 0.3.7

package/dist/messages/base.cjs

@@ -84,6 +84,10 @@ class BaseMessage extends serializable_js_1.Serializable {
     get text() {
         return typeof this.content === "string" ? this.content : "";
     }
+    /** The type of the message. */
+    getType() {
+        return this._getType();
+    }
     constructor(fields, 
     /** @deprecated */
     kwargs) {

package/dist/messages/base.d.ts

@@ -1,4 +1,4 @@
-import { Serializable } from "../load/serializable.js";
+import { Serializable, SerializedConstructor } from "../load/serializable.js";
 import { StringWithAutocomplete } from "../utils/types/index.js";
 export interface StoredMessageData {
     content: string;
@@ -114,8 +114,20 @@ export declare abstract class BaseMessage extends Serializable implements BaseMe
      * provided by the provider/model which created the message.
      */
     id?: string;
-    /** The type of the message. */
+    /**
+     * @deprecated Use .getType() instead or import the proper typeguard.
+     * For example:
+     *
+     * ```ts
+     * import { isAIMessage } from "@langchain/core/messages";
+     *
+     * const message = new AIMessage("Hello!");
+     * isAIMessage(message); // true
+     * ```
+     */
     abstract _getType(): MessageType;
+    /** The type of the message. */
+    getType(): MessageType;
     constructor(fields: string | BaseMessageFields, 
     /** @deprecated */
     kwargs?: Record<string, unknown>);
@@ -172,6 +184,6 @@ export type BaseMessageLike = BaseMessage | MessageFieldWithRole | [
  */
  | ({
     type: MessageType | "user" | "assistant" | "placeholder";
-} & BaseMessageFields & Record<string, unknown>);
+} & BaseMessageFields & Record<string, unknown>) | SerializedConstructor;
 export declare function isBaseMessage(messageLike?: unknown): messageLike is BaseMessage;
 export declare function isBaseMessageChunk(messageLike?: unknown): messageLike is BaseMessageChunk;

package/dist/messages/base.js

@@ -79,6 +79,10 @@ export class BaseMessage extends Serializable {
     get text() {
         return typeof this.content === "string" ? this.content : "";
     }
+    /** The type of the message. */
+    getType() {
+        return this._getType();
+    }
     constructor(fields, 
     /** @deprecated */
     kwargs) {

package/dist/messages/chat.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ChatMessageChunk = exports.ChatMessage = void 0;
+exports.isChatMessageChunk = exports.isChatMessage = exports.ChatMessageChunk = exports.ChatMessage = void 0;
 const base_js_1 = require("./base.cjs");
 /**
  * Represents a chat message in a conversation.
@@ -82,3 +82,11 @@ class ChatMessageChunk extends base_js_1.BaseMessageChunk {
     }
 }
 exports.ChatMessageChunk = ChatMessageChunk;
+function isChatMessage(x) {
+    return x._getType() === "generic";
+}
+exports.isChatMessage = isChatMessage;
+function isChatMessageChunk(x) {
+    return x._getType() === "generic";
+}
+exports.isChatMessageChunk = isChatMessageChunk;

package/dist/messages/chat.d.ts

@@ -28,3 +28,5 @@ export declare class ChatMessageChunk extends BaseMessageChunk {
     concat(chunk: ChatMessageChunk): ChatMessageChunk;
     get _printableFields(): Record<string, unknown>;
 }
+export declare function isChatMessage(x: BaseMessage): x is ChatMessage;
+export declare function isChatMessageChunk(x: BaseMessageChunk): x is ChatMessageChunk;

package/dist/messages/chat.js

@@ -77,3 +77,9 @@ export class ChatMessageChunk extends BaseMessageChunk {
         };
     }
 }
+export function isChatMessage(x) {
+    return x._getType() === "generic";
+}
+export function isChatMessageChunk(x) {
+    return x._getType() === "generic";
+}

package/dist/messages/function.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FunctionMessageChunk = exports.FunctionMessage = void 0;
+exports.isFunctionMessageChunk = exports.isFunctionMessage = exports.FunctionMessageChunk = exports.FunctionMessage = void 0;
 const base_js_1 = require("./base.cjs");
 /**
  * Represents a function message in a conversation.
@@ -45,3 +45,11 @@ class FunctionMessageChunk extends base_js_1.BaseMessageChunk {
     }
 }
 exports.FunctionMessageChunk = FunctionMessageChunk;
+function isFunctionMessage(x) {
+    return x._getType() === "function";
+}
+exports.isFunctionMessage = isFunctionMessage;
+function isFunctionMessageChunk(x) {
+    return x._getType() === "function";
+}
+exports.isFunctionMessageChunk = isFunctionMessageChunk;

package/dist/messages/function.d.ts

@@ -22,3 +22,5 @@ export declare class FunctionMessageChunk extends BaseMessageChunk {
     _getType(): MessageType;
     concat(chunk: FunctionMessageChunk): FunctionMessageChunk;
 }
+export declare function isFunctionMessage(x: BaseMessage): x is FunctionMessage;
+export declare function isFunctionMessageChunk(x: BaseMessageChunk): x is FunctionMessageChunk;

package/dist/messages/function.js

@@ -40,3 +40,9 @@ export class FunctionMessageChunk extends BaseMessageChunk {
         });
     }
 }
+export function isFunctionMessage(x) {
+    return x._getType() === "function";
+}
+export function isFunctionMessageChunk(x) {
+    return x._getType() === "function";
+}

package/dist/messages/human.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HumanMessageChunk = exports.HumanMessage = void 0;
+exports.isHumanMessageChunk = exports.isHumanMessage = exports.HumanMessageChunk = exports.HumanMessage = void 0;
 const base_js_1 = require("./base.cjs");
 /**
  * Represents a human message in a conversation.
@@ -35,3 +35,11 @@ class HumanMessageChunk extends base_js_1.BaseMessageChunk {
     }
 }
 exports.HumanMessageChunk = HumanMessageChunk;
+function isHumanMessage(x) {
+    return x.getType() === "human";
+}
+exports.isHumanMessage = isHumanMessage;
+function isHumanMessageChunk(x) {
+    return x.getType() === "human";
+}
+exports.isHumanMessageChunk = isHumanMessageChunk;

package/dist/messages/human.d.ts

@@ -15,3 +15,5 @@ export declare class HumanMessageChunk extends BaseMessageChunk {
     _getType(): MessageType;
     concat(chunk: HumanMessageChunk): HumanMessageChunk;
 }
+export declare function isHumanMessage(x: BaseMessage): x is HumanMessage;
+export declare function isHumanMessageChunk(x: BaseMessageChunk): x is HumanMessageChunk;

package/dist/messages/human.js

@@ -30,3 +30,9 @@ export class HumanMessageChunk extends BaseMessageChunk {
         });
     }
 }
+export function isHumanMessage(x) {
+    return x.getType() === "human";
+}
+export function isHumanMessageChunk(x) {
+    return x.getType() === "human";
+}

package/dist/messages/index.cjs

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ToolMessageChunk = exports.ToolMessage = void 0;
+exports.isToolMessageChunk = exports.isToolMessage = exports.ToolMessageChunk = exports.ToolMessage = void 0;
 __exportStar(require("./ai.cjs"), exports);
 __exportStar(require("./base.cjs"), exports);
 __exportStar(require("./chat.cjs"), exports);
@@ -29,3 +29,5 @@ __exportStar(require("./modifier.cjs"), exports);
 var tool_js_1 = require("./tool.cjs");
 Object.defineProperty(exports, "ToolMessage", { enumerable: true, get: function () { return tool_js_1.ToolMessage; } });
 Object.defineProperty(exports, "ToolMessageChunk", { enumerable: true, get: function () { return tool_js_1.ToolMessageChunk; } });
+Object.defineProperty(exports, "isToolMessage", { enumerable: true, get: function () { return tool_js_1.isToolMessage; } });
+Object.defineProperty(exports, "isToolMessageChunk", { enumerable: true, get: function () { return tool_js_1.isToolMessageChunk; } });

package/dist/messages/index.d.ts

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

package/dist/messages/index.js

@@ -9,4 +9,4 @@ export * from "./transformers.js";
 export * from "./modifier.js";
 // TODO: Use a star export when we deprecate the
 // existing "ToolCall" type in "base.js".
-export { ToolMessage, ToolMessageChunk, } from "./tool.js";
+export { ToolMessage, ToolMessageChunk, isToolMessage, isToolMessageChunk, } from "./tool.js";

package/dist/messages/system.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SystemMessageChunk = exports.SystemMessage = void 0;
+exports.isSystemMessageChunk = exports.isSystemMessage = exports.SystemMessageChunk = exports.SystemMessage = void 0;
 const base_js_1 = require("./base.cjs");
 /**
  * Represents a system message in a conversation.
@@ -35,3 +35,11 @@ class SystemMessageChunk extends base_js_1.BaseMessageChunk {
     }
 }
 exports.SystemMessageChunk = SystemMessageChunk;
+function isSystemMessage(x) {
+    return x._getType() === "system";
+}
+exports.isSystemMessage = isSystemMessage;
+function isSystemMessageChunk(x) {
+    return x._getType() === "system";
+}
+exports.isSystemMessageChunk = isSystemMessageChunk;

package/dist/messages/system.d.ts

@@ -15,3 +15,5 @@ export declare class SystemMessageChunk extends BaseMessageChunk {
     _getType(): MessageType;
     concat(chunk: SystemMessageChunk): SystemMessageChunk;
 }
+export declare function isSystemMessage(x: BaseMessage): x is SystemMessage;
+export declare function isSystemMessageChunk(x: BaseMessageChunk): x is SystemMessageChunk;

package/dist/messages/system.js

@@ -30,3 +30,9 @@ export class SystemMessageChunk extends BaseMessageChunk {
         });
     }
 }
+export function isSystemMessage(x) {
+    return x._getType() === "system";
+}
+export function isSystemMessageChunk(x) {
+    return x._getType() === "system";
+}

package/dist/messages/tool.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultToolCallParser = exports.ToolMessageChunk = exports.ToolMessage = void 0;
+exports.isToolMessageChunk = exports.isToolMessage = exports.defaultToolCallParser = exports.ToolMessageChunk = exports.ToolMessage = void 0;
 const base_js_1 = require("./base.cjs");
 /**
  * Represents a tool message in a conversation.
@@ -168,3 +168,11 @@ rawToolCalls) {
     return [toolCalls, invalidToolCalls];
 }
 exports.defaultToolCallParser = defaultToolCallParser;
+function isToolMessage(x) {
+    return x._getType() === "tool";
+}
+exports.isToolMessage = isToolMessage;
+function isToolMessageChunk(x) {
+    return x._getType() === "tool";
+}
+exports.isToolMessageChunk = isToolMessageChunk;

package/dist/messages/tool.d.ts

@@ -143,3 +143,5 @@ export type InvalidToolCall = {
     type?: "invalid_tool_call";
 };
 export declare function defaultToolCallParser(rawToolCalls: Record<string, any>[]): [ToolCall[], InvalidToolCall[]];
+export declare function isToolMessage(x: BaseMessage): x is ToolMessage;
+export declare function isToolMessageChunk(x: BaseMessageChunk): x is ToolMessageChunk;

package/dist/messages/tool.js

@@ -162,3 +162,9 @@ rawToolCalls) {
     }
     return [toolCalls, invalidToolCalls];
 }
+export function isToolMessage(x) {
+    return x._getType() === "tool";
+}
+export function isToolMessageChunk(x) {
+    return x._getType() === "tool";
+}

package/dist/messages/utils.cjs

@@ -34,8 +34,40 @@ function _coerceToolCall(toolCall) {
         return toolCall;
     }
 }
+function isSerializedConstructor(x) {
+    return (typeof x === "object" &&
+        x != null &&
+        x.lc === 1 &&
+        Array.isArray(x.id) &&
+        x.kwargs != null &&
+        typeof x.kwargs === "object");
+}
 function _constructMessageFromParams(params) {
-    const { type, ...rest } = params;
+    let type;
+    let rest;
+    // Support serialized messages
+    if (isSerializedConstructor(params)) {
+        const className = params.id.at(-1);
+        if (className === "HumanMessage" || className === "HumanMessageChunk") {
+            type = "user";
+        }
+        else if (className === "AIMessage" || className === "AIMessageChunk") {
+            type = "assistant";
+        }
+        else if (className === "SystemMessage" ||
+            className === "SystemMessageChunk") {
+            type = "system";
+        }
+        else {
+            type = "unknown";
+        }
+        rest = params.kwargs;
+    }
+    else {
+        const { type: extractedType, ...otherParams } = params;
+        type = extractedType;
+        rest = otherParams;
+    }
     if (type === "human" || type === "user") {
         return new human_js_1.HumanMessage(rest);
     }
@@ -59,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.`);
+        throw new Error(`Unable to coerce message from array: only human, AI, or system message coercion is currently supported.\n\nReceived:${params}`);
     }
 }
 function coerceMessageLikeToMessage(messageLike) {

package/dist/messages/utils.js

@@ -31,8 +31,40 @@ function _coerceToolCall(toolCall) {
         return toolCall;
     }
 }
+function isSerializedConstructor(x) {
+    return (typeof x === "object" &&
+        x != null &&
+        x.lc === 1 &&
+        Array.isArray(x.id) &&
+        x.kwargs != null &&
+        typeof x.kwargs === "object");
+}
 function _constructMessageFromParams(params) {
-    const { type, ...rest } = params;
+    let type;
+    let rest;
+    // Support serialized messages
+    if (isSerializedConstructor(params)) {
+        const className = params.id.at(-1);
+        if (className === "HumanMessage" || className === "HumanMessageChunk") {
+            type = "user";
+        }
+        else if (className === "AIMessage" || className === "AIMessageChunk") {
+            type = "assistant";
+        }
+        else if (className === "SystemMessage" ||
+            className === "SystemMessageChunk") {
+            type = "system";
+        }
+        else {
+            type = "unknown";
+        }
+        rest = params.kwargs;
+    }
+    else {
+        const { type: extractedType, ...otherParams } = params;
+        type = extractedType;
+        rest = otherParams;
+    }
     if (type === "human" || type === "user") {
         return new HumanMessage(rest);
     }
@@ -56,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.`);
+        throw new Error(`Unable to coerce message from array: only human, AI, or system message coercion is currently supported.\n\nReceived:${params}`);
     }
 }
 export function coerceMessageLikeToMessage(messageLike) {

package/package.json

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