@langchain/core 0.2.15 → 0.2.16

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

@@ -3,6 +3,7 @@ import { filterMessages, mergeMessageRuns, trimMessages, } from "../transformers
 import { AIMessage } from "../ai.js";
 import { HumanMessage } from "../human.js";
 import { SystemMessage } from "../system.js";
+import { getBufferString } from "../utils.js";
 describe("filterMessage", () => {
     const getMessages = () => [
         new SystemMessage("you're a good assistant."),
@@ -97,8 +98,8 @@ describe("mergeMessageRuns", () => {
                     { type: "text", text: "my favorite dish is lasagna" },
                 ],
                 tool_calls: [
-                    { name: "blah_tool", args: { x: 2 }, id: "123" },
-                    { name: "blah_tool", args: { x: -10 }, id: "456" },
+                    { name: "blah_tool", args: { x: 2 }, id: "123", type: "tool_call" },
+                    { name: "blah_tool", args: { x: -10 }, id: "456", type: "tool_call" },
                 ],
                 id: "baz",
             }),
@@ -380,3 +381,54 @@ describe("trimMessages can trim", () => {
         expect(typeof trimmedMessages.func).toBe("function");
     });
 });
+test("getBufferString can handle complex messages", () => {
+    const messageArr1 = [new HumanMessage("Hello there!")];
+    const messageArr2 = [
+        new AIMessage({
+            content: [
+                {
+                    type: "text",
+                    text: "Hello there!",
+                },
+            ],
+        }),
+    ];
+    const messageArr3 = [
+        new HumanMessage({
+            content: [
+                {
+                    type: "image_url",
+                    image_url: {
+                        url: "https://example.com/image.jpg",
+                    },
+                },
+                {
+                    type: "image_url",
+                    image_url: "https://example.com/image.jpg",
+                },
+            ],
+        }),
+    ];
+    const bufferString1 = getBufferString(messageArr1);
+    expect(bufferString1).toBe("Human: Hello there!");
+    const bufferString2 = getBufferString(messageArr2);
+    expect(bufferString2).toBe(`AI: ${JSON.stringify([
+        {
+            type: "text",
+            text: "Hello there!",
+        },
+    ], null, 2)}`);
+    const bufferString3 = getBufferString(messageArr3);
+    expect(bufferString3).toBe(`Human: ${JSON.stringify([
+        {
+            type: "image_url",
+            image_url: {
+                url: "https://example.com/image.jpg",
+            },
+        },
+        {
+            type: "image_url",
+            image_url: "https://example.com/image.jpg",
+        },
+    ], null, 2)}`);
+});

package/dist/messages/tool.cjs

@@ -25,7 +25,22 @@ class ToolMessage extends base_js_1.BaseMessage {
             writable: true,
             value: void 0
         });
+        /**
+         * Artifact of the Tool execution which is not meant to be sent to the model.
+         *
+         * Should only be specified if it is different from the message content, e.g. if only
+         * a subset of the full tool output is being passed as message content but the full
+         * output is needed in other parts of the code.
+         */
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        Object.defineProperty(this, "artifact", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.tool_call_id = fields.tool_call_id;
+        this.artifact = fields.artifact;
     }
     _getType() {
         return "tool";
@@ -48,7 +63,22 @@ class ToolMessageChunk extends base_js_1.BaseMessageChunk {
             writable: true,
             value: void 0
         });
+        /**
+         * Artifact of the Tool execution which is not meant to be sent to the model.
+         *
+         * Should only be specified if it is different from the message content, e.g. if only
+         * a subset of the full tool output is being passed as message content but the full
+         * output is needed in other parts of the code.
+         */
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        Object.defineProperty(this, "artifact", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.tool_call_id = fields.tool_call_id;
+        this.artifact = fields.artifact;
     }
     static lc_name() {
         return "ToolMessageChunk";
@@ -61,6 +91,7 @@ class ToolMessageChunk extends base_js_1.BaseMessageChunk {
             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),
+            artifact: (0, base_js_1._mergeObj)(this.artifact, chunk.artifact),
             tool_call_id: this.tool_call_id,
             id: this.id ?? chunk.id,
         });

package/dist/messages/tool.d.ts

