@langchain/core 0.1.12 → 0.1.13

package/dist/language_models/base.d.ts

@@ -93,6 +93,10 @@ export interface FunctionDefinition {
      */
     description?: string;
 }
+export interface ToolDefinition {
+    type: "function";
+    function: FunctionDefinition;
+}
 export type FunctionCallOption = {
     name: string;
 };

package/dist/load/import_map.cjs

@@ -24,7 +24,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.vectorstores = exports.utils__types = exports.utils__tiktoken = exports.utils__testing = exports.utils__stream = exports.utils__math = exports.utils__json_schema = exports.utils__json_patch = exports.utils__hash = exports.utils__env = exports.utils__chunk_array = exports.utils__async_caller = exports.tracers__tracer_langchain_v1 = exports.tracers__tracer_langchain = exports.tracers__run_collector = exports.tracers__log_stream = exports.tracers__initialize = exports.tracers__console = exports.tracers__base = exports.tools = exports.stores = exports.retrievers = exports.runnables = exports.prompt_values = exports.prompts = exports.outputs = exports.output_parsers = exports.messages = exports.memory = exports.load__serializable = exports.language_models__llms = exports.language_models__chat_models = exports.language_models__base = exports.example_selectors = exports.embeddings = exports.documents = exports.chat_history = exports.callbacks__promises = exports.callbacks__manager = exports.callbacks__base = exports.caches = exports.agents = void 0;
+exports.vectorstores = exports.utils__types = exports.utils__tiktoken = exports.utils__testing = exports.utils__stream = exports.utils__math = exports.utils__json_schema = exports.utils__json_patch = exports.utils__hash = exports.utils__function_calling = exports.utils__env = exports.utils__chunk_array = exports.utils__async_caller = exports.tracers__tracer_langchain_v1 = exports.tracers__tracer_langchain = exports.tracers__run_collector = exports.tracers__log_stream = exports.tracers__initialize = exports.tracers__console = exports.tracers__base = exports.tools = exports.stores = exports.retrievers = exports.runnables = exports.prompt_values = exports.prompts = exports.outputs = exports.output_parsers = exports.messages = exports.memory = exports.load__serializable = exports.language_models__llms = exports.language_models__chat_models = exports.language_models__base = exports.example_selectors = exports.embeddings = exports.documents = exports.chat_history = exports.callbacks__promises = exports.callbacks__manager = exports.callbacks__base = exports.caches = exports.agents = void 0;
 exports.agents = __importStar(require("../agents.cjs"));
 exports.caches = __importStar(require("../caches.cjs"));
 exports.callbacks__base = __importStar(require("../callbacks/base.cjs"));
