langchain 0.0.130 → 0.0.132

package/dist/stores/message/xata.js

@@ -9,6 +9,12 @@ const chatMemoryColumns = [
     { name: "name", type: "string" },
     { name: "additionalKwargs", type: "text" },
 ];
+/**
+ * A class for managing chat message history using Xata.io client. It
+ * extends the BaseListChatMessageHistory class and provides methods to
+ * get, add, and clear messages. It also ensures the existence of a table
+ * where the chat messages are stored.
+ */
 export class XataChatMessageHistory extends BaseListChatMessageHistory {
     constructor(fields) {
         super(fields);
@@ -79,6 +85,11 @@ export class XataChatMessageHistory extends BaseListChatMessageHistory {
         }
         this.tableInitialized = false;
     }
+    /**
+     * Retrieves all messages associated with the session ID, ordered by
+     * creation time.
+     * @returns A promise that resolves to an array of BaseMessage instances.
+     */
     async getMessages() {
         await this.ensureTable();
         const records = await this.client.db[this.table]
@@ -104,6 +115,11 @@ export class XataChatMessageHistory extends BaseListChatMessageHistory {
         });
         return mapStoredMessagesToChatMessages(orderedMessages);
     }
+    /**
+     * Adds a new message to the database.
+     * @param message The BaseMessage instance to be added.
+     * @returns A promise that resolves when the message has been added.
+     */
     async addMessage(message) {
         await this.ensureTable();
         const messageToAdd = mapChatMessagesToStoredMessages([message]);
@@ -116,6 +132,10 @@ export class XataChatMessageHistory extends BaseListChatMessageHistory {
             additionalKwargs: JSON.stringify(messageToAdd[0].data.additional_kwargs),
         });
     }
