@langchain/core 0.2.14 → 0.2.16

package/dist/utils/function_calling.cjs

@@ -1,12 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isStructuredTool = exports.convertToOpenAITool = exports.convertToOpenAIFunction = void 0;
+exports.isRunnableToolLike = exports.isStructuredTool = exports.convertToOpenAITool = exports.convertToOpenAIFunction = void 0;
 const zod_to_json_schema_1 = require("zod-to-json-schema");
+const base_js_1 = require("../runnables/base.cjs");
 /**
- * Formats a `StructuredTool` instance into a format that is compatible
- * with OpenAI function calling. It uses the `zodToJsonSchema`
- * function to convert the schema of the `StructuredTool` into a JSON
- * schema, which is then used as the parameters for the OpenAI function.
+ * Formats a `StructuredTool` or `RunnableToolLike` instance into a format
+ * that is compatible with OpenAI function calling. It uses the `zodToJsonSchema`
+ * function to convert the schema of the `StructuredTool` or `RunnableToolLike`
+ * into a JSON schema, which is then used as the parameters for the OpenAI function.
+ *
+ * @param {StructuredToolInterface | RunnableToolLike} tool The tool to convert to an OpenAI function.
+ * @returns {FunctionDefinition} The inputted tool in OpenAI function format.
  */
 function convertToOpenAIFunction(tool) {
     return {
@@ -17,15 +21,19 @@ function convertToOpenAIFunction(tool) {
 }
 exports.convertToOpenAIFunction = convertToOpenAIFunction;
 /**
- * Formats a `StructuredTool` instance into a format that is compatible
- * with OpenAI tool calling. It uses the `zodToJsonSchema`
- * function to convert the schema of the `StructuredTool` into a JSON
- * schema, which is then used as the parameters for the OpenAI tool.
+ * Formats a `StructuredTool` or `RunnableToolLike` instance into a
+ * format that is compatible with OpenAI tool calling. It uses the
+ * `zodToJsonSchema` function to convert the schema of the `StructuredTool`
+ * or `RunnableToolLike` into a JSON schema, which is then used as the
+ * parameters for the OpenAI tool.
+ *
+ * @param {StructuredToolInterface | Record<string, any> | RunnableToolLike} tool The tool to convert to an OpenAI tool.
+ * @returns {ToolDefinition} The inputted tool in OpenAI tool format.
  */
 function convertToOpenAITool(
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 tool) {
-    if (isStructuredTool(tool)) {
+    if (isStructuredTool(tool) || isRunnableToolLike(tool)) {
         return {
             type: "function",
             function: convertToOpenAIFunction(tool),
@@ -34,6 +42,12 @@ tool) {
     return tool;
 }
 exports.convertToOpenAITool = convertToOpenAITool;
+/**
+ * Confirm whether the inputted tool is an instance of `StructuredToolInterface`.
+ *
+ * @param {StructuredToolInterface | Record<string, any> | undefined} tool The tool to check if it is an instance of `StructuredToolInterface`.
+ * @returns {tool is StructuredToolInterface} Whether the inputted tool is an instance of `StructuredToolInterface`.
+ */
 function isStructuredTool(
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 tool) {
@@ -41,3 +55,17 @@ tool) {
         Array.isArray(tool.lc_namespace));
 }
 exports.isStructuredTool = isStructuredTool;
+/**
+ * Confirm whether the inputted tool is an instance of `RunnableToolLike`.
+ *
+ * @param {unknown | undefined} tool The tool to check if it is an instance of `RunnableToolLike`.
+ * @returns {tool is RunnableToolLike} Whether the inputted tool is an instance of `RunnableToolLike`.
+ */
+function isRunnableToolLike(tool) {
+    return (tool !== undefined &&
+        base_js_1.Runnable.isRunnable(tool) &&
+        "lc_name" in tool.constructor &&
+        typeof tool.constructor.lc_name === "function" &&
+        tool.constructor.lc_name() === "RunnableToolLike");
+}
+exports.isRunnableToolLike = isRunnableToolLike;

package/dist/utils/function_calling.d.ts

@@ -1,17 +1,38 @@
-import { StructuredToolInterface } from "../tools.js";
+import { StructuredToolInterface } from "../tools/index.js";
 import { FunctionDefinition, ToolDefinition } from "../language_models/base.js";
+import { RunnableToolLike } from "../runnables/base.js";
 /**
- * Formats a `StructuredTool` instance into a format that is compatible
- * with OpenAI function calling. It uses the `zodToJsonSchema`
- * function to convert the schema of the `StructuredTool` into a JSON
- * schema, which is then used as the parameters for the OpenAI function.
+ * Formats a `StructuredTool` or `RunnableToolLike` instance into a format
+ * that is compatible with OpenAI function calling. It uses the `zodToJsonSchema`
+ * function to convert the schema of the `StructuredTool` or `RunnableToolLike`
+ * into a JSON schema, which is then used as the parameters for the OpenAI function.
+ *
+ * @param {StructuredToolInterface | RunnableToolLike} tool The tool to convert to an OpenAI function.
+ * @returns {FunctionDefinition} The inputted tool in OpenAI function format.
  */
-export declare function convertToOpenAIFunction(tool: StructuredToolInterface): FunctionDefinition;
+export declare function convertToOpenAIFunction(tool: StructuredToolInterface | RunnableToolLike): FunctionDefinition;
 /**
- * Formats a `StructuredTool` instance into a format that is compatible
- * with OpenAI tool calling. It uses the `zodToJsonSchema`
- * function to convert the schema of the `StructuredTool` into a JSON
- * schema, which is then used as the parameters for the OpenAI tool.
+ * Formats a `StructuredTool` or `RunnableToolLike` instance into a
+ * format that is compatible with OpenAI tool calling. It uses the
+ * `zodToJsonSchema` function to convert the schema of the `StructuredTool`
+ * or `RunnableToolLike` into a JSON schema, which is then used as the
+ * parameters for the OpenAI tool.
+ *
+ * @param {StructuredToolInterface | Record<string, any> | RunnableToolLike} tool The tool to convert to an OpenAI tool.
+ * @returns {ToolDefinition} The inputted tool in OpenAI tool format.
+ */
+export declare function convertToOpenAITool(tool: StructuredToolInterface | Record<string, any> | RunnableToolLike): ToolDefinition;
+/**
+ * Confirm whether the inputted tool is an instance of `StructuredToolInterface`.
+ *
+ * @param {StructuredToolInterface | Record<string, any> | undefined} tool The tool to check if it is an instance of `StructuredToolInterface`.
+ * @returns {tool is StructuredToolInterface} Whether the inputted tool is an instance of `StructuredToolInterface`.
  */
-export declare function convertToOpenAITool(tool: StructuredToolInterface | Record<string, any>): ToolDefinition;
 export declare function isStructuredTool(tool?: StructuredToolInterface | Record<string, any>): tool is StructuredToolInterface;
+/**
+ * Confirm whether the inputted tool is an instance of `RunnableToolLike`.
+ *
+ * @param {unknown | undefined} tool The tool to check if it is an instance of `RunnableToolLike`.
+ * @returns {tool is RunnableToolLike} Whether the inputted tool is an instance of `RunnableToolLike`.
+ */
+export declare function isRunnableToolLike(tool?: unknown): tool is RunnableToolLike;

package/dist/utils/function_calling.js

@@ -1,9 +1,13 @@
 import { zodToJsonSchema } from "zod-to-json-schema";
+import { Runnable } from "../runnables/base.js";
 /**
- * Formats a `StructuredTool` instance into a format that is compatible
- * with OpenAI function calling. It uses the `zodToJsonSchema`
- * function to convert the schema of the `StructuredTool` into a JSON
- * schema, which is then used as the parameters for the OpenAI function.
+ * Formats a `StructuredTool` or `RunnableToolLike` instance into a format
+ * that is compatible with OpenAI function calling. It uses the `zodToJsonSchema`
+ * function to convert the schema of the `StructuredTool` or `RunnableToolLike`
+ * into a JSON schema, which is then used as the parameters for the OpenAI function.
+ *
+ * @param {StructuredToolInterface | RunnableToolLike} tool The tool to convert to an OpenAI function.
+ * @returns {FunctionDefinition} The inputted tool in OpenAI function format.
  */
 export function convertToOpenAIFunction(tool) {
     return {
@@ -13,15 +17,19 @@ export function convertToOpenAIFunction(tool) {
     };
 }
 /**
- * Formats a `StructuredTool` instance into a format that is compatible
- * with OpenAI tool calling. It uses the `zodToJsonSchema`
- * function to convert the schema of the `StructuredTool` into a JSON
- * schema, which is then used as the parameters for the OpenAI tool.
+ * Formats a `StructuredTool` or `RunnableToolLike` instance into a
+ * format that is compatible with OpenAI tool calling. It uses the
+ * `zodToJsonSchema` function to convert the schema of the `StructuredTool`
+ * or `RunnableToolLike` into a JSON schema, which is then used as the
+ * parameters for the OpenAI tool.
+ *
+ * @param {StructuredToolInterface | Record<string, any> | RunnableToolLike} tool The tool to convert to an OpenAI tool.
+ * @returns {ToolDefinition} The inputted tool in OpenAI tool format.
  */
 export function convertToOpenAITool(
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 tool) {
-    if (isStructuredTool(tool)) {
+    if (isStructuredTool(tool) || isRunnableToolLike(tool)) {
         return {
             type: "function",
             function: convertToOpenAIFunction(tool),
@@ -29,9 +37,28 @@ tool) {
     }
     return tool;
 }
+/**
+ * Confirm whether the inputted tool is an instance of `StructuredToolInterface`.
+ *
+ * @param {StructuredToolInterface | Record<string, any> | undefined} tool The tool to check if it is an instance of `StructuredToolInterface`.
+ * @returns {tool is StructuredToolInterface} Whether the inputted tool is an instance of `StructuredToolInterface`.
+ */
 export function isStructuredTool(
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 tool) {
     return (tool !== undefined &&
         Array.isArray(tool.lc_namespace));
 }
+/**
+ * Confirm whether the inputted tool is an instance of `RunnableToolLike`.
+ *
+ * @param {unknown | undefined} tool The tool to check if it is an instance of `RunnableToolLike`.
+ * @returns {tool is RunnableToolLike} Whether the inputted tool is an instance of `RunnableToolLike`.
+ */
+export function isRunnableToolLike(tool) {
+    return (tool !== undefined &&
+        Runnable.isRunnable(tool) &&
+        "lc_name" in tool.constructor &&
+        typeof tool.constructor.lc_name === "function" &&
+        tool.constructor.lc_name() === "RunnableToolLike");
+}

package/dist/utils/testing/index.cjs

@@ -13,7 +13,7 @@ const base_js_1 = require("../../output_parsers/base.cjs");
 const outputs_js_1 = require("../../outputs.cjs");
 const index_js_2 = require("../../retrievers/index.cjs");
 const base_js_2 = require("../../runnables/base.cjs");
-const tools_js_1 = require("../../tools.cjs");
+const index_js_3 = require("../../tools/index.cjs");
 const base_js_3 = require("../../tracers/base.cjs");
 const embeddings_js_1 = require("../../embeddings.cjs");
 /**
@@ -162,7 +162,14 @@ class FakeChatModel extends chat_models_js_1.BaseChatModel {
                 ],
             };
         }
-        const text = messages.map((m) => m.content).join("\n");
+        const text = messages
+            .map((m) => {
+            if (typeof m.content === "string") {
+                return m.content;
+            }
+            return JSON.stringify(m.content, null, 2);
+        })
+            .join("\n");
         await runManager?.handleLLMNewToken(text);
         return {
             generations: [
@@ -475,7 +482,7 @@ class FakeTracer extends base_js_3.BaseTracer {
     }
 }
 exports.FakeTracer = FakeTracer;
-class FakeTool extends tools_js_1.StructuredTool {
+class FakeTool extends index_js_3.StructuredTool {
     constructor(fields) {
         super(fields);
         Object.defineProperty(this, "name", {

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

@@ -9,7 +9,7 @@ import { BaseOutputParser } from "../../output_parsers/base.js";
 import { GenerationChunk, type ChatResult, ChatGenerationChunk } from "../../outputs.js";
 import { BaseRetriever } from "../../retrievers/index.js";
 import { Runnable } from "../../runnables/base.js";
-import { StructuredTool, ToolParams } from "../../tools.js";
+import { StructuredTool, ToolParams } from "../../tools/index.js";
 import { BaseTracer, Run } from "../../tracers/base.js";
 import { Embeddings, EmbeddingsParams } from "../../embeddings.js";
 import { StructuredOutputMethodParams, BaseLanguageModelInput, StructuredOutputMethodOptions } from "../../language_models/base.js";

package/dist/utils/testing/index.js

@@ -10,7 +10,7 @@ import { BaseOutputParser } from "../../output_parsers/base.js";
 import { ChatGenerationChunk, } from "../../outputs.js";
 import { BaseRetriever } from "../../retrievers/index.js";
 import { Runnable, RunnableLambda } from "../../runnables/base.js";
-import { StructuredTool } from "../../tools.js";
+import { StructuredTool } from "../../tools/index.js";
 import { BaseTracer } from "../../tracers/base.js";
 import { Embeddings } from "../../embeddings.js";
 /**
@@ -155,7 +155,14 @@ export class FakeChatModel extends BaseChatModel {
                 ],
             };
         }
-        const text = messages.map((m) => m.content).join("\n");
+        const text = messages
+            .map((m) => {
+            if (typeof m.content === "string") {
+                return m.content;
+            }
+            return JSON.stringify(m.content, null, 2);
+        })
+            .join("\n");
         await runManager?.handleLLMNewToken(text);
         return {
             generations: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/core",
-  "version": "0.2.14",
+  "version": "0.2.16",
   "description": "Core LangChain.js abstractions and schemas",
   "type": "module",
   "engines": {
@@ -74,6 +74,7 @@
     "prettier": "^2.8.3",
     "release-it": "^15.10.1",
     "rimraf": "^5.0.1",
+    "ts-jest": "^29.1.0",
     "typescript": "~5.1.6",
     "web-streams-polyfill": "^3.3.3"
   },
@@ -122,6 +123,24 @@
       "import": "./callbacks/base.js",
       "require": "./callbacks/base.cjs"
     },
+    "./callbacks/dispatch": {
+      "types": {
+        "import": "./callbacks/dispatch.d.ts",
+        "require": "./callbacks/dispatch.d.cts",
+        "default": "./callbacks/dispatch.d.ts"
+      },
+      "import": "./callbacks/dispatch.js",
+      "require": "./callbacks/dispatch.cjs"
+    },
+    "./callbacks/dispatch/web": {
+      "types": {
+        "import": "./callbacks/dispatch/web.d.ts",
+        "require": "./callbacks/dispatch/web.d.cts",
+        "default": "./callbacks/dispatch/web.d.ts"
+      },
+      "import": "./callbacks/dispatch/web.js",
+      "require": "./callbacks/dispatch/web.cjs"
+    },
     "./callbacks/manager": {
       "types": {
         "import": "./callbacks/manager.d.ts",
@@ -473,15 +492,6 @@
       "import": "./utils/async_caller.js",
       "require": "./utils/async_caller.cjs"
     },
-    "./utils/beta_warning": {
-      "types": {
-        "import": "./utils/beta_warning.d.ts",
-        "require": "./utils/beta_warning.d.cts",
-        "default": "./utils/beta_warning.d.ts"
-      },
-      "import": "./utils/beta_warning.js",
-      "require": "./utils/beta_warning.cjs"
-    },
     "./utils/chunk_array": {
       "types": {
         "import": "./utils/chunk_array.d.ts",
@@ -615,6 +625,14 @@
     "callbacks/base.js",
     "callbacks/base.d.ts",
     "callbacks/base.d.cts",
+    "callbacks/dispatch.cjs",
+    "callbacks/dispatch.js",
+    "callbacks/dispatch.d.ts",
+    "callbacks/dispatch.d.cts",
+    "callbacks/dispatch/web.cjs",
+    "callbacks/dispatch/web.js",
+    "callbacks/dispatch/web.d.ts",
+    "callbacks/dispatch/web.d.cts",
     "callbacks/manager.cjs",
     "callbacks/manager.js",
     "callbacks/manager.d.ts",
@@ -771,10 +789,6 @@
     "utils/async_caller.js",
     "utils/async_caller.d.ts",
     "utils/async_caller.d.cts",
-    "utils/beta_warning.cjs",
-    "utils/beta_warning.js",
-    "utils/beta_warning.d.ts",
-    "utils/beta_warning.d.cts",
     "utils/chunk_array.cjs",
     "utils/chunk_array.js",
     "utils/chunk_array.d.ts",

package/tools.cjs

@@ -1 +1 @@
-module.exports = require('./dist/tools.cjs');
+module.exports = require('./dist/tools/index.cjs');

package/tools.d.cts

@@ -1 +1 @@
-export * from './dist/tools.js'
+export * from './dist/tools/index.js'

package/tools.d.ts

@@ -1 +1 @@
-export * from './dist/tools.js'
+export * from './dist/tools/index.js'

package/tools.js

@@ -1 +1 @@
-export * from './dist/tools.js'
+export * from './dist/tools/index.js'

package/dist/utils/beta_warning.cjs

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.betaWarning = void 0;
-/**
- * Util function for logging a warning when a method is called.
- * @param {string} func The name of the function that is in beta.
- */
-function betaWarning(func) {
-    console.warn(`The function '${func}' is in beta. It is actively being worked on, so the API may change.`);
-}
-exports.betaWarning = betaWarning;

package/dist/utils/beta_warning.d.ts

@@ -1,5 +0,0 @@
-/**
- * Util function for logging a warning when a method is called.
- * @param {string} func The name of the function that is in beta.
- */
-export declare function betaWarning(func: string): void;

package/dist/utils/beta_warning.js

@@ -1,7 +0,0 @@
-/**
- * Util function for logging a warning when a method is called.
- * @param {string} func The name of the function that is in beta.
- */
-export function betaWarning(func) {
-    console.warn(`The function '${func}' is in beta. It is actively being worked on, so the API may change.`);
-}

package/utils/beta_warning.cjs

@@ -1 +0,0 @@
-module.exports = require('../dist/utils/beta_warning.cjs');

package/utils/beta_warning.d.cts

@@ -1 +0,0 @@
-export * from '../dist/utils/beta_warning.js'

package/utils/beta_warning.d.ts

@@ -1 +0,0 @@
-export * from '../dist/utils/beta_warning.js'

package/utils/beta_warning.js

@@ -1 +0,0 @@
-export * from '../dist/utils/beta_warning.js'