@langchain/core 0.1.7 → 0.1.9-rc.0

package/dist/language_models/base.d.ts

@@ -105,7 +105,13 @@ export interface BaseLanguageModelInterface<RunOutput = any, CallOptions extends
     CallOptions: CallOptions;
     get callKeys(): string[];
     generatePrompt(promptValues: BasePromptValueInterface[], options?: string[] | CallOptions, callbacks?: Callbacks): Promise<LLMResult>;
+    /**
+     * @deprecated Use .invoke() instead. Will be removed in 0.2.0.
+     */
     predict(text: string, options?: string[] | CallOptions, callbacks?: Callbacks): Promise<string>;
+    /**
+     * @deprecated Use .invoke() instead. Will be removed in 0.2.0.
+     */
     predictMessages(messages: BaseMessage[], options?: string[] | CallOptions, callbacks?: Callbacks): Promise<BaseMessage>;
     _modelType(): string;
     _llmType(): string;
@@ -135,7 +141,13 @@ export declare abstract class BaseLanguageModel<RunOutput = any, CallOptions ext
     cache?: BaseCache;
     constructor({ callbacks, callbackManager, ...params }: BaseLanguageModelParams);
     abstract generatePrompt(promptValues: BasePromptValueInterface[], options?: string[] | CallOptions, callbacks?: Callbacks): Promise<LLMResult>;
+    /**
+     * @deprecated Use .invoke() instead. Will be removed in 0.2.0.
+     */
     abstract predict(text: string, options?: string[] | CallOptions, callbacks?: Callbacks): Promise<string>;
+    /**
+     * @deprecated Use .invoke() instead. Will be removed in 0.2.0.
+     */
     abstract predictMessages(messages: BaseMessage[], options?: string[] | CallOptions, callbacks?: Callbacks): Promise<BaseMessage>;
     abstract _modelType(): string;
     abstract _llmType(): string;
@@ -163,4 +175,13 @@ export declare abstract class BaseLanguageModel<RunOutput = any, CallOptions ext
      */
     static deserialize(_data: SerializedLLM): Promise<BaseLanguageModel>;
 }
+/**
+ * Shared interface for token usage
+ * return type from LLM calls.
+ */
+export interface TokenUsage {
+    completionTokens?: number;
+    promptTokens?: number;
+    totalTokens?: number;
+}
 export {};

package/dist/language_models/chat_models.cjs