@@ -1,5 +1,13 @@
 import { BaseMessage, BaseMessageChunk, type BaseMessageFields, type MessageType } from "./base.js";
 export interface ToolMessageFieldsWithToolCallId extends BaseMessageFields {
+    /**
+     * Artifact of the Tool execution which is not meant to be sent to the model.
+     *
+     * Should only be specified if it is different from the message content, e.g. if only
+     * a subset of the full tool output is being passed as message content but the full
+     * output is needed in other parts of the code.
+     */
+    artifact?: any;
     tool_call_id: string;
 }
 /**
@@ -9,6 +17,14 @@ export declare class ToolMessage extends BaseMessage {
     static lc_name(): string;
     get lc_aliases(): Record<string, string>;
     tool_call_id: string;
+    /**
+     * Artifact of the Tool execution which is not meant to be sent to the model.
+     *
+     * Should only be specified if it is different from the message content, e.g. if only
+     * a subset of the full tool output is being passed as message content but the full
+     * output is needed in other parts of the code.
+     */
+    artifact?: any;
     constructor(fields: ToolMessageFieldsWithToolCallId);
     constructor(fields: string | BaseMessageFields, tool_call_id: string, name?: string);
     _getType(): MessageType;
@@ -20,6 +36,14 @@ export declare class ToolMessage extends BaseMessage {
  */
 export declare class ToolMessageChunk extends BaseMessageChunk {
     tool_call_id: string;
+    /**
+     * Artifact of the Tool execution which is not meant to be sent to the model.
+     *
+     * Should only be specified if it is different from the message content, e.g. if only
+     * a subset of the full tool output is being passed as message content but the full
+     * output is needed in other parts of the code.
+     */
+    artifact?: any;
     constructor(fields: ToolMessageFieldsWithToolCallId);
     static lc_name(): string;
     _getType(): MessageType;
@@ -35,6 +59,7 @@ export type ToolCall = {
     name: string;
     args: Record<string, any>;
     id?: string;
+    type?: "tool_call";
 };
 /**
  * A chunk of a tool call (e.g., as part of a stream).
@@ -91,11 +116,13 @@ export type ToolCallChunk = {
     args?: string;
     id?: string;
     index?: number;
+    type?: "tool_call_chunk";
 };
 export type InvalidToolCall = {
     name?: string;
     args?: string;
     id?: string;
     error?: string;
+    type?: "invalid_tool_call";
 };
 export declare function defaultToolCallParser(rawToolCalls: Record<string, any>[]): [ToolCall[], InvalidToolCall[]];

package/dist/messages/tool.js

@@ -1,4 +1,4 @@
-import { BaseMessage, BaseMessageChunk, mergeContent, _mergeDicts, } from "./base.js";
+import { BaseMessage, BaseMessageChunk, mergeContent, _mergeDicts, _mergeObj, } from "./base.js";
 /**
  * Represents a tool message in a conversation.
  */
@@ -22,7 +22,22 @@ export class ToolMessage extends BaseMessage {
             writable: true,
             value: void 0
         });
+        /**
+         * Artifact of the Tool execution which is not meant to be sent to the model.
+         *
+         * Should only be specified if it is different from the message content, e.g. if only
+         * a subset of the full tool output is being passed as message content but the full
+         * output is needed in other parts of the code.
+         */
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        Object.defineProperty(this, "artifact", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.tool_call_id = fields.tool_call_id;
+        this.artifact = fields.artifact;
     }
     _getType() {
         return "tool";
@@ -44,7 +59,22 @@ export class ToolMessageChunk extends BaseMessageChunk {
             writable: true,
             value: void 0
         });
+        /**
+         * Artifact of the Tool execution which is not meant to be sent to the model.
+         *
+         * Should only be specified if it is different from the message content, e.g. if only
+         * a subset of the full tool output is being passed as message content but the full
+         * output is needed in other parts of the code.
+         */
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        Object.defineProperty(this, "artifact", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.tool_call_id = fields.tool_call_id;
+        this.artifact = fields.artifact;
     }
     static lc_name() {
         return "ToolMessageChunk";
@@ -57,6 +87,7 @@ export class ToolMessageChunk extends BaseMessageChunk {
             content: mergeContent(this.content, chunk.content),
             additional_kwargs: _mergeDicts(this.additional_kwargs, chunk.additional_kwargs),
             response_metadata: _mergeDicts(this.response_metadata, chunk.response_metadata),
+            artifact: _mergeObj(this.artifact, chunk.artifact),
             tool_call_id: this.tool_call_id,
             id: this.id ?? chunk.id,
         });

package/dist/messages/transformers.cjs

@@ -326,6 +326,7 @@ function _switchTypeToMessage(messageType, fields, returnChunk) {
                         ...aiChunkFields,
                         tool_call_chunks: aiChunkFields.tool_calls?.map((tc) => ({
                             ...tc,
+                            type: "tool_call_chunk",
                             index: undefined,
                             args: JSON.stringify(tc.args),
                         })),

package/dist/messages/transformers.js

@@ -320,6 +320,7 @@ function _switchTypeToMessage(messageType, fields, returnChunk) {
                         ...aiChunkFields,
                         tool_call_chunks: aiChunkFields.tool_calls?.map((tc) => ({
                             ...tc,
+                            type: "tool_call_chunk",
                             index: undefined,
                             args: JSON.stringify(tc.args),
                         })),

package/dist/messages/utils.cjs

@@ -69,7 +69,10 @@ function getBufferString(messages, humanPrefix = "Human", aiPrefix = "AI") {
             throw new Error(`Got unsupported message type: ${m._getType()}`);
         }
         const nameStr = m.name ? `${m.name}, ` : "";
-        string_messages.push(`${role}: ${nameStr}${m.content}`);
+        const readableContent = typeof m.content === "string"
+            ? m.content
+            : JSON.stringify(m.content, null, 2);
+        string_messages.push(`${role}: ${nameStr}${readableContent}`);
     }
     return string_messages.join("\n");
 }
@@ -166,6 +169,7 @@ function convertToChunk(message) {
                 ...aiChunkFields,
                 tool_call_chunks: aiChunkFields.tool_calls?.map((tc) => ({
                     ...tc,
+                    type: "tool_call_chunk",
                     index: undefined,
                     args: JSON.stringify(tc.args),
                 })),

package/dist/messages/utils.js

@@ -65,7 +65,10 @@ export function getBufferString(messages, humanPrefix = "Human", aiPrefix = "AI"
             throw new Error(`Got unsupported message type: ${m._getType()}`);
         }
         const nameStr = m.name ? `${m.name}, ` : "";
-        string_messages.push(`${role}: ${nameStr}${m.content}`);
+        const readableContent = typeof m.content === "string"
+            ? m.content
+            : JSON.stringify(m.content, null, 2);
+        string_messages.push(`${role}: ${nameStr}${readableContent}`);
     }
     return string_messages.join("\n");
 }