+    /**
+     * Deletes all messages associated with the session ID.
+     * @returns A promise that resolves when the messages have been deleted.
+     */
     async clear() {
         await this.ensureTable();
         const records = await this.client.db[this.table]
@@ -125,6 +145,11 @@ export class XataChatMessageHistory extends BaseListChatMessageHistory {
         const ids = records.map((m) => m.id);
         await this.client.db[this.table].delete(ids);
     }
+    /**
+     * Checks if the table exists and creates it if it doesn't. This method is
+     * called before any operation on the table.
+     * @returns A promise that resolves when the table has been ensured.
+     */
     async ensureTable() {
         if (!this.createTable) {
             return;

package/dist/text_splitter.cjs

@@ -162,6 +162,9 @@ which is longer than the specified ${this.chunkSize}`);
 }
 exports.TextSplitter = TextSplitter;
 class CharacterTextSplitter extends TextSplitter {
+    static lc_name() {
+        return "CharacterTextSplitter";
+    }
     constructor(fields) {
         super(fields);
         Object.defineProperty(this, "separator", {
@@ -198,6 +201,9 @@ exports.SupportedTextSplitterLanguages = [
     "sol",
 ];
 class RecursiveCharacterTextSplitter extends TextSplitter {
+    static lc_name() {
+        return "RecursiveCharacterTextSplitter";
+    }
     constructor(fields) {
         super(fields);
         Object.defineProperty(this, "separators", {
@@ -632,6 +638,9 @@ exports.RecursiveCharacterTextSplitter = RecursiveCharacterTextSplitter;
  * Implementation of splitter which looks at tokens.
  */
 class TokenTextSplitter extends TextSplitter {
+    static lc_name() {
+        return "TokenTextSplitter";
+    }
     constructor(fields) {
         super(fields);
         Object.defineProperty(this, "encodingName", {

package/dist/text_splitter.d.ts

@@ -31,6 +31,7 @@ export interface CharacterTextSplitterParams extends TextSplitterParams {
     separator: string;
 }
 export declare class CharacterTextSplitter extends TextSplitter implements CharacterTextSplitterParams {
+    static lc_name(): string;
     separator: string;
     constructor(fields?: Partial<CharacterTextSplitterParams>);
     splitText(text: string): Promise<string[]>;
@@ -41,6 +42,7 @@ export interface RecursiveCharacterTextSplitterParams extends TextSplitterParams
 export declare const SupportedTextSplitterLanguages: readonly ["cpp", "go", "java", "js", "php", "proto", "python", "rst", "ruby", "rust", "scala", "swift", "markdown", "latex", "html", "sol"];
 export type SupportedTextSplitterLanguage = (typeof SupportedTextSplitterLanguages)[number];
 export declare class RecursiveCharacterTextSplitter extends TextSplitter implements RecursiveCharacterTextSplitterParams {
+    static lc_name(): string;
     separators: string[];
     constructor(fields?: Partial<RecursiveCharacterTextSplitterParams>);
     private _splitText;
@@ -57,6 +59,7 @@ export interface TokenTextSplitterParams extends TextSplitterParams {
  * Implementation of splitter which looks at tokens.
  */
 export declare class TokenTextSplitter extends TextSplitter implements TokenTextSplitterParams {
+    static lc_name(): string;
     encodingName: tiktoken.TiktokenEncoding;
     allowedSpecial: "all" | Array<string>;
     disallowedSpecial: "all" | Array<string>;

package/dist/text_splitter.js

@@ -158,6 +158,9 @@ which is longer than the specified ${this.chunkSize}`);
     }
 }
 export class CharacterTextSplitter extends TextSplitter {
+    static lc_name() {
+        return "CharacterTextSplitter";
+    }
     constructor(fields) {
         super(fields);
         Object.defineProperty(this, "separator", {
@@ -193,6 +196,9 @@ export const SupportedTextSplitterLanguages = [
     "sol",
 ];
 export class RecursiveCharacterTextSplitter extends TextSplitter {
+    static lc_name() {
+        return "RecursiveCharacterTextSplitter";
+    }
     constructor(fields) {
         super(fields);
         Object.defineProperty(this, "separators", {
@@ -626,6 +632,9 @@ export class RecursiveCharacterTextSplitter extends TextSplitter {
  * Implementation of splitter which looks at tokens.
  */
 export class TokenTextSplitter extends TextSplitter {
+    static lc_name() {
+        return "TokenTextSplitter";
+    }
     constructor(fields) {
         super(fields);
         Object.defineProperty(this, "encodingName", {

package/dist/tools/IFTTTWebhook.cjs

@@ -36,7 +36,16 @@ service, and you're ready to start receiving data and triggering actions 🎉
 https://maker.ifttt.com/use/YOUR_IFTTT_KEY. Grab the YOUR_IFTTT_KEY value.
  */
 const base_js_1 = require("./base.cjs");
+/**
+ * Represents a tool for creating and managing webhooks with the IFTTT (If
+ * This Then That) service. The IFTTT service allows users to create
+ * chains of simple conditional statements, called applets, which are
+ * triggered based on changes to other web services.
+ */
 class IFTTTWebhook extends base_js_1.Tool {
+    static lc_name() {
+        return "IFTTTWebhook";
+    }
     constructor(url, name, description) {
         super(...arguments);
         Object.defineProperty(this, "url", {

package/dist/tools/IFTTTWebhook.d.ts

@@ -33,7 +33,14 @@ service, and you're ready to start receiving data and triggering actions 🎉
 https://maker.ifttt.com/use/YOUR_IFTTT_KEY. Grab the YOUR_IFTTT_KEY value.
  */
 import { Tool } from "./base.js";
+/**
+ * Represents a tool for creating and managing webhooks with the IFTTT (If
+ * This Then That) service. The IFTTT service allows users to create
+ * chains of simple conditional statements, called applets, which are
+ * triggered based on changes to other web services.
+ */
 export declare class IFTTTWebhook extends Tool {
+    static lc_name(): string;
     private url;
     name: string;
     description: string;

package/dist/tools/IFTTTWebhook.js

@@ -33,7 +33,16 @@ service, and you're ready to start receiving data and triggering actions 🎉
 https://maker.ifttt.com/use/YOUR_IFTTT_KEY. Grab the YOUR_IFTTT_KEY value.
  */
 import { Tool } from "./base.js";
+/**
+ * Represents a tool for creating and managing webhooks with the IFTTT (If
+ * This Then That) service. The IFTTT service allows users to create
+ * chains of simple conditional statements, called applets, which are
+ * triggered based on changes to other web services.
+ */
 export class IFTTTWebhook extends Tool {
+    static lc_name() {
+        return "IFTTTWebhook";
+    }
     constructor(url, name, description) {
         super(...arguments);
         Object.defineProperty(this, "url", {

package/dist/tools/aiplugin.cjs

@@ -2,7 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AIPluginTool = void 0;
 const base_js_1 = require("./base.cjs");
+/**
+ * Class for creating instances of AI tools from plugins. It extends the
+ * Tool class and implements the AIPluginToolParams interface.
+ */
 class AIPluginTool extends base_js_1.Tool {
+    static lc_name() {
+        return "AIPluginTool";
+    }
     get name() {
         return this._name;
     }
@@ -37,6 +44,14 @@ class AIPluginTool extends base_js_1.Tool {
     async _call(_input) {
         return this.apiSpec;
     }
+    /**
+     * Static method that creates an instance of AIPluginTool from a given
+     * plugin URL. It fetches the plugin and its API specification from the
+     * provided URL and returns a new instance of AIPluginTool with the
+     * fetched data.
+     * @param url The URL of the AI plugin.
+     * @returns A new instance of AIPluginTool.
+     */
     static async fromPluginUrl(url) {
         const aiPluginRes = await fetch(url);
         if (!aiPluginRes.ok) {

package/dist/tools/aiplugin.d.ts

@@ -1,10 +1,19 @@
 import { Tool, ToolParams } from "./base.js";
+/**
+ * Interface for parameters required to create an instance of
+ * AIPluginTool.
+ */
 export interface AIPluginToolParams extends ToolParams {
     name: string;
     description: string;
     apiSpec: string;
 }
+/**
+ * Class for creating instances of AI tools from plugins. It extends the
+ * Tool class and implements the AIPluginToolParams interface.
+ */
 export declare class AIPluginTool extends Tool implements AIPluginToolParams {
+    static lc_name(): string;
     private _name;
     private _description;
     apiSpec: string;
@@ -13,5 +22,13 @@ export declare class AIPluginTool extends Tool implements AIPluginToolParams {
     constructor(params: AIPluginToolParams);
     /** @ignore */
     _call(_input: string): Promise<string>;
+    /**
+     * Static method that creates an instance of AIPluginTool from a given
+     * plugin URL. It fetches the plugin and its API specification from the
+     * provided URL and returns a new instance of AIPluginTool with the
+     * fetched data.
+     * @param url The URL of the AI plugin.
+     * @returns A new instance of AIPluginTool.
+     */
     static fromPluginUrl(url: string): Promise<AIPluginTool>;
 }

package/dist/tools/aiplugin.js

@@ -1,5 +1,12 @@
 import { Tool } from "./base.js";
+/**
+ * Class for creating instances of AI tools from plugins. It extends the
+ * Tool class and implements the AIPluginToolParams interface.
+ */
 export class AIPluginTool extends Tool {
+    static lc_name() {
+        return "AIPluginTool";
+    }
     get name() {
         return this._name;
     }
@@ -34,6 +41,14 @@ export class AIPluginTool extends Tool {
     async _call(_input) {
         return this.apiSpec;
     }
+    /**
+     * Static method that creates an instance of AIPluginTool from a given
+     * plugin URL. It fetches the plugin and its API specification from the
+     * provided URL and returns a new instance of AIPluginTool with the
+     * fetched data.
+     * @param url The URL of the AI plugin.
+     * @returns A new instance of AIPluginTool.
+     */
     static async fromPluginUrl(url) {
         const aiPluginRes = await fetch(url);
         if (!aiPluginRes.ok) {

package/dist/tools/aws_lambda.cjs

@@ -2,6 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AWSLambda = void 0;
 const dynamic_js_1 = require("./dynamic.cjs");
+/**
+ * Class for invoking AWS Lambda functions within the LangChain framework.
+ * Extends the DynamicTool class.
+ */
 class AWSLambda extends dynamic_js_1.DynamicTool {
     get lc_namespace() {
         return [...super.lc_namespace, "aws_lambda"];
@@ -61,6 +65,11 @@ class AWSLambda extends dynamic_js_1.DynamicTool {
     }
 }
 exports.AWSLambda = AWSLambda;
+/**
+ * Helper function that imports the necessary AWS SDK modules for invoking
+ * the Lambda function. Returns an object that includes the LambdaClient
+ * and InvokeCommand classes from the AWS SDK.
+ */
 async function LambdaImports() {
     try {
         const { LambdaClient, InvokeCommand } = await import("@aws-sdk/client-lambda");

package/dist/tools/aws_lambda.d.ts

@@ -1,10 +1,17 @@
 import { DynamicTool, DynamicToolInput } from "./dynamic.js";
+/**
+ * Interface for the configuration of the AWS Lambda function.
+ */
 interface LambdaConfig {
     functionName: string;
     region?: string;
     accessKeyId?: string;
     secretAccessKey?: string;
 }
+/**
+ * Class for invoking AWS Lambda functions within the LangChain framework.
+ * Extends the DynamicTool class.
+ */
 declare class AWSLambda extends DynamicTool {
     get lc_namespace(): string[];
     get lc_secrets(): {

package/dist/tools/aws_lambda.js

@@ -1,4 +1,8 @@
 import { DynamicTool } from "./dynamic.js";
+/**
+ * Class for invoking AWS Lambda functions within the LangChain framework.
+ * Extends the DynamicTool class.
+ */
 class AWSLambda extends DynamicTool {
     get lc_namespace() {
         return [...super.lc_namespace, "aws_lambda"];
@@ -57,6 +61,11 @@ class AWSLambda extends DynamicTool {
         });
     }
 }
+/**
+ * Helper function that imports the necessary AWS SDK modules for invoking
+ * the Lambda function. Returns an object that includes the LambdaClient
+ * and InvokeCommand classes from the AWS SDK.
+ */
 async function LambdaImports() {
     try {
         const { LambdaClient, InvokeCommand } = await import("@aws-sdk/client-lambda");

package/dist/tools/aws_sfn.cjs

@@ -3,7 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SendTaskSuccessAWSSfnTool = exports.DescribeExecutionAWSSfnTool = exports.StartExecutionAWSSfnTool = void 0;
 const client_sfn_1 = require("@aws-sdk/client-sfn");
 const base_js_1 = require("./base.cjs");
+/**
+ * Class for starting the execution of an AWS Step Function.
+ */
 class StartExecutionAWSSfnTool extends base_js_1.Tool {
+    static lc_name() {
+        return "StartExecutionAWSSfnTool";
+    }
     constructor({ name, description, ...rest }) {
         super();
         Object.defineProperty(this, "sfnConfig", {
@@ -28,6 +34,12 @@ class StartExecutionAWSSfnTool extends base_js_1.Tool {
         this.description = description;
         this.sfnConfig = rest;
     }
+    /**
+     * Generates a formatted description for the StartExecutionAWSSfnTool.
+     * @param name Name of the state machine.
+     * @param description Description of the state machine.
+     * @returns A formatted description string.
+     */
     static formatDescription(name, description) {
         return `Use to start executing the ${name} state machine. Use to run ${name} workflows. Whenever you need to start (or execute) an asynchronous workflow (or state machine) about ${description} you should ALWAYS use this. Input should be a valid JSON string.`;
     }
@@ -59,7 +71,13 @@ class StartExecutionAWSSfnTool extends base_js_1.Tool {
     }
 }
 exports.StartExecutionAWSSfnTool = StartExecutionAWSSfnTool;
+/**
+ * Class for checking the status of an AWS Step Function execution.
+ */
 class DescribeExecutionAWSSfnTool extends base_js_1.Tool {
+    static lc_name() {
+        return "DescribeExecutionAWSSfnTool";
+    }
     constructor(config) {
         super(config);
         Object.defineProperty(this, "name", {
@@ -111,7 +129,14 @@ class DescribeExecutionAWSSfnTool extends base_js_1.Tool {
     }
 }
 exports.DescribeExecutionAWSSfnTool = DescribeExecutionAWSSfnTool;
+/**
+ * Class for sending a task success signal to an AWS Step Function
+ * execution.
+ */
 class SendTaskSuccessAWSSfnTool extends base_js_1.Tool {
+    static lc_name() {
+        return "SendTaskSuccessAWSSfnTool";
+    }
     constructor(config) {
         super(config);
         Object.defineProperty(this, "name", {
@@ -160,6 +185,9 @@ class SendTaskSuccessAWSSfnTool extends base_js_1.Tool {
     }
 }
 exports.SendTaskSuccessAWSSfnTool = SendTaskSuccessAWSSfnTool;
+/**
+ * Helper function to construct the AWS SFN client.
+ */
 function getClientConstructorArgs(config) {
     const clientConstructorArgs = {};
     if (config.region) {

package/dist/tools/aws_sfn.d.ts

@@ -1,11 +1,18 @@
 import { Tool, ToolParams } from "./base.js";
+/**
+ * Interface for AWS Step Functions configuration.
+ */
 export interface SfnConfig {
     stateMachineArn: string;
     region?: string;
     accessKeyId?: string;
     secretAccessKey?: string;
 }
+/**
+ * Class for starting the execution of an AWS Step Function.
+ */
 export declare class StartExecutionAWSSfnTool extends Tool {
+    static lc_name(): string;
     private sfnConfig;
     name: string;
     description: string;
@@ -13,11 +20,21 @@ export declare class StartExecutionAWSSfnTool extends Tool {
         name: string;
         description: string;
     });
+    /**
+     * Generates a formatted description for the StartExecutionAWSSfnTool.
+     * @param name Name of the state machine.
+     * @param description Description of the state machine.
+     * @returns A formatted description string.
+     */
     static formatDescription(name: string, description: string): string;
     /** @ignore */
     _call(input: string): Promise<string>;
 }
+/**
+ * Class for checking the status of an AWS Step Function execution.
+ */
 export declare class DescribeExecutionAWSSfnTool extends Tool {
+    static lc_name(): string;
     name: string;
     description: string;
     sfnConfig: Omit<SfnConfig, "stateMachineArn">;
@@ -25,7 +42,12 @@ export declare class DescribeExecutionAWSSfnTool extends Tool {
     /** @ignore */
     _call(input: string): Promise<string>;
 }
+/**
+ * Class for sending a task success signal to an AWS Step Function
+ * execution.
+ */
 export declare class SendTaskSuccessAWSSfnTool extends Tool {
+    static lc_name(): string;
     name: string;
     description: string;
     sfnConfig: Omit<SfnConfig, "stateMachineArn">;

package/dist/tools/aws_sfn.js

@@ -1,6 +1,12 @@
 import { SFNClient as Client, StartExecutionCommand as Invoker, DescribeExecutionCommand as Describer, SendTaskSuccessCommand as TaskSuccessSender, } from "@aws-sdk/client-sfn";
 import { Tool } from "./base.js";
+/**
+ * Class for starting the execution of an AWS Step Function.
+ */
 export class StartExecutionAWSSfnTool extends Tool {
+    static lc_name() {
+        return "StartExecutionAWSSfnTool";
+    }
     constructor({ name, description, ...rest }) {
         super();
         Object.defineProperty(this, "sfnConfig", {
@@ -25,6 +31,12 @@ export class StartExecutionAWSSfnTool extends Tool {
         this.description = description;
         this.sfnConfig = rest;
     }
+    /**
+     * Generates a formatted description for the StartExecutionAWSSfnTool.
+     * @param name Name of the state machine.
+     * @param description Description of the state machine.
+     * @returns A formatted description string.
+     */
     static formatDescription(name, description) {
         return `Use to start executing the ${name} state machine. Use to run ${name} workflows. Whenever you need to start (or execute) an asynchronous workflow (or state machine) about ${description} you should ALWAYS use this. Input should be a valid JSON string.`;
     }
@@ -55,7 +67,13 @@ export class StartExecutionAWSSfnTool extends Tool {
         });
     }
 }
+/**
+ * Class for checking the status of an AWS Step Function execution.
+ */
 export class DescribeExecutionAWSSfnTool extends Tool {
+    static lc_name() {
+        return "DescribeExecutionAWSSfnTool";
+    }
     constructor(config) {
         super(config);
         Object.defineProperty(this, "name", {
@@ -106,7 +124,14 @@ export class DescribeExecutionAWSSfnTool extends Tool {
         });
     }
 }
+/**
+ * Class for sending a task success signal to an AWS Step Function
+ * execution.
+ */
 export class SendTaskSuccessAWSSfnTool extends Tool {
+    static lc_name() {
+        return "SendTaskSuccessAWSSfnTool";
+    }
     constructor(config) {
         super(config);
         Object.defineProperty(this, "name", {
@@ -154,6 +179,9 @@ export class SendTaskSuccessAWSSfnTool extends Tool {
         });
     }
 }
+/**
+ * Helper function to construct the AWS SFN client.
+ */
 function getClientConstructorArgs(config) {
     const clientConstructorArgs = {};
     if (config.region) {

package/dist/tools/base.cjs

@@ -20,9 +20,24 @@ class StructuredTool extends index_js_1.BaseLangChain {
             value: false
         });
     }
+    /**
+     * Invokes the tool with the provided input and configuration.
+     * @param input The input for the tool.
+     * @param config Optional configuration for the tool.
+     * @returns A Promise that resolves with a string.
+     */
     async invoke(input, config) {
         return this.call(input, config);
     }
+    /**
+     * Calls the tool with the provided argument, configuration, and tags. It
+     * parses the input according to the schema, handles any errors, and
+     * manages callbacks.
+     * @param arg The input argument for the tool.
+     * @param configArg Optional configuration or callbacks for the tool.
+     * @param tags Optional tags for the tool.
+     * @returns A Promise that resolves with a string.
+     */
     async call(arg, configArg, 
     /** @deprecated */
     tags) {
@@ -58,6 +73,13 @@ class Tool extends StructuredTool {
                 .transform((obj) => obj.input)
         });
     }
+    /**
+     * Calls the tool with the provided argument and callbacks. It handles
+     * string inputs specifically.
+     * @param arg The input argument for the tool, which can be a string, undefined, or an input of the tool's schema.
+     * @param callbacks Optional callbacks for the tool.
+     * @returns A Promise that resolves with a string.
+     */
     call(arg, callbacks) {
         return super.call(typeof arg === "string" || !arg ? { input: arg } : arg, callbacks);
     }

package/dist/tools/base.d.ts

@@ -2,6 +2,9 @@ import { z } from "zod";
 import { CallbackManagerForToolRun, Callbacks } from "../callbacks/manager.js";
 import { BaseLangChain, BaseLangChainParams } from "../base_language/index.js";
 import { RunnableConfig } from "../schema/runnable.js";
+/**
+ * Parameters for the Tool classes.
+ */
 export interface ToolParams extends BaseLangChainParams {
 }
 /**
@@ -12,7 +15,22 @@ export declare abstract class StructuredTool<T extends z.ZodObject<any, any, any
     get lc_namespace(): string[];
     constructor(fields?: ToolParams);
     protected abstract _call(arg: z.output<T>, runManager?: CallbackManagerForToolRun): Promise<string>;
+    /**
+     * Invokes the tool with the provided input and configuration.
+     * @param input The input for the tool.
+     * @param config Optional configuration for the tool.
+     * @returns A Promise that resolves with a string.
+     */
     invoke(input: (z.output<T> extends string ? string : never) | z.input<T>, config?: RunnableConfig): Promise<string>;
+    /**
+     * Calls the tool with the provided argument, configuration, and tags. It
+     * parses the input according to the schema, handles any errors, and
+     * manages callbacks.
+     * @param arg The input argument for the tool.
+     * @param configArg Optional configuration or callbacks for the tool.
+     * @param tags Optional tags for the tool.
+     * @returns A Promise that resolves with a string.
+     */
     call(arg: (z.output<T> extends string ? string : never) | z.input<T>, configArg?: Callbacks | RunnableConfig, 
     /** @deprecated */
     tags?: string[]): Promise<string>;
@@ -34,5 +52,12 @@ export declare abstract class Tool extends StructuredTool {
         input?: string | undefined;
     }>;
     constructor(fields?: ToolParams);
+    /**
+     * Calls the tool with the provided argument and callbacks. It handles
+     * string inputs specifically.
+     * @param arg The input argument for the tool, which can be a string, undefined, or an input of the tool's schema.
+     * @param callbacks Optional callbacks for the tool.
+     * @returns A Promise that resolves with a string.
+     */
     call(arg: string | undefined | z.input<this["schema"]>, callbacks?: Callbacks): Promise<string>;
 }

package/dist/tools/base.js

@@ -17,9 +17,24 @@ export class StructuredTool extends BaseLangChain {
             value: false
         });
     }
+    /**
+     * Invokes the tool with the provided input and configuration.
+     * @param input The input for the tool.
+     * @param config Optional configuration for the tool.
+     * @returns A Promise that resolves with a string.
+     */
     async invoke(input, config) {
         return this.call(input, config);
     }
+    /**
+     * Calls the tool with the provided argument, configuration, and tags. It
+     * parses the input according to the schema, handles any errors, and
+     * manages callbacks.
+     * @param arg The input argument for the tool.
+     * @param configArg Optional configuration or callbacks for the tool.
+     * @param tags Optional tags for the tool.
+     * @returns A Promise that resolves with a string.
+     */
     async call(arg, configArg, 
     /** @deprecated */
     tags) {
@@ -54,6 +69,13 @@ export class Tool extends StructuredTool {
                 .transform((obj) => obj.input)
         });
     }
+    /**
+     * Calls the tool with the provided argument and callbacks. It handles
+     * string inputs specifically.
+     * @param arg The input argument for the tool, which can be a string, undefined, or an input of the tool's schema.
+     * @param callbacks Optional callbacks for the tool.
+     * @returns A Promise that resolves with a string.
+     */
     call(arg, callbacks) {
         return super.call(typeof arg === "string" || !arg ? { input: arg } : arg, callbacks);
     }