@@ -286,6 +286,8 @@ class BaseChatModel extends base_js_1.BaseLanguageModel {
         return this.generate(promptMessages, options, callbacks);
     }
     /**
+     * @deprecated Use .invoke() instead. Will be removed in 0.2.0.
+     *
      * Makes a single call to the chat model.
      * @param messages An array of BaseMessage instances.
      * @param options The call options or an array of stop sequences.
@@ -298,6 +300,8 @@ class BaseChatModel extends base_js_1.BaseLanguageModel {
         return generations[0][0].message;
     }
     /**
+     * @deprecated Use .invoke() instead. Will be removed in 0.2.0.
+     *
      * Makes a single call to the chat model with a prompt value.
      * @param promptValue The value of the prompt.
      * @param options The call options or an array of stop sequences.
@@ -309,6 +313,8 @@ class BaseChatModel extends base_js_1.BaseLanguageModel {
         return this.call(promptMessages, options, callbacks);
     }
     /**
+     * @deprecated Use .invoke() instead. Will be removed in 0.2.0.
+     *
      * Predicts the next message based on the input messages.
      * @param messages An array of BaseMessage instances.
      * @param options The call options or an array of stop sequences.
@@ -319,6 +325,8 @@ class BaseChatModel extends base_js_1.BaseLanguageModel {
         return this.call(messages, options, callbacks);
     }
     /**
+     * @deprecated Use .invoke() instead. Will be removed in 0.2.0.
+     *
      * Predicts the next message based on a text input.
      * @param text The text input.
      * @param options The call options or an array of stop sequences.

package/dist/language_models/chat_models.d.ts

@@ -93,6 +93,8 @@ export declare abstract class BaseChatModel<CallOptions extends BaseChatModelCal
     generatePrompt(promptValues: BasePromptValueInterface[], options?: string[] | CallOptions, callbacks?: Callbacks): Promise<LLMResult>;
     abstract _generate(messages: BaseMessage[], options: this["ParsedCallOptions"], runManager?: CallbackManagerForLLMRun): Promise<ChatResult>;
     /**
+     * @deprecated Use .invoke() instead. Will be removed in 0.2.0.
+     *
      * Makes a single call to the chat model.
      * @param messages An array of BaseMessage instances.
      * @param options The call options or an array of stop sequences.
@@ -101,6 +103,8 @@ export declare abstract class BaseChatModel<CallOptions extends BaseChatModelCal
      */
     call(messages: BaseMessageLike[], options?: string[] | CallOptions, callbacks?: Callbacks): Promise<BaseMessage>;
     /**
+     * @deprecated Use .invoke() instead. Will be removed in 0.2.0.
+     *
      * Makes a single call to the chat model with a prompt value.
      * @param promptValue The value of the prompt.
      * @param options The call options or an array of stop sequences.
@@ -109,6 +113,8 @@ export declare abstract class BaseChatModel<CallOptions extends BaseChatModelCal
      */
     callPrompt(promptValue: BasePromptValueInterface, options?: string[] | CallOptions, callbacks?: Callbacks): Promise<BaseMessage>;
     /**
+     * @deprecated Use .invoke() instead. Will be removed in 0.2.0.
+     *
      * Predicts the next message based on the input messages.
      * @param messages An array of BaseMessage instances.
      * @param options The call options or an array of stop sequences.
@@ -117,6 +123,8 @@ export declare abstract class BaseChatModel<CallOptions extends BaseChatModelCal
      */
     predictMessages(messages: BaseMessage[], options?: string[] | CallOptions, callbacks?: Callbacks): Promise<BaseMessage>;
     /**
+     * @deprecated Use .invoke() instead. Will be removed in 0.2.0.
+     *
      * Predicts the next message based on a text input.
      * @param text The text input.
      * @param options The call options or an array of stop sequences.

package/dist/language_models/chat_models.js

@@ -282,6 +282,8 @@ export class BaseChatModel extends BaseLanguageModel {
         return this.generate(promptMessages, options, callbacks);
     }
     /**
+     * @deprecated Use .invoke() instead. Will be removed in 0.2.0.
+     *
      * Makes a single call to the chat model.
      * @param messages An array of BaseMessage instances.
      * @param options The call options or an array of stop sequences.
@@ -294,6 +296,8 @@ export class BaseChatModel extends BaseLanguageModel {
         return generations[0][0].message;
     }
     /**
+     * @deprecated Use .invoke() instead. Will be removed in 0.2.0.
+     *
      * Makes a single call to the chat model with a prompt value.
      * @param promptValue The value of the prompt.
      * @param options The call options or an array of stop sequences.
@@ -305,6 +309,8 @@ export class BaseChatModel extends BaseLanguageModel {
         return this.call(promptMessages, options, callbacks);
     }
     /**
+     * @deprecated Use .invoke() instead. Will be removed in 0.2.0.
+     *
      * Predicts the next message based on the input messages.
      * @param messages An array of BaseMessage instances.
      * @param options The call options or an array of stop sequences.
@@ -315,6 +321,8 @@ export class BaseChatModel extends BaseLanguageModel {
         return this.call(messages, options, callbacks);
     }
     /**
+     * @deprecated Use .invoke() instead. Will be removed in 0.2.0.
+     *
      * Predicts the next message based on a text input.
      * @param text The text input.
      * @param options The call options or an array of stop sequences.

package/dist/language_models/llms.cjs

@@ -6,7 +6,7 @@ const outputs_js_1 = require("../outputs.cjs");
 const manager_js_1 = require("../callbacks/manager.cjs");
 const base_js_1 = require("./base.cjs");
 /**
- * LLM Wrapper. Provides an {@link call} (an {@link generate}) function that takes in a prompt (or prompts) and returns a string.
+ * LLM Wrapper. Takes in a prompt (or prompts) and returns a string.
  */
 class BaseLLM extends base_js_1.BaseLanguageModel {
     constructor({ concurrency, ...rest }) {
@@ -252,6 +252,7 @@ class BaseLLM extends base_js_1.BaseLanguageModel {
         return { generations, llmOutput };
     }
     /**
+     * @deprecated Use .invoke() instead. Will be removed in 0.2.0.
      * Convenience wrapper for {@link generate} that takes in a single string prompt and returns a single string output.
      */
     async call(prompt, options, callbacks) {
@@ -259,6 +260,8 @@ class BaseLLM extends base_js_1.BaseLanguageModel {
         return generations[0][0].text;
     }
     /**
+     * @deprecated Use .invoke() instead. Will be removed in 0.2.0.
+     *
      * This method is similar to `call`, but it's used for making predictions
      * based on the input text.
      * @param text Input text for the prediction.
@@ -270,6 +273,8 @@ class BaseLLM extends base_js_1.BaseLanguageModel {
         return this.call(text, options, callbacks);
     }
     /**
+     * @deprecated Use .invoke() instead. Will be removed in 0.2.0.
+     *
      * This method takes a list of messages, options, and callbacks, and
      * returns a predicted message.
      * @param messages A list of messages for the prediction.

package/dist/language_models/llms.d.ts

@@ -25,7 +25,7 @@ interface LLMGenerateCachedParameters<T extends BaseLLM<CallOptions>, CallOption
     handledOptions: RunnableConfig;
 }
 /**
- * LLM Wrapper. Provides an {@link call} (an {@link generate}) function that takes in a prompt (or prompts) and returns a string.
+ * LLM Wrapper. Takes in a prompt (or prompts) and returns a string.
  */
 export declare abstract class BaseLLM<CallOptions extends BaseLLMCallOptions = BaseLLMCallOptions> extends BaseLanguageModel<string, CallOptions> {
     ParsedCallOptions: Omit<CallOptions, keyof RunnableConfig & "timeout">;
@@ -71,10 +71,13 @@ export declare abstract class BaseLLM<CallOptions extends BaseLLMCallOptions = B
      */
     generate(prompts: string[], options?: string[] | CallOptions, callbacks?: Callbacks): Promise<LLMResult>;
     /**
+     * @deprecated Use .invoke() instead. Will be removed in 0.2.0.
      * Convenience wrapper for {@link generate} that takes in a single string prompt and returns a single string output.
      */
     call(prompt: string, options?: string[] | CallOptions, callbacks?: Callbacks): Promise<string>;
     /**
+     * @deprecated Use .invoke() instead. Will be removed in 0.2.0.
+     *
      * This method is similar to `call`, but it's used for making predictions
      * based on the input text.
      * @param text Input text for the prediction.
@@ -84,6 +87,8 @@ export declare abstract class BaseLLM<CallOptions extends BaseLLMCallOptions = B
      */
     predict(text: string, options?: string[] | CallOptions, callbacks?: Callbacks): Promise<string>;
     /**
+     * @deprecated Use .invoke() instead. Will be removed in 0.2.0.
+     *
      * This method takes a list of messages, options, and callbacks, and
      * returns a predicted message.
      * @param messages A list of messages for the prediction.

package/dist/language_models/llms.js

@@ -3,7 +3,7 @@ import { RUN_KEY, GenerationChunk, } from "../outputs.js";
 import { CallbackManager, } from "../callbacks/manager.js";
 import { BaseLanguageModel, } from "./base.js";
 /**
- * LLM Wrapper. Provides an {@link call} (an {@link generate}) function that takes in a prompt (or prompts) and returns a string.
+ * LLM Wrapper. Takes in a prompt (or prompts) and returns a string.
  */
 export class BaseLLM extends BaseLanguageModel {
     constructor({ concurrency, ...rest }) {
@@ -249,6 +249,7 @@ export class BaseLLM extends BaseLanguageModel {
         return { generations, llmOutput };
     }
     /**
+     * @deprecated Use .invoke() instead. Will be removed in 0.2.0.
      * Convenience wrapper for {@link generate} that takes in a single string prompt and returns a single string output.
      */
     async call(prompt, options, callbacks) {
@@ -256,6 +257,8 @@ export class BaseLLM extends BaseLanguageModel {
         return generations[0][0].text;
     }
     /**
+     * @deprecated Use .invoke() instead. Will be removed in 0.2.0.
+     *
      * This method is similar to `call`, but it's used for making predictions
      * based on the input text.
      * @param text Input text for the prediction.
@@ -267,6 +270,8 @@ export class BaseLLM extends BaseLanguageModel {
         return this.call(text, options, callbacks);
     }
     /**
+     * @deprecated Use .invoke() instead. Will be removed in 0.2.0.
+     *
      * This method takes a list of messages, options, and callbacks, and
      * returns a predicted message.
      * @param messages A list of messages for the prediction.

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 = 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__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"));
@@ -54,6 +54,7 @@ exports.tracers__initialize = __importStar(require("../tracers/initialize.cjs"))
 exports.tracers__log_stream = __importStar(require("../tracers/log_stream.cjs"));
 exports.tracers__run_collector = __importStar(require("../tracers/run_collector.cjs"));
 exports.tracers__tracer_langchain = __importStar(require("../tracers/tracer_langchain.cjs"));
+exports.tracers__tracer_langchain_v1 = __importStar(require("../tracers/tracer_langchain_v1.cjs"));
 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"));

package/dist/load/import_map.d.ts

@@ -27,6 +27,7 @@ export * as tracers__initialize from "../tracers/initialize.js";
 export * as tracers__log_stream from "../tracers/log_stream.js";
 export * as tracers__run_collector from "../tracers/run_collector.js";
 export * as tracers__tracer_langchain from "../tracers/tracer_langchain.js";
+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";

package/dist/load/import_map.js

@@ -28,6 +28,7 @@ export * as tracers__initialize from "../tracers/initialize.js";
 export * as tracers__log_stream from "../tracers/log_stream.js";
 export * as tracers__run_collector from "../tracers/run_collector.js";
 export * as tracers__tracer_langchain from "../tracers/tracer_langchain.js";
+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";

package/dist/runnables/branch.cjs

@@ -84,7 +84,7 @@ class RunnableBranch extends base_js_1.Runnable {
      *
      * @example
      * ```ts
-     * import { RunnableBranch } from "langchain/schema/runnable";
+     * import { RunnableBranch } from "@langchain/core/runnables";
      *
      * const branch = RunnableBranch.from([
      *   [(x: number) => x > 0, (x: number) => x + 1],

package/dist/runnables/branch.d.ts

@@ -73,7 +73,7 @@ export declare class RunnableBranch<RunInput = any, RunOutput = any> extends Run
      *
      * @example
      * ```ts
-     * import { RunnableBranch } from "langchain/schema/runnable";
+     * import { RunnableBranch } from "@langchain/core/runnables";
      *
      * const branch = RunnableBranch.from([
      *   [(x: number) => x > 0, (x: number) => x + 1],

package/dist/runnables/branch.js

@@ -81,7 +81,7 @@ export class RunnableBranch extends Runnable {
      *
      * @example
      * ```ts
-     * import { RunnableBranch } from "langchain/schema/runnable";
+     * import { RunnableBranch } from "@langchain/core/runnables";
      *
      * const branch = RunnableBranch.from([
      *   [(x: number) => x > 0, (x: number) => x + 1],

package/dist/runnables/history.cjs

@@ -4,6 +4,70 @@ exports.RunnableWithMessageHistory = void 0;
 const index_js_1 = require("../messages/index.cjs");
 const base_js_1 = require("./base.cjs");
 const passthrough_js_1 = require("./passthrough.cjs");
+/**
+ * Wraps a LCEL chain and manages history. It appends input messages
+ * and chain outputs as history, and adds the current history messages to
+ * the chain input.
+ * @example
+ * ```typescript
+ * // yarn add @langchain/anthropic @langchain/community @upstash/redis
+ *
+ * import {
+ *   ChatPromptTemplate,
+ *   MessagesPlaceholder,
+ * } from "@langchain/core/prompts";
+ * import { ChatAnthropic } from "@langchain/anthropic";
+ * import { UpstashRedisChatMessageHistory } from "@langchain/community/stores/message/upstash_redis";
+ * // For demos, you can also use an in-memory store:
+ * // import { ChatMessageHistory } from "langchain/stores/message/in_memory";
+ *
+ * const prompt = ChatPromptTemplate.fromMessages([
+ *   ["system", "You're an assistant who's good at {ability}"],
+ *   new MessagesPlaceholder("history"),
+ *   ["human", "{question}"],
+ * ]);
+ *
+ * const chain = prompt.pipe(new ChatAnthropic({}));
+ *
+ * const chainWithHistory = new RunnableWithMessageHistory({
+ *   runnable: chain,
+ *   getMessageHistory: (sessionId) =>
+ *     new UpstashRedisChatMessageHistory({
+ *       sessionId,
+ *       config: {
+ *         url: process.env.UPSTASH_REDIS_REST_URL!,
+ *         token: process.env.UPSTASH_REDIS_REST_TOKEN!,
+ *       },
+ *     }),
+ *   inputMessagesKey: "question",
+ *   historyMessagesKey: "history",
+ * });
+ *
+ * const result = await chainWithHistory.invoke(
+ *   {
+ *     ability: "math",
+ *     question: "What does cosine mean?",
+ *   },
+ *   {
+ *     configurable: {
+ *       sessionId: "some_string_identifying_a_user",
+ *     },
+ *   }
+ * );
+ *
+ * const result2 = await chainWithHistory.invoke(
+ *   {
+ *     ability: "math",
+ *     question: "What's its inverse?",
+ *   },
+ *   {
+ *     configurable: {
+ *       sessionId: "some_string_identifying_a_user",
+ *     },
+ *   }
+ * );
+ * ```
+ */
 class RunnableWithMessageHistory extends base_js_1.RunnableBinding {
     constructor(fields) {
         let historyChain = new base_js_1.RunnableLambda({

package/dist/runnables/history.d.ts

@@ -12,6 +12,70 @@ export interface RunnableWithMessageHistoryInputs<RunInput, RunOutput> extends O
     historyMessagesKey?: string;
     config?: RunnableConfig;
 }
+/**
+ * Wraps a LCEL chain and manages history. It appends input messages
+ * and chain outputs as history, and adds the current history messages to
+ * the chain input.
+ * @example
+ * ```typescript
+ * // yarn add @langchain/anthropic @langchain/community @upstash/redis
+ *
+ * import {
+ *   ChatPromptTemplate,
+ *   MessagesPlaceholder,
+ * } from "@langchain/core/prompts";
+ * import { ChatAnthropic } from "@langchain/anthropic";
+ * import { UpstashRedisChatMessageHistory } from "@langchain/community/stores/message/upstash_redis";
+ * // For demos, you can also use an in-memory store:
+ * // import { ChatMessageHistory } from "langchain/stores/message/in_memory";
+ *
+ * const prompt = ChatPromptTemplate.fromMessages([
+ *   ["system", "You're an assistant who's good at {ability}"],
+ *   new MessagesPlaceholder("history"),
+ *   ["human", "{question}"],
+ * ]);
+ *
+ * const chain = prompt.pipe(new ChatAnthropic({}));
+ *
+ * const chainWithHistory = new RunnableWithMessageHistory({
+ *   runnable: chain,
+ *   getMessageHistory: (sessionId) =>
+ *     new UpstashRedisChatMessageHistory({
+ *       sessionId,
+ *       config: {
+ *         url: process.env.UPSTASH_REDIS_REST_URL!,
+ *         token: process.env.UPSTASH_REDIS_REST_TOKEN!,
+ *       },
+ *     }),
+ *   inputMessagesKey: "question",
+ *   historyMessagesKey: "history",
+ * });
+ *
+ * const result = await chainWithHistory.invoke(
+ *   {
+ *     ability: "math",
+ *     question: "What does cosine mean?",
+ *   },
+ *   {
+ *     configurable: {
+ *       sessionId: "some_string_identifying_a_user",
+ *     },
+ *   }
+ * );
+ *
+ * const result2 = await chainWithHistory.invoke(
+ *   {
+ *     ability: "math",
+ *     question: "What's its inverse?",
+ *   },
+ *   {
+ *     configurable: {
+ *       sessionId: "some_string_identifying_a_user",
+ *     },
+ *   }
+ * );
+ * ```
+ */
 export declare class RunnableWithMessageHistory<RunInput, RunOutput> extends RunnableBinding<RunInput, RunOutput> {
     runnable: Runnable<RunInput, RunOutput>;
     inputMessagesKey?: string;

package/dist/runnables/history.js

@@ -1,6 +1,70 @@
 import { AIMessage, HumanMessage, isBaseMessage, } from "../messages/index.js";
 import { RunnableBinding, RunnableLambda, } from "./base.js";
 import { RunnablePassthrough } from "./passthrough.js";
+/**
+ * Wraps a LCEL chain and manages history. It appends input messages
+ * and chain outputs as history, and adds the current history messages to
+ * the chain input.
+ * @example
+ * ```typescript
+ * // yarn add @langchain/anthropic @langchain/community @upstash/redis
+ *
+ * import {
+ *   ChatPromptTemplate,
+ *   MessagesPlaceholder,
+ * } from "@langchain/core/prompts";
+ * import { ChatAnthropic } from "@langchain/anthropic";
+ * import { UpstashRedisChatMessageHistory } from "@langchain/community/stores/message/upstash_redis";
+ * // For demos, you can also use an in-memory store:
+ * // import { ChatMessageHistory } from "langchain/stores/message/in_memory";
+ *
+ * const prompt = ChatPromptTemplate.fromMessages([
+ *   ["system", "You're an assistant who's good at {ability}"],
+ *   new MessagesPlaceholder("history"),
+ *   ["human", "{question}"],
+ * ]);
+ *
+ * const chain = prompt.pipe(new ChatAnthropic({}));
+ *
+ * const chainWithHistory = new RunnableWithMessageHistory({
+ *   runnable: chain,
+ *   getMessageHistory: (sessionId) =>
+ *     new UpstashRedisChatMessageHistory({
+ *       sessionId,
+ *       config: {
+ *         url: process.env.UPSTASH_REDIS_REST_URL!,
+ *         token: process.env.UPSTASH_REDIS_REST_TOKEN!,
+ *       },
+ *     }),
+ *   inputMessagesKey: "question",
+ *   historyMessagesKey: "history",
+ * });
+ *
+ * const result = await chainWithHistory.invoke(
+ *   {
+ *     ability: "math",
+ *     question: "What does cosine mean?",
+ *   },
+ *   {
+ *     configurable: {
+ *       sessionId: "some_string_identifying_a_user",
+ *     },
+ *   }
+ * );
+ *
+ * const result2 = await chainWithHistory.invoke(
+ *   {
+ *     ability: "math",
+ *     question: "What's its inverse?",
+ *   },
+ *   {
+ *     configurable: {
+ *       sessionId: "some_string_identifying_a_user",
+ *     },
+ *   }
+ * );
+ * ```
+ */
 export class RunnableWithMessageHistory extends RunnableBinding {
     constructor(fields) {
         let historyChain = new RunnableLambda({

package/dist/runnables/passthrough.cjs

@@ -81,9 +81,7 @@ class RunnablePassthrough extends base_js_1.Runnable {
      * });
      * ```
      */
-    static assign(
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    mapping) {
+    static assign(mapping) {
         return new base_js_1.RunnableAssign(new base_js_1.RunnableMap({ steps: mapping }));
     }
 }

package/dist/runnables/passthrough.d.ts

@@ -60,5 +60,5 @@ export declare class RunnablePassthrough<RunInput> extends Runnable<RunInput, Ru
      * });
      * ```
      */
-    static assign(mapping: RunnableMapLike<Record<string, unknown>, Record<string, unknown>>): RunnableAssign<Record<string, unknown>, Record<string, unknown>>;
+    static assign<RunInput extends Record<string, unknown>, RunOutput extends Record<string, unknown>>(mapping: RunnableMapLike<RunInput, RunOutput>): RunnableAssign<RunInput, RunInput & RunOutput>;
 }

package/dist/runnables/passthrough.js

@@ -78,9 +78,7 @@ export class RunnablePassthrough extends Runnable {
      * });
      * ```
      */
-    static assign(
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    mapping) {
+    static assign(mapping) {
         return new RunnableAssign(new RunnableMap({ steps: mapping }));
     }
 }

package/dist/tracers/initialize.cjs

@@ -1,7 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getTracingV2CallbackHandler = void 0;
+exports.getTracingV2CallbackHandler = exports.getTracingCallbackHandler = void 0;
 const tracer_langchain_js_1 = require("./tracer_langchain.cjs");
+const tracer_langchain_v1_js_1 = require("./tracer_langchain_v1.cjs");
+/**
+ * @deprecated Use the V2 handler instead.
+ *
+ * Function that returns an instance of `LangChainTracerV1`. If a session
+ * is provided, it loads that session into the tracer; otherwise, it loads
+ * a default session.
+ * @param session Optional session to load into the tracer.
+ * @returns An instance of `LangChainTracerV1`.
+ */
+async function getTracingCallbackHandler(session) {
+    const tracer = new tracer_langchain_v1_js_1.LangChainTracerV1();
+    if (session) {
+        await tracer.loadSession(session);
+    }
+    else {
+        await tracer.loadDefaultSession();
+    }
+    return tracer;
+}
+exports.getTracingCallbackHandler = getTracingCallbackHandler;
 /**
  * Function that returns an instance of `LangChainTracer`. It does not
  * load any session data.

package/dist/tracers/initialize.d.ts

@@ -1,4 +1,15 @@
 import { LangChainTracer } from "./tracer_langchain.js";
+import { LangChainTracerV1 } from "./tracer_langchain_v1.js";
+/**
+ * @deprecated Use the V2 handler instead.
+ *
+ * Function that returns an instance of `LangChainTracerV1`. If a session
+ * is provided, it loads that session into the tracer; otherwise, it loads
+ * a default session.
+ * @param session Optional session to load into the tracer.
+ * @returns An instance of `LangChainTracerV1`.
+ */
+export declare function getTracingCallbackHandler(session?: string): Promise<LangChainTracerV1>;
 /**
  * Function that returns an instance of `LangChainTracer`. It does not
  * load any session data.

package/dist/tracers/initialize.js

@@ -1,4 +1,24 @@
 import { LangChainTracer } from "./tracer_langchain.js";
+import { LangChainTracerV1 } from "./tracer_langchain_v1.js";
+/**
+ * @deprecated Use the V2 handler instead.
+ *
+ * Function that returns an instance of `LangChainTracerV1`. If a session
+ * is provided, it loads that session into the tracer; otherwise, it loads
+ * a default session.
+ * @param session Optional session to load into the tracer.
+ * @returns An instance of `LangChainTracerV1`.
+ */
+export async function getTracingCallbackHandler(session) {
+    const tracer = new LangChainTracerV1();
+    if (session) {
+        await tracer.loadSession(session);
+    }
+    else {
+        await tracer.loadDefaultSession();
+    }
+    return tracer;
+}
 /**
  * Function that returns an instance of `LangChainTracer`. It does not
  * load any session data.

package/dist/tracers/tracer_langchain_v1.cjs

@@ -0,0 +1,200 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LangChainTracerV1 = void 0;
+const index_js_1 = require("../messages/index.cjs");
+const env_js_1 = require("../utils/env.cjs");
+const base_js_1 = require("./base.cjs");
+/** @deprecated Use LangChainTracer instead. */
+class LangChainTracerV1 extends base_js_1.BaseTracer {
+    constructor() {
+        super();
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "langchain_tracer"
+        });
+        Object.defineProperty(this, "endpoint", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: (0, env_js_1.getEnvironmentVariable)("LANGCHAIN_ENDPOINT") || "http://localhost:1984"
+        });
+        Object.defineProperty(this, "headers", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: {
+                "Content-Type": "application/json",
+            }
+        });
+        Object.defineProperty(this, "session", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        const apiKey = (0, env_js_1.getEnvironmentVariable)("LANGCHAIN_API_KEY");
+        if (apiKey) {
+            this.headers["x-api-key"] = apiKey;
+        }
+    }
+    async newSession(sessionName) {
+        const sessionCreate = {
+            start_time: Date.now(),
+            name: sessionName,
+        };
+        const session = await this.persistSession(sessionCreate);
+        this.session = session;
+        return session;
+    }
+    async loadSession(sessionName) {
+        const endpoint = `${this.endpoint}/sessions?name=${sessionName}`;
+        return this._handleSessionResponse(endpoint);
+    }
+    async loadDefaultSession() {
+        const endpoint = `${this.endpoint}/sessions?name=default`;
+        return this._handleSessionResponse(endpoint);
+    }
+    async convertV2RunToRun(run) {
+        const session = this.session ?? (await this.loadDefaultSession());
+        const serialized = run.serialized;
+        let runResult;
+        if (run.run_type === "llm") {
+            const prompts = run.inputs.prompts
+                ? run.inputs.prompts
+                : run.inputs.messages.map((x) => (0, index_js_1.getBufferString)(x));
+            const llmRun = {
+                uuid: run.id,
+                start_time: run.start_time,
+                end_time: run.end_time,
+                execution_order: run.execution_order,
+                child_execution_order: run.child_execution_order,
+                serialized,
+                type: run.run_type,
+                session_id: session.id,
+                prompts,
+                response: run.outputs,
+            };
+            runResult = llmRun;
+        }
+        else if (run.run_type === "chain") {
+            const child_runs = await Promise.all(run.child_runs.map((child_run) => this.convertV2RunToRun(child_run)));
+            const chainRun = {
+                uuid: run.id,
+                start_time: run.start_time,
+                end_time: run.end_time,
+                execution_order: run.execution_order,
+                child_execution_order: run.child_execution_order,
+                serialized,
+                type: run.run_type,
+                session_id: session.id,
+                inputs: run.inputs,
+                outputs: run.outputs,
+                child_llm_runs: child_runs.filter((child_run) => child_run.type === "llm"),
+                child_chain_runs: child_runs.filter((child_run) => child_run.type === "chain"),
+                child_tool_runs: child_runs.filter((child_run) => child_run.type === "tool"),
+            };
+            runResult = chainRun;
+        }
+        else if (run.run_type === "tool") {
+            const child_runs = await Promise.all(run.child_runs.map((child_run) => this.convertV2RunToRun(child_run)));
+            const toolRun = {
+                uuid: run.id,
+                start_time: run.start_time,
+                end_time: run.end_time,
+                execution_order: run.execution_order,
+                child_execution_order: run.child_execution_order,
+                serialized,
+                type: run.run_type,
+                session_id: session.id,
+                tool_input: run.inputs.input,
+                output: run.outputs?.output,
+                action: JSON.stringify(serialized),
+                child_llm_runs: child_runs.filter((child_run) => child_run.type === "llm"),
+                child_chain_runs: child_runs.filter((child_run) => child_run.type === "chain"),
+                child_tool_runs: child_runs.filter((child_run) => child_run.type === "tool"),
+            };
+            runResult = toolRun;
+        }
+        else {
+            throw new Error(`Unknown run type: ${run.run_type}`);
+        }
+        return runResult;
+    }
+    async persistRun(run) {
+        let endpoint;
+        let v1Run;
+        if (run.run_type !== undefined) {
+            v1Run = await this.convertV2RunToRun(run);
+        }
+        else {
+            v1Run = run;
+        }
+        if (v1Run.type === "llm") {
+            endpoint = `${this.endpoint}/llm-runs`;
+        }
+        else if (v1Run.type === "chain") {
+            endpoint = `${this.endpoint}/chain-runs`;
+        }
+        else {
+            endpoint = `${this.endpoint}/tool-runs`;
+        }
+        const response = await fetch(endpoint, {
+            method: "POST",
+            headers: this.headers,
+            body: JSON.stringify(v1Run),
+        });
+        if (!response.ok) {
+            console.error(`Failed to persist run: ${response.status} ${response.statusText}`);
+        }
+    }
+    async persistSession(sessionCreate) {
+        const endpoint = `${this.endpoint}/sessions`;
+        const response = await fetch(endpoint, {
+            method: "POST",
+            headers: this.headers,
+            body: JSON.stringify(sessionCreate),
+        });
+        if (!response.ok) {
+            console.error(`Failed to persist session: ${response.status} ${response.statusText}, using default session.`);
+            return {
+                id: 1,
+                ...sessionCreate,
+            };
+        }
+        return {
+            id: (await response.json()).id,
+            ...sessionCreate,
+        };
+    }
+    async _handleSessionResponse(endpoint) {
+        const response = await fetch(endpoint, {
+            method: "GET",
+            headers: this.headers,
+        });
+        let tracerSession;
+        if (!response.ok) {
+            console.error(`Failed to load session: ${response.status} ${response.statusText}`);
+            tracerSession = {
+                id: 1,
+                start_time: Date.now(),
+            };
+            this.session = tracerSession;
+            return tracerSession;
+        }
+        const resp = (await response.json());
+        if (resp.length === 0) {
+            tracerSession = {
+                id: 1,
+                start_time: Date.now(),
+            };
+            this.session = tracerSession;
+            return tracerSession;
+        }
+        [tracerSession] = resp;
+        this.session = tracerSession;
+        return tracerSession;
+    }
+}
+exports.LangChainTracerV1 = LangChainTracerV1;

package/dist/tracers/tracer_langchain_v1.d.ts

@@ -0,0 +1,59 @@
+import type { ChainValues } from "../utils/types.js";
+import type { LLMResult } from "../outputs.js";
+import { BaseTracer, type RunType, type Run } from "./base.js";
+export interface BaseRunV1 {
+    uuid: string;
+    parent_uuid?: string;
+    start_time: number;
+    end_time?: number;
+    execution_order: number;
+    child_execution_order: number;
+    serialized: {
+        name: string;
+    };
+    session_id: number;
+    error?: string;
+    type: RunType;
+}
+export interface LLMRun extends BaseRunV1 {
+    prompts: string[];
+    response?: LLMResult;
+}
+export interface ChainRun extends BaseRunV1 {
+    inputs: ChainValues;
+    outputs?: ChainValues;
+    child_llm_runs: LLMRun[];
+    child_chain_runs: ChainRun[];
+    child_tool_runs: ToolRun[];
+}
+export interface ToolRun extends BaseRunV1 {
+    tool_input: string;
+    output?: string;
+    action: string;
+    child_llm_runs: LLMRun[];
+    child_chain_runs: ChainRun[];
+    child_tool_runs: ToolRun[];
+}
+export interface BaseTracerSession {
+    start_time: number;
+    name?: string;
+}
+export type TracerSessionCreate = BaseTracerSession;
+export interface TracerSessionV1 extends BaseTracerSession {
+    id: number;
+}
+/** @deprecated Use LangChainTracer instead. */
+export declare class LangChainTracerV1 extends BaseTracer {
+    name: string;
+    protected endpoint: string;
+    protected headers: Record<string, string>;
+    protected session: TracerSessionV1;
+    constructor();
+    newSession(sessionName?: string): Promise<TracerSessionV1>;
+    loadSession(sessionName: string): Promise<TracerSessionV1>;
+    loadDefaultSession(): Promise<TracerSessionV1>;
+    protected convertV2RunToRun(run: Run): Promise<LLMRun | ChainRun | ToolRun>;
+    protected persistRun(run: Run | LLMRun | ChainRun | ToolRun): Promise<void>;
+    protected persistSession(sessionCreate: BaseTracerSession): Promise<TracerSessionV1>;
+    protected _handleSessionResponse(endpoint: string): Promise<TracerSessionV1>;
+}

package/dist/tracers/tracer_langchain_v1.js

@@ -0,0 +1,196 @@
+import { getBufferString } from "../messages/index.js";
+import { getEnvironmentVariable } from "../utils/env.js";
+import { BaseTracer } from "./base.js";
+/** @deprecated Use LangChainTracer instead. */
+export class LangChainTracerV1 extends BaseTracer {
+    constructor() {
+        super();
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "langchain_tracer"
+        });
+        Object.defineProperty(this, "endpoint", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: getEnvironmentVariable("LANGCHAIN_ENDPOINT") || "http://localhost:1984"
+        });
+        Object.defineProperty(this, "headers", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: {
+                "Content-Type": "application/json",
+            }
+        });
+        Object.defineProperty(this, "session", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        const apiKey = getEnvironmentVariable("LANGCHAIN_API_KEY");
+        if (apiKey) {
+            this.headers["x-api-key"] = apiKey;
+        }
+    }
+    async newSession(sessionName) {
+        const sessionCreate = {
+            start_time: Date.now(),
+            name: sessionName,
+        };
+        const session = await this.persistSession(sessionCreate);
+        this.session = session;
+        return session;
+    }
+    async loadSession(sessionName) {
+        const endpoint = `${this.endpoint}/sessions?name=${sessionName}`;
+        return this._handleSessionResponse(endpoint);
+    }
+    async loadDefaultSession() {
+        const endpoint = `${this.endpoint}/sessions?name=default`;
+        return this._handleSessionResponse(endpoint);
+    }
+    async convertV2RunToRun(run) {
+        const session = this.session ?? (await this.loadDefaultSession());
+        const serialized = run.serialized;
+        let runResult;
+        if (run.run_type === "llm") {
+            const prompts = run.inputs.prompts
+                ? run.inputs.prompts
+                : run.inputs.messages.map((x) => getBufferString(x));
+            const llmRun = {
+                uuid: run.id,
+                start_time: run.start_time,
+                end_time: run.end_time,
+                execution_order: run.execution_order,
+                child_execution_order: run.child_execution_order,
+                serialized,
+                type: run.run_type,
+                session_id: session.id,
+                prompts,
+                response: run.outputs,
+            };
+            runResult = llmRun;
+        }
+        else if (run.run_type === "chain") {
+            const child_runs = await Promise.all(run.child_runs.map((child_run) => this.convertV2RunToRun(child_run)));
+            const chainRun = {
+                uuid: run.id,
+                start_time: run.start_time,
+                end_time: run.end_time,
+                execution_order: run.execution_order,
+                child_execution_order: run.child_execution_order,
+                serialized,
+                type: run.run_type,
+                session_id: session.id,
+                inputs: run.inputs,
+                outputs: run.outputs,
+                child_llm_runs: child_runs.filter((child_run) => child_run.type === "llm"),
+                child_chain_runs: child_runs.filter((child_run) => child_run.type === "chain"),
+                child_tool_runs: child_runs.filter((child_run) => child_run.type === "tool"),
+            };
+            runResult = chainRun;
+        }
+        else if (run.run_type === "tool") {
+            const child_runs = await Promise.all(run.child_runs.map((child_run) => this.convertV2RunToRun(child_run)));
+            const toolRun = {
+                uuid: run.id,
+                start_time: run.start_time,
+                end_time: run.end_time,
+                execution_order: run.execution_order,
+                child_execution_order: run.child_execution_order,
+                serialized,
+                type: run.run_type,
+                session_id: session.id,
+                tool_input: run.inputs.input,
+                output: run.outputs?.output,
+                action: JSON.stringify(serialized),
+                child_llm_runs: child_runs.filter((child_run) => child_run.type === "llm"),
+                child_chain_runs: child_runs.filter((child_run) => child_run.type === "chain"),
+                child_tool_runs: child_runs.filter((child_run) => child_run.type === "tool"),
+            };
+            runResult = toolRun;
+        }
+        else {
+            throw new Error(`Unknown run type: ${run.run_type}`);
+        }
+        return runResult;
+    }
+    async persistRun(run) {
+        let endpoint;
+        let v1Run;
+        if (run.run_type !== undefined) {
+            v1Run = await this.convertV2RunToRun(run);
+        }
+        else {
+            v1Run = run;
+        }
+        if (v1Run.type === "llm") {
+            endpoint = `${this.endpoint}/llm-runs`;
+        }
+        else if (v1Run.type === "chain") {
+            endpoint = `${this.endpoint}/chain-runs`;
+        }
+        else {
+            endpoint = `${this.endpoint}/tool-runs`;
+        }
+        const response = await fetch(endpoint, {
+            method: "POST",
+            headers: this.headers,
+            body: JSON.stringify(v1Run),
+        });
+        if (!response.ok) {
+            console.error(`Failed to persist run: ${response.status} ${response.statusText}`);
+        }
+    }
+    async persistSession(sessionCreate) {
+        const endpoint = `${this.endpoint}/sessions`;
+        const response = await fetch(endpoint, {
+            method: "POST",
+            headers: this.headers,
+            body: JSON.stringify(sessionCreate),
+        });
+        if (!response.ok) {
+            console.error(`Failed to persist session: ${response.status} ${response.statusText}, using default session.`);
+            return {
+                id: 1,
+                ...sessionCreate,
+            };
+        }
+        return {
+            id: (await response.json()).id,
+            ...sessionCreate,
+        };
+    }
+    async _handleSessionResponse(endpoint) {
+        const response = await fetch(endpoint, {
+            method: "GET",
+            headers: this.headers,
+        });
+        let tracerSession;
+        if (!response.ok) {
+            console.error(`Failed to load session: ${response.status} ${response.statusText}`);
+            tracerSession = {
+                id: 1,
+                start_time: Date.now(),
+            };
+            this.session = tracerSession;
+            return tracerSession;
+        }
+        const resp = (await response.json());
+        if (resp.length === 0) {
+            tracerSession = {
+                id: 1,
+                start_time: Date.now(),
+            };
+            this.session = tracerSession;
+            return tracerSession;
+        }
+        [tracerSession] = resp;
+        this.session = tracerSession;
+        return tracerSession;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/core",
-  "version": "0.1.7",
+  "version": "0.1.9-rc.0",
   "description": "Core LangChain.js abstractions and schemas",
   "type": "module",
   "engines": {
@@ -234,6 +234,11 @@
       "import": "./tracers/tracer_langchain.js",
       "require": "./tracers/tracer_langchain.cjs"
     },
+    "./tracers/tracer_langchain_v1": {
+      "types": "./tracers/tracer_langchain_v1.d.ts",
+      "import": "./tracers/tracer_langchain_v1.js",
+      "require": "./tracers/tracer_langchain_v1.cjs"
+    },
     "./utils/async_caller": {
       "types": "./utils/async_caller.d.ts",
       "import": "./utils/async_caller.js",
@@ -388,6 +393,9 @@
     "tracers/tracer_langchain.cjs",
     "tracers/tracer_langchain.js",
     "tracers/tracer_langchain.d.ts",
+    "tracers/tracer_langchain_v1.cjs",
+    "tracers/tracer_langchain_v1.js",
+    "tracers/tracer_langchain_v1.d.ts",
     "utils/async_caller.cjs",
     "utils/async_caller.js",
     "utils/async_caller.d.ts",

package/tracers/tracer_langchain_v1.cjs

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

package/tracers/tracer_langchain_v1.d.ts

@@ -0,0 +1 @@
+export * from '../dist/tracers/tracer_langchain_v1.js'

package/tracers/tracer_langchain_v1.js

@@ -0,0 +1 @@
+export * from '../dist/tracers/tracer_langchain_v1.js'