@@ -158,6 +161,7 @@ export function convertToChunk(message) {
                 ...aiChunkFields,
                 tool_call_chunks: aiChunkFields.tool_calls?.map((tc) => ({
                     ...tc,
+                    type: "tool_call_chunk",
                     index: undefined,
                     args: JSON.stringify(tc.args),
                 })),

package/dist/output_parsers/openai_tools/json_output_tools_parsers.cjs

@@ -37,6 +37,7 @@ rawToolCall, options) {
     const parsedToolCall = {
         name: rawToolCall.function.name,
         args: functionArgs,
+        type: "tool_call",
     };
     if (options?.returnId) {
         parsedToolCall.id = rawToolCall.id;
@@ -66,6 +67,7 @@ rawToolCall, errorMsg) {
         args: rawToolCall.function?.arguments,
         id: rawToolCall.id,
         error: errorMsg,
+        type: "invalid_tool_call",
     };
 }
 exports.makeInvalidToolCall = makeInvalidToolCall;

package/dist/output_parsers/openai_tools/json_output_tools_parsers.js

@@ -34,6 +34,7 @@ rawToolCall, options) {
     const parsedToolCall = {
         name: rawToolCall.function.name,
         args: functionArgs,
+        type: "tool_call",
     };
     if (options?.returnId) {
         parsedToolCall.id = rawToolCall.id;
@@ -61,6 +62,7 @@ rawToolCall, errorMsg) {
         args: rawToolCall.function?.arguments,
         id: rawToolCall.id,
         error: errorMsg,
+        type: "invalid_tool_call",
     };
 }
 /**

package/dist/runnables/base.cjs

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RunnablePick = exports.RunnableAssign = exports._coerceToRunnable = exports.RunnableWithFallbacks = exports.RunnableParallel = exports.RunnableLambda = exports.RunnableTraceable = exports.RunnableMap = exports.RunnableSequence = exports.RunnableRetry = exports.RunnableEach = exports.RunnableBinding = exports.Runnable = exports._coerceToDict = void 0;
+exports.convertRunnableToTool = exports.RunnableToolLike = exports.RunnablePick = exports.RunnableAssign = exports._coerceToRunnable = exports.RunnableWithFallbacks = exports.RunnableParallel = exports.RunnableLambda = exports.RunnableTraceable = exports.RunnableMap = exports.RunnableSequence = exports.RunnableRetry = exports.RunnableEach = exports.RunnableBinding = exports.Runnable = exports._coerceToDict = void 0;
 const zod_1 = require("zod");
 const p_retry_1 = __importDefault(require("p-retry"));
 const uuid_1 = require("uuid");
@@ -718,6 +718,21 @@ class Runnable extends serializable_js_1.Serializable {
             ],
         });
     }
+    /**
+     * Convert a runnable to a tool. Return a new instance of `RunnableToolLike`
+     * which contains the runnable, name, description and schema.
+     *
+     * @template {T extends RunInput = RunInput} RunInput - The input type of the runnable. Should be the same as the `RunInput` type of the runnable.
+     *
+     * @param fields
+     * @param {string | undefined} [fields.name] The name of the tool. If not provided, it will default to the name of the runnable.
+     * @param {string | undefined} [fields.description] The description of the tool. Falls back to the description on the Zod schema if not provided, or undefined if neither are provided.
+     * @param {z.ZodType<T>} [fields.schema] The Zod schema for the input of the tool. Infers the Zod type from the input type of the runnable.
+     * @returns {RunnableToolLike<z.ZodType<T>, RunOutput>} An instance of `RunnableToolLike` which is a runnable that can be used as a tool.
+     */
+    asTool(fields) {
+        return convertRunnableToTool(this, fields);
+    }
 }
 exports.Runnable = Runnable;
 /**
@@ -1912,3 +1927,60 @@ class RunnablePick extends Runnable {
     }
 }
 exports.RunnablePick = RunnablePick;
+class RunnableToolLike extends RunnableBinding {
+    constructor(fields) {
+        super({
+            bound: fields.bound,
+            config: fields.config ?? {},
+        });
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "description", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "schema", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.name = fields.name;
+        this.description = fields.description;
+        this.schema = fields.schema;
+    }
+    static lc_name() {
+        return "RunnableToolLike";
+    }
+}
+exports.RunnableToolLike = RunnableToolLike;
+/**
+ * Given a runnable and a Zod schema, convert the runnable to a tool.
+ *
+ * @template RunInput The input type for the runnable.
+ * @template RunOutput The output type for the runnable.
+ *
+ * @param {Runnable<RunInput, RunOutput>} runnable The runnable to convert to a tool.
+ * @param fields
+ * @param {string | undefined} [fields.name] The name of the tool. If not provided, it will default to the name of the runnable.
+ * @param {string | undefined} [fields.description] The description of the tool. Falls back to the description on the Zod schema if not provided, or undefined if neither are provided.
+ * @param {z.ZodType<RunInput>} [fields.schema] The Zod schema for the input of the tool. Infers the Zod type from the input type of the runnable.
+ * @returns {RunnableToolLike<z.ZodType<RunInput>, RunOutput>} An instance of `RunnableToolLike` which is a runnable that can be used as a tool.
+ */
+function convertRunnableToTool(runnable, fields) {
+    const name = fields.name ?? runnable.getName();
+    const description = fields.description ?? fields.schema.description;
+    return new RunnableToolLike({
+        name,
+        description,
+        schema: fields.schema,
+        bound: runnable,
+    });
+}
+exports.convertRunnableToTool = convertRunnableToTool;

