@langchain/core 0.3.6 → 0.3.8-rc.0

package/dist/language_models/base.cjs

@@ -156,9 +156,10 @@ class BaseLanguageModel extends BaseLangChain {
         return ["stop", "timeout", "signal", "tags", "metadata", "callbacks"];
     }
     constructor({ callbacks, callbackManager, ...params }) {
+        const { cache, ...rest } = params;
         super({
             callbacks: callbacks ?? callbackManager,
-            ...params,
+            ...rest,
         });
         /**
          * The async caller should be used by subclasses to make any async calls,
@@ -182,10 +183,10 @@ class BaseLanguageModel extends BaseLangChain {
             writable: true,
             value: void 0
         });
-        if (typeof params.cache === "object") {
-            this.cache = params.cache;
+        if (typeof cache === "object") {
+            this.cache = cache;
         }
-        else if (params.cache) {
+        else if (cache) {
             this.cache = base_js_1.InMemoryCache.global();
         }
         else {

package/dist/language_models/base.js

@@ -147,9 +147,10 @@ export class BaseLanguageModel extends BaseLangChain {
         return ["stop", "timeout", "signal", "tags", "metadata", "callbacks"];
     }
     constructor({ callbacks, callbackManager, ...params }) {
+        const { cache, ...rest } = params;
         super({
             callbacks: callbacks ?? callbackManager,
-            ...params,
+            ...rest,
         });
         /**
          * The async caller should be used by subclasses to make any async calls,
@@ -173,10 +174,10 @@ export class BaseLanguageModel extends BaseLangChain {
             writable: true,
             value: void 0
         });
-        if (typeof params.cache === "object") {
-            this.cache = params.cache;
+        if (typeof cache === "object") {
+            this.cache = cache;
         }
-        else if (params.cache) {
+        else if (cache) {
             this.cache = InMemoryCache.global();
         }
         else {

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/dist/runnables/base.d.ts

@@ -479,7 +479,7 @@ export declare class RunnableSequence<RunInput = any, RunOutput = any> extends R
         last: Runnable<any, RunOutput>;
         name?: string;
     });
-    get steps(): Runnable<any, any, RunnableConfig>[];
+    get steps(): Runnable<any, any, RunnableConfig<Record<string, any>>>[];
     invoke(input: RunInput, options?: RunnableConfig): Promise<RunOutput>;
     batch(inputs: RunInput[], options?: Partial<RunnableConfig> | Partial<RunnableConfig>[], batchOptions?: RunnableBatchOptions & {
         returnExceptions?: false;
@@ -593,7 +593,7 @@ export declare class RunnableWithFallbacks<RunInput, RunOutput> extends Runnable
         runnable: Runnable<RunInput, RunOutput>;
         fallbacks: Runnable<RunInput, RunOutput>[];
     });
-    runnables(): Generator<Runnable<RunInput, RunOutput, RunnableConfig>, void, unknown>;
+    runnables(): Generator<Runnable<RunInput, RunOutput, RunnableConfig<Record<string, any>>>, void, unknown>;
     invoke(input: RunInput, options?: Partial<RunnableConfig>): Promise<RunOutput>;
     _streamIterator(input: RunInput, options?: Partial<RunnableConfig> | undefined): AsyncGenerator<RunOutput>;
     batch(inputs: RunInput[], options?: Partial<RunnableConfig> | Partial<RunnableConfig>[], batchOptions?: RunnableBatchOptions & {

package/dist/runnables/graph.d.ts

@@ -19,7 +19,7 @@ export declare class Graph {
      */
     extend(graph: Graph, prefix?: string): ({
         id: string;
-        data: RunnableIOSchema | RunnableInterface<any, any, import("./types.js").RunnableConfig>;
+        data: RunnableIOSchema | RunnableInterface<any, any, import("./types.js").RunnableConfig<Record<string, any>>>;
     } | undefined)[];
     trimFirstNode(): void;
     trimLastNode(): void;

package/dist/runnables/history.d.ts

@@ -87,6 +87,6 @@ export declare class RunnableWithMessageHistory<RunInput, RunOutput> extends Run
     _getOutputMessages(outputValue: string | BaseMessage | Array<BaseMessage> | Record<string, any>): Array<BaseMessage>;
     _enterHistory(input: any, kwargs?: RunnableConfig): Promise<BaseMessage[]>;
     _exitHistory(run: Run, config: RunnableConfig): Promise<void>;
-    _mergeConfig(...configs: Array<RunnableConfig | undefined>): Promise<Partial<RunnableConfig>>;
+    _mergeConfig(...configs: Array<RunnableConfig | undefined>): Promise<Partial<RunnableConfig<Record<string, any>>>>;
 }
 export {};