@@ -58,6 +58,7 @@ exports.tracers__tracer_langchain_v1 = __importStar(require("../tracers/tracer_l
 exports.utils__async_caller = __importStar(require("../utils/async_caller.cjs"));
 exports.utils__chunk_array = __importStar(require("../utils/chunk_array.cjs"));
 exports.utils__env = __importStar(require("../utils/env.cjs"));
+exports.utils__function_calling = __importStar(require("../utils/function_calling.cjs"));
 exports.utils__hash = __importStar(require("../utils/hash.cjs"));
 exports.utils__json_patch = __importStar(require("../utils/json_patch.cjs"));
 exports.utils__json_schema = __importStar(require("../utils/json_schema.cjs"));

package/dist/load/import_map.d.ts

@@ -31,6 +31,7 @@ export * as tracers__tracer_langchain_v1 from "../tracers/tracer_langchain_v1.js
 export * as utils__async_caller from "../utils/async_caller.js";
 export * as utils__chunk_array from "../utils/chunk_array.js";
 export * as utils__env from "../utils/env.js";
+export * as utils__function_calling from "../utils/function_calling.js";
 export * as utils__hash from "../utils/hash.js";
 export * as utils__json_patch from "../utils/json_patch.js";
 export * as utils__json_schema from "../utils/json_schema.js";

package/dist/load/import_map.js

@@ -32,6 +32,7 @@ export * as tracers__tracer_langchain_v1 from "../tracers/tracer_langchain_v1.js
 export * as utils__async_caller from "../utils/async_caller.js";
 export * as utils__chunk_array from "../utils/chunk_array.js";
 export * as utils__env from "../utils/env.js";
+export * as utils__function_calling from "../utils/function_calling.js";
 export * as utils__hash from "../utils/hash.js";
 export * as utils__json_patch from "../utils/json_patch.js";
 export * as utils__json_schema from "../utils/json_schema.js";

package/dist/tracers/base.cjs

@@ -218,7 +218,7 @@ class BaseTracer extends base_js_1.BaseCallbackHandler {
             throw new Error("No chain run to end.");
         }
         run.end_time = Date.now();
-        run.error = error.message;
+        run.error = error.message + (error.stack ? `\n\n${error.stack}` : "");
         run.events.push({
             name: "error",
             time: new Date(run.end_time).toISOString(),

package/dist/tracers/base.js

@@ -215,7 +215,7 @@ export class BaseTracer extends BaseCallbackHandler {
             throw new Error("No chain run to end.");
         }
         run.end_time = Date.now();
-        run.error = error.message;
+        run.error = error.message + (error.stack ? `\n\n${error.stack}` : "");
         run.events.push({
             name: "error",
             time: new Date(run.end_time).toISOString(),

package/dist/utils/function_calling.cjs

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertToOpenAITool = exports.convertToOpenAIFunction = void 0;
+const zod_to_json_schema_1 = require("zod-to-json-schema");
+/**
+ * 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.
+ */
+function convertToOpenAIFunction(tool) {
+    return {
+        name: tool.name,
+        description: tool.description,
+        parameters: (0, zod_to_json_schema_1.zodToJsonSchema)(tool.schema),
+    };
+}
+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.
+ */
+function convertToOpenAITool(tool) {
+    return {
+        type: "function",
+        function: convertToOpenAIFunction(tool),
+    };
+}
+exports.convertToOpenAITool = convertToOpenAITool;

package/dist/utils/function_calling.d.ts

@@ -0,0 +1,16 @@
+import { StructuredToolInterface } from "../tools.js";
+import { FunctionDefinition, ToolDefinition } from "../language_models/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.
+ */
+export declare function convertToOpenAIFunction(tool: StructuredToolInterface): 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.
+ */
+export declare function convertToOpenAITool(tool: StructuredToolInterface): ToolDefinition;

package/dist/utils/function_calling.js

@@ -0,0 +1,26 @@
+import { zodToJsonSchema } from "zod-to-json-schema";
+/**
+ * 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.
+ */
+export function convertToOpenAIFunction(tool) {
+    return {
+        name: tool.name,
+        description: tool.description,
+        parameters: zodToJsonSchema(tool.schema),
+    };
+}
+/**
+ * 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.
+ */
+export function convertToOpenAITool(tool) {
+    return {
+        type: "function",
+        function: convertToOpenAIFunction(tool),
+    };
+}

package/dist/utils/stream.d.ts

@@ -1,4 +1,4 @@
-export interface IterableReadableStreamInterface<T> extends ReadableStream<T>, AsyncGenerator<T> {
+export interface IterableReadableStreamInterface<T> extends ReadableStream<T>, AsyncIterable<T> {
 }
 export declare class IterableReadableStream<T> extends ReadableStream<T> implements IterableReadableStreamInterface<T> {
     reader: ReadableStreamDefaultReader<T>;

package/dist/utils/testing/index.cjs

@@ -1,8 +1,6 @@
 "use strict";
-/* eslint-disable no-promise-executor-return */
-/* eslint-disable @typescript-eslint/no-explicit-any */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FakeTracer = exports.FakeListChatMessageHistory = exports.FakeChatMessageHistory = exports.FakeListChatModel = exports.FakeRetriever = exports.FakeChatModel = exports.FakeStreamingLLM = exports.FakeLLM = exports.FakeRunnable = exports.FakeSplitIntoListParser = void 0;
+exports.FakeTool = exports.FakeTracer = exports.FakeListChatMessageHistory = exports.FakeChatMessageHistory = exports.FakeListChatModel = exports.FakeRetriever = exports.FakeChatModel = exports.FakeStreamingLLM = exports.FakeLLM = exports.FakeRunnable = exports.FakeSplitIntoListParser = void 0;
 const chat_history_js_1 = require("../../chat_history.cjs");
 const document_js_1 = require("../../documents/document.cjs");
 const chat_models_js_1 = require("../../language_models/chat_models.cjs");
@@ -12,6 +10,7 @@ const base_js_1 = require("../../output_parsers/base.cjs");
 const outputs_js_1 = require("../../outputs.cjs");
 const retrievers_js_1 = require("../../retrievers.cjs");
 const base_js_2 = require("../../runnables/base.cjs");
+const tools_js_1 = require("../../tools.cjs");
 const base_js_3 = require("../../tracers/base.cjs");
 /**
  * Parser for comma-separated values. It splits the input text by commas
@@ -366,3 +365,33 @@ class FakeTracer extends base_js_3.BaseTracer {
     }
 }
 exports.FakeTracer = FakeTracer;
+class FakeTool extends tools_js_1.StructuredTool {
+    constructor(fields) {
+        super(fields);
+        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;
+    }
+    async _call(arg, _runManager) {
+        return JSON.stringify(arg);
+    }
+}
+exports.FakeTool = FakeTool;

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

@@ -1,4 +1,5 @@
-import { BaseCallbackConfig, CallbackManagerForLLMRun } from "../../callbacks/manager.js";
+import { z } from "zod";
+import { BaseCallbackConfig, CallbackManagerForLLMRun, CallbackManagerForToolRun } from "../../callbacks/manager.js";
 import { BaseChatMessageHistory, BaseListChatMessageHistory } from "../../chat_history.js";
 import { Document } from "../../documents/document.js";
 import { BaseChatModel, BaseChatModelParams } from "../../language_models/chat_models.js";
@@ -8,6 +9,7 @@ import { BaseOutputParser } from "../../output_parsers/base.js";
 import { GenerationChunk, type ChatResult, ChatGenerationChunk } from "../../outputs.js";
 import { BaseRetriever } from "../../retrievers.js";
 import { Runnable } from "../../runnables/base.js";
+import { StructuredTool, ToolParams } from "../../tools.js";
 import { BaseTracer, Run } from "../../tracers/base.js";
 /**
  * Parser for comma-separated values. It splits the input text by commas
@@ -130,3 +132,15 @@ export declare class FakeTracer extends BaseTracer {
     constructor();
     protected persistRun(run: Run): Promise<void>;
 }
+export interface FakeToolParams<T extends z.ZodObject<any, any, any, any> = z.ZodObject<any, any, any, any>> extends ToolParams {
+    name: string;
+    description: string;
+    schema: T;
+}
+export declare class FakeTool<T extends z.ZodObject<any, any, any, any> = z.ZodObject<any, any, any, any>> extends StructuredTool<T> {
+    name: string;
+    description: string;
+    schema: T;
+    constructor(fields: FakeToolParams<T>);
+    protected _call(arg: z.output<T>, _runManager?: CallbackManagerForToolRun): Promise<string>;
+}

package/dist/utils/testing/index.js

@@ -1,5 +1,3 @@
-/* eslint-disable no-promise-executor-return */
-/* eslint-disable @typescript-eslint/no-explicit-any */
 import { BaseChatMessageHistory, BaseListChatMessageHistory, } from "../../chat_history.js";
 import { Document } from "../../documents/document.js";
 import { BaseChatModel, } from "../../language_models/chat_models.js";
@@ -9,6 +7,7 @@ import { BaseOutputParser } from "../../output_parsers/base.js";
 import { ChatGenerationChunk, } from "../../outputs.js";
 import { BaseRetriever } from "../../retrievers.js";
 import { Runnable } from "../../runnables/base.js";
+import { StructuredTool } from "../../tools.js";
 import { BaseTracer } from "../../tracers/base.js";
 /**
  * Parser for comma-separated values. It splits the input text by commas
@@ -353,3 +352,32 @@ export class FakeTracer extends BaseTracer {
         return Promise.resolve();
     }
 }
+export class FakeTool extends StructuredTool {
+    constructor(fields) {
+        super(fields);
+        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;
+    }
+    async _call(arg, _runManager) {
+        return JSON.stringify(arg);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/core",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "description": "Core LangChain.js abstractions and schemas",
   "type": "module",
   "engines": {
@@ -43,7 +43,8 @@
     "p-queue": "^6.6.2",
     "p-retry": "4",
     "uuid": "^9.0.0",
-    "zod": "^3.22.3"
+    "zod": "^3.22.3",
+    "zod-to-json-schema": "3.20.3"
   },
   "devDependencies": {
     "@jest/globals": "^29.5.0",
@@ -254,6 +255,11 @@
       "import": "./utils/env.js",
       "require": "./utils/env.cjs"
     },
+    "./utils/function_calling": {
+      "types": "./utils/function_calling.d.ts",
+      "import": "./utils/function_calling.js",
+      "require": "./utils/function_calling.cjs"
+    },
     "./utils/hash": {
       "types": "./utils/hash.d.ts",
       "import": "./utils/hash.js",
@@ -405,6 +411,9 @@
     "utils/env.cjs",
     "utils/env.js",
     "utils/env.d.ts",
+    "utils/function_calling.cjs",
+    "utils/function_calling.js",
+    "utils/function_calling.d.ts",
     "utils/hash.cjs",
     "utils/hash.js",
     "utils/hash.d.ts",

package/utils/function_calling.cjs

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

package/utils/function_calling.d.ts

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

package/utils/function_calling.js

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