package/dist/runnables/base.d.ts

@@ -1,3 +1,4 @@
+import { z } from "zod";
 import { type TraceableFunction } from "langsmith/singletons/traceable";
 import type { RunnableInterface, RunnableBatchOptions } from "./types.js";
 import { CallbackManagerForChainRun } from "../callbacks/manager.js";
@@ -245,6 +246,23 @@ export declare abstract class Runnable<RunInput = any, RunOutput = any, CallOpti
         onEnd?: (run: Run, config?: RunnableConfig) => void | Promise<void>;
         onError?: (run: Run, config?: RunnableConfig) => void | Promise<void>;
     }): Runnable<RunInput, RunOutput, CallOptions>;
+    /**
+     * Convert a runnable to a tool. Return a new instance of `RunnableToolLike`
+     * which contains the runnable, name, description and schema.
+     *
+     * @template {T extends RunInput = RunInput} RunInput - The input type of the runnable. Should be the same as the `RunInput` type of the runnable.
+     *
+     * @param fields
+     * @param {string | undefined} [fields.name] The name of the tool. If not provided, it will default to the name of the runnable.
+     * @param {string | undefined} [fields.description] The description of the tool. Falls back to the description on the Zod schema if not provided, or undefined if neither are provided.
+     * @param {z.ZodType<T>} [fields.schema] The Zod schema for the input of the tool. Infers the Zod type from the input type of the runnable.
+     * @returns {RunnableToolLike<z.ZodType<T>, RunOutput>} An instance of `RunnableToolLike` which is a runnable that can be used as a tool.
+     */
+    asTool<T extends RunInput = RunInput>(fields: {
+        name?: string;
+        description?: string;
+        schema: z.ZodType<T>;
+    }): RunnableToolLike<z.ZodType<T>, RunOutput>;
 }
 export type RunnableBindingArgs<RunInput, RunOutput, CallOptions extends RunnableConfig = RunnableConfig> = {
     bound: Runnable<RunInput, RunOutput, CallOptions>;
@@ -560,3 +578,34 @@ export declare class RunnablePick<RunInput extends Record<string, any> = Record<
     transform(generator: AsyncGenerator<RunInput>, options?: Partial<RunnableConfig>): AsyncGenerator<RunOutput>;
     stream(input: RunInput, options?: Partial<RunnableConfig>): Promise<IterableReadableStream<RunOutput>>;
 }
