@langchain/core 0.1.12 → 0.1.14

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

@@ -147,15 +147,15 @@ export declare abstract class Runnable<RunInput = any, RunOutput = any, CallOpti
      * @param coerceable A runnable, function, or object whose values are functions or runnables.
      * @returns A new runnable sequence.
      */
-    pipe<NewRunOutput>(coerceable: RunnableLike<RunOutput, NewRunOutput>): RunnableSequence<RunInput, Exclude<NewRunOutput, Error>>;
+    pipe<NewRunOutput>(coerceable: RunnableLike<RunOutput, NewRunOutput>): Runnable<RunInput, Exclude<NewRunOutput, Error>>;
     /**
      * Pick keys from the dict output of this runnable. Returns a new runnable.
      */
-    pick(keys: string | string[]): RunnableSequence;
+    pick(keys: string | string[]): Runnable;
     /**
      * Assigns new fields to the dict output of this runnable. Returns a new runnable.
      */
-    assign(mapping: RunnableMapLike<Record<string, unknown>, Record<string, unknown>>): RunnableSequence;
+    assign(mapping: RunnableMapLike<Record<string, unknown>, Record<string, unknown>>): Runnable;
     /**
      * Default implementation of transform, which buffers input and then calls stream.
      * Subclasses should override this method if they can start producing output while
@@ -357,7 +357,7 @@ export declare class RunnableSequence<RunInput = any, RunOutput = any> extends R
         last: Runnable<any, RunOutput>;
         name?: string;
     });
-    get steps(): Runnable<RunInput, any, RunnableConfig>[];
+    get steps(): Runnable<any, any, RunnableConfig>[];
     invoke(input: RunInput, options?: RunnableConfig): Promise<RunOutput>;
     batch(inputs: RunInput[], options?: Partial<RunnableConfig> | Partial<RunnableConfig>[], batchOptions?: RunnableBatchOptions & {
         returnExceptions?: false;

package/dist/runnables/passthrough.cjs

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RunnablePassthrough = void 0;
+const stream_js_1 = require("../utils/stream.cjs");
 const base_js_1 = require("./base.cjs");
 /**
  * A runnable to passthrough inputs unchanged or with additional keys.
@@ -29,8 +30,11 @@ const base_js_1 = require("./base.cjs");
  * ```
  */
 class RunnablePassthrough extends base_js_1.Runnable {
-    constructor() {
-        super(...arguments);
+    static lc_name() {
+        return "RunnablePassthrough";
+    }
+    constructor(fields) {
+        super(fields);
         Object.defineProperty(this, "lc_namespace", {
             enumerable: true,
             configurable: true,
@@ -43,15 +47,46 @@ class RunnablePassthrough extends base_js_1.Runnable {
             writable: true,
             value: true
         });
-    }
-    static lc_name() {
-        return "RunnablePassthrough";
+        Object.defineProperty(this, "func", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        if (fields) {
+            this.func = fields.func;
+        }
     }
     async invoke(input, options) {
+        if (this.func) {
+            await this.func(input, options);
+        }
         return this._callWithConfig((input) => Promise.resolve(input), input, options);
     }
-    transform(generator, options) {
-        return this._transformStreamWithConfig(generator, (input) => input, options);
+    async *transform(generator, options) {
+        let finalOutput;
+        let finalOutputSupported = true;
+        for await (const chunk of this._transformStreamWithConfig(generator, (input) => input, options)) {
+            yield chunk;
+            if (finalOutputSupported) {
+                if (finalOutput === undefined) {
+                    finalOutput = chunk;
+                }
+                else {
+                    try {
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        finalOutput = (0, stream_js_1.concat)(finalOutput, chunk);
+                    }
+                    catch {
+                        finalOutput = undefined;
+                        finalOutputSupported = false;
+                    }
+                }
+            }
+        }
+        if (this.func && finalOutput !== undefined) {
+            await this.func(finalOutput, options);
+        }
     }
     /**
      * A runnable that assigns key-value pairs to the input.

package/dist/runnables/passthrough.d.ts

@@ -1,5 +1,6 @@
 import { Runnable, RunnableAssign, RunnableMapLike } from "./base.js";
 import type { RunnableConfig } from "./config.js";
+type RunnablePassthroughFunc<RunInput = any> = ((input: RunInput) => void) | ((input: RunInput, config?: RunnableConfig) => void) | ((input: RunInput) => Promise<void>) | ((input: RunInput, config?: RunnableConfig) => Promise<void>);
 /**
  * A runnable to passthrough inputs unchanged or with additional keys.
  *
@@ -30,6 +31,10 @@ export declare class RunnablePassthrough<RunInput> extends Runnable<RunInput, Ru
     static lc_name(): string;
     lc_namespace: string[];
     lc_serializable: boolean;
+    func?: RunnablePassthroughFunc<RunInput>;
+    constructor(fields?: {
+        func?: RunnablePassthroughFunc<RunInput>;
+    });
     invoke(input: RunInput, options?: Partial<RunnableConfig>): Promise<RunInput>;
     transform(generator: AsyncGenerator<RunInput>, options: Partial<RunnableConfig>): AsyncGenerator<RunInput>;
     /**
@@ -62,3 +67,4 @@ export declare class RunnablePassthrough<RunInput> extends Runnable<RunInput, Ru
      */
     static assign<RunInput extends Record<string, unknown>, RunOutput extends Record<string, unknown>>(mapping: RunnableMapLike<RunInput, RunOutput>): RunnableAssign<RunInput, RunInput & RunOutput>;
 }
+export {};

package/dist/runnables/passthrough.js

@@ -1,3 +1,4 @@
+import { concat } from "../utils/stream.js";
 import { Runnable, RunnableAssign, RunnableMap, } from "./base.js";
 /**
  * A runnable to passthrough inputs unchanged or with additional keys.
@@ -26,8 +27,11 @@ import { Runnable, RunnableAssign, RunnableMap, } from "./base.js";
  * ```
  */
 export class RunnablePassthrough extends Runnable {
-    constructor() {
-        super(...arguments);
+    static lc_name() {
+        return "RunnablePassthrough";
+    }
+    constructor(fields) {
+        super(fields);
         Object.defineProperty(this, "lc_namespace", {
             enumerable: true,
             configurable: true,
@@ -40,15 +44,46 @@ export class RunnablePassthrough extends Runnable {
             writable: true,
             value: true
         });
-    }
-    static lc_name() {
-        return "RunnablePassthrough";
+        Object.defineProperty(this, "func", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        if (fields) {
+            this.func = fields.func;
+        }
     }
     async invoke(input, options) {
+        if (this.func) {
+            await this.func(input, options);
+        }
         return this._callWithConfig((input) => Promise.resolve(input), input, options);
     }
-    transform(generator, options) {
-        return this._transformStreamWithConfig(generator, (input) => input, options);
+    async *transform(generator, options) {
+        let finalOutput;
+        let finalOutputSupported = true;
+        for await (const chunk of this._transformStreamWithConfig(generator, (input) => input, options)) {
+            yield chunk;
+            if (finalOutputSupported) {
+                if (finalOutput === undefined) {
+                    finalOutput = chunk;
+                }
+                else {
+                    try {
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        finalOutput = concat(finalOutput, chunk);
+                    }
+                    catch {
+                        finalOutput = undefined;
+                        finalOutputSupported = false;
+                    }
+                }
+            }
+        }
+        if (this.func && finalOutput !== undefined) {
+            await this.func(finalOutput, options);
+        }
     }
     /**
      * A runnable that assigns key-value pairs to the input.

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.14",
   "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'