package/dist/runnables/types.d.ts

@@ -43,12 +43,12 @@ export interface Node {
     data: RunnableIOSchema | RunnableInterface;
     metadata?: Record<string, any>;
 }
-export interface RunnableConfig extends BaseCallbackConfig {
+export interface RunnableConfig<ConfigurableFieldType extends Record<string, any> = Record<string, any>> extends BaseCallbackConfig {
     /**
      * Runtime values for attributes previously made configurable on this Runnable,
      * or sub-Runnables.
      */
-    configurable?: Record<string, any>;
+    configurable?: ConfigurableFieldType;
     /**
      * Maximum number of times a call can recurse. If not provided, defaults to 25.
      */

package/dist/utils/testing/index.cjs

@@ -309,8 +309,14 @@ class FakeListChatModel extends chat_models_js_1.BaseChatModel {
     static lc_name() {
         return "FakeListChatModel";
     }
-    constructor({ responses, sleep, emitCustomEvent }) {
-        super({});
+    constructor(params) {
+        super(params);
+        Object.defineProperty(this, "lc_serializable", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: true
+        });
         Object.defineProperty(this, "responses", {
             enumerable: true,
             configurable: true,
@@ -335,6 +341,7 @@ class FakeListChatModel extends chat_models_js_1.BaseChatModel {
             writable: true,
             value: false
         });
+        const { responses, sleep, emitCustomEvent } = params;
         this.responses = responses;
         this.sleep = sleep;
         this.emitCustomEvent = emitCustomEvent ?? this.emitCustomEvent;

package/dist/utils/testing/index.d.ts

@@ -116,11 +116,12 @@ export interface FakeListChatModelCallOptions extends BaseChatModelCallOptions {
  */
 export declare class FakeListChatModel extends BaseChatModel<FakeListChatModelCallOptions> {
     static lc_name(): string;
+    lc_serializable: boolean;
     responses: string[];
     i: number;
     sleep?: number;
     emitCustomEvent: boolean;
-    constructor({ responses, sleep, emitCustomEvent }: FakeChatInput);
+    constructor(params: FakeChatInput);
     _combineLLMOutput(): never[];
     _llmType(): string;
     _generate(_messages: BaseMessage[], options?: this["ParsedCallOptions"], runManager?: CallbackManagerForLLMRun): Promise<ChatResult>;

package/dist/utils/testing/index.js

@@ -299,8 +299,14 @@ export class FakeListChatModel extends BaseChatModel {
     static lc_name() {
         return "FakeListChatModel";
     }
-    constructor({ responses, sleep, emitCustomEvent }) {
-        super({});
+    constructor(params) {
+        super(params);
+        Object.defineProperty(this, "lc_serializable", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: true
+        });
         Object.defineProperty(this, "responses", {
             enumerable: true,
             configurable: true,
@@ -325,6 +331,7 @@ export class FakeListChatModel extends BaseChatModel {
             writable: true,
             value: false
         });
+        const { responses, sleep, emitCustomEvent } = params;
         this.responses = responses;
         this.sleep = sleep;
         this.emitCustomEvent = emitCustomEvent ?? this.emitCustomEvent;

package/package.json

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