+export interface RunnableToolLikeArgs<RunInput extends z.ZodType = z.ZodType, RunOutput = unknown> extends Omit<RunnableBindingArgs<z.infer<RunInput>, RunOutput>, "config"> {
+    name: string;
+    description?: string;
+    schema: RunInput;
+    config?: RunnableConfig;
+}
+export declare class RunnableToolLike<RunInput extends z.ZodType = z.ZodType, RunOutput = unknown> extends RunnableBinding<z.infer<RunInput>, RunOutput> {
+    name: string;
+    description?: string;
+    schema: RunInput;
+    constructor(fields: RunnableToolLikeArgs<RunInput, RunOutput>);
+    static lc_name(): string;
+}
+/**
+ * Given a runnable and a Zod schema, convert the runnable to a tool.
+ *
+ * @template RunInput The input type for the runnable.
+ * @template RunOutput The output type for the runnable.
+ *
+ * @param {Runnable<RunInput, RunOutput>} runnable The runnable to convert to a tool.
+ * @param fields
+ * @param {string | undefined} [fields.name] The name of the tool. If not provided, it will default to the name of the runnable.
+ * @param {string | undefined} [fields.description] The description of the tool. Falls back to the description on the Zod schema if not provided, or undefined if neither are provided.
+ * @param {z.ZodType<RunInput>} [fields.schema] The Zod schema for the input of the tool. Infers the Zod type from the input type of the runnable.
+ * @returns {RunnableToolLike<z.ZodType<RunInput>, RunOutput>} An instance of `RunnableToolLike` which is a runnable that can be used as a tool.
+ */
+export declare function convertRunnableToTool<RunInput, RunOutput>(runnable: Runnable<RunInput, RunOutput>, fields: {
+    name?: string;
+    description?: string;
+    schema: z.ZodType<RunInput>;
+}): RunnableToolLike<z.ZodType<RunInput>, RunOutput>;

