@langchain/core 0.1.55-rc.0 → 0.1.56

package/dist/messages/index.js

@@ -1,611 +1,10 @@
-import { Serializable } from "../load/serializable.js";
-function mergeContent(firstContent, secondContent) {
-    // If first content is a string
-    if (typeof firstContent === "string") {
-        if (typeof secondContent === "string") {
-            return firstContent + secondContent;
-        }
-        else {
-            return [{ type: "text", text: 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
-    }
-    else {
-        // Otherwise, add the second content as a new element of the list
-        return [...firstContent, { type: "text", text: secondContent }];
-    }
-}
-/**
- * Base class for all types of messages in a conversation. It includes
- * properties like `content`, `name`, and `additional_kwargs`. It also
- * includes methods like `toDict()` and `_getType()`.
- */
-export class BaseMessage extends Serializable {
-    get lc_aliases() {
-        // exclude snake case conversion to pascal case
-        return {
-            additional_kwargs: "additional_kwargs",
-            response_metadata: "response_metadata",
-        };
-    }
-    /**
-     * @deprecated
-     * Use {@link BaseMessage.content} instead.
-     */
-    get text() {
-        return typeof this.content === "string" ? this.content : "";
-    }
-    constructor(fields, 
-    /** @deprecated */
-    kwargs) {
-        if (typeof fields === "string") {
-            // eslint-disable-next-line no-param-reassign
-            fields = {
-                content: fields,
-                additional_kwargs: kwargs,
-                response_metadata: {},
-            };
-        }
-        // Make sure the default value for additional_kwargs is passed into super() for serialization
-        if (!fields.additional_kwargs) {
-            // eslint-disable-next-line no-param-reassign
-            fields.additional_kwargs = {};
-        }
-        if (!fields.response_metadata) {
-            // eslint-disable-next-line no-param-reassign
-            fields.response_metadata = {};
-        }
-        super(fields);
-        Object.defineProperty(this, "lc_namespace", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: ["langchain_core", "messages"]
-        });
-        Object.defineProperty(this, "lc_serializable", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: true
-        });
-        /** The content of the message. */
-        Object.defineProperty(this, "content", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        /** The name of the message sender in a multi-user chat. */
-        Object.defineProperty(this, "name", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        /** Additional keyword arguments */
-        Object.defineProperty(this, "additional_kwargs", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        /** Response metadata. For example: response headers, logprobs, token counts. */
-        Object.defineProperty(this, "response_metadata", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.name = fields.name;
-        this.content = fields.content;
-        this.additional_kwargs = fields.additional_kwargs;
-        this.response_metadata = fields.response_metadata;
-    }
-    toDict() {
-        return {
-            type: this._getType(),
-            data: this.toJSON()
-                .kwargs,
-        };
-    }
-    toChunk() {
-        const type = this._getType();
-        if (type === "human") {
-            // eslint-disable-next-line @typescript-eslint/no-use-before-define
-            return new HumanMessageChunk({ ...this });
-        }
-        else if (type === "ai") {
-            // eslint-disable-next-line @typescript-eslint/no-use-before-define
-            return new AIMessageChunk({ ...this });
-        }
-        else if (type === "system") {
-            // eslint-disable-next-line @typescript-eslint/no-use-before-define
-            return new SystemMessageChunk({ ...this });
-        }
-        else if (type === "function") {
-            // eslint-disable-next-line @typescript-eslint/no-use-before-define
-            return new FunctionMessageChunk({ ...this });
-            // eslint-disable-next-line @typescript-eslint/no-use-before-define
-        }
-        else if (ChatMessage.isInstance(this)) {
-            // eslint-disable-next-line @typescript-eslint/no-use-before-define
-            return new ChatMessageChunk({ ...this });
-        }
-        else {
-            throw new Error("Unknown message type.");
-        }
-    }
-}
-function isOpenAIToolCallArray(value) {
-    return (Array.isArray(value) &&
-        value.every((v) => typeof v.index === "number"));
-}
-function _mergeDicts(
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-left, 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-right
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-) {
-    const merged = { ...left };
-    for (const [key, value] of Object.entries(right)) {
-        if (merged[key] == null) {
-            merged[key] = value;
-        }
-        else if (value == null) {
-            continue;
-        }
-        else if (typeof merged[key] !== typeof value ||
-            Array.isArray(merged[key]) !== Array.isArray(value)) {
-            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;
-        }
-        else if (!Array.isArray(merged[key]) && typeof merged[key] === "object") {
-            merged[key] = _mergeDicts(merged[key], value);
-        }
-        else if (key === "tool_calls" &&
-            isOpenAIToolCallArray(merged[key]) &&
-            isOpenAIToolCallArray(value)) {
-            for (const toolCall of value) {
-                if (merged[key]?.[toolCall.index] !== undefined) {
-                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                    merged[key] = merged[key]?.map((value, i) => {
-                        if (i !== toolCall.index) {
-                            return value;
-                        }
-                        return {
-                            ...value,
-                            ...toolCall,
-                            function: {
-                                name: toolCall.function.name ?? value.function.name,
-                                arguments: (value.function.arguments ?? "") +
-                                    (toolCall.function.arguments ?? ""),
-                            },
-                        };
-                    });
-                }
-                else {
-                    merged[key][toolCall.index] = toolCall;
-                }
-            }
-        }
-        else if (Array.isArray(merged[key])) {
-            merged[key] = merged[key].concat(value);
-        }
-        else if (merged[key] === value) {
-            continue;
-        }
-        else {
-            console.warn(`field[${key}] already exists in this message chunk and value has unsupported type.`);
-        }
-    }
-    return merged;
-}
-/**
- * Represents a chunk of a message, which can be concatenated with other
- * message chunks. It includes a method `_merge_kwargs_dict()` for merging
- * additional keyword arguments from another `BaseMessageChunk` into this
- * one. It also overrides the `__add__()` method to support concatenation
- * of `BaseMessageChunk` instances.
- */
-export class BaseMessageChunk extends BaseMessage {
-}
-/**
- * Represents a human message in a conversation.
- */
-export class HumanMessage extends BaseMessage {
-    static lc_name() {
-        return "HumanMessage";
-    }
-    _getType() {
-        return "human";
-    }
-}
-/**
- * Represents a chunk of a human message, which can be concatenated with
- * other human message chunks.
- */
-export class HumanMessageChunk extends BaseMessageChunk {
-    static lc_name() {
-        return "HumanMessageChunk";
-    }
-    _getType() {
-        return "human";
-    }
-    concat(chunk) {
-        return new HumanMessageChunk({
-            content: mergeContent(this.content, chunk.content),
-            additional_kwargs: _mergeDicts(this.additional_kwargs, chunk.additional_kwargs),
-            response_metadata: _mergeDicts(this.response_metadata, chunk.response_metadata),
-        });
-    }
-}
-/**
- * Represents an AI message in a conversation.
- */
-export class AIMessage extends BaseMessage {
-    static lc_name() {
-        return "AIMessage";
-    }
-    _getType() {
-        return "ai";
-    }
-}
-/**
- * Represents a chunk of an AI message, which can be concatenated with
- * other AI message chunks.
- */
-export class AIMessageChunk extends BaseMessageChunk {
-    static lc_name() {
-        return "AIMessageChunk";
-    }
-    _getType() {
-        return "ai";
-    }
-    concat(chunk) {
-        return new AIMessageChunk({
-            content: mergeContent(this.content, chunk.content),
-            additional_kwargs: _mergeDicts(this.additional_kwargs, chunk.additional_kwargs),
-            response_metadata: _mergeDicts(this.response_metadata, chunk.response_metadata),
-        });
-    }
-}
-/**
- * Represents a system message in a conversation.
- */
-export class SystemMessage extends BaseMessage {
-    static lc_name() {
-        return "SystemMessage";
-    }
-    _getType() {
-        return "system";
-    }
-}
-/**
- * Represents a chunk of a system message, which can be concatenated with
- * other system message chunks.
- */
-export class SystemMessageChunk extends BaseMessageChunk {
-    static lc_name() {
-        return "SystemMessageChunk";
-    }
-    _getType() {
-        return "system";
-    }
-    concat(chunk) {
-        return new SystemMessageChunk({
-            content: mergeContent(this.content, chunk.content),
-            additional_kwargs: _mergeDicts(this.additional_kwargs, chunk.additional_kwargs),
-            response_metadata: _mergeDicts(this.response_metadata, chunk.response_metadata),
-        });
-    }
-}
-/**
- * Represents a function message in a conversation.
- */
-export class FunctionMessage extends BaseMessage {
-    static lc_name() {
-        return "FunctionMessage";
-    }
-    constructor(fields, 
-    /** @deprecated */
-    name) {
-        if (typeof fields === "string") {
-            // eslint-disable-next-line no-param-reassign, @typescript-eslint/no-non-null-assertion
-            fields = { content: fields, name: name };
-        }
-        super(fields);
-    }
-    _getType() {
-        return "function";
-    }
-}
-/**
- * Represents a chunk of a function message, which can be concatenated
- * with other function message chunks.
- */
-export class FunctionMessageChunk extends BaseMessageChunk {
-    static lc_name() {
-        return "FunctionMessageChunk";
-    }
-    _getType() {
-        return "function";
-    }
-    concat(chunk) {
-        return new FunctionMessageChunk({
-            content: mergeContent(this.content, chunk.content),
-            additional_kwargs: _mergeDicts(this.additional_kwargs, chunk.additional_kwargs),
-            response_metadata: _mergeDicts(this.response_metadata, chunk.response_metadata),
-            name: this.name ?? "",
-        });
-    }
-}
-/**
- * Represents a tool message in a conversation.
- */
-export class ToolMessage extends BaseMessage {
-    static lc_name() {
-        return "ToolMessage";
-    }
-    get lc_aliases() {
-        // exclude snake case conversion to pascal case
-        return { tool_call_id: "tool_call_id" };
-    }
-    constructor(fields, tool_call_id, name) {
-        if (typeof fields === "string") {
-            // eslint-disable-next-line no-param-reassign, @typescript-eslint/no-non-null-assertion
-            fields = { content: fields, name, tool_call_id: tool_call_id };
-        }
-        super(fields);
-        Object.defineProperty(this, "tool_call_id", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.tool_call_id = fields.tool_call_id;
-    }
-    _getType() {
-        return "tool";
-    }
-    static isInstance(message) {
-        return message._getType() === "tool";
-    }
-}
-/**
- * Represents a chunk of a tool message, which can be concatenated
- * with other tool message chunks.
- */
-export class ToolMessageChunk extends BaseMessageChunk {
-    constructor(fields) {
-        super(fields);
-        Object.defineProperty(this, "tool_call_id", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.tool_call_id = fields.tool_call_id;
-    }
-    static lc_name() {
-        return "ToolMessageChunk";
-    }
-    _getType() {
-        return "tool";
-    }
-    concat(chunk) {
-        return new ToolMessageChunk({
-            content: mergeContent(this.content, chunk.content),
-            additional_kwargs: _mergeDicts(this.additional_kwargs, chunk.additional_kwargs),
-            response_metadata: _mergeDicts(this.response_metadata, chunk.response_metadata),
-            tool_call_id: this.tool_call_id,
-        });
-    }
-}
-/**
- * Represents a chat message in a conversation.
- */
-export class ChatMessage extends BaseMessage {
-    static lc_name() {
-        return "ChatMessage";
-    }
-    static _chatMessageClass() {
-        return ChatMessage;
-    }
-    constructor(fields, role) {
-        if (typeof fields === "string") {
-            // eslint-disable-next-line no-param-reassign, @typescript-eslint/no-non-null-assertion
-            fields = { content: fields, role: role };
-        }
-        super(fields);
-        Object.defineProperty(this, "role", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.role = fields.role;
-    }
-    _getType() {
-        return "generic";
-    }
-    static isInstance(message) {
-        return message._getType() === "generic";
-    }
-}
-export function isBaseMessage(messageLike) {
-    return typeof messageLike?._getType === "function";
-}
-export function isBaseMessageChunk(messageLike) {
-    return (isBaseMessage(messageLike) &&
-        typeof messageLike.concat === "function");
-}
-export function coerceMessageLikeToMessage(messageLike) {
-    if (typeof messageLike === "string") {
-        return new HumanMessage(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 });
-    }
-    else {
-        throw new Error(`Unable to coerce message from array: only human, AI, or system message coercion is currently supported.`);
-    }
-}
-/**
- * Represents a chunk of a chat message, which can be concatenated with
- * other chat message chunks.
- */
-export class ChatMessageChunk extends BaseMessageChunk {
-    static lc_name() {
-        return "ChatMessageChunk";
-    }
-    constructor(fields, role) {
-        if (typeof fields === "string") {
-            // eslint-disable-next-line no-param-reassign, @typescript-eslint/no-non-null-assertion
-            fields = { content: fields, role: role };
-        }
-        super(fields);
-        Object.defineProperty(this, "role", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.role = fields.role;
-    }
-    _getType() {
-        return "generic";
-    }
-    concat(chunk) {
-        return new ChatMessageChunk({
-            content: mergeContent(this.content, chunk.content),
-            additional_kwargs: _mergeDicts(this.additional_kwargs, chunk.additional_kwargs),
-            response_metadata: _mergeDicts(this.response_metadata, chunk.response_metadata),
-            role: this.role,
-        });
-    }
-}
-/**
- * This function is used by memory classes to get a string representation
- * of the chat message history, based on the message content and role.
- */
-export function getBufferString(messages, humanPrefix = "Human", aiPrefix = "AI") {
-    const string_messages = [];
-    for (const m of messages) {
-        let role;
-        if (m._getType() === "human") {
-            role = humanPrefix;
-        }
-        else if (m._getType() === "ai") {
-            role = aiPrefix;
-        }
-        else if (m._getType() === "system") {
-            role = "System";
-        }
-        else if (m._getType() === "function") {
-            role = "Function";
-        }
-        else if (m._getType() === "tool") {
-            role = "Tool";
-        }
-        else if (m._getType() === "generic") {
-            role = m.role;
-        }
-        else {
-            throw new Error(`Got unsupported message type: ${m._getType()}`);
-        }
-        const nameStr = m.name ? `${m.name}, ` : "";
-        string_messages.push(`${role}: ${nameStr}${m.content}`);
-    }
-    return string_messages.join("\n");
-}
-/**
- * Maps messages from an older format (V1) to the current `StoredMessage`
- * format. If the message is already in the `StoredMessage` format, it is
- * returned as is. Otherwise, it transforms the V1 message into a
- * `StoredMessage`. This function is important for maintaining
- * compatibility with older message formats.
- */
-function mapV1MessageToStoredMessage(message) {
-    // TODO: Remove this mapper when we deprecate the old message format.
-    if (message.data !== undefined) {
-        return message;
-    }
-    else {
-        const v1Message = message;
-        return {
-            type: v1Message.type,
-            data: {
-                content: v1Message.text,
-                role: v1Message.role,
-                name: undefined,
-                tool_call_id: undefined,
-            },
-        };
-    }
-}
-export function mapStoredMessageToChatMessage(message) {
-    const storedMessage = mapV1MessageToStoredMessage(message);
-    switch (storedMessage.type) {
-        case "human":
-            return new HumanMessage(storedMessage.data);
-        case "ai":
-            return new AIMessage(storedMessage.data);
-        case "system":
-            return new SystemMessage(storedMessage.data);
-        case "function":
-            if (storedMessage.data.name === undefined) {
-                throw new Error("Name must be defined for function messages");
-            }
-            return new FunctionMessage(storedMessage.data);
-        case "tool":
-            if (storedMessage.data.tool_call_id === undefined) {
-                throw new Error("Tool call ID must be defined for tool messages");
-            }
-            return new ToolMessage(storedMessage.data);
-        case "chat": {
-            if (storedMessage.data.role === undefined) {
-                throw new Error("Role must be defined for chat messages");
-            }
-            return new ChatMessage(storedMessage.data);
-        }
-        default:
-            throw new Error(`Got unexpected type: ${storedMessage.type}`);
-    }
-}
-/**
- * Transforms an array of `StoredMessage` instances into an array of
- * `BaseMessage` instances. It uses the `mapV1MessageToStoredMessage`
- * function to ensure all messages are in the `StoredMessage` format, then
- * creates new instances of the appropriate `BaseMessage` subclass based
- * on the type of each message. This function is used to prepare stored
- * messages for use in a chat context.
- */
-export function mapStoredMessagesToChatMessages(messages) {
-    return messages.map(mapStoredMessageToChatMessage);
-}
-/**
- * Transforms an array of `BaseMessage` instances into an array of
- * `StoredMessage` instances. It does this by calling the `toDict` method
- * on each `BaseMessage`, which returns a `StoredMessage`. This function
- * is used to prepare chat messages for storage.
- */
-export function mapChatMessagesToStoredMessages(messages) {
-    return messages.map((message) => message.toDict());
-}
+export * from "./ai.js";
+export * from "./base.js";
+export * from "./chat.js";
+export * from "./function.js";
+export * from "./human.js";
+export * from "./system.js";
+export * from "./utils.js";
+// TODO: Use a star export when we deprecate the
+// existing "ToolCall" type in "base.js".
+export { ToolMessage, ToolMessageChunk, } from "./tool.js";

package/dist/messages/system.cjs

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SystemMessageChunk = exports.SystemMessage = void 0;
+const base_js_1 = require("./base.cjs");
+/**
+ * Represents a system message in a conversation.
+ */
+class SystemMessage extends base_js_1.BaseMessage {
+    static lc_name() {
+        return "SystemMessage";
+    }
+    _getType() {
+        return "system";
+    }
+}
+exports.SystemMessage = SystemMessage;
+/**
+ * Represents a chunk of a system message, which can be concatenated with
+ * other system message chunks.
+ */
+class SystemMessageChunk extends base_js_1.BaseMessageChunk {
+    static lc_name() {
+        return "SystemMessageChunk";
+    }
+    _getType() {
+        return "system";
+    }
+    concat(chunk) {
+        return new SystemMessageChunk({
+            content: (0, base_js_1.mergeContent)(this.content, chunk.content),
+            additional_kwargs: (0, base_js_1._mergeDicts)(this.additional_kwargs, chunk.additional_kwargs),
+            response_metadata: (0, base_js_1._mergeDicts)(this.response_metadata, chunk.response_metadata),
+        });
+    }
+}
+exports.SystemMessageChunk = SystemMessageChunk;

package/dist/messages/system.d.ts

@@ -0,0 +1,17 @@
+import { BaseMessage, BaseMessageChunk, type MessageType } from "./base.js";
+/**
+ * Represents a system message in a conversation.
+ */
+export declare class SystemMessage extends BaseMessage {
+    static lc_name(): string;
+    _getType(): MessageType;
+}
+/**
+ * Represents a chunk of a system message, which can be concatenated with
+ * other system message chunks.
+ */
+export declare class SystemMessageChunk extends BaseMessageChunk {
+    static lc_name(): string;
+    _getType(): MessageType;
+    concat(chunk: SystemMessageChunk): SystemMessageChunk;
+}

package/dist/messages/system.js

@@ -0,0 +1,31 @@
+import { BaseMessage, BaseMessageChunk, mergeContent, _mergeDicts, } from "./base.js";
+/**
+ * Represents a system message in a conversation.
+ */
+export class SystemMessage extends BaseMessage {
+    static lc_name() {
+        return "SystemMessage";
+    }
+    _getType() {
+        return "system";
+    }
+}
+/**
+ * Represents a chunk of a system message, which can be concatenated with
+ * other system message chunks.
+ */
+export class SystemMessageChunk extends BaseMessageChunk {
+    static lc_name() {
+        return "SystemMessageChunk";
+    }
+    _getType() {
+        return "system";
+    }
+    concat(chunk) {
+        return new SystemMessageChunk({
+            content: mergeContent(this.content, chunk.content),
+            additional_kwargs: _mergeDicts(this.additional_kwargs, chunk.additional_kwargs),
+            response_metadata: _mergeDicts(this.response_metadata, chunk.response_metadata),
+        });
+    }
+}