@langchain/core 0.3.56 → 0.3.57

package/dist/prompts/structured.cjs

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StructuredPrompt = void 0;
+const base_js_1 = require("../runnables/base.cjs");
 const chat_js_1 = require("./chat.cjs");
 function isWithStructuredOutput(x
 // eslint-disable-next-line @typescript-eslint/ban-types
@@ -54,15 +55,12 @@ class StructuredPrompt extends chat_js_1.ChatPromptTemplate {
         }
         if (isRunnableBinding(coerceable) &&
             isWithStructuredOutput(coerceable.bound)) {
-            return super.pipe(this.method
-                ? coerceable.bound
-                    .withStructuredOutput(this.schema, { method: this.method })
-                    .bind(coerceable.kwargs ?? {})
-                    .withConfig(coerceable.config)
-                : coerceable.bound
-                    .withStructuredOutput(this.schema)
-                    .bind(coerceable.kwargs ?? {})
-                    .withConfig(coerceable.config));
+            return super.pipe(new base_js_1.RunnableBinding({
+                bound: coerceable.bound.withStructuredOutput(this.schema, ...(this.method ? [{ method: this.method }] : [])),
+                kwargs: coerceable.kwargs ?? {},
+                config: coerceable.config,
+                configFactories: coerceable.configFactories,
+            }));
         }
         throw new Error(`Structured prompts need to be piped to a language model that supports the "withStructuredOutput()" method.`);
     }

package/dist/prompts/structured.js

@@ -1,3 +1,4 @@
+import { RunnableBinding } from "../runnables/base.js";
 import { ChatPromptTemplate, } from "./chat.js";
 function isWithStructuredOutput(x
 // eslint-disable-next-line @typescript-eslint/ban-types
@@ -51,15 +52,12 @@ export class StructuredPrompt extends ChatPromptTemplate {
         }
         if (isRunnableBinding(coerceable) &&
             isWithStructuredOutput(coerceable.bound)) {
-            return super.pipe(this.method
-                ? coerceable.bound
-                    .withStructuredOutput(this.schema, { method: this.method })
-                    .bind(coerceable.kwargs ?? {})
-                    .withConfig(coerceable.config)
-                : coerceable.bound
-                    .withStructuredOutput(this.schema)
-                    .bind(coerceable.kwargs ?? {})
-                    .withConfig(coerceable.config));
+            return super.pipe(new RunnableBinding({
+                bound: coerceable.bound.withStructuredOutput(this.schema, ...(this.method ? [{ method: this.method }] : [])),
+                kwargs: coerceable.kwargs ?? {},
+                config: coerceable.config,
+                configFactories: coerceable.configFactories,
+            }));
         }
         throw new Error(`Structured prompts need to be piped to a language model that supports the "withStructuredOutput()" method.`);
     }

package/dist/runnables/base.cjs