package/dist/runnables/base.js

@@ -711,6 +711,21 @@ export class Runnable extends Serializable {
             ],
         });
     }
+    /**
+     * Convert a runnable to a tool. Return a new instance of `RunnableToolLike`
+     * which contains the runnable, name, description and schema.
+     *
+     * @template {T extends RunInput = RunInput} RunInput - The input type of the runnable. Should be the same as the `RunInput` type of the runnable.
+     *
+     * @param fields
+     * @param {string | undefined} [fields.name] The name of the tool. If not provided, it will default to the name of the runnable.
+     * @param {string | undefined} [fields.description] The description of the tool. Falls back to the description on the Zod schema if not provided, or undefined if neither are provided.
+     * @param {z.ZodType<T>} [fields.schema] The Zod schema for the input of the tool. Infers the Zod type from the input type of the runnable.
+     * @returns {RunnableToolLike<z.ZodType<T>, RunOutput>} An instance of `RunnableToolLike` which is a runnable that can be used as a tool.
+     */
+    asTool(fields) {
+        return convertRunnableToTool(this, fields);
+    }
 }
 /**
  * A runnable that delegates calls to another runnable with a set of kwargs.
@@ -1892,3 +1907,58 @@ export class RunnablePick extends Runnable {
         return IterableReadableStream.fromAsyncGenerator(wrappedGenerator);
     }
 }
+export class RunnableToolLike extends RunnableBinding {
+    constructor(fields) {
+        super({
+            bound: fields.bound,
+            config: fields.config ?? {},
+        });
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "description", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "schema", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.name = fields.name;
+        this.description = fields.description;
+        this.schema = fields.schema;
+    }
+    static lc_name() {
+        return "RunnableToolLike";
+    }
+}
+/**
+ * Given a runnable and a Zod schema, convert the runnable to a tool.
+ *
+ * @template RunInput The input type for the runnable.
+ * @template RunOutput The output type for the runnable.
+ *
+ * @param {Runnable<RunInput, RunOutput>} runnable The runnable to convert to a tool.
+ * @param fields
+ * @param {string | undefined} [fields.name] The name of the tool. If not provided, it will default to the name of the runnable.
+ * @param {string | undefined} [fields.description] The description of the tool. Falls back to the description on the Zod schema if not provided, or undefined if neither are provided.
+ * @param {z.ZodType<RunInput>} [fields.schema] The Zod schema for the input of the tool. Infers the Zod type from the input type of the runnable.
+ * @returns {RunnableToolLike<z.ZodType<RunInput>, RunOutput>} An instance of `RunnableToolLike` which is a runnable that can be used as a tool.
+ */
+export function convertRunnableToTool(runnable, fields) {
+    const name = fields.name ?? runnable.getName();
+    const description = fields.description ?? fields.schema.description;
+    return new RunnableToolLike({
+        name,
+        description,
+        schema: fields.schema,
+        bound: runnable,
+    });
+}

package/dist/runnables/index.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RunnableWithMessageHistory = exports.RunnableBranch = exports.RouterRunnable = exports.RunnablePassthrough = exports.mergeConfigs = exports.ensureConfig = exports.patchConfig = exports.getCallbackManagerForConfig = exports._coerceToRunnable = exports.RunnablePick = exports.RunnableAssign = exports.RunnableWithFallbacks = exports.RunnableLambda = exports.RunnableParallel = exports.RunnableMap = exports.RunnableSequence = exports.RunnableRetry = exports.RunnableEach = exports.RunnableBinding = exports.Runnable = void 0;
+exports.RunnableWithMessageHistory = exports.RunnableBranch = exports.RouterRunnable = exports.RunnablePassthrough = exports.mergeConfigs = exports.ensureConfig = exports.patchConfig = exports.getCallbackManagerForConfig = exports.RunnableToolLike = exports._coerceToRunnable = exports.RunnablePick = exports.RunnableAssign = exports.RunnableWithFallbacks = exports.RunnableLambda = exports.RunnableParallel = exports.RunnableMap = exports.RunnableSequence = exports.RunnableRetry = exports.RunnableEach = exports.RunnableBinding = exports.Runnable = void 0;
 var base_js_1 = require("./base.cjs");
 Object.defineProperty(exports, "Runnable", { enumerable: true, get: function () { return base_js_1.Runnable; } });
 Object.defineProperty(exports, "RunnableBinding", { enumerable: true, get: function () { return base_js_1.RunnableBinding; } });
