@langchain/core 0.1.52 → 0.1.54

package/dist/callbacks/base.d.ts

@@ -1,4 +1,4 @@
-import type { ChainValues } from "../utils/types.js";
+import type { ChainValues } from "../utils/types/index.js";
 import type { BaseMessage } from "../messages/index.js";
 import type { AgentAction, AgentFinish } from "../agents.js";
 import type { ChatGenerationChunk, GenerationChunk, LLMResult } from "../outputs.js";

package/dist/callbacks/manager.cjs

@@ -372,34 +372,36 @@ class CallbackManager extends BaseCallbackManager {
     getParentRunId() {
         return this._parentRunId;
     }
-    async handleLLMStart(llm, prompts, _runId = undefined, _parentRunId = undefined, extraParams = undefined, _tags = undefined, _metadata = undefined, runName = undefined) {
-        return Promise.all(prompts.map(async (prompt) => {
-            const runId = (0, uuid_1.v4)();
+    async handleLLMStart(llm, prompts, runId = undefined, _parentRunId = undefined, extraParams = undefined, _tags = undefined, _metadata = undefined, runName = undefined) {
+        return Promise.all(prompts.map(async (prompt, idx) => {
+            // Can't have duplicate runs with the same run ID (if provided)
+            const runId_ = idx === 0 && runId ? runId : (0, uuid_1.v4)();
             await Promise.all(this.handlers.map((handler) => (0, promises_js_1.consumeCallback)(async () => {
                 if (!handler.ignoreLLM) {
                     try {
-                        await handler.handleLLMStart?.(llm, [prompt], runId, this._parentRunId, extraParams, this.tags, this.metadata, runName);
+                        await handler.handleLLMStart?.(llm, [prompt], runId_, this._parentRunId, extraParams, this.tags, this.metadata, runName);
                     }
                     catch (err) {
                         console.error(`Error in handler ${handler.constructor.name}, handleLLMStart: ${err}`);
                     }
                 }
             }, handler.awaitHandlers)));
-            return new CallbackManagerForLLMRun(runId, this.handlers, this.inheritableHandlers, this.tags, this.inheritableTags, this.metadata, this.inheritableMetadata, this._parentRunId);
+            return new CallbackManagerForLLMRun(runId_, this.handlers, this.inheritableHandlers, this.tags, this.inheritableTags, this.metadata, this.inheritableMetadata, this._parentRunId);
         }));
     }
-    async handleChatModelStart(llm, messages, _runId = undefined, _parentRunId = undefined, extraParams = undefined, _tags = undefined, _metadata = undefined, runName = undefined) {
-        return Promise.all(messages.map(async (messageGroup) => {
-            const runId = (0, uuid_1.v4)();
+    async handleChatModelStart(llm, messages, runId = undefined, _parentRunId = undefined, extraParams = undefined, _tags = undefined, _metadata = undefined, runName = undefined) {
+        return Promise.all(messages.map(async (messageGroup, idx) => {
+            // Can't have duplicate runs with the same run ID (if provided)
+            const runId_ = idx === 0 && runId ? runId : (0, uuid_1.v4)();
             await Promise.all(this.handlers.map((handler) => (0, promises_js_1.consumeCallback)(async () => {
                 if (!handler.ignoreLLM) {
                     try {
                         if (handler.handleChatModelStart) {
-                            await handler.handleChatModelStart?.(llm, [messageGroup], runId, this._parentRunId, extraParams, this.tags, this.metadata, runName);
+                            await handler.handleChatModelStart?.(llm, [messageGroup], runId_, this._parentRunId, extraParams, this.tags, this.metadata, runName);
                         }
                         else if (handler.handleLLMStart) {
                             const messageString = (0, index_js_1.getBufferString)(messageGroup);
-                            await handler.handleLLMStart?.(llm, [messageString], runId, this._parentRunId, extraParams, this.tags, this.metadata, runName);
+                            await handler.handleLLMStart?.(llm, [messageString], runId_, this._parentRunId, extraParams, this.tags, this.metadata, runName);
                         }
                     }
                     catch (err) {
@@ -407,7 +409,7 @@ class CallbackManager extends BaseCallbackManager {
                     }
                 }
             }, handler.awaitHandlers)));
-            return new CallbackManagerForLLMRun(runId, this.handlers, this.inheritableHandlers, this.tags, this.inheritableTags, this.metadata, this.inheritableMetadata, this._parentRunId);
+            return new CallbackManagerForLLMRun(runId_, this.handlers, this.inheritableHandlers, this.tags, this.inheritableTags, this.metadata, this.inheritableMetadata, this._parentRunId);
         }));
     }
     async handleChainStart(chain, inputs, runId = (0, uuid_1.v4)(), runType = undefined, _tags = undefined, _metadata = undefined, runName = undefined) {

package/dist/callbacks/manager.d.ts

@@ -1,5 +1,5 @@
 import { AgentAction, AgentFinish } from "../agents.js";
-import type { ChainValues } from "../utils/types.js";
+import type { ChainValues } from "../utils/types/index.js";
 import { LLMResult } from "../outputs.js";
 import { BaseCallbackHandler, CallbackHandlerMethods, HandleLLMNewTokenCallbackFields, NewTokenIndices } from "./base.js";
 import { type BaseMessage } from "../messages/index.js";
@@ -34,6 +34,11 @@ export interface BaseCallbackConfig {
      * Tags are passed to all callbacks, metadata is passed to handle*Start callbacks.
      */
     callbacks?: Callbacks;
+    /**
+     * Unique identifier for the tracer run for this call. If not provided, a new UUID
+     * will be generated.
+     */
+    runId?: string;
 }
 export declare function parseCallbackConfigArg(arg: Callbacks | BaseCallbackConfig | undefined): BaseCallbackConfig;
 /**
@@ -130,8 +135,8 @@ export declare class CallbackManager extends BaseCallbackManager implements Base
      * @returns The parent run ID.
      */
     getParentRunId(): string | undefined;
-    handleLLMStart(llm: Serialized, prompts: string[], _runId?: string | undefined, _parentRunId?: string | undefined, extraParams?: Record<string, unknown> | undefined, _tags?: string[] | undefined, _metadata?: Record<string, unknown> | undefined, runName?: string | undefined): Promise<CallbackManagerForLLMRun[]>;
-    handleChatModelStart(llm: Serialized, messages: BaseMessage[][], _runId?: string | undefined, _parentRunId?: string | undefined, extraParams?: Record<string, unknown> | undefined, _tags?: string[] | undefined, _metadata?: Record<string, unknown> | undefined, runName?: string | undefined): Promise<CallbackManagerForLLMRun[]>;
+    handleLLMStart(llm: Serialized, prompts: string[], runId?: string | undefined, _parentRunId?: string | undefined, extraParams?: Record<string, unknown> | undefined, _tags?: string[] | undefined, _metadata?: Record<string, unknown> | undefined, runName?: string | undefined): Promise<CallbackManagerForLLMRun[]>;
+    handleChatModelStart(llm: Serialized, messages: BaseMessage[][], runId?: string | undefined, _parentRunId?: string | undefined, extraParams?: Record<string, unknown> | undefined, _tags?: string[] | undefined, _metadata?: Record<string, unknown> | undefined, runName?: string | undefined): Promise<CallbackManagerForLLMRun[]>;
     handleChainStart(chain: Serialized, inputs: ChainValues, runId?: string, runType?: string | undefined, _tags?: string[] | undefined, _metadata?: Record<string, unknown> | undefined, runName?: string | undefined): Promise<CallbackManagerForChainRun>;
     handleToolStart(tool: Serialized, input: string, runId?: string, _parentRunId?: string | undefined, _tags?: string[] | undefined, _metadata?: Record<string, unknown> | undefined, runName?: string | undefined): Promise<CallbackManagerForToolRun>;
     handleRetrieverStart(retriever: Serialized, query: string, runId?: string, _parentRunId?: string | undefined, _tags?: string[] | undefined, _metadata?: Record<string, unknown> | undefined, runName?: string | undefined): Promise<CallbackManagerForRetrieverRun>;

package/dist/callbacks/manager.js

@@ -363,34 +363,36 @@ export class CallbackManager extends BaseCallbackManager {
     getParentRunId() {
         return this._parentRunId;
     }
-    async handleLLMStart(llm, prompts, _runId = undefined, _parentRunId = undefined, extraParams = undefined, _tags = undefined, _metadata = undefined, runName = undefined) {
-        return Promise.all(prompts.map(async (prompt) => {
-            const runId = uuidv4();
+    async handleLLMStart(llm, prompts, runId = undefined, _parentRunId = undefined, extraParams = undefined, _tags = undefined, _metadata = undefined, runName = undefined) {
+        return Promise.all(prompts.map(async (prompt, idx) => {
+            // Can't have duplicate runs with the same run ID (if provided)
+            const runId_ = idx === 0 && runId ? runId : uuidv4();
             await Promise.all(this.handlers.map((handler) => consumeCallback(async () => {
                 if (!handler.ignoreLLM) {
                     try {
-                        await handler.handleLLMStart?.(llm, [prompt], runId, this._parentRunId, extraParams, this.tags, this.metadata, runName);
+                        await handler.handleLLMStart?.(llm, [prompt], runId_, this._parentRunId, extraParams, this.tags, this.metadata, runName);
                     }
                     catch (err) {
                         console.error(`Error in handler ${handler.constructor.name}, handleLLMStart: ${err}`);
                     }
                 }
             }, handler.awaitHandlers)));
-            return new CallbackManagerForLLMRun(runId, this.handlers, this.inheritableHandlers, this.tags, this.inheritableTags, this.metadata, this.inheritableMetadata, this._parentRunId);
+            return new CallbackManagerForLLMRun(runId_, this.handlers, this.inheritableHandlers, this.tags, this.inheritableTags, this.metadata, this.inheritableMetadata, this._parentRunId);
         }));
     }
-    async handleChatModelStart(llm, messages, _runId = undefined, _parentRunId = undefined, extraParams = undefined, _tags = undefined, _metadata = undefined, runName = undefined) {
-        return Promise.all(messages.map(async (messageGroup) => {
-            const runId = uuidv4();
+    async handleChatModelStart(llm, messages, runId = undefined, _parentRunId = undefined, extraParams = undefined, _tags = undefined, _metadata = undefined, runName = undefined) {
+        return Promise.all(messages.map(async (messageGroup, idx) => {
+            // Can't have duplicate runs with the same run ID (if provided)
+            const runId_ = idx === 0 && runId ? runId : uuidv4();
             await Promise.all(this.handlers.map((handler) => consumeCallback(async () => {
                 if (!handler.ignoreLLM) {
                     try {
                         if (handler.handleChatModelStart) {
-                            await handler.handleChatModelStart?.(llm, [messageGroup], runId, this._parentRunId, extraParams, this.tags, this.metadata, runName);
+                            await handler.handleChatModelStart?.(llm, [messageGroup], runId_, this._parentRunId, extraParams, this.tags, this.metadata, runName);
                         }
                         else if (handler.handleLLMStart) {
                             const messageString = getBufferString(messageGroup);
-                            await handler.handleLLMStart?.(llm, [messageString], runId, this._parentRunId, extraParams, this.tags, this.metadata, runName);
+                            await handler.handleLLMStart?.(llm, [messageString], runId_, this._parentRunId, extraParams, this.tags, this.metadata, runName);
                         }
                     }
                     catch (err) {
@@ -398,7 +400,7 @@ export class CallbackManager extends BaseCallbackManager {
                     }
                 }
             }, handler.awaitHandlers)));
-            return new CallbackManagerForLLMRun(runId, this.handlers, this.inheritableHandlers, this.tags, this.inheritableTags, this.metadata, this.inheritableMetadata, this._parentRunId);
+            return new CallbackManagerForLLMRun(runId_, this.handlers, this.inheritableHandlers, this.tags, this.inheritableTags, this.metadata, this.inheritableMetadata, this._parentRunId);
         }));
     }
     async handleChainStart(chain, inputs, runId = uuidv4(), runType = undefined, _tags = undefined, _metadata = undefined, runName = undefined) {

package/dist/example_selectors/conditional.d.ts

@@ -2,7 +2,7 @@ import type { BaseChatModel } from "../language_models/chat_models.js";
 import type { BasePromptTemplate } from "../prompts/base.js";
 import type { BaseLanguageModelInterface } from "../language_models/base.js";
 import type { BaseLLM } from "../language_models/llms.js";
-import type { PartialValues } from "../utils/types.js";
+import type { PartialValues } from "../utils/types/index.js";
 export type BaseGetPromptAsyncOptions = {
     partialVariables?: PartialValues;
 };

package/dist/language_models/chat_models.cjs

@@ -76,7 +76,7 @@ class BaseChatModel extends base_js_1.BaseLanguageModel {
                 invocation_params: this?.invocationParams(callOptions),
                 batch_size: 1,
             };
-            const runManagers = await callbackManager_?.handleChatModelStart(this.toJSON(), [messages], undefined, undefined, extra, undefined, undefined, runnableConfig.runName);
+            const runManagers = await callbackManager_?.handleChatModelStart(this.toJSON(), [messages], runnableConfig.runId, undefined, extra, undefined, undefined, runnableConfig.runName);
             let generationChunk;
             try {
                 for await (const chunk of this._streamResponseChunks(messages, callOptions, runManagers?.[0])) {
@@ -113,7 +113,7 @@ class BaseChatModel extends base_js_1.BaseLanguageModel {
             invocation_params: this?.invocationParams(parsedOptions),
             batch_size: 1,
         };
-        const runManagers = await callbackManager_?.handleChatModelStart(this.toJSON(), baseMessages, undefined, undefined, extra, undefined, undefined, handledOptions.runName);
+        const runManagers = await callbackManager_?.handleChatModelStart(this.toJSON(), baseMessages, handledOptions.runId, undefined, extra, undefined, undefined, handledOptions.runName);
         // generate results
         const results = await Promise.allSettled(baseMessages.map((messageList, i) => this._generate(messageList, { ...parsedOptions, promptIndex: i }, runManagers?.[i])));
         // handle results
@@ -172,7 +172,7 @@ class BaseChatModel extends base_js_1.BaseLanguageModel {
             batch_size: 1,
             cached: true,
         };
-        const runManagers = await callbackManager_?.handleChatModelStart(this.toJSON(), baseMessages, undefined, undefined, extra, undefined, undefined, handledOptions.runName);
+        const runManagers = await callbackManager_?.handleChatModelStart(this.toJSON(), baseMessages, handledOptions.runId, undefined, extra, undefined, undefined, handledOptions.runName);
         // generate results
         const missingPromptIndices = [];
         const results = await Promise.allSettled(baseMessages.map(async (baseMessage, index) => {

package/dist/language_models/chat_models.js

@@ -72,7 +72,7 @@ export class BaseChatModel extends BaseLanguageModel {
                 invocation_params: this?.invocationParams(callOptions),
                 batch_size: 1,
             };
-            const runManagers = await callbackManager_?.handleChatModelStart(this.toJSON(), [messages], undefined, undefined, extra, undefined, undefined, runnableConfig.runName);
+            const runManagers = await callbackManager_?.handleChatModelStart(this.toJSON(), [messages], runnableConfig.runId, undefined, extra, undefined, undefined, runnableConfig.runName);
             let generationChunk;
             try {
                 for await (const chunk of this._streamResponseChunks(messages, callOptions, runManagers?.[0])) {
@@ -109,7 +109,7 @@ export class BaseChatModel extends BaseLanguageModel {
             invocation_params: this?.invocationParams(parsedOptions),
             batch_size: 1,
         };
-        const runManagers = await callbackManager_?.handleChatModelStart(this.toJSON(), baseMessages, undefined, undefined, extra, undefined, undefined, handledOptions.runName);
+        const runManagers = await callbackManager_?.handleChatModelStart(this.toJSON(), baseMessages, handledOptions.runId, undefined, extra, undefined, undefined, handledOptions.runName);
         // generate results
         const results = await Promise.allSettled(baseMessages.map((messageList, i) => this._generate(messageList, { ...parsedOptions, promptIndex: i }, runManagers?.[i])));
         // handle results
@@ -168,7 +168,7 @@ export class BaseChatModel extends BaseLanguageModel {
             batch_size: 1,
             cached: true,
         };
-        const runManagers = await callbackManager_?.handleChatModelStart(this.toJSON(), baseMessages, undefined, undefined, extra, undefined, undefined, handledOptions.runName);
+        const runManagers = await callbackManager_?.handleChatModelStart(this.toJSON(), baseMessages, handledOptions.runId, undefined, extra, undefined, undefined, handledOptions.runName);
         // generate results
         const missingPromptIndices = [];
         const results = await Promise.allSettled(baseMessages.map(async (baseMessage, index) => {

package/dist/language_models/llms.cjs

@@ -57,7 +57,7 @@ class BaseLLM extends base_js_1.BaseLanguageModel {
                 invocation_params: this?.invocationParams(callOptions),
                 batch_size: 1,
             };
-            const runManagers = await callbackManager_?.handleLLMStart(this.toJSON(), [prompt.toString()], undefined, undefined, extra, undefined, undefined, runnableConfig.runName);
+            const runManagers = await callbackManager_?.handleLLMStart(this.toJSON(), [prompt.toString()], runnableConfig.runId, undefined, extra, undefined, undefined, runnableConfig.runName);
             let generation = new outputs_js_1.GenerationChunk({
                 text: "",
             });
@@ -132,7 +132,7 @@ class BaseLLM extends base_js_1.BaseLanguageModel {
             invocation_params: this?.invocationParams(parsedOptions),
             batch_size: prompts.length,
         };
-        const runManagers = await callbackManager_?.handleLLMStart(this.toJSON(), prompts, undefined, undefined, extra, undefined, undefined, handledOptions?.runName);
+        const runManagers = await callbackManager_?.handleLLMStart(this.toJSON(), prompts, handledOptions.runId, undefined, extra, undefined, undefined, handledOptions?.runName);
         let output;
         try {
             output = await this._generate(prompts, parsedOptions, runManagers?.[0]);
@@ -153,7 +153,7 @@ class BaseLLM extends base_js_1.BaseLanguageModel {
         });
         return output;
     }
-    async _generateCached({ prompts, cache, llmStringKey, parsedOptions, handledOptions, }) {
+    async _generateCached({ prompts, cache, llmStringKey, parsedOptions, handledOptions, runId, }) {
         const callbackManager_ = await manager_js_1.CallbackManager.configure(handledOptions.callbacks, this.callbacks, handledOptions.tags, this.tags, handledOptions.metadata, this.metadata, { verbose: this.verbose });
         const extra = {
             options: parsedOptions,
@@ -161,7 +161,7 @@ class BaseLLM extends base_js_1.BaseLanguageModel {
             batch_size: prompts.length,
             cached: true,
         };
-        const runManagers = await callbackManager_?.handleLLMStart(this.toJSON(), prompts, undefined, undefined, extra, undefined, undefined, handledOptions?.runName);
+        const runManagers = await callbackManager_?.handleLLMStart(this.toJSON(), prompts, runId, undefined, extra, undefined, undefined, handledOptions?.runName);
         // generate results
         const missingPromptIndices = [];
         const results = await Promise.allSettled(prompts.map(async (prompt, index) => {
@@ -238,6 +238,7 @@ class BaseLLM extends base_js_1.BaseLanguageModel {
             llmStringKey,
             parsedOptions: callOptions,
             handledOptions: runnableConfig,
+            runId: runnableConfig.runId,
         });
         let llmOutput = {};
         if (missingPromptIndices.length > 0) {

package/dist/language_models/llms.d.ts

@@ -23,6 +23,7 @@ interface LLMGenerateCachedParameters<T extends BaseLLM<CallOptions>, CallOption
     llmStringKey: string;
     parsedOptions: T["ParsedCallOptions"];
     handledOptions: RunnableConfig;
+    runId?: string;
 }
 /**
  * LLM Wrapper. Takes in a prompt (or prompts) and returns a string.
@@ -63,7 +64,7 @@ export declare abstract class BaseLLM<CallOptions extends BaseLLMCallOptions = B
     _flattenLLMResult(llmResult: LLMResult): LLMResult[];
     /** @ignore */
     _generateUncached(prompts: string[], parsedOptions: this["ParsedCallOptions"], handledOptions: BaseCallbackConfig): Promise<LLMResult>;
-    _generateCached({ prompts, cache, llmStringKey, parsedOptions, handledOptions, }: LLMGenerateCachedParameters<typeof this>): Promise<LLMResult & {
+    _generateCached({ prompts, cache, llmStringKey, parsedOptions, handledOptions, runId, }: LLMGenerateCachedParameters<typeof this>): Promise<LLMResult & {
         missingPromptIndices: number[];
     }>;
     /**

package/dist/language_models/llms.js

@@ -54,7 +54,7 @@ export class BaseLLM extends BaseLanguageModel {
                 invocation_params: this?.invocationParams(callOptions),
                 batch_size: 1,
             };
-            const runManagers = await callbackManager_?.handleLLMStart(this.toJSON(), [prompt.toString()], undefined, undefined, extra, undefined, undefined, runnableConfig.runName);
+            const runManagers = await callbackManager_?.handleLLMStart(this.toJSON(), [prompt.toString()], runnableConfig.runId, undefined, extra, undefined, undefined, runnableConfig.runName);
             let generation = new GenerationChunk({
                 text: "",
             });
@@ -129,7 +129,7 @@ export class BaseLLM extends BaseLanguageModel {
             invocation_params: this?.invocationParams(parsedOptions),
             batch_size: prompts.length,
         };
-        const runManagers = await callbackManager_?.handleLLMStart(this.toJSON(), prompts, undefined, undefined, extra, undefined, undefined, handledOptions?.runName);
+        const runManagers = await callbackManager_?.handleLLMStart(this.toJSON(), prompts, handledOptions.runId, undefined, extra, undefined, undefined, handledOptions?.runName);
         let output;
         try {
             output = await this._generate(prompts, parsedOptions, runManagers?.[0]);
@@ -150,7 +150,7 @@ export class BaseLLM extends BaseLanguageModel {
         });
         return output;
     }
-    async _generateCached({ prompts, cache, llmStringKey, parsedOptions, handledOptions, }) {
+    async _generateCached({ prompts, cache, llmStringKey, parsedOptions, handledOptions, runId, }) {
         const callbackManager_ = await CallbackManager.configure(handledOptions.callbacks, this.callbacks, handledOptions.tags, this.tags, handledOptions.metadata, this.metadata, { verbose: this.verbose });
         const extra = {
             options: parsedOptions,
@@ -158,7 +158,7 @@ export class BaseLLM extends BaseLanguageModel {
             batch_size: prompts.length,
             cached: true,
         };
-        const runManagers = await callbackManager_?.handleLLMStart(this.toJSON(), prompts, undefined, undefined, extra, undefined, undefined, handledOptions?.runName);
+        const runManagers = await callbackManager_?.handleLLMStart(this.toJSON(), prompts, runId, undefined, extra, undefined, undefined, handledOptions?.runName);
         // generate results
         const missingPromptIndices = [];
         const results = await Promise.allSettled(prompts.map(async (prompt, index) => {
@@ -235,6 +235,7 @@ export class BaseLLM extends BaseLanguageModel {
             llmStringKey,
             parsedOptions: callOptions,
             handledOptions: runnableConfig,
+            runId: runnableConfig.runId,
         });
         let llmOutput = {};
         if (missingPromptIndices.length > 0) {

package/dist/load/import_map.cjs

@@ -45,7 +45,7 @@ exports.outputs = __importStar(require("../outputs.cjs"));
 exports.prompts = __importStar(require("../prompts/index.cjs"));
 exports.prompt_values = __importStar(require("../prompt_values.cjs"));
 exports.runnables = __importStar(require("../runnables/index.cjs"));
-exports.retrievers = __importStar(require("../retrievers.cjs"));
+exports.retrievers = __importStar(require("../retrievers/index.cjs"));
 exports.stores = __importStar(require("../stores.cjs"));
 exports.tools = __importStar(require("../tools.cjs"));
 exports.tracers__base = __importStar(require("../tracers/base.cjs"));
@@ -66,5 +66,5 @@ exports.utils__math = __importStar(require("../utils/math.cjs"));
 exports.utils__stream = __importStar(require("../utils/stream.cjs"));
 exports.utils__testing = __importStar(require("../utils/testing/index.cjs"));
 exports.utils__tiktoken = __importStar(require("../utils/tiktoken.cjs"));
-exports.utils__types = __importStar(require("../utils/types.cjs"));
+exports.utils__types = __importStar(require("../utils/types/index.cjs"));
 exports.vectorstores = __importStar(require("../vectorstores.cjs"));

package/dist/load/import_map.d.ts

@@ -18,7 +18,7 @@ export * as outputs from "../outputs.js";
 export * as prompts from "../prompts/index.js";
 export * as prompt_values from "../prompt_values.js";
 export * as runnables from "../runnables/index.js";
-export * as retrievers from "../retrievers.js";
+export * as retrievers from "../retrievers/index.js";
 export * as stores from "../stores.js";
 export * as tools from "../tools.js";
 export * as tracers__base from "../tracers/base.js";
@@ -39,5 +39,5 @@ export * as utils__math from "../utils/math.js";
 export * as utils__stream from "../utils/stream.js";
 export * as utils__testing from "../utils/testing/index.js";
 export * as utils__tiktoken from "../utils/tiktoken.js";
-export * as utils__types from "../utils/types.js";
+export * as utils__types from "../utils/types/index.js";
 export * as vectorstores from "../vectorstores.js";

package/dist/load/import_map.js

@@ -19,7 +19,7 @@ export * as outputs from "../outputs.js";
 export * as prompts from "../prompts/index.js";
 export * as prompt_values from "../prompt_values.js";
 export * as runnables from "../runnables/index.js";
-export * as retrievers from "../retrievers.js";
+export * as retrievers from "../retrievers/index.js";
 export * as stores from "../stores.js";
 export * as tools from "../tools.js";
 export * as tracers__base from "../tracers/base.js";
@@ -40,5 +40,5 @@ export * as utils__math from "../utils/math.js";
 export * as utils__stream from "../utils/stream.js";
 export * as utils__testing from "../utils/testing/index.js";
 export * as utils__tiktoken from "../utils/tiktoken.js";
-export * as utils__types from "../utils/types.js";
+export * as utils__types from "../utils/types/index.js";
 export * as vectorstores from "../vectorstores.js";

package/dist/messages/index.d.ts

@@ -1,5 +1,5 @@
 import { Serializable } from "../load/serializable.js";
-import type { StringWithAutocomplete } from "../utils/types.js";
+import type { StringWithAutocomplete } from "../utils/types/index.js";
 export interface StoredMessageData {
     content: string;
     role: string | undefined;
@@ -30,7 +30,11 @@ export type MessageContentImageUrl = {
         detail?: ImageDetail;
     };
 };
-export type MessageContentComplex = MessageContentText | MessageContentImageUrl;
+export type MessageContentComplex = MessageContentText | MessageContentImageUrl | (Record<string, any> & {
+    type?: "text" | "image_url" | string;
+}) | (Record<string, any> & {
+    type?: never;
+});
 export type MessageContent = string | MessageContentComplex[];
 export interface FunctionCall {
     /**
@@ -225,7 +229,10 @@ export declare class ChatMessage extends BaseMessage implements ChatMessageField
     _getType(): MessageType;
     static isInstance(message: BaseMessage): message is ChatMessage;
 }
-export type BaseMessageLike = BaseMessage | [StringWithAutocomplete<MessageType | "user" | "assistant">, MessageContent] | string;
+export type BaseMessageLike = BaseMessage | [
+    StringWithAutocomplete<MessageType | "user" | "assistant" | "placeholder">,
+    MessageContent
+] | string;
 export declare function isBaseMessage(messageLike?: unknown): messageLike is BaseMessage;
 export declare function isBaseMessageChunk(messageLike?: unknown): messageLike is BaseMessageChunk;
 export declare function coerceMessageLikeToMessage(messageLike: BaseMessageLike): BaseMessage;

package/dist/output_parsers/string.cjs

@@ -62,14 +62,21 @@ class StringOutputParser extends transform_js_1.BaseTransformOutputParser {
     _messageContentComplexToString(content) {
         switch (content.type) {
             case "text":
-                return this._textContentToString(content);
+                if ("text" in content) {
+                    // Type guard for MessageContentText
+                    return this._textContentToString(content);
+                }
+                break;
             case "image_url":
-                return this._imageUrlContentToString(content);
+                if ("image_url" in content) {
+                    // Type guard for MessageContentImageUrl
+                    return this._imageUrlContentToString(content);
+                }
+                break;
             default:
-                throw new Error(
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                `Cannot coerce "${content.type}" message part into a string.`);
+                throw new Error(`Cannot coerce "${content.type}" message part into a string.`);
         }
+        throw new Error(`Invalid content type: ${content.type}`);
     }
     _baseMessageContentToString(content) {
         return content.reduce((acc, item) => acc + this._messageContentComplexToString(item), "");

package/dist/output_parsers/string.js

@@ -59,14 +59,21 @@ export class StringOutputParser extends BaseTransformOutputParser {
     _messageContentComplexToString(content) {
         switch (content.type) {
             case "text":
-                return this._textContentToString(content);
+                if ("text" in content) {
+                    // Type guard for MessageContentText
+                    return this._textContentToString(content);
+                }
+                break;
             case "image_url":
-                return this._imageUrlContentToString(content);
+                if ("image_url" in content) {
+                    // Type guard for MessageContentImageUrl
+                    return this._imageUrlContentToString(content);
+                }
+                break;
             default:
-                throw new Error(
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                `Cannot coerce "${content.type}" message part into a string.`);
+                throw new Error(`Cannot coerce "${content.type}" message part into a string.`);
         }
+        throw new Error(`Invalid content type: ${content.type}`);
     }
     _baseMessageContentToString(content) {
         return content.reduce((acc, item) => acc + this._messageContentComplexToString(item), "");

package/dist/prompts/base.d.ts

@@ -1,4 +1,4 @@
-import type { InputValues, PartialValues, StringWithAutocomplete } from "../utils/types.js";
+import type { InputValues, PartialValues, StringWithAutocomplete } from "../utils/types/index.js";
 import { type BasePromptValueInterface } from "../prompt_values.js";
 import { BaseOutputParser } from "../output_parsers/index.js";
 import type { SerializedFields } from "../load/map_keys.js";

package/dist/prompts/chat.cjs

@@ -451,15 +451,44 @@ function _coerceMessagePromptTemplateLike(messagePromptTemplateLike) {
         (0, index_js_1.isBaseMessage)(messagePromptTemplateLike)) {
         return messagePromptTemplateLike;
     }
+    if (Array.isArray(messagePromptTemplateLike) &&
+        messagePromptTemplateLike[0] === "placeholder") {
+        const messageContent = messagePromptTemplateLike[1];
+        if (typeof messageContent !== "string" ||
+            messageContent[0] !== "{" ||
+            messageContent[messageContent.length - 1] !== "}") {
+            throw new Error(`Invalid placeholder template: "${messagePromptTemplateLike[1]}". Expected a variable name surrounded by curly braces.`);
+        }
+        const variableName = messageContent.slice(1, -1);
+        return new MessagesPlaceholder({ variableName, optional: true });
+    }
     const message = (0, index_js_1.coerceMessageLikeToMessage)(messagePromptTemplateLike);
+    let templateData;
+    if (typeof message.content === "string") {
+        templateData = message.content;
+    }
+    else {
+        // Assuming message.content is an array of complex objects, transform it.
+        templateData = message.content.map((item) => {
+            if ("text" in item) {
+                return { text: item.text };
+            }
+            else if ("image_url" in item) {
+                return { image_url: item.image_url };
+            }
+            else {
+                throw new Error("Invalid message content");
+            }
+        });
+    }
     if (message._getType() === "human") {
-        return HumanMessagePromptTemplate.fromTemplate(message.content);
+        return HumanMessagePromptTemplate.fromTemplate(templateData);
     }
     else if (message._getType() === "ai") {
-        return AIMessagePromptTemplate.fromTemplate(message.content);
+        return AIMessagePromptTemplate.fromTemplate(templateData);
     }
     else if (message._getType() === "system") {
-        return SystemMessagePromptTemplate.fromTemplate(message.content);
+        return SystemMessagePromptTemplate.fromTemplate(templateData);
     }
     else if (index_js_1.ChatMessage.isInstance(message)) {
         return ChatMessagePromptTemplate.fromTemplate(message.content, message.role);

package/dist/prompts/chat.d.ts

@@ -1,7 +1,7 @@
 import type { BaseCallbackConfig } from "../callbacks/manager.js";
 import { AIMessage, HumanMessage, SystemMessage, BaseMessage, ChatMessage, type BaseMessageLike, MessageContent } from "../messages/index.js";
 import { type ChatPromptValueInterface } from "../prompt_values.js";
-import type { InputValues, PartialValues } from "../utils/types.js";
+import type { InputValues, PartialValues } from "../utils/types/index.js";
 import { Runnable } from "../runnables/base.js";
 import { BaseStringPromptTemplate } from "./string.js";
 import { BasePromptTemplate, type BasePromptTemplateInput, type TypedPromptInputValues } from "./base.js";

package/dist/prompts/chat.js

@@ -440,15 +440,44 @@ function _coerceMessagePromptTemplateLike(messagePromptTemplateLike) {
         isBaseMessage(messagePromptTemplateLike)) {
         return messagePromptTemplateLike;
     }
+    if (Array.isArray(messagePromptTemplateLike) &&
+        messagePromptTemplateLike[0] === "placeholder") {
+        const messageContent = messagePromptTemplateLike[1];
+        if (typeof messageContent !== "string" ||
+            messageContent[0] !== "{" ||
+            messageContent[messageContent.length - 1] !== "}") {
+            throw new Error(`Invalid placeholder template: "${messagePromptTemplateLike[1]}". Expected a variable name surrounded by curly braces.`);
+        }
+        const variableName = messageContent.slice(1, -1);
+        return new MessagesPlaceholder({ variableName, optional: true });
+    }
     const message = coerceMessageLikeToMessage(messagePromptTemplateLike);
+    let templateData;
+    if (typeof message.content === "string") {
+        templateData = message.content;
+    }
+    else {
+        // Assuming message.content is an array of complex objects, transform it.
+        templateData = message.content.map((item) => {
+            if ("text" in item) {
+                return { text: item.text };
+            }
+            else if ("image_url" in item) {
+                return { image_url: item.image_url };
+            }
+            else {
+                throw new Error("Invalid message content");
+            }
+        });
+    }
     if (message._getType() === "human") {
-        return HumanMessagePromptTemplate.fromTemplate(message.content);
+        return HumanMessagePromptTemplate.fromTemplate(templateData);
     }
     else if (message._getType() === "ai") {
-        return AIMessagePromptTemplate.fromTemplate(message.content);
+        return AIMessagePromptTemplate.fromTemplate(templateData);
     }
     else if (message._getType() === "system") {
-        return SystemMessagePromptTemplate.fromTemplate(message.content);
+        return SystemMessagePromptTemplate.fromTemplate(templateData);
     }
     else if (ChatMessage.isInstance(message)) {
         return ChatMessagePromptTemplate.fromTemplate(message.content, message.role);

package/dist/prompts/few_shot.d.ts

@@ -4,7 +4,7 @@ import type { BaseExampleSelector } from "../example_selectors/base.js";
 import { type TemplateFormat } from "./template.js";
 import { PromptTemplate } from "./prompt.js";
 import type { SerializedFewShotTemplate } from "./serde.js";
-import type { InputValues, PartialValues } from "../utils/types.js";
+import type { InputValues, PartialValues } from "../utils/types/index.js";
 import type { BaseMessage } from "../messages/index.js";
 import { BaseChatPromptTemplate, type BaseMessagePromptTemplate } from "./chat.js";
 export interface FewShotPromptTemplateInput extends BasePromptTemplateInput<InputValues> {

package/dist/prompts/image.d.ts

@@ -1,5 +1,5 @@
 import { ImagePromptValue, ImageContent } from "../prompt_values.js";
-import type { InputValues, PartialValues } from "../utils/types.js";
+import type { InputValues, PartialValues } from "../utils/types/index.js";
 import { BasePromptTemplate, BasePromptTemplateInput, TypedPromptInputValues } from "./base.js";
 import { TemplateFormat } from "./template.js";
 /**

package/dist/prompts/pipeline.d.ts

@@ -1,4 +1,4 @@
-import type { InputValues, PartialValues } from "../utils/types.js";
+import type { InputValues, PartialValues } from "../utils/types/index.js";
 import type { SerializedBasePromptTemplate } from "./serde.js";
 import { BasePromptTemplate, type BasePromptTemplateInput } from "./base.js";
 /**

package/dist/prompts/prompt.d.ts

@@ -2,7 +2,7 @@ import { BaseStringPromptTemplate } from "./string.js";
 import type { BasePromptTemplateInput, TypedPromptInputValues } from "./base.js";
 import { type TemplateFormat } from "./template.js";
 import type { SerializedPromptTemplate } from "./serde.js";
-import type { InputValues, PartialValues } from "../utils/types.js";
+import type { InputValues, PartialValues } from "../utils/types/index.js";
 import { MessageContent } from "../messages/index.js";
 /**
  * Inputs to create a {@link PromptTemplate}

package/dist/prompts/string.d.ts

@@ -1,4 +1,4 @@
-import type { InputValues } from "../utils/types.js";
+import type { InputValues } from "../utils/types/index.js";
 import { type StringPromptValueInterface } from "../prompt_values.js";
 import { BasePromptTemplate, type TypedPromptInputValues } from "./base.js";
 /**