@@ -63,6 +63,8 @@ class Runnable extends serializable_js_1.Serializable {
      * Bind arguments to a Runnable, returning a new Runnable.
      * @param kwargs
      * @returns A new RunnableBinding that, when invoked, will apply the bound args.
+     *
+     * @deprecated Use {@link withConfig} instead. This will be removed in the next breaking release.
      */
     bind(kwargs) {
         // eslint-disable-next-line @typescript-eslint/no-use-before-define
@@ -71,6 +73,8 @@ class Runnable extends serializable_js_1.Serializable {
     /**
      * Return a new Runnable that maps a list of inputs to a list of outputs,
      * by calling invoke() with each input.
+     *
+     * @deprecated This will be removed in the next breaking release.
      */
     map() {
         // eslint-disable-next-line @typescript-eslint/no-use-before-define
@@ -78,7 +82,8 @@ class Runnable extends serializable_js_1.Serializable {
     }
     /**
      * Add retry logic to an existing runnable.
-     * @param kwargs
+     * @param fields.stopAfterAttempt The number of attempts to retry.
+     * @param fields.onFailedAttempt A function that is called when a retry fails.
      * @returns A new RunnableRetry that, when invoked, will retry according to the parameters.
      */
     withRetry(fields) {
@@ -774,7 +779,8 @@ class Runnable extends serializable_js_1.Serializable {
 }
 exports.Runnable = Runnable;
 /**
- * A runnable that delegates calls to another runnable with a set of kwargs.
+ * Wraps a runnable and applies partial config upon invocation.
+ *
  * @example
  * ```typescript
  * import {
@@ -869,8 +875,14 @@ class RunnableBinding extends Runnable {
             ? await Promise.all(this.configFactories.map(async (configFactory) => await configFactory(config)))
             : []));
     }
+    /**
+     * Binds the runnable with the specified arguments.
+     * @param kwargs The arguments to bind the runnable with.
+     * @returns A new instance of the `RunnableBinding` class that is bound with the specified arguments.
+     *
+     * @deprecated Use {@link withConfig} instead. This will be removed in the next breaking release.
+     */
     bind(kwargs) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         return new this.constructor({
             bound: this.bound,
             kwargs: { ...this.kwargs, ...kwargs },
@@ -878,7 +890,6 @@ class RunnableBinding extends Runnable {
         });
     }
     withConfig(config) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         return new this.constructor({
             bound: this.bound,
             kwargs: this.kwargs,
@@ -886,11 +897,13 @@ class RunnableBinding extends Runnable {
         });
     }
     withRetry(fields) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        return new this.constructor({
-            bound: this.bound.withRetry(fields),
+        // eslint-disable-next-line @typescript-eslint/no-use-before-define
+        return new RunnableRetry({
+            bound: this.bound,
             kwargs: this.kwargs,
             config: this.config,
+            maxAttemptNumber: fields?.stopAfterAttempt,
+            ...fields,
         });
     }
     async invoke(input, options) {
@@ -982,6 +995,8 @@ exports.RunnableBinding = RunnableBinding;
  *
  * // ["Hello, ALICE!", "Hello, BOB!", "Hello, CAROL!"]
  * ```
+ *
+ * @deprecated This will be removed in the next breaking release.
  */
 class RunnableEach extends Runnable {
     static lc_name() {
@@ -1013,6 +1028,8 @@ class RunnableEach extends Runnable {
      * Binds the runnable with the specified arguments.
      * @param kwargs The arguments to bind the runnable with.
      * @returns A new instance of the `RunnableEach` class that is bound with the specified arguments.
+     *
+     * @deprecated Use {@link withConfig} instead. This will be removed in the next breaking release.
      */
     bind(kwargs) {
         return new RunnableEach({

package/dist/runnables/base.d.ts

@@ -30,16 +30,21 @@ export declare abstract class Runnable<RunInput = any, RunOutput = any, CallOpti
      * Bind arguments to a Runnable, returning a new Runnable.
      * @param kwargs
      * @returns A new RunnableBinding that, when invoked, will apply the bound args.
+     *
+     * @deprecated Use {@link withConfig} instead. This will be removed in the next breaking release.
      */
     bind(kwargs: Partial<CallOptions>): Runnable<RunInput, RunOutput, CallOptions>;
     /**
      * Return a new Runnable that maps a list of inputs to a list of outputs,
      * by calling invoke() with each input.
+     *
+     * @deprecated This will be removed in the next breaking release.
      */
     map(): Runnable<RunInput[], RunOutput[], CallOptions>;
     /**
      * Add retry logic to an existing runnable.
-     * @param kwargs
+     * @param fields.stopAfterAttempt The number of attempts to retry.
+     * @param fields.onFailedAttempt A function that is called when a retry fails.
      * @returns A new RunnableRetry that, when invoked, will retry according to the parameters.
      */
     withRetry(fields?: {
@@ -310,12 +315,16 @@ export declare abstract class Runnable<RunInput = any, RunOutput = any, CallOpti
 }
 export type RunnableBindingArgs<RunInput, RunOutput, CallOptions extends RunnableConfig = RunnableConfig> = {
     bound: Runnable<RunInput, RunOutput, CallOptions>;
+    /**
+     * @deprecated use {@link config} instead
+     */
     kwargs?: Partial<CallOptions>;
     config: RunnableConfig;
-    configFactories?: Array<(config: RunnableConfig) => RunnableConfig>;
+    configFactories?: Array<(config: RunnableConfig) => RunnableConfig | Promise<RunnableConfig>>;
 };
 /**
- * A runnable that delegates calls to another runnable with a set of kwargs.
+ * Wraps a runnable and applies partial config upon invocation.
+ *
  * @example
  * ```typescript
  * import {
@@ -365,8 +374,15 @@ export declare class RunnableBinding<RunInput, RunOutput, CallOptions extends Ru
     constructor(fields: RunnableBindingArgs<RunInput, RunOutput, CallOptions>);
     getName(suffix?: string | undefined): string;
     _mergeConfig(...options: (Partial<CallOptions> | RunnableConfig | undefined)[]): Promise<Partial<CallOptions>>;
+    /**
+     * Binds the runnable with the specified arguments.
+     * @param kwargs The arguments to bind the runnable with.
+     * @returns A new instance of the `RunnableBinding` class that is bound with the specified arguments.
+     *
+     * @deprecated Use {@link withConfig} instead. This will be removed in the next breaking release.
+     */
     bind(kwargs: Partial<CallOptions>): RunnableBinding<RunInput, RunOutput, CallOptions>;
-    withConfig(config: RunnableConfig): Runnable<RunInput, RunOutput, CallOptions>;
+    withConfig(config: Partial<CallOptions>): Runnable<RunInput, RunOutput, CallOptions>;
     withRetry(fields?: {
         stopAfterAttempt?: number;
         onFailedAttempt?: RunnableRetryFailedAttemptHandler;
@@ -428,6 +444,8 @@ export declare class RunnableBinding<RunInput, RunOutput, CallOptions extends Ru
  *
  * // ["Hello, ALICE!", "Hello, BOB!", "Hello, CAROL!"]
  * ```
+ *
+ * @deprecated This will be removed in the next breaking release.
  */
 export declare class RunnableEach<RunInputItem, RunOutputItem, CallOptions extends RunnableConfig> extends Runnable<RunInputItem[], RunOutputItem[], CallOptions> {
     static lc_name(): string;
@@ -441,6 +459,8 @@ export declare class RunnableEach<RunInputItem, RunOutputItem, CallOptions exten
      * Binds the runnable with the specified arguments.
      * @param kwargs The arguments to bind the runnable with.
      * @returns A new instance of the `RunnableEach` class that is bound with the specified arguments.
+     *
+     * @deprecated Use {@link withConfig} instead. This will be removed in the next breaking release.
      */
     bind(kwargs: Partial<CallOptions>): RunnableEach<RunInputItem, RunOutputItem, CallOptions>;
     /**

package/dist/runnables/base.js

@@ -56,6 +56,8 @@ export class Runnable extends Serializable {
      * Bind arguments to a Runnable, returning a new Runnable.
      * @param kwargs
      * @returns A new RunnableBinding that, when invoked, will apply the bound args.
+     *
+     * @deprecated Use {@link withConfig} instead. This will be removed in the next breaking release.
      */
     bind(kwargs) {
         // eslint-disable-next-line @typescript-eslint/no-use-before-define
@@ -64,6 +66,8 @@ export class Runnable extends Serializable {
     /**
      * Return a new Runnable that maps a list of inputs to a list of outputs,
      * by calling invoke() with each input.
+     *
+     * @deprecated This will be removed in the next breaking release.
      */
     map() {
         // eslint-disable-next-line @typescript-eslint/no-use-before-define
@@ -71,7 +75,8 @@ export class Runnable extends Serializable {
     }
     /**
      * Add retry logic to an existing runnable.
-     * @param kwargs
+     * @param fields.stopAfterAttempt The number of attempts to retry.
+     * @param fields.onFailedAttempt A function that is called when a retry fails.
      * @returns A new RunnableRetry that, when invoked, will retry according to the parameters.
      */
     withRetry(fields) {
@@ -766,7 +771,8 @@ export class Runnable extends Serializable {
     }
 }
 /**
- * A runnable that delegates calls to another runnable with a set of kwargs.
+ * Wraps a runnable and applies partial config upon invocation.
+ *
  * @example
  * ```typescript
  * import {
@@ -861,8 +867,14 @@ export class RunnableBinding extends Runnable {
             ? await Promise.all(this.configFactories.map(async (configFactory) => await configFactory(config)))
             : []));
     }
+    /**
+     * Binds the runnable with the specified arguments.
+     * @param kwargs The arguments to bind the runnable with.
+     * @returns A new instance of the `RunnableBinding` class that is bound with the specified arguments.
+     *
+     * @deprecated Use {@link withConfig} instead. This will be removed in the next breaking release.
+     */
     bind(kwargs) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         return new this.constructor({
             bound: this.bound,
             kwargs: { ...this.kwargs, ...kwargs },
@@ -870,7 +882,6 @@ export class RunnableBinding extends Runnable {
         });
     }
     withConfig(config) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         return new this.constructor({
             bound: this.bound,
             kwargs: this.kwargs,
@@ -878,11 +889,13 @@ export class RunnableBinding extends Runnable {
         });
     }
     withRetry(fields) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        return new this.constructor({
-            bound: this.bound.withRetry(fields),
+        // eslint-disable-next-line @typescript-eslint/no-use-before-define
+        return new RunnableRetry({
+            bound: this.bound,
             kwargs: this.kwargs,
             config: this.config,
+            maxAttemptNumber: fields?.stopAfterAttempt,
+            ...fields,
         });
     }
     async invoke(input, options) {
@@ -973,6 +986,8 @@ export class RunnableBinding extends Runnable {
  *
  * // ["Hello, ALICE!", "Hello, BOB!", "Hello, CAROL!"]
  * ```
+ *
+ * @deprecated This will be removed in the next breaking release.
  */
 export class RunnableEach extends Runnable {
     static lc_name() {
@@ -1004,6 +1019,8 @@ export class RunnableEach extends Runnable {
      * Binds the runnable with the specified arguments.
      * @param kwargs The arguments to bind the runnable with.
      * @returns A new instance of the `RunnableEach` class that is bound with the specified arguments.
+     *
+     * @deprecated Use {@link withConfig} instead. This will be removed in the next breaking release.
      */
     bind(kwargs) {
         return new RunnableEach({

package/dist/runnables/passthrough.cjs

@@ -112,7 +112,7 @@ class RunnablePassthrough extends base_js_1.Runnable {
      *     schema: async () => db.getTableInfo(),
      *   }),
      *   prompt,
-     *   new ChatOpenAI({}).bind({ stop: ["\nSQLResult:"] }),
+     *   new ChatOpenAI({}).withConfig({ stop: ["\nSQLResult:"] }),
      *   new StringOutputParser(),
      * ]);
      * const result = await sqlQueryGeneratorChain.invoke({

package/dist/runnables/passthrough.d.ts

@@ -57,7 +57,7 @@ export declare class RunnablePassthrough<RunInput = any> extends Runnable<RunInp
      *     schema: async () => db.getTableInfo(),
      *   }),
      *   prompt,
-     *   new ChatOpenAI({}).bind({ stop: ["\nSQLResult:"] }),
+     *   new ChatOpenAI({}).withConfig({ stop: ["\nSQLResult:"] }),
      *   new StringOutputParser(),
      * ]);
      * const result = await sqlQueryGeneratorChain.invoke({

package/dist/runnables/passthrough.js

@@ -109,7 +109,7 @@ export class RunnablePassthrough extends Runnable {
      *     schema: async () => db.getTableInfo(),
      *   }),
      *   prompt,
-     *   new ChatOpenAI({}).bind({ stop: ["\nSQLResult:"] }),
+     *   new ChatOpenAI({}).withConfig({ stop: ["\nSQLResult:"] }),
      *   new StringOutputParser(),
      * ]);
      * const result = await sqlQueryGeneratorChain.invoke({

package/dist/tools/index.cjs

@@ -426,7 +426,7 @@ function _formatToolOutput(params) {
 }
 function _stringify(content) {
     try {
-        return JSON.stringify(content, null, 2);
+        return JSON.stringify(content, null, 2) ?? "";
     }
     catch (_noOp) {
         return `${content}`;

package/dist/tools/index.js

@@ -413,7 +413,7 @@ function _formatToolOutput(params) {
 }
 function _stringify(content) {
     try {
-        return JSON.stringify(content, null, 2);
+        return JSON.stringify(content, null, 2) ?? "";
     }
     catch (_noOp) {
         return `${content}`;

package/dist/utils/testing/index.cjs

@@ -283,7 +283,7 @@ class FakeStreamingChatModel extends chat_models_js_1.BaseChatModel {
             thrownErrorString: this.thrownErrorString,
         });
         next.tools = merged;
-        return next.bind({ tools: wrapped });
+        return next.withConfig({ tools: wrapped });
     }
     async _generate(messages, _options, _runManager) {
         if (this.thrownErrorString) {

package/dist/utils/testing/index.js

@@ -275,7 +275,7 @@ export class FakeStreamingChatModel extends BaseChatModel {
             thrownErrorString: this.thrownErrorString,
         });
         next.tools = merged;
-        return next.bind({ tools: wrapped });
+        return next.withConfig({ tools: wrapped });
     }
     async _generate(messages, _options, _runManager) {
         if (this.thrownErrorString) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/core",
-  "version": "0.3.56",
+  "version": "0.3.57",
   "description": "Core LangChain.js abstractions and schemas",
   "type": "module",
   "engines": {