@@ -14,6 +14,7 @@ Object.defineProperty(exports, "RunnableWithFallbacks", { enumerable: true, get:
 Object.defineProperty(exports, "RunnableAssign", { enumerable: true, get: function () { return base_js_1.RunnableAssign; } });
 Object.defineProperty(exports, "RunnablePick", { enumerable: true, get: function () { return base_js_1.RunnablePick; } });
 Object.defineProperty(exports, "_coerceToRunnable", { enumerable: true, get: function () { return base_js_1._coerceToRunnable; } });
+Object.defineProperty(exports, "RunnableToolLike", { enumerable: true, get: function () { return base_js_1.RunnableToolLike; } });
 var config_js_1 = require("./config.cjs");
 Object.defineProperty(exports, "getCallbackManagerForConfig", { enumerable: true, get: function () { return config_js_1.getCallbackManagerForConfig; } });
 Object.defineProperty(exports, "patchConfig", { enumerable: true, get: function () { return config_js_1.patchConfig; } });

package/dist/runnables/index.d.ts

@@ -1,4 +1,4 @@
-export { type RunnableFunc, type RunnableLike, type RunnableRetryFailedAttemptHandler, Runnable, type RunnableBindingArgs, RunnableBinding, RunnableEach, RunnableRetry, RunnableSequence, RunnableMap, RunnableParallel, RunnableLambda, RunnableWithFallbacks, RunnableAssign, RunnablePick, _coerceToRunnable, } from "./base.js";
+export { type RunnableFunc, type RunnableLike, type RunnableRetryFailedAttemptHandler, Runnable, type RunnableBindingArgs, RunnableBinding, RunnableEach, RunnableRetry, RunnableSequence, RunnableMap, RunnableParallel, RunnableLambda, RunnableWithFallbacks, RunnableAssign, RunnablePick, _coerceToRunnable, RunnableToolLike, type RunnableToolLikeArgs, } from "./base.js";
 export { type RunnableBatchOptions, type RunnableInterface, type RunnableIOSchema, } from "./types.js";
 export { type RunnableConfig, getCallbackManagerForConfig, patchConfig, ensureConfig, mergeConfigs, } from "./config.js";
 export { RunnablePassthrough } from "./passthrough.js";

package/dist/runnables/index.js

@@ -1,4 +1,4 @@
-export { Runnable, RunnableBinding, RunnableEach, RunnableRetry, RunnableSequence, RunnableMap, RunnableParallel, RunnableLambda, RunnableWithFallbacks, RunnableAssign, RunnablePick, _coerceToRunnable, } from "./base.js";
+export { Runnable, RunnableBinding, RunnableEach, RunnableRetry, RunnableSequence, RunnableMap, RunnableParallel, RunnableLambda, RunnableWithFallbacks, RunnableAssign, RunnablePick, _coerceToRunnable, RunnableToolLike, } from "./base.js";
 export { getCallbackManagerForConfig, patchConfig, ensureConfig, mergeConfigs, } from "./config.js";
 export { RunnablePassthrough } from "./passthrough.js";
 export { RouterRunnable } from "./router.js";

package/dist/runnables/tests/runnable_stream_events.test.js

@@ -8,7 +8,7 @@ import { ChatPromptTemplate } from "../../prompts/chat.js";
 import { FakeListChatModel, FakeRetriever, FakeStreamingLLM, } from "../../utils/testing/index.js";
 import { AIMessageChunk, HumanMessage, SystemMessage, } from "../../messages/index.js";
 import { ChatGenerationChunk, GenerationChunk } from "../../outputs.js";
-import { DynamicStructuredTool, DynamicTool } from "../../tools.js";
+import { DynamicStructuredTool, DynamicTool } from "../../tools/index.js";
 import { Document } from "../../documents/document.js";
 function reverse(s) {
     // Reverse a string.