@langchain/classic 1.0.17 → 1.0.18

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @langchain/classic
 
+## 1.0.18
+
+### Patch Changes
+
+- Updated dependencies [[`05396f7`](https://github.com/langchain-ai/langchainjs/commit/05396f7ce0a91c49a3bae4bbcd3dbdd6cbd18089), [`5a6f26b`](https://github.com/langchain-ai/langchainjs/commit/5a6f26bbaed80195dc538c538b96219a8b03f38f), [`7be50a7`](https://github.com/langchain-ai/langchainjs/commit/7be50a7014d7622e0ab8d303dfc9c633ebc96333)]:
+  - @langchain/openai@1.2.8
+
 ## 1.0.17
 
 ### Patch Changes

package/dist/_virtual/{rolldown_runtime.cjs → _rolldown/runtime.cjs}

@@ -1,23 +1,34 @@
-//#region rolldown:runtime
+//#region \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (!no_symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
 };
 var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
 	}
 	return to;
 };
@@ -29,6 +40,6 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 
 //#endregion
 
-exports.__export = __export;
+exports.__exportAll = __exportAll;
 exports.__reExport = __reExport;
 exports.__toESM = __toESM;

package/dist/_virtual/_rolldown/runtime.js

@@ -0,0 +1,36 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (!no_symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+
+//#endregion
+export { __exportAll, __reExport };

package/dist/agents/agent.cjs

@@ -1,6 +1,6 @@
-const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
-const __langchain_core_load_serializable = require_rolldown_runtime.__toESM(require("@langchain/core/load/serializable"));
-const __langchain_core_runnables = require_rolldown_runtime.__toESM(require("@langchain/core/runnables"));
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+let _langchain_core_load_serializable = require("@langchain/core/load/serializable");
+let _langchain_core_runnables = require("@langchain/core/runnables");
 
 //#region src/agents/agent.ts
 /**
@@ -18,13 +18,11 @@ var ParseError = class extends Error {
 * Abstract base class for agents in LangChain. Provides common
 * functionality for agents, such as handling inputs and outputs.
 */
-var BaseAgent = class extends __langchain_core_load_serializable.Serializable {
+var BaseAgent = class extends _langchain_core_load_serializable.Serializable {
 	get returnValues() {
 		return ["output"];
 	}
-	get allowedTools() {
-		return void 0;
-	}
+	get allowedTools() {}
 	/**
 	* Return the string type key uniquely identifying this class of agent.
 	*/
@@ -74,11 +72,11 @@ function isAgentAction(input) {
 function isRunnableAgent(x) {
 	return x.runnable !== void 0;
 }
-var AgentRunnableSequence = class extends __langchain_core_runnables.RunnableSequence {
+var AgentRunnableSequence = class extends _langchain_core_runnables.RunnableSequence {
 	streamRunnable;
 	singleAction;
 	static fromRunnables([first, ...runnables], config) {
-		const sequence = __langchain_core_runnables.RunnableSequence.from([first, ...runnables], config.name);
+		const sequence = _langchain_core_runnables.RunnableSequence.from([first, ...runnables], config.name);
 		sequence.singleAction = config.singleAction;
 		sequence.streamRunnable = config.streamRunnable;
 		return sequence;
@@ -126,7 +124,7 @@ var RunnableSingleActionAgent = class extends BaseSingleActionAgent {
 			...inputs,
 			steps
 		};
-		const combinedConfig = (0, __langchain_core_runnables.patchConfig)(config, {
+		const combinedConfig = (0, _langchain_core_runnables.patchConfig)(config, {
 			callbacks: callbackManager,
 			runName: this.defaultRunName
 		});
@@ -170,7 +168,7 @@ var RunnableMultiActionAgent = class extends BaseMultiActionAgent {
 			...inputs,
 			steps
 		};
-		const combinedConfig = (0, __langchain_core_runnables.patchConfig)(config, {
+		const combinedConfig = (0, _langchain_core_runnables.patchConfig)(config, {
 			callbacks: callbackManager,
 			runName: this.defaultRunName
 		});

package/dist/agents/agent.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"agent.cjs","names":["msg: string","output: string","Serializable","earlyStoppingMethod: StoppingMethod","_steps: AgentStep[]","_inputs: ChainValues","_callbackManager?: CallbackManager","_returnValues: AgentFinish[\"returnValues\"]","input: unknown","x: BaseAgent","RunnableSequence","config: { singleAction: boolean; streamRunnable?: boolean; name?: string }","x: Runnable","fields: RunnableSingleActionAgentInput","steps: AgentStep[]","inputs: ChainValues","callbackManager?: CallbackManager","config?: RunnableConfig","finalOutput: AgentAction | AgentFinish | undefined","fields: RunnableMultiActionAgentInput","finalOutput: AgentAction | AgentFinish | AgentAction[] | undefined","input: LLMSingleActionAgentInput","input: AgentInput","_fields?: OutputParserArgs","_tools: StructuredToolInterface[]","_fields?: Record<string, any>","_llm: BaseLanguageModelInterface","_args?: AgentArgs","suffix?: string","newInputs: ChainValues","data: SerializedAgent & {\n      llm?: BaseLanguageModelInterface;\n      tools?: ToolInterface[];\n    }"],"sources":["../../src/agents/agent.ts"],"sourcesContent":["import type {\n  StructuredToolInterface,\n  ToolInterface,\n} from \"@langchain/core/tools\";\nimport type { BaseLanguageModelInterface } from \"@langchain/core/language_models/base\";\nimport { CallbackManager, Callbacks } from \"@langchain/core/callbacks/manager\";\nimport { BasePromptTemplate } from \"@langchain/core/prompts\";\nimport { AgentAction, AgentFinish, AgentStep } from \"@langchain/core/agents\";\nimport { BaseMessage } from \"@langchain/core/messages\";\nimport { ChainValues } from \"@langchain/core/utils/types\";\nimport { Serializable } from \"@langchain/core/load/serializable\";\nimport {\n  Runnable,\n  patchConfig,\n  type RunnableConfig,\n  RunnableSequence,\n  RunnableLike,\n} from \"@langchain/core/runnables\";\nimport { LLMChain } from \"../chains/llm_chain.js\";\nimport type {\n  AgentActionOutputParser,\n  AgentInput,\n  RunnableMultiActionAgentInput,\n  RunnableSingleActionAgentInput,\n  SerializedAgent,\n  StoppingMethod,\n} from \"./types.js\";\n\n/**\n * Record type for arguments passed to output parsers.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type OutputParserArgs = Record<string, any>;\n\n/**\n * Error class for parse errors in LangChain. Contains information about\n * the error message and the output that caused the error.\n */\nclass ParseError extends Error {\n  output: string;\n\n  constructor(msg: string, output: string) {\n    super(msg);\n    this.output = output;\n  }\n}\n\n/**\n * Abstract base class for agents in LangChain. Provides common\n * functionality for agents, such as handling inputs and outputs.\n */\nexport abstract class BaseAgent extends Serializable {\n  declare ToolType: StructuredToolInterface;\n\n  abstract get inputKeys(): string[];\n\n  get returnValues(): string[] {\n    return [\"output\"];\n  }\n\n  get allowedTools(): string[] | undefined {\n    return undefined;\n  }\n\n  /**\n   * Return the string type key uniquely identifying this class of agent.\n   */\n  _agentType(): string {\n    throw new Error(\"Not implemented\");\n  }\n\n  /**\n   * Return the string type key uniquely identifying multi or single action agents.\n   */\n  abstract _agentActionType(): string;\n\n  /**\n   * Return response when agent has been stopped due to max iterations\n   */\n  returnStoppedResponse(\n    earlyStoppingMethod: StoppingMethod,\n    _steps: AgentStep[],\n    _inputs: ChainValues,\n    _callbackManager?: CallbackManager\n  ): Promise<AgentFinish> {\n    if (earlyStoppingMethod === \"force\") {\n      return Promise.resolve({\n        returnValues: { output: \"Agent stopped due to max iterations.\" },\n        log: \"\",\n      });\n    }\n\n    throw new Error(`Invalid stopping method: ${earlyStoppingMethod}`);\n  }\n\n  /**\n   * Prepare the agent for output, if needed\n   */\n  async prepareForOutput(\n    _returnValues: AgentFinish[\"returnValues\"],\n    _steps: AgentStep[]\n  ): Promise<AgentFinish[\"returnValues\"]> {\n    return {};\n  }\n}\n\n/**\n * Abstract base class for single action agents in LangChain. Extends the\n * BaseAgent class and provides additional functionality specific to\n * single action agents.\n */\nexport abstract class BaseSingleActionAgent extends BaseAgent {\n  _agentActionType(): string {\n    return \"single\" as const;\n  }\n\n  /**\n   * Decide what to do, given some input.\n   *\n   * @param steps - Steps the LLM has taken so far, along with observations from each.\n   * @param inputs - User inputs.\n   * @param callbackManager - Callback manager.\n   *\n   * @returns Action specifying what tool to use.\n   */\n  abstract plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager,\n    config?: RunnableConfig\n  ): Promise<AgentAction | AgentFinish>;\n}\n\n/**\n * Abstract base class for multi-action agents in LangChain. Extends the\n * BaseAgent class and provides additional functionality specific to\n * multi-action agents.\n */\nexport abstract class BaseMultiActionAgent extends BaseAgent {\n  _agentActionType(): string {\n    return \"multi\" as const;\n  }\n\n  /**\n   * Decide what to do, given some input.\n   *\n   * @param steps - Steps the LLM has taken so far, along with observations from each.\n   * @param inputs - User inputs.\n   * @param callbackManager - Callback manager.\n   *\n   * @returns Actions specifying what tools to use.\n   */\n  abstract plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager,\n    config?: RunnableConfig\n  ): Promise<AgentAction[] | AgentFinish>;\n}\n\nfunction isAgentAction(input: unknown): input is AgentAction {\n  return !Array.isArray(input) && (input as AgentAction)?.tool !== undefined;\n}\n\nexport function isRunnableAgent(x: BaseAgent) {\n  return (\n    (x as RunnableMultiActionAgent | RunnableSingleActionAgent).runnable !==\n    undefined\n  );\n}\n\n// TODO: Remove in the future. Only for backwards compatibility.\n// Allows for the creation of runnables with properties that will\n// be passed to the agent executor constructor.\nexport class AgentRunnableSequence<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  RunInput = any,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  RunOutput = any,\n> extends RunnableSequence<RunInput, RunOutput> {\n  streamRunnable?: boolean;\n\n  singleAction: boolean;\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  static fromRunnables<RunInput = any, RunOutput = any>(\n    [first, ...runnables]: [\n      RunnableLike<RunInput>,\n      ...RunnableLike[],\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      RunnableLike<any, RunOutput>,\n    ],\n    config: { singleAction: boolean; streamRunnable?: boolean; name?: string }\n  ): AgentRunnableSequence<RunInput, Exclude<RunOutput, Error>> {\n    const sequence = RunnableSequence.from(\n      [first, ...runnables],\n      config.name\n    ) as AgentRunnableSequence<RunInput, Exclude<RunOutput, Error>>;\n    sequence.singleAction = config.singleAction;\n    sequence.streamRunnable = config.streamRunnable;\n    return sequence;\n  }\n\n  static isAgentRunnableSequence(x: Runnable): x is AgentRunnableSequence {\n    return typeof (x as AgentRunnableSequence).singleAction === \"boolean\";\n  }\n}\n\n/**\n * Class representing a single-action agent powered by runnables.\n * Extends the BaseSingleActionAgent class and provides methods for\n * planning agent actions with runnables.\n */\nexport class RunnableSingleActionAgent extends BaseSingleActionAgent {\n  lc_namespace = [\"langchain\", \"agents\", \"runnable\"];\n\n  runnable: Runnable<\n    ChainValues & { steps: AgentStep[] },\n    AgentAction | AgentFinish\n  >;\n\n  get inputKeys(): string[] {\n    return [];\n  }\n\n  /**\n   * Whether to stream from the runnable or not.\n   * If true, the underlying LLM is invoked in a streaming fashion to make it\n   * possible to get access to the individual LLM tokens when using\n   * `streamLog` with the Agent Executor. If false then LLM is invoked in a\n   * non-streaming fashion and individual LLM tokens will not be available\n   * in `streamLog`.\n   *\n   * Note that the runnable should still only stream a single action or\n   * finish chunk.\n   */\n  streamRunnable = true;\n\n  defaultRunName = \"RunnableAgent\";\n\n  constructor(fields: RunnableSingleActionAgentInput) {\n    super(fields);\n    this.runnable = fields.runnable;\n    this.defaultRunName =\n      fields.defaultRunName ?? this.runnable.name ?? this.defaultRunName;\n    this.streamRunnable = fields.streamRunnable ?? this.streamRunnable;\n  }\n\n  async plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager,\n    config?: RunnableConfig\n  ): Promise<AgentAction | AgentFinish> {\n    const combinedInput = { ...inputs, steps };\n    const combinedConfig = patchConfig(config, {\n      callbacks: callbackManager,\n      runName: this.defaultRunName,\n    });\n    if (this.streamRunnable) {\n      const stream = await this.runnable.stream(combinedInput, combinedConfig);\n      let finalOutput: AgentAction | AgentFinish | undefined;\n      for await (const chunk of stream) {\n        if (finalOutput === undefined) {\n          finalOutput = chunk;\n        } else {\n          throw new Error(\n            [\n              `Multiple agent actions/finishes received in streamed agent output.`,\n              `Set \"streamRunnable: false\" when initializing the agent to invoke this agent in non-streaming mode.`,\n            ].join(\"\\n\")\n          );\n        }\n      }\n      if (finalOutput === undefined) {\n        throw new Error(\n          [\n            \"No streaming output received from underlying runnable.\",\n            `Set \"streamRunnable: false\" when initializing the agent to invoke this agent in non-streaming mode.`,\n          ].join(\"\\n\")\n        );\n      }\n      return finalOutput;\n    } else {\n      return this.runnable.invoke(combinedInput, combinedConfig);\n    }\n  }\n}\n\n/**\n * Class representing a multi-action agent powered by runnables.\n * Extends the BaseMultiActionAgent class and provides methods for\n * planning agent actions with runnables.\n */\nexport class RunnableMultiActionAgent extends BaseMultiActionAgent {\n  lc_namespace = [\"langchain\", \"agents\", \"runnable\"];\n\n  // TODO: Rename input to \"intermediate_steps\"\n  runnable: Runnable<\n    ChainValues & { steps: AgentStep[] },\n    AgentAction[] | AgentAction | AgentFinish\n  >;\n\n  defaultRunName = \"RunnableAgent\";\n\n  stop?: string[];\n\n  streamRunnable = true;\n\n  get inputKeys(): string[] {\n    return [];\n  }\n\n  constructor(fields: RunnableMultiActionAgentInput) {\n    super(fields);\n    this.runnable = fields.runnable;\n    this.stop = fields.stop;\n    this.defaultRunName =\n      fields.defaultRunName ?? this.runnable.name ?? this.defaultRunName;\n    this.streamRunnable = fields.streamRunnable ?? this.streamRunnable;\n  }\n\n  async plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager,\n    config?: RunnableConfig\n  ): Promise<AgentAction[] | AgentFinish> {\n    const combinedInput = { ...inputs, steps };\n    const combinedConfig = patchConfig(config, {\n      callbacks: callbackManager,\n      runName: this.defaultRunName,\n    });\n    let output;\n    if (this.streamRunnable) {\n      const stream = await this.runnable.stream(combinedInput, combinedConfig);\n      let finalOutput: AgentAction | AgentFinish | AgentAction[] | undefined;\n      for await (const chunk of stream) {\n        if (finalOutput === undefined) {\n          finalOutput = chunk;\n        } else {\n          throw new Error(\n            [\n              `Multiple agent actions/finishes received in streamed agent output.`,\n              `Set \"streamRunnable: false\" when initializing the agent to invoke this agent in non-streaming mode.`,\n            ].join(\"\\n\")\n          );\n        }\n      }\n      if (finalOutput === undefined) {\n        throw new Error(\n          [\n            \"No streaming output received from underlying runnable.\",\n            `Set \"streamRunnable: false\" when initializing the agent to invoke this agent in non-streaming mode.`,\n          ].join(\"\\n\")\n        );\n      }\n      output = finalOutput;\n    } else {\n      output = await this.runnable.invoke(combinedInput, combinedConfig);\n    }\n\n    if (isAgentAction(output)) {\n      return [output];\n    }\n\n    return output;\n  }\n}\n\nexport class RunnableAgent extends RunnableMultiActionAgent {}\n\n/**\n * Interface for input data for creating a LLMSingleActionAgent.\n */\nexport interface LLMSingleActionAgentInput {\n  llmChain: LLMChain;\n  outputParser: AgentActionOutputParser;\n  stop?: string[];\n}\n\n/**\n * Class representing a single action agent using a LLMChain in LangChain.\n * Extends the BaseSingleActionAgent class and provides methods for\n * planning agent actions based on LLMChain outputs.\n * @example\n * ```typescript\n * const customPromptTemplate = new CustomPromptTemplate({\n *   tools: [new Calculator()],\n *   inputVariables: [\"input\", \"agent_scratchpad\"],\n * });\n * const customOutputParser = new CustomOutputParser();\n * const agent = new LLMSingleActionAgent({\n *   llmChain: new LLMChain({\n *     prompt: customPromptTemplate,\n *     llm: new ChatOpenAI({ model: \"gpt-4o-mini\", temperature: 0 }),\n *   }),\n *   outputParser: customOutputParser,\n *   stop: [\"\\nObservation\"],\n * });\n * const executor = new AgentExecutor({\n *   agent,\n *   tools: [new Calculator()],\n * });\n * const result = await executor.invoke({\n *   input:\n *     \"Who is Olivia Wilde's boyfriend? What is his current age raised to the 0.23 power?\",\n * });\n * ```\n */\nexport class LLMSingleActionAgent extends BaseSingleActionAgent {\n  lc_namespace = [\"langchain\", \"agents\"];\n\n  llmChain: LLMChain;\n\n  outputParser: AgentActionOutputParser;\n\n  stop?: string[];\n\n  constructor(input: LLMSingleActionAgentInput) {\n    super(input);\n    this.stop = input.stop;\n    this.llmChain = input.llmChain;\n    this.outputParser = input.outputParser;\n  }\n\n  get inputKeys(): string[] {\n    return this.llmChain.inputKeys;\n  }\n\n  /**\n   * Decide what to do given some input.\n   *\n   * @param steps - Steps the LLM has taken so far, along with observations from each.\n   * @param inputs - User inputs.\n   * @param callbackManager - Callback manager.\n   *\n   * @returns Action specifying what tool to use.\n   */\n  async plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager\n  ): Promise<AgentAction | AgentFinish> {\n    const output = await this.llmChain.call(\n      {\n        intermediate_steps: steps,\n        stop: this.stop,\n        ...inputs,\n      },\n      callbackManager\n    );\n    return this.outputParser.parse(\n      output[this.llmChain.outputKey],\n      callbackManager\n    );\n  }\n}\n\n/**\n * Interface for arguments used to create an agent in LangChain.\n */\nexport interface AgentArgs {\n  outputParser?: AgentActionOutputParser;\n\n  callbacks?: Callbacks;\n\n  /**\n   * @deprecated Use `callbacks` instead.\n   */\n  callbackManager?: CallbackManager;\n}\n\n/**\n * Class responsible for calling a language model and deciding an action.\n *\n * @remarks This is driven by an LLMChain. The prompt in the LLMChain *must*\n * include a variable called \"agent_scratchpad\" where the agent can put its\n * intermediary work.\n */\nexport abstract class Agent extends BaseSingleActionAgent {\n  llmChain: LLMChain;\n\n  outputParser: AgentActionOutputParser | undefined;\n\n  private _allowedTools?: string[] = undefined;\n\n  get allowedTools(): string[] | undefined {\n    return this._allowedTools;\n  }\n\n  get inputKeys(): string[] {\n    return this.llmChain.inputKeys.filter((k) => k !== \"agent_scratchpad\");\n  }\n\n  constructor(input: AgentInput) {\n    super(input);\n\n    this.llmChain = input.llmChain;\n    this._allowedTools = input.allowedTools;\n    this.outputParser = input.outputParser;\n  }\n\n  /**\n   * Prefix to append the observation with.\n   */\n  abstract observationPrefix(): string;\n\n  /**\n   * Prefix to append the LLM call with.\n   */\n  abstract llmPrefix(): string;\n\n  /**\n   * Return the string type key uniquely identifying this class of agent.\n   */\n  abstract _agentType(): string;\n\n  /**\n   * Get the default output parser for this agent.\n   */\n  static getDefaultOutputParser(\n    _fields?: OutputParserArgs\n  ): AgentActionOutputParser {\n    throw new Error(\"Not implemented\");\n  }\n\n  /**\n   * Create a prompt for this class\n   *\n   * @param _tools - List of tools the agent will have access to, used to format the prompt.\n   * @param _fields - Additional fields used to format the prompt.\n   *\n   * @returns A PromptTemplate assembled from the given tools and fields.\n   * */\n  static createPrompt(\n    _tools: StructuredToolInterface[],\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _fields?: Record<string, any>\n  ): BasePromptTemplate {\n    throw new Error(\"Not implemented\");\n  }\n\n  /** Construct an agent from an LLM and a list of tools */\n  static fromLLMAndTools(\n    _llm: BaseLanguageModelInterface,\n    _tools: StructuredToolInterface[],\n\n    _args?: AgentArgs\n  ): Agent {\n    throw new Error(\"Not implemented\");\n  }\n\n  /**\n   * Validate that appropriate tools are passed in\n   */\n  static validateTools(_tools: StructuredToolInterface[]): void {}\n\n  _stop(): string[] {\n    return [`\\n${this.observationPrefix()}`];\n  }\n\n  /**\n   * Name of tool to use to terminate the chain.\n   */\n  finishToolName(): string {\n    return \"Final Answer\";\n  }\n\n  /**\n   * Construct a scratchpad to let the agent continue its thought process\n   */\n  async constructScratchPad(\n    steps: AgentStep[]\n  ): Promise<string | BaseMessage[]> {\n    return steps.reduce(\n      (thoughts, { action, observation }) =>\n        thoughts +\n        [\n          action.log,\n          `${this.observationPrefix()}${observation}`,\n          this.llmPrefix(),\n        ].join(\"\\n\"),\n      \"\"\n    );\n  }\n\n  private async _plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    suffix?: string,\n    callbackManager?: CallbackManager\n  ): Promise<AgentAction | AgentFinish> {\n    const thoughts = await this.constructScratchPad(steps);\n    const newInputs: ChainValues = {\n      ...inputs,\n      agent_scratchpad: suffix ? `${thoughts}${suffix}` : thoughts,\n    };\n\n    if (this._stop().length !== 0) {\n      newInputs.stop = this._stop();\n    }\n\n    const output = await this.llmChain.predict(newInputs, callbackManager);\n    if (!this.outputParser) {\n      throw new Error(\"Output parser not set\");\n    }\n    return this.outputParser.parse(output, callbackManager);\n  }\n\n  /**\n   * Decide what to do given some input.\n   *\n   * @param steps - Steps the LLM has taken so far, along with observations from each.\n   * @param inputs - User inputs.\n   * @param callbackManager - Callback manager to use for this call.\n   *\n   * @returns Action specifying what tool to use.\n   */\n  plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager\n  ): Promise<AgentAction | AgentFinish> {\n    return this._plan(steps, inputs, undefined, callbackManager);\n  }\n\n  /**\n   * Return response when agent has been stopped due to max iterations\n   */\n  async returnStoppedResponse(\n    earlyStoppingMethod: StoppingMethod,\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager\n  ): Promise<AgentFinish> {\n    if (earlyStoppingMethod === \"force\") {\n      return {\n        returnValues: { output: \"Agent stopped due to max iterations.\" },\n        log: \"\",\n      };\n    }\n\n    if (earlyStoppingMethod === \"generate\") {\n      try {\n        const action = await this._plan(\n          steps,\n          inputs,\n          \"\\n\\nI now need to return a final answer based on the previous steps:\",\n          callbackManager\n        );\n        if (\"returnValues\" in action) {\n          return action;\n        }\n\n        return { returnValues: { output: action.log }, log: action.log };\n      } catch (err) {\n        // fine to use instanceof because we're in the same module\n        // eslint-disable-next-line no-instanceof/no-instanceof\n        if (!(err instanceof ParseError)) {\n          throw err;\n        }\n        return { returnValues: { output: err.output }, log: err.output };\n      }\n    }\n\n    throw new Error(`Invalid stopping method: ${earlyStoppingMethod}`);\n  }\n\n  /**\n   * Load an agent from a json-like object describing it.\n   */\n  static async deserialize(\n    data: SerializedAgent & {\n      llm?: BaseLanguageModelInterface;\n      tools?: ToolInterface[];\n    }\n  ): Promise<Agent> {\n    switch (data._type) {\n      case \"zero-shot-react-description\": {\n        const { ZeroShotAgent } = await import(\"./mrkl/index.js\");\n        return ZeroShotAgent.deserialize(data);\n      }\n      default:\n        throw new Error(\"Unknown agent type\");\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"agent.cjs","names":["Serializable","RunnableSequence"],"sources":["../../src/agents/agent.ts"],"sourcesContent":["import type {\n  StructuredToolInterface,\n  ToolInterface,\n} from \"@langchain/core/tools\";\nimport type { BaseLanguageModelInterface } from \"@langchain/core/language_models/base\";\nimport { CallbackManager, Callbacks } from \"@langchain/core/callbacks/manager\";\nimport { BasePromptTemplate } from \"@langchain/core/prompts\";\nimport { AgentAction, AgentFinish, AgentStep } from \"@langchain/core/agents\";\nimport { BaseMessage } from \"@langchain/core/messages\";\nimport { ChainValues } from \"@langchain/core/utils/types\";\nimport { Serializable } from \"@langchain/core/load/serializable\";\nimport {\n  Runnable,\n  patchConfig,\n  type RunnableConfig,\n  RunnableSequence,\n  RunnableLike,\n} from \"@langchain/core/runnables\";\nimport { LLMChain } from \"../chains/llm_chain.js\";\nimport type {\n  AgentActionOutputParser,\n  AgentInput,\n  RunnableMultiActionAgentInput,\n  RunnableSingleActionAgentInput,\n  SerializedAgent,\n  StoppingMethod,\n} from \"./types.js\";\n\n/**\n * Record type for arguments passed to output parsers.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type OutputParserArgs = Record<string, any>;\n\n/**\n * Error class for parse errors in LangChain. Contains information about\n * the error message and the output that caused the error.\n */\nclass ParseError extends Error {\n  output: string;\n\n  constructor(msg: string, output: string) {\n    super(msg);\n    this.output = output;\n  }\n}\n\n/**\n * Abstract base class for agents in LangChain. Provides common\n * functionality for agents, such as handling inputs and outputs.\n */\nexport abstract class BaseAgent extends Serializable {\n  declare ToolType: StructuredToolInterface;\n\n  abstract get inputKeys(): string[];\n\n  get returnValues(): string[] {\n    return [\"output\"];\n  }\n\n  get allowedTools(): string[] | undefined {\n    return undefined;\n  }\n\n  /**\n   * Return the string type key uniquely identifying this class of agent.\n   */\n  _agentType(): string {\n    throw new Error(\"Not implemented\");\n  }\n\n  /**\n   * Return the string type key uniquely identifying multi or single action agents.\n   */\n  abstract _agentActionType(): string;\n\n  /**\n   * Return response when agent has been stopped due to max iterations\n   */\n  returnStoppedResponse(\n    earlyStoppingMethod: StoppingMethod,\n    _steps: AgentStep[],\n    _inputs: ChainValues,\n    _callbackManager?: CallbackManager\n  ): Promise<AgentFinish> {\n    if (earlyStoppingMethod === \"force\") {\n      return Promise.resolve({\n        returnValues: { output: \"Agent stopped due to max iterations.\" },\n        log: \"\",\n      });\n    }\n\n    throw new Error(`Invalid stopping method: ${earlyStoppingMethod}`);\n  }\n\n  /**\n   * Prepare the agent for output, if needed\n   */\n  async prepareForOutput(\n    _returnValues: AgentFinish[\"returnValues\"],\n    _steps: AgentStep[]\n  ): Promise<AgentFinish[\"returnValues\"]> {\n    return {};\n  }\n}\n\n/**\n * Abstract base class for single action agents in LangChain. Extends the\n * BaseAgent class and provides additional functionality specific to\n * single action agents.\n */\nexport abstract class BaseSingleActionAgent extends BaseAgent {\n  _agentActionType(): string {\n    return \"single\" as const;\n  }\n\n  /**\n   * Decide what to do, given some input.\n   *\n   * @param steps - Steps the LLM has taken so far, along with observations from each.\n   * @param inputs - User inputs.\n   * @param callbackManager - Callback manager.\n   *\n   * @returns Action specifying what tool to use.\n   */\n  abstract plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager,\n    config?: RunnableConfig\n  ): Promise<AgentAction | AgentFinish>;\n}\n\n/**\n * Abstract base class for multi-action agents in LangChain. Extends the\n * BaseAgent class and provides additional functionality specific to\n * multi-action agents.\n */\nexport abstract class BaseMultiActionAgent extends BaseAgent {\n  _agentActionType(): string {\n    return \"multi\" as const;\n  }\n\n  /**\n   * Decide what to do, given some input.\n   *\n   * @param steps - Steps the LLM has taken so far, along with observations from each.\n   * @param inputs - User inputs.\n   * @param callbackManager - Callback manager.\n   *\n   * @returns Actions specifying what tools to use.\n   */\n  abstract plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager,\n    config?: RunnableConfig\n  ): Promise<AgentAction[] | AgentFinish>;\n}\n\nfunction isAgentAction(input: unknown): input is AgentAction {\n  return !Array.isArray(input) && (input as AgentAction)?.tool !== undefined;\n}\n\nexport function isRunnableAgent(x: BaseAgent) {\n  return (\n    (x as RunnableMultiActionAgent | RunnableSingleActionAgent).runnable !==\n    undefined\n  );\n}\n\n// TODO: Remove in the future. Only for backwards compatibility.\n// Allows for the creation of runnables with properties that will\n// be passed to the agent executor constructor.\nexport class AgentRunnableSequence<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  RunInput = any,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  RunOutput = any,\n> extends RunnableSequence<RunInput, RunOutput> {\n  streamRunnable?: boolean;\n\n  singleAction: boolean;\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  static fromRunnables<RunInput = any, RunOutput = any>(\n    [first, ...runnables]: [\n      RunnableLike<RunInput>,\n      ...RunnableLike[],\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      RunnableLike<any, RunOutput>,\n    ],\n    config: { singleAction: boolean; streamRunnable?: boolean; name?: string }\n  ): AgentRunnableSequence<RunInput, Exclude<RunOutput, Error>> {\n    const sequence = RunnableSequence.from(\n      [first, ...runnables],\n      config.name\n    ) as AgentRunnableSequence<RunInput, Exclude<RunOutput, Error>>;\n    sequence.singleAction = config.singleAction;\n    sequence.streamRunnable = config.streamRunnable;\n    return sequence;\n  }\n\n  static isAgentRunnableSequence(x: Runnable): x is AgentRunnableSequence {\n    return typeof (x as AgentRunnableSequence).singleAction === \"boolean\";\n  }\n}\n\n/**\n * Class representing a single-action agent powered by runnables.\n * Extends the BaseSingleActionAgent class and provides methods for\n * planning agent actions with runnables.\n */\nexport class RunnableSingleActionAgent extends BaseSingleActionAgent {\n  lc_namespace = [\"langchain\", \"agents\", \"runnable\"];\n\n  runnable: Runnable<\n    ChainValues & { steps: AgentStep[] },\n    AgentAction | AgentFinish\n  >;\n\n  get inputKeys(): string[] {\n    return [];\n  }\n\n  /**\n   * Whether to stream from the runnable or not.\n   * If true, the underlying LLM is invoked in a streaming fashion to make it\n   * possible to get access to the individual LLM tokens when using\n   * `streamLog` with the Agent Executor. If false then LLM is invoked in a\n   * non-streaming fashion and individual LLM tokens will not be available\n   * in `streamLog`.\n   *\n   * Note that the runnable should still only stream a single action or\n   * finish chunk.\n   */\n  streamRunnable = true;\n\n  defaultRunName = \"RunnableAgent\";\n\n  constructor(fields: RunnableSingleActionAgentInput) {\n    super(fields);\n    this.runnable = fields.runnable;\n    this.defaultRunName =\n      fields.defaultRunName ?? this.runnable.name ?? this.defaultRunName;\n    this.streamRunnable = fields.streamRunnable ?? this.streamRunnable;\n  }\n\n  async plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager,\n    config?: RunnableConfig\n  ): Promise<AgentAction | AgentFinish> {\n    const combinedInput = { ...inputs, steps };\n    const combinedConfig = patchConfig(config, {\n      callbacks: callbackManager,\n      runName: this.defaultRunName,\n    });\n    if (this.streamRunnable) {\n      const stream = await this.runnable.stream(combinedInput, combinedConfig);\n      let finalOutput: AgentAction | AgentFinish | undefined;\n      for await (const chunk of stream) {\n        if (finalOutput === undefined) {\n          finalOutput = chunk;\n        } else {\n          throw new Error(\n            [\n              `Multiple agent actions/finishes received in streamed agent output.`,\n              `Set \"streamRunnable: false\" when initializing the agent to invoke this agent in non-streaming mode.`,\n            ].join(\"\\n\")\n          );\n        }\n      }\n      if (finalOutput === undefined) {\n        throw new Error(\n          [\n            \"No streaming output received from underlying runnable.\",\n            `Set \"streamRunnable: false\" when initializing the agent to invoke this agent in non-streaming mode.`,\n          ].join(\"\\n\")\n        );\n      }\n      return finalOutput;\n    } else {\n      return this.runnable.invoke(combinedInput, combinedConfig);\n    }\n  }\n}\n\n/**\n * Class representing a multi-action agent powered by runnables.\n * Extends the BaseMultiActionAgent class and provides methods for\n * planning agent actions with runnables.\n */\nexport class RunnableMultiActionAgent extends BaseMultiActionAgent {\n  lc_namespace = [\"langchain\", \"agents\", \"runnable\"];\n\n  // TODO: Rename input to \"intermediate_steps\"\n  runnable: Runnable<\n    ChainValues & { steps: AgentStep[] },\n    AgentAction[] | AgentAction | AgentFinish\n  >;\n\n  defaultRunName = \"RunnableAgent\";\n\n  stop?: string[];\n\n  streamRunnable = true;\n\n  get inputKeys(): string[] {\n    return [];\n  }\n\n  constructor(fields: RunnableMultiActionAgentInput) {\n    super(fields);\n    this.runnable = fields.runnable;\n    this.stop = fields.stop;\n    this.defaultRunName =\n      fields.defaultRunName ?? this.runnable.name ?? this.defaultRunName;\n    this.streamRunnable = fields.streamRunnable ?? this.streamRunnable;\n  }\n\n  async plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager,\n    config?: RunnableConfig\n  ): Promise<AgentAction[] | AgentFinish> {\n    const combinedInput = { ...inputs, steps };\n    const combinedConfig = patchConfig(config, {\n      callbacks: callbackManager,\n      runName: this.defaultRunName,\n    });\n    let output;\n    if (this.streamRunnable) {\n      const stream = await this.runnable.stream(combinedInput, combinedConfig);\n      let finalOutput: AgentAction | AgentFinish | AgentAction[] | undefined;\n      for await (const chunk of stream) {\n        if (finalOutput === undefined) {\n          finalOutput = chunk;\n        } else {\n          throw new Error(\n            [\n              `Multiple agent actions/finishes received in streamed agent output.`,\n              `Set \"streamRunnable: false\" when initializing the agent to invoke this agent in non-streaming mode.`,\n            ].join(\"\\n\")\n          );\n        }\n      }\n      if (finalOutput === undefined) {\n        throw new Error(\n          [\n            \"No streaming output received from underlying runnable.\",\n            `Set \"streamRunnable: false\" when initializing the agent to invoke this agent in non-streaming mode.`,\n          ].join(\"\\n\")\n        );\n      }\n      output = finalOutput;\n    } else {\n      output = await this.runnable.invoke(combinedInput, combinedConfig);\n    }\n\n    if (isAgentAction(output)) {\n      return [output];\n    }\n\n    return output;\n  }\n}\n\nexport class RunnableAgent extends RunnableMultiActionAgent {}\n\n/**\n * Interface for input data for creating a LLMSingleActionAgent.\n */\nexport interface LLMSingleActionAgentInput {\n  llmChain: LLMChain;\n  outputParser: AgentActionOutputParser;\n  stop?: string[];\n}\n\n/**\n * Class representing a single action agent using a LLMChain in LangChain.\n * Extends the BaseSingleActionAgent class and provides methods for\n * planning agent actions based on LLMChain outputs.\n * @example\n * ```typescript\n * const customPromptTemplate = new CustomPromptTemplate({\n *   tools: [new Calculator()],\n *   inputVariables: [\"input\", \"agent_scratchpad\"],\n * });\n * const customOutputParser = new CustomOutputParser();\n * const agent = new LLMSingleActionAgent({\n *   llmChain: new LLMChain({\n *     prompt: customPromptTemplate,\n *     llm: new ChatOpenAI({ model: \"gpt-4o-mini\", temperature: 0 }),\n *   }),\n *   outputParser: customOutputParser,\n *   stop: [\"\\nObservation\"],\n * });\n * const executor = new AgentExecutor({\n *   agent,\n *   tools: [new Calculator()],\n * });\n * const result = await executor.invoke({\n *   input:\n *     \"Who is Olivia Wilde's boyfriend? What is his current age raised to the 0.23 power?\",\n * });\n * ```\n */\nexport class LLMSingleActionAgent extends BaseSingleActionAgent {\n  lc_namespace = [\"langchain\", \"agents\"];\n\n  llmChain: LLMChain;\n\n  outputParser: AgentActionOutputParser;\n\n  stop?: string[];\n\n  constructor(input: LLMSingleActionAgentInput) {\n    super(input);\n    this.stop = input.stop;\n    this.llmChain = input.llmChain;\n    this.outputParser = input.outputParser;\n  }\n\n  get inputKeys(): string[] {\n    return this.llmChain.inputKeys;\n  }\n\n  /**\n   * Decide what to do given some input.\n   *\n   * @param steps - Steps the LLM has taken so far, along with observations from each.\n   * @param inputs - User inputs.\n   * @param callbackManager - Callback manager.\n   *\n   * @returns Action specifying what tool to use.\n   */\n  async plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager\n  ): Promise<AgentAction | AgentFinish> {\n    const output = await this.llmChain.call(\n      {\n        intermediate_steps: steps,\n        stop: this.stop,\n        ...inputs,\n      },\n      callbackManager\n    );\n    return this.outputParser.parse(\n      output[this.llmChain.outputKey],\n      callbackManager\n    );\n  }\n}\n\n/**\n * Interface for arguments used to create an agent in LangChain.\n */\nexport interface AgentArgs {\n  outputParser?: AgentActionOutputParser;\n\n  callbacks?: Callbacks;\n\n  /**\n   * @deprecated Use `callbacks` instead.\n   */\n  callbackManager?: CallbackManager;\n}\n\n/**\n * Class responsible for calling a language model and deciding an action.\n *\n * @remarks This is driven by an LLMChain. The prompt in the LLMChain *must*\n * include a variable called \"agent_scratchpad\" where the agent can put its\n * intermediary work.\n */\nexport abstract class Agent extends BaseSingleActionAgent {\n  llmChain: LLMChain;\n\n  outputParser: AgentActionOutputParser | undefined;\n\n  private _allowedTools?: string[] = undefined;\n\n  get allowedTools(): string[] | undefined {\n    return this._allowedTools;\n  }\n\n  get inputKeys(): string[] {\n    return this.llmChain.inputKeys.filter((k) => k !== \"agent_scratchpad\");\n  }\n\n  constructor(input: AgentInput) {\n    super(input);\n\n    this.llmChain = input.llmChain;\n    this._allowedTools = input.allowedTools;\n    this.outputParser = input.outputParser;\n  }\n\n  /**\n   * Prefix to append the observation with.\n   */\n  abstract observationPrefix(): string;\n\n  /**\n   * Prefix to append the LLM call with.\n   */\n  abstract llmPrefix(): string;\n\n  /**\n   * Return the string type key uniquely identifying this class of agent.\n   */\n  abstract _agentType(): string;\n\n  /**\n   * Get the default output parser for this agent.\n   */\n  static getDefaultOutputParser(\n    _fields?: OutputParserArgs\n  ): AgentActionOutputParser {\n    throw new Error(\"Not implemented\");\n  }\n\n  /**\n   * Create a prompt for this class\n   *\n   * @param _tools - List of tools the agent will have access to, used to format the prompt.\n   * @param _fields - Additional fields used to format the prompt.\n   *\n   * @returns A PromptTemplate assembled from the given tools and fields.\n   * */\n  static createPrompt(\n    _tools: StructuredToolInterface[],\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _fields?: Record<string, any>\n  ): BasePromptTemplate {\n    throw new Error(\"Not implemented\");\n  }\n\n  /** Construct an agent from an LLM and a list of tools */\n  static fromLLMAndTools(\n    _llm: BaseLanguageModelInterface,\n    _tools: StructuredToolInterface[],\n\n    _args?: AgentArgs\n  ): Agent {\n    throw new Error(\"Not implemented\");\n  }\n\n  /**\n   * Validate that appropriate tools are passed in\n   */\n  static validateTools(_tools: StructuredToolInterface[]): void {}\n\n  _stop(): string[] {\n    return [`\\n${this.observationPrefix()}`];\n  }\n\n  /**\n   * Name of tool to use to terminate the chain.\n   */\n  finishToolName(): string {\n    return \"Final Answer\";\n  }\n\n  /**\n   * Construct a scratchpad to let the agent continue its thought process\n   */\n  async constructScratchPad(\n    steps: AgentStep[]\n  ): Promise<string | BaseMessage[]> {\n    return steps.reduce(\n      (thoughts, { action, observation }) =>\n        thoughts +\n        [\n          action.log,\n          `${this.observationPrefix()}${observation}`,\n          this.llmPrefix(),\n        ].join(\"\\n\"),\n      \"\"\n    );\n  }\n\n  private async _plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    suffix?: string,\n    callbackManager?: CallbackManager\n  ): Promise<AgentAction | AgentFinish> {\n    const thoughts = await this.constructScratchPad(steps);\n    const newInputs: ChainValues = {\n      ...inputs,\n      agent_scratchpad: suffix ? `${thoughts}${suffix}` : thoughts,\n    };\n\n    if (this._stop().length !== 0) {\n      newInputs.stop = this._stop();\n    }\n\n    const output = await this.llmChain.predict(newInputs, callbackManager);\n    if (!this.outputParser) {\n      throw new Error(\"Output parser not set\");\n    }\n    return this.outputParser.parse(output, callbackManager);\n  }\n\n  /**\n   * Decide what to do given some input.\n   *\n   * @param steps - Steps the LLM has taken so far, along with observations from each.\n   * @param inputs - User inputs.\n   * @param callbackManager - Callback manager to use for this call.\n   *\n   * @returns Action specifying what tool to use.\n   */\n  plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager\n  ): Promise<AgentAction | AgentFinish> {\n    return this._plan(steps, inputs, undefined, callbackManager);\n  }\n\n  /**\n   * Return response when agent has been stopped due to max iterations\n   */\n  async returnStoppedResponse(\n    earlyStoppingMethod: StoppingMethod,\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager\n  ): Promise<AgentFinish> {\n    if (earlyStoppingMethod === \"force\") {\n      return {\n        returnValues: { output: \"Agent stopped due to max iterations.\" },\n        log: \"\",\n      };\n    }\n\n    if (earlyStoppingMethod === \"generate\") {\n      try {\n        const action = await this._plan(\n          steps,\n          inputs,\n          \"\\n\\nI now need to return a final answer based on the previous steps:\",\n          callbackManager\n        );\n        if (\"returnValues\" in action) {\n          return action;\n        }\n\n        return { returnValues: { output: action.log }, log: action.log };\n      } catch (err) {\n        // fine to use instanceof because we're in the same module\n        // eslint-disable-next-line no-instanceof/no-instanceof\n        if (!(err instanceof ParseError)) {\n          throw err;\n        }\n        return { returnValues: { output: err.output }, log: err.output };\n      }\n    }\n\n    throw new Error(`Invalid stopping method: ${earlyStoppingMethod}`);\n  }\n\n  /**\n   * Load an agent from a json-like object describing it.\n   */\n  static async deserialize(\n    data: SerializedAgent & {\n      llm?: BaseLanguageModelInterface;\n      tools?: ToolInterface[];\n    }\n  ): Promise<Agent> {\n    switch (data._type) {\n      case \"zero-shot-react-description\": {\n        const { ZeroShotAgent } = await import(\"./mrkl/index.js\");\n        return ZeroShotAgent.deserialize(data);\n      }\n      default:\n        throw new Error(\"Unknown agent type\");\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/agents/agent.d.cts

@@ -11,7 +11,6 @@ import { StructuredToolInterface, ToolInterface } from "@langchain/core/tools";
 import { Serializable } from "@langchain/core/load/serializable";
 
 //#region src/agents/agent.d.ts
-
 /**
  * Record type for arguments passed to output parsers.
  */

package/dist/agents/agent.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.cts","names":["StructuredToolInterface","ToolInterface","BaseLanguageModelInterface","CallbackManager","Callbacks","BasePromptTemplate","AgentAction","AgentFinish","AgentStep","BaseMessage","ChainValues","Serializable","Runnable","RunnableConfig","RunnableSequence","RunnableLike","LLMChain","AgentActionOutputParser","AgentInput","RunnableMultiActionAgentInput","RunnableSingleActionAgentInput","SerializedAgent","StoppingMethod","OutputParserArgs","Record","BaseAgent","Promise","BaseSingleActionAgent","BaseMultiActionAgent","isRunnableAgent","AgentRunnableSequence","RunInput","RunOutput","Error","Exclude","RunnableSingleActionAgent","RunnableMultiActionAgent","RunnableAgent","LLMSingleActionAgentInput","LLMSingleActionAgent","AgentArgs","Agent"],"sources":["../../src/agents/agent.d.ts"],"sourcesContent":["import type { StructuredToolInterface, ToolInterface } from \"@langchain/core/tools\";\nimport type { BaseLanguageModelInterface } from \"@langchain/core/language_models/base\";\nimport { CallbackManager, Callbacks } from \"@langchain/core/callbacks/manager\";\nimport { BasePromptTemplate } from \"@langchain/core/prompts\";\nimport { AgentAction, AgentFinish, AgentStep } from \"@langchain/core/agents\";\nimport { BaseMessage } from \"@langchain/core/messages\";\nimport { ChainValues } from \"@langchain/core/utils/types\";\nimport { Serializable } from \"@langchain/core/load/serializable\";\nimport { Runnable, type RunnableConfig, RunnableSequence, RunnableLike } from \"@langchain/core/runnables\";\nimport { LLMChain } from \"../chains/llm_chain.js\";\nimport type { AgentActionOutputParser, AgentInput, RunnableMultiActionAgentInput, RunnableSingleActionAgentInput, SerializedAgent, StoppingMethod } from \"./types.js\";\n/**\n * Record type for arguments passed to output parsers.\n */\nexport type OutputParserArgs = Record<string, any>;\n/**\n * Abstract base class for agents in LangChain. Provides common\n * functionality for agents, such as handling inputs and outputs.\n */\nexport declare abstract class BaseAgent extends Serializable {\n    ToolType: StructuredToolInterface;\n    abstract get inputKeys(): string[];\n    get returnValues(): string[];\n    get allowedTools(): string[] | undefined;\n    /**\n     * Return the string type key uniquely identifying this class of agent.\n     */\n    _agentType(): string;\n    /**\n     * Return the string type key uniquely identifying multi or single action agents.\n     */\n    abstract _agentActionType(): string;\n    /**\n     * Return response when agent has been stopped due to max iterations\n     */\n    returnStoppedResponse(earlyStoppingMethod: StoppingMethod, _steps: AgentStep[], _inputs: ChainValues, _callbackManager?: CallbackManager): Promise<AgentFinish>;\n    /**\n     * Prepare the agent for output, if needed\n     */\n    prepareForOutput(_returnValues: AgentFinish[\"returnValues\"], _steps: AgentStep[]): Promise<AgentFinish[\"returnValues\"]>;\n}\n/**\n * Abstract base class for single action agents in LangChain. Extends the\n * BaseAgent class and provides additional functionality specific to\n * single action agents.\n */\nexport declare abstract class BaseSingleActionAgent extends BaseAgent {\n    _agentActionType(): string;\n    /**\n     * Decide what to do, given some input.\n     *\n     * @param steps - Steps the LLM has taken so far, along with observations from each.\n     * @param inputs - User inputs.\n     * @param callbackManager - Callback manager.\n     *\n     * @returns Action specifying what tool to use.\n     */\n    abstract plan(steps: AgentStep[], inputs: ChainValues, callbackManager?: CallbackManager, config?: RunnableConfig): Promise<AgentAction | AgentFinish>;\n}\n/**\n * Abstract base class for multi-action agents in LangChain. Extends the\n * BaseAgent class and provides additional functionality specific to\n * multi-action agents.\n */\nexport declare abstract class BaseMultiActionAgent extends BaseAgent {\n    _agentActionType(): string;\n    /**\n     * Decide what to do, given some input.\n     *\n     * @param steps - Steps the LLM has taken so far, along with observations from each.\n     * @param inputs - User inputs.\n     * @param callbackManager - Callback manager.\n     *\n     * @returns Actions specifying what tools to use.\n     */\n    abstract plan(steps: AgentStep[], inputs: ChainValues, callbackManager?: CallbackManager, config?: RunnableConfig): Promise<AgentAction[] | AgentFinish>;\n}\nexport declare function isRunnableAgent(x: BaseAgent): boolean;\nexport declare class AgentRunnableSequence<RunInput = any, RunOutput = any> extends RunnableSequence<RunInput, RunOutput> {\n    streamRunnable?: boolean;\n    singleAction: boolean;\n    static fromRunnables<RunInput = any, RunOutput = any>([first, ...runnables]: [\n        RunnableLike<RunInput>,\n        ...RunnableLike[],\n        RunnableLike<any, RunOutput>\n    ], config: {\n        singleAction: boolean;\n        streamRunnable?: boolean;\n        name?: string;\n    }): AgentRunnableSequence<RunInput, Exclude<RunOutput, Error>>;\n    static isAgentRunnableSequence(x: Runnable): x is AgentRunnableSequence;\n}\n/**\n * Class representing a single-action agent powered by runnables.\n * Extends the BaseSingleActionAgent class and provides methods for\n * planning agent actions with runnables.\n */\nexport declare class RunnableSingleActionAgent extends BaseSingleActionAgent {\n    lc_namespace: string[];\n    runnable: Runnable<ChainValues & {\n        steps: AgentStep[];\n    }, AgentAction | AgentFinish>;\n    get inputKeys(): string[];\n    /**\n     * Whether to stream from the runnable or not.\n     * If true, the underlying LLM is invoked in a streaming fashion to make it\n     * possible to get access to the individual LLM tokens when using\n     * `streamLog` with the Agent Executor. If false then LLM is invoked in a\n     * non-streaming fashion and individual LLM tokens will not be available\n     * in `streamLog`.\n     *\n     * Note that the runnable should still only stream a single action or\n     * finish chunk.\n     */\n    streamRunnable: boolean;\n    defaultRunName: string;\n    constructor(fields: RunnableSingleActionAgentInput);\n    plan(steps: AgentStep[], inputs: ChainValues, callbackManager?: CallbackManager, config?: RunnableConfig): Promise<AgentAction | AgentFinish>;\n}\n/**\n * Class representing a multi-action agent powered by runnables.\n * Extends the BaseMultiActionAgent class and provides methods for\n * planning agent actions with runnables.\n */\nexport declare class RunnableMultiActionAgent extends BaseMultiActionAgent {\n    lc_namespace: string[];\n    runnable: Runnable<ChainValues & {\n        steps: AgentStep[];\n    }, AgentAction[] | AgentAction | AgentFinish>;\n    defaultRunName: string;\n    stop?: string[];\n    streamRunnable: boolean;\n    get inputKeys(): string[];\n    constructor(fields: RunnableMultiActionAgentInput);\n    plan(steps: AgentStep[], inputs: ChainValues, callbackManager?: CallbackManager, config?: RunnableConfig): Promise<AgentAction[] | AgentFinish>;\n}\nexport declare class RunnableAgent extends RunnableMultiActionAgent {\n}\n/**\n * Interface for input data for creating a LLMSingleActionAgent.\n */\nexport interface LLMSingleActionAgentInput {\n    llmChain: LLMChain;\n    outputParser: AgentActionOutputParser;\n    stop?: string[];\n}\n/**\n * Class representing a single action agent using a LLMChain in LangChain.\n * Extends the BaseSingleActionAgent class and provides methods for\n * planning agent actions based on LLMChain outputs.\n * @example\n * ```typescript\n * const customPromptTemplate = new CustomPromptTemplate({\n *   tools: [new Calculator()],\n *   inputVariables: [\"input\", \"agent_scratchpad\"],\n * });\n * const customOutputParser = new CustomOutputParser();\n * const agent = new LLMSingleActionAgent({\n *   llmChain: new LLMChain({\n *     prompt: customPromptTemplate,\n *     llm: new ChatOpenAI({ model: \"gpt-4o-mini\", temperature: 0 }),\n *   }),\n *   outputParser: customOutputParser,\n *   stop: [\"\\nObservation\"],\n * });\n * const executor = new AgentExecutor({\n *   agent,\n *   tools: [new Calculator()],\n * });\n * const result = await executor.invoke({\n *   input:\n *     \"Who is Olivia Wilde's boyfriend? What is his current age raised to the 0.23 power?\",\n * });\n * ```\n */\nexport declare class LLMSingleActionAgent extends BaseSingleActionAgent {\n    lc_namespace: string[];\n    llmChain: LLMChain;\n    outputParser: AgentActionOutputParser;\n    stop?: string[];\n    constructor(input: LLMSingleActionAgentInput);\n    get inputKeys(): string[];\n    /**\n     * Decide what to do given some input.\n     *\n     * @param steps - Steps the LLM has taken so far, along with observations from each.\n     * @param inputs - User inputs.\n     * @param callbackManager - Callback manager.\n     *\n     * @returns Action specifying what tool to use.\n     */\n    plan(steps: AgentStep[], inputs: ChainValues, callbackManager?: CallbackManager): Promise<AgentAction | AgentFinish>;\n}\n/**\n * Interface for arguments used to create an agent in LangChain.\n */\nexport interface AgentArgs {\n    outputParser?: AgentActionOutputParser;\n    callbacks?: Callbacks;\n    /**\n     * @deprecated Use `callbacks` instead.\n     */\n    callbackManager?: CallbackManager;\n}\n/**\n * Class responsible for calling a language model and deciding an action.\n *\n * @remarks This is driven by an LLMChain. The prompt in the LLMChain *must*\n * include a variable called \"agent_scratchpad\" where the agent can put its\n * intermediary work.\n */\nexport declare abstract class Agent extends BaseSingleActionAgent {\n    llmChain: LLMChain;\n    outputParser: AgentActionOutputParser | undefined;\n    private _allowedTools?;\n    get allowedTools(): string[] | undefined;\n    get inputKeys(): string[];\n    constructor(input: AgentInput);\n    /**\n     * Prefix to append the observation with.\n     */\n    abstract observationPrefix(): string;\n    /**\n     * Prefix to append the LLM call with.\n     */\n    abstract llmPrefix(): string;\n    /**\n     * Return the string type key uniquely identifying this class of agent.\n     */\n    abstract _agentType(): string;\n    /**\n     * Get the default output parser for this agent.\n     */\n    static getDefaultOutputParser(_fields?: OutputParserArgs): AgentActionOutputParser;\n    /**\n     * Create a prompt for this class\n     *\n     * @param _tools - List of tools the agent will have access to, used to format the prompt.\n     * @param _fields - Additional fields used to format the prompt.\n     *\n     * @returns A PromptTemplate assembled from the given tools and fields.\n     * */\n    static createPrompt(_tools: StructuredToolInterface[], _fields?: Record<string, any>): BasePromptTemplate;\n    /** Construct an agent from an LLM and a list of tools */\n    static fromLLMAndTools(_llm: BaseLanguageModelInterface, _tools: StructuredToolInterface[], _args?: AgentArgs): Agent;\n    /**\n     * Validate that appropriate tools are passed in\n     */\n    static validateTools(_tools: StructuredToolInterface[]): void;\n    _stop(): string[];\n    /**\n     * Name of tool to use to terminate the chain.\n     */\n    finishToolName(): string;\n    /**\n     * Construct a scratchpad to let the agent continue its thought process\n     */\n    constructScratchPad(steps: AgentStep[]): Promise<string | BaseMessage[]>;\n    private _plan;\n    /**\n     * Decide what to do given some input.\n     *\n     * @param steps - Steps the LLM has taken so far, along with observations from each.\n     * @param inputs - User inputs.\n     * @param callbackManager - Callback manager to use for this call.\n     *\n     * @returns Action specifying what tool to use.\n     */\n    plan(steps: AgentStep[], inputs: ChainValues, callbackManager?: CallbackManager): Promise<AgentAction | AgentFinish>;\n    /**\n     * Return response when agent has been stopped due to max iterations\n     */\n    returnStoppedResponse(earlyStoppingMethod: StoppingMethod, steps: AgentStep[], inputs: ChainValues, callbackManager?: CallbackManager): Promise<AgentFinish>;\n    /**\n     * Load an agent from a json-like object describing it.\n     */\n    static deserialize(data: SerializedAgent & {\n        llm?: BaseLanguageModelInterface;\n        tools?: ToolInterface[];\n    }): Promise<Agent>;\n}\n//# sourceMappingURL=agent.d.ts.map"],"mappings":"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"}
+{"version":3,"file":"agent.d.cts","names":[],"sources":["../../src/agents/agent.ts"],"mappings":"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"}

package/dist/agents/agent.d.ts

@@ -1,17 +1,16 @@
 import { LLMChain } from "../chains/llm_chain.js";
 import { AgentActionOutputParser, AgentInput, RunnableMultiActionAgentInput, SerializedAgent, StoppingMethod } from "./types.js";
-import { Serializable } from "@langchain/core/load/serializable";
+import { BaseMessage } from "@langchain/core/messages";
 import { BasePromptTemplate } from "@langchain/core/prompts";
+import { Serializable } from "@langchain/core/load/serializable";
 import { Runnable, RunnableConfig, RunnableLike, RunnableSequence } from "@langchain/core/runnables";
 import { StructuredToolInterface, ToolInterface } from "@langchain/core/tools";
 import { BaseLanguageModelInterface } from "@langchain/core/language_models/base";
 import { CallbackManager, Callbacks } from "@langchain/core/callbacks/manager";
-import { BaseMessage } from "@langchain/core/messages";
 import { ChainValues } from "@langchain/core/utils/types";
 import { AgentAction, AgentFinish, AgentStep } from "@langchain/core/agents";
 
 //#region src/agents/agent.d.ts
-
 /**
  * Record type for arguments passed to output parsers.
  */

package/dist/agents/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","names":["StructuredToolInterface","ToolInterface","BaseLanguageModelInterface","CallbackManager","Callbacks","BasePromptTemplate","AgentAction","AgentFinish","AgentStep","BaseMessage","ChainValues","Serializable","Runnable","RunnableConfig","RunnableSequence","RunnableLike","LLMChain","AgentActionOutputParser","AgentInput","RunnableMultiActionAgentInput","RunnableSingleActionAgentInput","SerializedAgent","StoppingMethod","OutputParserArgs","Record","BaseAgent","Promise","BaseSingleActionAgent","BaseMultiActionAgent","isRunnableAgent","AgentRunnableSequence","RunInput","RunOutput","Error","Exclude","RunnableSingleActionAgent","RunnableMultiActionAgent","RunnableAgent","LLMSingleActionAgentInput","LLMSingleActionAgent","AgentArgs","Agent"],"sources":["../../src/agents/agent.d.ts"],"sourcesContent":["import type { StructuredToolInterface, ToolInterface } from \"@langchain/core/tools\";\nimport type { BaseLanguageModelInterface } from \"@langchain/core/language_models/base\";\nimport { CallbackManager, Callbacks } from \"@langchain/core/callbacks/manager\";\nimport { BasePromptTemplate } from \"@langchain/core/prompts\";\nimport { AgentAction, AgentFinish, AgentStep } from \"@langchain/core/agents\";\nimport { BaseMessage } from \"@langchain/core/messages\";\nimport { ChainValues } from \"@langchain/core/utils/types\";\nimport { Serializable } from \"@langchain/core/load/serializable\";\nimport { Runnable, type RunnableConfig, RunnableSequence, RunnableLike } from \"@langchain/core/runnables\";\nimport { LLMChain } from \"../chains/llm_chain.js\";\nimport type { AgentActionOutputParser, AgentInput, RunnableMultiActionAgentInput, RunnableSingleActionAgentInput, SerializedAgent, StoppingMethod } from \"./types.js\";\n/**\n * Record type for arguments passed to output parsers.\n */\nexport type OutputParserArgs = Record<string, any>;\n/**\n * Abstract base class for agents in LangChain. Provides common\n * functionality for agents, such as handling inputs and outputs.\n */\nexport declare abstract class BaseAgent extends Serializable {\n    ToolType: StructuredToolInterface;\n    abstract get inputKeys(): string[];\n    get returnValues(): string[];\n    get allowedTools(): string[] | undefined;\n    /**\n     * Return the string type key uniquely identifying this class of agent.\n     */\n    _agentType(): string;\n    /**\n     * Return the string type key uniquely identifying multi or single action agents.\n     */\n    abstract _agentActionType(): string;\n    /**\n     * Return response when agent has been stopped due to max iterations\n     */\n    returnStoppedResponse(earlyStoppingMethod: StoppingMethod, _steps: AgentStep[], _inputs: ChainValues, _callbackManager?: CallbackManager): Promise<AgentFinish>;\n    /**\n     * Prepare the agent for output, if needed\n     */\n    prepareForOutput(_returnValues: AgentFinish[\"returnValues\"], _steps: AgentStep[]): Promise<AgentFinish[\"returnValues\"]>;\n}\n/**\n * Abstract base class for single action agents in LangChain. Extends the\n * BaseAgent class and provides additional functionality specific to\n * single action agents.\n */\nexport declare abstract class BaseSingleActionAgent extends BaseAgent {\n    _agentActionType(): string;\n    /**\n     * Decide what to do, given some input.\n     *\n     * @param steps - Steps the LLM has taken so far, along with observations from each.\n     * @param inputs - User inputs.\n     * @param callbackManager - Callback manager.\n     *\n     * @returns Action specifying what tool to use.\n     */\n    abstract plan(steps: AgentStep[], inputs: ChainValues, callbackManager?: CallbackManager, config?: RunnableConfig): Promise<AgentAction | AgentFinish>;\n}\n/**\n * Abstract base class for multi-action agents in LangChain. Extends the\n * BaseAgent class and provides additional functionality specific to\n * multi-action agents.\n */\nexport declare abstract class BaseMultiActionAgent extends BaseAgent {\n    _agentActionType(): string;\n    /**\n     * Decide what to do, given some input.\n     *\n     * @param steps - Steps the LLM has taken so far, along with observations from each.\n     * @param inputs - User inputs.\n     * @param callbackManager - Callback manager.\n     *\n     * @returns Actions specifying what tools to use.\n     */\n    abstract plan(steps: AgentStep[], inputs: ChainValues, callbackManager?: CallbackManager, config?: RunnableConfig): Promise<AgentAction[] | AgentFinish>;\n}\nexport declare function isRunnableAgent(x: BaseAgent): boolean;\nexport declare class AgentRunnableSequence<RunInput = any, RunOutput = any> extends RunnableSequence<RunInput, RunOutput> {\n    streamRunnable?: boolean;\n    singleAction: boolean;\n    static fromRunnables<RunInput = any, RunOutput = any>([first, ...runnables]: [\n        RunnableLike<RunInput>,\n        ...RunnableLike[],\n        RunnableLike<any, RunOutput>\n    ], config: {\n        singleAction: boolean;\n        streamRunnable?: boolean;\n        name?: string;\n    }): AgentRunnableSequence<RunInput, Exclude<RunOutput, Error>>;\n    static isAgentRunnableSequence(x: Runnable): x is AgentRunnableSequence;\n}\n/**\n * Class representing a single-action agent powered by runnables.\n * Extends the BaseSingleActionAgent class and provides methods for\n * planning agent actions with runnables.\n */\nexport declare class RunnableSingleActionAgent extends BaseSingleActionAgent {\n    lc_namespace: string[];\n    runnable: Runnable<ChainValues & {\n        steps: AgentStep[];\n    }, AgentAction | AgentFinish>;\n    get inputKeys(): string[];\n    /**\n     * Whether to stream from the runnable or not.\n     * If true, the underlying LLM is invoked in a streaming fashion to make it\n     * possible to get access to the individual LLM tokens when using\n     * `streamLog` with the Agent Executor. If false then LLM is invoked in a\n     * non-streaming fashion and individual LLM tokens will not be available\n     * in `streamLog`.\n     *\n     * Note that the runnable should still only stream a single action or\n     * finish chunk.\n     */\n    streamRunnable: boolean;\n    defaultRunName: string;\n    constructor(fields: RunnableSingleActionAgentInput);\n    plan(steps: AgentStep[], inputs: ChainValues, callbackManager?: CallbackManager, config?: RunnableConfig): Promise<AgentAction | AgentFinish>;\n}\n/**\n * Class representing a multi-action agent powered by runnables.\n * Extends the BaseMultiActionAgent class and provides methods for\n * planning agent actions with runnables.\n */\nexport declare class RunnableMultiActionAgent extends BaseMultiActionAgent {\n    lc_namespace: string[];\n    runnable: Runnable<ChainValues & {\n        steps: AgentStep[];\n    }, AgentAction[] | AgentAction | AgentFinish>;\n    defaultRunName: string;\n    stop?: string[];\n    streamRunnable: boolean;\n    get inputKeys(): string[];\n    constructor(fields: RunnableMultiActionAgentInput);\n    plan(steps: AgentStep[], inputs: ChainValues, callbackManager?: CallbackManager, config?: RunnableConfig): Promise<AgentAction[] | AgentFinish>;\n}\nexport declare class RunnableAgent extends RunnableMultiActionAgent {\n}\n/**\n * Interface for input data for creating a LLMSingleActionAgent.\n */\nexport interface LLMSingleActionAgentInput {\n    llmChain: LLMChain;\n    outputParser: AgentActionOutputParser;\n    stop?: string[];\n}\n/**\n * Class representing a single action agent using a LLMChain in LangChain.\n * Extends the BaseSingleActionAgent class and provides methods for\n * planning agent actions based on LLMChain outputs.\n * @example\n * ```typescript\n * const customPromptTemplate = new CustomPromptTemplate({\n *   tools: [new Calculator()],\n *   inputVariables: [\"input\", \"agent_scratchpad\"],\n * });\n * const customOutputParser = new CustomOutputParser();\n * const agent = new LLMSingleActionAgent({\n *   llmChain: new LLMChain({\n *     prompt: customPromptTemplate,\n *     llm: new ChatOpenAI({ model: \"gpt-4o-mini\", temperature: 0 }),\n *   }),\n *   outputParser: customOutputParser,\n *   stop: [\"\\nObservation\"],\n * });\n * const executor = new AgentExecutor({\n *   agent,\n *   tools: [new Calculator()],\n * });\n * const result = await executor.invoke({\n *   input:\n *     \"Who is Olivia Wilde's boyfriend? What is his current age raised to the 0.23 power?\",\n * });\n * ```\n */\nexport declare class LLMSingleActionAgent extends BaseSingleActionAgent {\n    lc_namespace: string[];\n    llmChain: LLMChain;\n    outputParser: AgentActionOutputParser;\n    stop?: string[];\n    constructor(input: LLMSingleActionAgentInput);\n    get inputKeys(): string[];\n    /**\n     * Decide what to do given some input.\n     *\n     * @param steps - Steps the LLM has taken so far, along with observations from each.\n     * @param inputs - User inputs.\n     * @param callbackManager - Callback manager.\n     *\n     * @returns Action specifying what tool to use.\n     */\n    plan(steps: AgentStep[], inputs: ChainValues, callbackManager?: CallbackManager): Promise<AgentAction | AgentFinish>;\n}\n/**\n * Interface for arguments used to create an agent in LangChain.\n */\nexport interface AgentArgs {\n    outputParser?: AgentActionOutputParser;\n    callbacks?: Callbacks;\n    /**\n     * @deprecated Use `callbacks` instead.\n     */\n    callbackManager?: CallbackManager;\n}\n/**\n * Class responsible for calling a language model and deciding an action.\n *\n * @remarks This is driven by an LLMChain. The prompt in the LLMChain *must*\n * include a variable called \"agent_scratchpad\" where the agent can put its\n * intermediary work.\n */\nexport declare abstract class Agent extends BaseSingleActionAgent {\n    llmChain: LLMChain;\n    outputParser: AgentActionOutputParser | undefined;\n    private _allowedTools?;\n    get allowedTools(): string[] | undefined;\n    get inputKeys(): string[];\n    constructor(input: AgentInput);\n    /**\n     * Prefix to append the observation with.\n     */\n    abstract observationPrefix(): string;\n    /**\n     * Prefix to append the LLM call with.\n     */\n    abstract llmPrefix(): string;\n    /**\n     * Return the string type key uniquely identifying this class of agent.\n     */\n    abstract _agentType(): string;\n    /**\n     * Get the default output parser for this agent.\n     */\n    static getDefaultOutputParser(_fields?: OutputParserArgs): AgentActionOutputParser;\n    /**\n     * Create a prompt for this class\n     *\n     * @param _tools - List of tools the agent will have access to, used to format the prompt.\n     * @param _fields - Additional fields used to format the prompt.\n     *\n     * @returns A PromptTemplate assembled from the given tools and fields.\n     * */\n    static createPrompt(_tools: StructuredToolInterface[], _fields?: Record<string, any>): BasePromptTemplate;\n    /** Construct an agent from an LLM and a list of tools */\n    static fromLLMAndTools(_llm: BaseLanguageModelInterface, _tools: StructuredToolInterface[], _args?: AgentArgs): Agent;\n    /**\n     * Validate that appropriate tools are passed in\n     */\n    static validateTools(_tools: StructuredToolInterface[]): void;\n    _stop(): string[];\n    /**\n     * Name of tool to use to terminate the chain.\n     */\n    finishToolName(): string;\n    /**\n     * Construct a scratchpad to let the agent continue its thought process\n     */\n    constructScratchPad(steps: AgentStep[]): Promise<string | BaseMessage[]>;\n    private _plan;\n    /**\n     * Decide what to do given some input.\n     *\n     * @param steps - Steps the LLM has taken so far, along with observations from each.\n     * @param inputs - User inputs.\n     * @param callbackManager - Callback manager to use for this call.\n     *\n     * @returns Action specifying what tool to use.\n     */\n    plan(steps: AgentStep[], inputs: ChainValues, callbackManager?: CallbackManager): Promise<AgentAction | AgentFinish>;\n    /**\n     * Return response when agent has been stopped due to max iterations\n     */\n    returnStoppedResponse(earlyStoppingMethod: StoppingMethod, steps: AgentStep[], inputs: ChainValues, callbackManager?: CallbackManager): Promise<AgentFinish>;\n    /**\n     * Load an agent from a json-like object describing it.\n     */\n    static deserialize(data: SerializedAgent & {\n        llm?: BaseLanguageModelInterface;\n        tools?: ToolInterface[];\n    }): Promise<Agent>;\n}\n//# sourceMappingURL=agent.d.ts.map"],"mappings":"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"}
+{"version":3,"file":"agent.d.ts","names":[],"sources":["../../src/agents/agent.ts"],"mappings":"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"}

package/dist/agents/agent.js

@@ -21,9 +21,7 @@ var BaseAgent = class extends Serializable {
 	get returnValues() {
 		return ["output"];
 	}
-	get allowedTools() {
-		return void 0;
-	}
+	get allowedTools() {}
 	/**
 	* Return the string type key uniquely identifying this class of agent.
 	*/

package/dist/agents/agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent.js","names":["msg: string","output: string","earlyStoppingMethod: StoppingMethod","_steps: AgentStep[]","_inputs: ChainValues","_callbackManager?: CallbackManager","_returnValues: AgentFinish[\"returnValues\"]","input: unknown","x: BaseAgent","config: { singleAction: boolean; streamRunnable?: boolean; name?: string }","x: Runnable","fields: RunnableSingleActionAgentInput","steps: AgentStep[]","inputs: ChainValues","callbackManager?: CallbackManager","config?: RunnableConfig","finalOutput: AgentAction | AgentFinish | undefined","fields: RunnableMultiActionAgentInput","finalOutput: AgentAction | AgentFinish | AgentAction[] | undefined","input: LLMSingleActionAgentInput","input: AgentInput","_fields?: OutputParserArgs","_tools: StructuredToolInterface[]","_fields?: Record<string, any>","_llm: BaseLanguageModelInterface","_args?: AgentArgs","suffix?: string","newInputs: ChainValues","data: SerializedAgent & {\n      llm?: BaseLanguageModelInterface;\n      tools?: ToolInterface[];\n    }"],"sources":["../../src/agents/agent.ts"],"sourcesContent":["import type {\n  StructuredToolInterface,\n  ToolInterface,\n} from \"@langchain/core/tools\";\nimport type { BaseLanguageModelInterface } from \"@langchain/core/language_models/base\";\nimport { CallbackManager, Callbacks } from \"@langchain/core/callbacks/manager\";\nimport { BasePromptTemplate } from \"@langchain/core/prompts\";\nimport { AgentAction, AgentFinish, AgentStep } from \"@langchain/core/agents\";\nimport { BaseMessage } from \"@langchain/core/messages\";\nimport { ChainValues } from \"@langchain/core/utils/types\";\nimport { Serializable } from \"@langchain/core/load/serializable\";\nimport {\n  Runnable,\n  patchConfig,\n  type RunnableConfig,\n  RunnableSequence,\n  RunnableLike,\n} from \"@langchain/core/runnables\";\nimport { LLMChain } from \"../chains/llm_chain.js\";\nimport type {\n  AgentActionOutputParser,\n  AgentInput,\n  RunnableMultiActionAgentInput,\n  RunnableSingleActionAgentInput,\n  SerializedAgent,\n  StoppingMethod,\n} from \"./types.js\";\n\n/**\n * Record type for arguments passed to output parsers.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type OutputParserArgs = Record<string, any>;\n\n/**\n * Error class for parse errors in LangChain. Contains information about\n * the error message and the output that caused the error.\n */\nclass ParseError extends Error {\n  output: string;\n\n  constructor(msg: string, output: string) {\n    super(msg);\n    this.output = output;\n  }\n}\n\n/**\n * Abstract base class for agents in LangChain. Provides common\n * functionality for agents, such as handling inputs and outputs.\n */\nexport abstract class BaseAgent extends Serializable {\n  declare ToolType: StructuredToolInterface;\n\n  abstract get inputKeys(): string[];\n\n  get returnValues(): string[] {\n    return [\"output\"];\n  }\n\n  get allowedTools(): string[] | undefined {\n    return undefined;\n  }\n\n  /**\n   * Return the string type key uniquely identifying this class of agent.\n   */\n  _agentType(): string {\n    throw new Error(\"Not implemented\");\n  }\n\n  /**\n   * Return the string type key uniquely identifying multi or single action agents.\n   */\n  abstract _agentActionType(): string;\n\n  /**\n   * Return response when agent has been stopped due to max iterations\n   */\n  returnStoppedResponse(\n    earlyStoppingMethod: StoppingMethod,\n    _steps: AgentStep[],\n    _inputs: ChainValues,\n    _callbackManager?: CallbackManager\n  ): Promise<AgentFinish> {\n    if (earlyStoppingMethod === \"force\") {\n      return Promise.resolve({\n        returnValues: { output: \"Agent stopped due to max iterations.\" },\n        log: \"\",\n      });\n    }\n\n    throw new Error(`Invalid stopping method: ${earlyStoppingMethod}`);\n  }\n\n  /**\n   * Prepare the agent for output, if needed\n   */\n  async prepareForOutput(\n    _returnValues: AgentFinish[\"returnValues\"],\n    _steps: AgentStep[]\n  ): Promise<AgentFinish[\"returnValues\"]> {\n    return {};\n  }\n}\n\n/**\n * Abstract base class for single action agents in LangChain. Extends the\n * BaseAgent class and provides additional functionality specific to\n * single action agents.\n */\nexport abstract class BaseSingleActionAgent extends BaseAgent {\n  _agentActionType(): string {\n    return \"single\" as const;\n  }\n\n  /**\n   * Decide what to do, given some input.\n   *\n   * @param steps - Steps the LLM has taken so far, along with observations from each.\n   * @param inputs - User inputs.\n   * @param callbackManager - Callback manager.\n   *\n   * @returns Action specifying what tool to use.\n   */\n  abstract plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager,\n    config?: RunnableConfig\n  ): Promise<AgentAction | AgentFinish>;\n}\n\n/**\n * Abstract base class for multi-action agents in LangChain. Extends the\n * BaseAgent class and provides additional functionality specific to\n * multi-action agents.\n */\nexport abstract class BaseMultiActionAgent extends BaseAgent {\n  _agentActionType(): string {\n    return \"multi\" as const;\n  }\n\n  /**\n   * Decide what to do, given some input.\n   *\n   * @param steps - Steps the LLM has taken so far, along with observations from each.\n   * @param inputs - User inputs.\n   * @param callbackManager - Callback manager.\n   *\n   * @returns Actions specifying what tools to use.\n   */\n  abstract plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager,\n    config?: RunnableConfig\n  ): Promise<AgentAction[] | AgentFinish>;\n}\n\nfunction isAgentAction(input: unknown): input is AgentAction {\n  return !Array.isArray(input) && (input as AgentAction)?.tool !== undefined;\n}\n\nexport function isRunnableAgent(x: BaseAgent) {\n  return (\n    (x as RunnableMultiActionAgent | RunnableSingleActionAgent).runnable !==\n    undefined\n  );\n}\n\n// TODO: Remove in the future. Only for backwards compatibility.\n// Allows for the creation of runnables with properties that will\n// be passed to the agent executor constructor.\nexport class AgentRunnableSequence<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  RunInput = any,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  RunOutput = any,\n> extends RunnableSequence<RunInput, RunOutput> {\n  streamRunnable?: boolean;\n\n  singleAction: boolean;\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  static fromRunnables<RunInput = any, RunOutput = any>(\n    [first, ...runnables]: [\n      RunnableLike<RunInput>,\n      ...RunnableLike[],\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      RunnableLike<any, RunOutput>,\n    ],\n    config: { singleAction: boolean; streamRunnable?: boolean; name?: string }\n  ): AgentRunnableSequence<RunInput, Exclude<RunOutput, Error>> {\n    const sequence = RunnableSequence.from(\n      [first, ...runnables],\n      config.name\n    ) as AgentRunnableSequence<RunInput, Exclude<RunOutput, Error>>;\n    sequence.singleAction = config.singleAction;\n    sequence.streamRunnable = config.streamRunnable;\n    return sequence;\n  }\n\n  static isAgentRunnableSequence(x: Runnable): x is AgentRunnableSequence {\n    return typeof (x as AgentRunnableSequence).singleAction === \"boolean\";\n  }\n}\n\n/**\n * Class representing a single-action agent powered by runnables.\n * Extends the BaseSingleActionAgent class and provides methods for\n * planning agent actions with runnables.\n */\nexport class RunnableSingleActionAgent extends BaseSingleActionAgent {\n  lc_namespace = [\"langchain\", \"agents\", \"runnable\"];\n\n  runnable: Runnable<\n    ChainValues & { steps: AgentStep[] },\n    AgentAction | AgentFinish\n  >;\n\n  get inputKeys(): string[] {\n    return [];\n  }\n\n  /**\n   * Whether to stream from the runnable or not.\n   * If true, the underlying LLM is invoked in a streaming fashion to make it\n   * possible to get access to the individual LLM tokens when using\n   * `streamLog` with the Agent Executor. If false then LLM is invoked in a\n   * non-streaming fashion and individual LLM tokens will not be available\n   * in `streamLog`.\n   *\n   * Note that the runnable should still only stream a single action or\n   * finish chunk.\n   */\n  streamRunnable = true;\n\n  defaultRunName = \"RunnableAgent\";\n\n  constructor(fields: RunnableSingleActionAgentInput) {\n    super(fields);\n    this.runnable = fields.runnable;\n    this.defaultRunName =\n      fields.defaultRunName ?? this.runnable.name ?? this.defaultRunName;\n    this.streamRunnable = fields.streamRunnable ?? this.streamRunnable;\n  }\n\n  async plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager,\n    config?: RunnableConfig\n  ): Promise<AgentAction | AgentFinish> {\n    const combinedInput = { ...inputs, steps };\n    const combinedConfig = patchConfig(config, {\n      callbacks: callbackManager,\n      runName: this.defaultRunName,\n    });\n    if (this.streamRunnable) {\n      const stream = await this.runnable.stream(combinedInput, combinedConfig);\n      let finalOutput: AgentAction | AgentFinish | undefined;\n      for await (const chunk of stream) {\n        if (finalOutput === undefined) {\n          finalOutput = chunk;\n        } else {\n          throw new Error(\n            [\n              `Multiple agent actions/finishes received in streamed agent output.`,\n              `Set \"streamRunnable: false\" when initializing the agent to invoke this agent in non-streaming mode.`,\n            ].join(\"\\n\")\n          );\n        }\n      }\n      if (finalOutput === undefined) {\n        throw new Error(\n          [\n            \"No streaming output received from underlying runnable.\",\n            `Set \"streamRunnable: false\" when initializing the agent to invoke this agent in non-streaming mode.`,\n          ].join(\"\\n\")\n        );\n      }\n      return finalOutput;\n    } else {\n      return this.runnable.invoke(combinedInput, combinedConfig);\n    }\n  }\n}\n\n/**\n * Class representing a multi-action agent powered by runnables.\n * Extends the BaseMultiActionAgent class and provides methods for\n * planning agent actions with runnables.\n */\nexport class RunnableMultiActionAgent extends BaseMultiActionAgent {\n  lc_namespace = [\"langchain\", \"agents\", \"runnable\"];\n\n  // TODO: Rename input to \"intermediate_steps\"\n  runnable: Runnable<\n    ChainValues & { steps: AgentStep[] },\n    AgentAction[] | AgentAction | AgentFinish\n  >;\n\n  defaultRunName = \"RunnableAgent\";\n\n  stop?: string[];\n\n  streamRunnable = true;\n\n  get inputKeys(): string[] {\n    return [];\n  }\n\n  constructor(fields: RunnableMultiActionAgentInput) {\n    super(fields);\n    this.runnable = fields.runnable;\n    this.stop = fields.stop;\n    this.defaultRunName =\n      fields.defaultRunName ?? this.runnable.name ?? this.defaultRunName;\n    this.streamRunnable = fields.streamRunnable ?? this.streamRunnable;\n  }\n\n  async plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager,\n    config?: RunnableConfig\n  ): Promise<AgentAction[] | AgentFinish> {\n    const combinedInput = { ...inputs, steps };\n    const combinedConfig = patchConfig(config, {\n      callbacks: callbackManager,\n      runName: this.defaultRunName,\n    });\n    let output;\n    if (this.streamRunnable) {\n      const stream = await this.runnable.stream(combinedInput, combinedConfig);\n      let finalOutput: AgentAction | AgentFinish | AgentAction[] | undefined;\n      for await (const chunk of stream) {\n        if (finalOutput === undefined) {\n          finalOutput = chunk;\n        } else {\n          throw new Error(\n            [\n              `Multiple agent actions/finishes received in streamed agent output.`,\n              `Set \"streamRunnable: false\" when initializing the agent to invoke this agent in non-streaming mode.`,\n            ].join(\"\\n\")\n          );\n        }\n      }\n      if (finalOutput === undefined) {\n        throw new Error(\n          [\n            \"No streaming output received from underlying runnable.\",\n            `Set \"streamRunnable: false\" when initializing the agent to invoke this agent in non-streaming mode.`,\n          ].join(\"\\n\")\n        );\n      }\n      output = finalOutput;\n    } else {\n      output = await this.runnable.invoke(combinedInput, combinedConfig);\n    }\n\n    if (isAgentAction(output)) {\n      return [output];\n    }\n\n    return output;\n  }\n}\n\nexport class RunnableAgent extends RunnableMultiActionAgent {}\n\n/**\n * Interface for input data for creating a LLMSingleActionAgent.\n */\nexport interface LLMSingleActionAgentInput {\n  llmChain: LLMChain;\n  outputParser: AgentActionOutputParser;\n  stop?: string[];\n}\n\n/**\n * Class representing a single action agent using a LLMChain in LangChain.\n * Extends the BaseSingleActionAgent class and provides methods for\n * planning agent actions based on LLMChain outputs.\n * @example\n * ```typescript\n * const customPromptTemplate = new CustomPromptTemplate({\n *   tools: [new Calculator()],\n *   inputVariables: [\"input\", \"agent_scratchpad\"],\n * });\n * const customOutputParser = new CustomOutputParser();\n * const agent = new LLMSingleActionAgent({\n *   llmChain: new LLMChain({\n *     prompt: customPromptTemplate,\n *     llm: new ChatOpenAI({ model: \"gpt-4o-mini\", temperature: 0 }),\n *   }),\n *   outputParser: customOutputParser,\n *   stop: [\"\\nObservation\"],\n * });\n * const executor = new AgentExecutor({\n *   agent,\n *   tools: [new Calculator()],\n * });\n * const result = await executor.invoke({\n *   input:\n *     \"Who is Olivia Wilde's boyfriend? What is his current age raised to the 0.23 power?\",\n * });\n * ```\n */\nexport class LLMSingleActionAgent extends BaseSingleActionAgent {\n  lc_namespace = [\"langchain\", \"agents\"];\n\n  llmChain: LLMChain;\n\n  outputParser: AgentActionOutputParser;\n\n  stop?: string[];\n\n  constructor(input: LLMSingleActionAgentInput) {\n    super(input);\n    this.stop = input.stop;\n    this.llmChain = input.llmChain;\n    this.outputParser = input.outputParser;\n  }\n\n  get inputKeys(): string[] {\n    return this.llmChain.inputKeys;\n  }\n\n  /**\n   * Decide what to do given some input.\n   *\n   * @param steps - Steps the LLM has taken so far, along with observations from each.\n   * @param inputs - User inputs.\n   * @param callbackManager - Callback manager.\n   *\n   * @returns Action specifying what tool to use.\n   */\n  async plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager\n  ): Promise<AgentAction | AgentFinish> {\n    const output = await this.llmChain.call(\n      {\n        intermediate_steps: steps,\n        stop: this.stop,\n        ...inputs,\n      },\n      callbackManager\n    );\n    return this.outputParser.parse(\n      output[this.llmChain.outputKey],\n      callbackManager\n    );\n  }\n}\n\n/**\n * Interface for arguments used to create an agent in LangChain.\n */\nexport interface AgentArgs {\n  outputParser?: AgentActionOutputParser;\n\n  callbacks?: Callbacks;\n\n  /**\n   * @deprecated Use `callbacks` instead.\n   */\n  callbackManager?: CallbackManager;\n}\n\n/**\n * Class responsible for calling a language model and deciding an action.\n *\n * @remarks This is driven by an LLMChain. The prompt in the LLMChain *must*\n * include a variable called \"agent_scratchpad\" where the agent can put its\n * intermediary work.\n */\nexport abstract class Agent extends BaseSingleActionAgent {\n  llmChain: LLMChain;\n\n  outputParser: AgentActionOutputParser | undefined;\n\n  private _allowedTools?: string[] = undefined;\n\n  get allowedTools(): string[] | undefined {\n    return this._allowedTools;\n  }\n\n  get inputKeys(): string[] {\n    return this.llmChain.inputKeys.filter((k) => k !== \"agent_scratchpad\");\n  }\n\n  constructor(input: AgentInput) {\n    super(input);\n\n    this.llmChain = input.llmChain;\n    this._allowedTools = input.allowedTools;\n    this.outputParser = input.outputParser;\n  }\n\n  /**\n   * Prefix to append the observation with.\n   */\n  abstract observationPrefix(): string;\n\n  /**\n   * Prefix to append the LLM call with.\n   */\n  abstract llmPrefix(): string;\n\n  /**\n   * Return the string type key uniquely identifying this class of agent.\n   */\n  abstract _agentType(): string;\n\n  /**\n   * Get the default output parser for this agent.\n   */\n  static getDefaultOutputParser(\n    _fields?: OutputParserArgs\n  ): AgentActionOutputParser {\n    throw new Error(\"Not implemented\");\n  }\n\n  /**\n   * Create a prompt for this class\n   *\n   * @param _tools - List of tools the agent will have access to, used to format the prompt.\n   * @param _fields - Additional fields used to format the prompt.\n   *\n   * @returns A PromptTemplate assembled from the given tools and fields.\n   * */\n  static createPrompt(\n    _tools: StructuredToolInterface[],\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _fields?: Record<string, any>\n  ): BasePromptTemplate {\n    throw new Error(\"Not implemented\");\n  }\n\n  /** Construct an agent from an LLM and a list of tools */\n  static fromLLMAndTools(\n    _llm: BaseLanguageModelInterface,\n    _tools: StructuredToolInterface[],\n\n    _args?: AgentArgs\n  ): Agent {\n    throw new Error(\"Not implemented\");\n  }\n\n  /**\n   * Validate that appropriate tools are passed in\n   */\n  static validateTools(_tools: StructuredToolInterface[]): void {}\n\n  _stop(): string[] {\n    return [`\\n${this.observationPrefix()}`];\n  }\n\n  /**\n   * Name of tool to use to terminate the chain.\n   */\n  finishToolName(): string {\n    return \"Final Answer\";\n  }\n\n  /**\n   * Construct a scratchpad to let the agent continue its thought process\n   */\n  async constructScratchPad(\n    steps: AgentStep[]\n  ): Promise<string | BaseMessage[]> {\n    return steps.reduce(\n      (thoughts, { action, observation }) =>\n        thoughts +\n        [\n          action.log,\n          `${this.observationPrefix()}${observation}`,\n          this.llmPrefix(),\n        ].join(\"\\n\"),\n      \"\"\n    );\n  }\n\n  private async _plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    suffix?: string,\n    callbackManager?: CallbackManager\n  ): Promise<AgentAction | AgentFinish> {\n    const thoughts = await this.constructScratchPad(steps);\n    const newInputs: ChainValues = {\n      ...inputs,\n      agent_scratchpad: suffix ? `${thoughts}${suffix}` : thoughts,\n    };\n\n    if (this._stop().length !== 0) {\n      newInputs.stop = this._stop();\n    }\n\n    const output = await this.llmChain.predict(newInputs, callbackManager);\n    if (!this.outputParser) {\n      throw new Error(\"Output parser not set\");\n    }\n    return this.outputParser.parse(output, callbackManager);\n  }\n\n  /**\n   * Decide what to do given some input.\n   *\n   * @param steps - Steps the LLM has taken so far, along with observations from each.\n   * @param inputs - User inputs.\n   * @param callbackManager - Callback manager to use for this call.\n   *\n   * @returns Action specifying what tool to use.\n   */\n  plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager\n  ): Promise<AgentAction | AgentFinish> {\n    return this._plan(steps, inputs, undefined, callbackManager);\n  }\n\n  /**\n   * Return response when agent has been stopped due to max iterations\n   */\n  async returnStoppedResponse(\n    earlyStoppingMethod: StoppingMethod,\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager\n  ): Promise<AgentFinish> {\n    if (earlyStoppingMethod === \"force\") {\n      return {\n        returnValues: { output: \"Agent stopped due to max iterations.\" },\n        log: \"\",\n      };\n    }\n\n    if (earlyStoppingMethod === \"generate\") {\n      try {\n        const action = await this._plan(\n          steps,\n          inputs,\n          \"\\n\\nI now need to return a final answer based on the previous steps:\",\n          callbackManager\n        );\n        if (\"returnValues\" in action) {\n          return action;\n        }\n\n        return { returnValues: { output: action.log }, log: action.log };\n      } catch (err) {\n        // fine to use instanceof because we're in the same module\n        // eslint-disable-next-line no-instanceof/no-instanceof\n        if (!(err instanceof ParseError)) {\n          throw err;\n        }\n        return { returnValues: { output: err.output }, log: err.output };\n      }\n    }\n\n    throw new Error(`Invalid stopping method: ${earlyStoppingMethod}`);\n  }\n\n  /**\n   * Load an agent from a json-like object describing it.\n   */\n  static async deserialize(\n    data: SerializedAgent & {\n      llm?: BaseLanguageModelInterface;\n      tools?: ToolInterface[];\n    }\n  ): Promise<Agent> {\n    switch (data._type) {\n      case \"zero-shot-react-description\": {\n        const { ZeroShotAgent } = await import(\"./mrkl/index.js\");\n        return ZeroShotAgent.deserialize(data);\n      }\n      default:\n        throw new Error(\"Unknown agent type\");\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"agent.js","names":[],"sources":["../../src/agents/agent.ts"],"sourcesContent":["import type {\n  StructuredToolInterface,\n  ToolInterface,\n} from \"@langchain/core/tools\";\nimport type { BaseLanguageModelInterface } from \"@langchain/core/language_models/base\";\nimport { CallbackManager, Callbacks } from \"@langchain/core/callbacks/manager\";\nimport { BasePromptTemplate } from \"@langchain/core/prompts\";\nimport { AgentAction, AgentFinish, AgentStep } from \"@langchain/core/agents\";\nimport { BaseMessage } from \"@langchain/core/messages\";\nimport { ChainValues } from \"@langchain/core/utils/types\";\nimport { Serializable } from \"@langchain/core/load/serializable\";\nimport {\n  Runnable,\n  patchConfig,\n  type RunnableConfig,\n  RunnableSequence,\n  RunnableLike,\n} from \"@langchain/core/runnables\";\nimport { LLMChain } from \"../chains/llm_chain.js\";\nimport type {\n  AgentActionOutputParser,\n  AgentInput,\n  RunnableMultiActionAgentInput,\n  RunnableSingleActionAgentInput,\n  SerializedAgent,\n  StoppingMethod,\n} from \"./types.js\";\n\n/**\n * Record type for arguments passed to output parsers.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type OutputParserArgs = Record<string, any>;\n\n/**\n * Error class for parse errors in LangChain. Contains information about\n * the error message and the output that caused the error.\n */\nclass ParseError extends Error {\n  output: string;\n\n  constructor(msg: string, output: string) {\n    super(msg);\n    this.output = output;\n  }\n}\n\n/**\n * Abstract base class for agents in LangChain. Provides common\n * functionality for agents, such as handling inputs and outputs.\n */\nexport abstract class BaseAgent extends Serializable {\n  declare ToolType: StructuredToolInterface;\n\n  abstract get inputKeys(): string[];\n\n  get returnValues(): string[] {\n    return [\"output\"];\n  }\n\n  get allowedTools(): string[] | undefined {\n    return undefined;\n  }\n\n  /**\n   * Return the string type key uniquely identifying this class of agent.\n   */\n  _agentType(): string {\n    throw new Error(\"Not implemented\");\n  }\n\n  /**\n   * Return the string type key uniquely identifying multi or single action agents.\n   */\n  abstract _agentActionType(): string;\n\n  /**\n   * Return response when agent has been stopped due to max iterations\n   */\n  returnStoppedResponse(\n    earlyStoppingMethod: StoppingMethod,\n    _steps: AgentStep[],\n    _inputs: ChainValues,\n    _callbackManager?: CallbackManager\n  ): Promise<AgentFinish> {\n    if (earlyStoppingMethod === \"force\") {\n      return Promise.resolve({\n        returnValues: { output: \"Agent stopped due to max iterations.\" },\n        log: \"\",\n      });\n    }\n\n    throw new Error(`Invalid stopping method: ${earlyStoppingMethod}`);\n  }\n\n  /**\n   * Prepare the agent for output, if needed\n   */\n  async prepareForOutput(\n    _returnValues: AgentFinish[\"returnValues\"],\n    _steps: AgentStep[]\n  ): Promise<AgentFinish[\"returnValues\"]> {\n    return {};\n  }\n}\n\n/**\n * Abstract base class for single action agents in LangChain. Extends the\n * BaseAgent class and provides additional functionality specific to\n * single action agents.\n */\nexport abstract class BaseSingleActionAgent extends BaseAgent {\n  _agentActionType(): string {\n    return \"single\" as const;\n  }\n\n  /**\n   * Decide what to do, given some input.\n   *\n   * @param steps - Steps the LLM has taken so far, along with observations from each.\n   * @param inputs - User inputs.\n   * @param callbackManager - Callback manager.\n   *\n   * @returns Action specifying what tool to use.\n   */\n  abstract plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager,\n    config?: RunnableConfig\n  ): Promise<AgentAction | AgentFinish>;\n}\n\n/**\n * Abstract base class for multi-action agents in LangChain. Extends the\n * BaseAgent class and provides additional functionality specific to\n * multi-action agents.\n */\nexport abstract class BaseMultiActionAgent extends BaseAgent {\n  _agentActionType(): string {\n    return \"multi\" as const;\n  }\n\n  /**\n   * Decide what to do, given some input.\n   *\n   * @param steps - Steps the LLM has taken so far, along with observations from each.\n   * @param inputs - User inputs.\n   * @param callbackManager - Callback manager.\n   *\n   * @returns Actions specifying what tools to use.\n   */\n  abstract plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager,\n    config?: RunnableConfig\n  ): Promise<AgentAction[] | AgentFinish>;\n}\n\nfunction isAgentAction(input: unknown): input is AgentAction {\n  return !Array.isArray(input) && (input as AgentAction)?.tool !== undefined;\n}\n\nexport function isRunnableAgent(x: BaseAgent) {\n  return (\n    (x as RunnableMultiActionAgent | RunnableSingleActionAgent).runnable !==\n    undefined\n  );\n}\n\n// TODO: Remove in the future. Only for backwards compatibility.\n// Allows for the creation of runnables with properties that will\n// be passed to the agent executor constructor.\nexport class AgentRunnableSequence<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  RunInput = any,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  RunOutput = any,\n> extends RunnableSequence<RunInput, RunOutput> {\n  streamRunnable?: boolean;\n\n  singleAction: boolean;\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  static fromRunnables<RunInput = any, RunOutput = any>(\n    [first, ...runnables]: [\n      RunnableLike<RunInput>,\n      ...RunnableLike[],\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      RunnableLike<any, RunOutput>,\n    ],\n    config: { singleAction: boolean; streamRunnable?: boolean; name?: string }\n  ): AgentRunnableSequence<RunInput, Exclude<RunOutput, Error>> {\n    const sequence = RunnableSequence.from(\n      [first, ...runnables],\n      config.name\n    ) as AgentRunnableSequence<RunInput, Exclude<RunOutput, Error>>;\n    sequence.singleAction = config.singleAction;\n    sequence.streamRunnable = config.streamRunnable;\n    return sequence;\n  }\n\n  static isAgentRunnableSequence(x: Runnable): x is AgentRunnableSequence {\n    return typeof (x as AgentRunnableSequence).singleAction === \"boolean\";\n  }\n}\n\n/**\n * Class representing a single-action agent powered by runnables.\n * Extends the BaseSingleActionAgent class and provides methods for\n * planning agent actions with runnables.\n */\nexport class RunnableSingleActionAgent extends BaseSingleActionAgent {\n  lc_namespace = [\"langchain\", \"agents\", \"runnable\"];\n\n  runnable: Runnable<\n    ChainValues & { steps: AgentStep[] },\n    AgentAction | AgentFinish\n  >;\n\n  get inputKeys(): string[] {\n    return [];\n  }\n\n  /**\n   * Whether to stream from the runnable or not.\n   * If true, the underlying LLM is invoked in a streaming fashion to make it\n   * possible to get access to the individual LLM tokens when using\n   * `streamLog` with the Agent Executor. If false then LLM is invoked in a\n   * non-streaming fashion and individual LLM tokens will not be available\n   * in `streamLog`.\n   *\n   * Note that the runnable should still only stream a single action or\n   * finish chunk.\n   */\n  streamRunnable = true;\n\n  defaultRunName = \"RunnableAgent\";\n\n  constructor(fields: RunnableSingleActionAgentInput) {\n    super(fields);\n    this.runnable = fields.runnable;\n    this.defaultRunName =\n      fields.defaultRunName ?? this.runnable.name ?? this.defaultRunName;\n    this.streamRunnable = fields.streamRunnable ?? this.streamRunnable;\n  }\n\n  async plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager,\n    config?: RunnableConfig\n  ): Promise<AgentAction | AgentFinish> {\n    const combinedInput = { ...inputs, steps };\n    const combinedConfig = patchConfig(config, {\n      callbacks: callbackManager,\n      runName: this.defaultRunName,\n    });\n    if (this.streamRunnable) {\n      const stream = await this.runnable.stream(combinedInput, combinedConfig);\n      let finalOutput: AgentAction | AgentFinish | undefined;\n      for await (const chunk of stream) {\n        if (finalOutput === undefined) {\n          finalOutput = chunk;\n        } else {\n          throw new Error(\n            [\n              `Multiple agent actions/finishes received in streamed agent output.`,\n              `Set \"streamRunnable: false\" when initializing the agent to invoke this agent in non-streaming mode.`,\n            ].join(\"\\n\")\n          );\n        }\n      }\n      if (finalOutput === undefined) {\n        throw new Error(\n          [\n            \"No streaming output received from underlying runnable.\",\n            `Set \"streamRunnable: false\" when initializing the agent to invoke this agent in non-streaming mode.`,\n          ].join(\"\\n\")\n        );\n      }\n      return finalOutput;\n    } else {\n      return this.runnable.invoke(combinedInput, combinedConfig);\n    }\n  }\n}\n\n/**\n * Class representing a multi-action agent powered by runnables.\n * Extends the BaseMultiActionAgent class and provides methods for\n * planning agent actions with runnables.\n */\nexport class RunnableMultiActionAgent extends BaseMultiActionAgent {\n  lc_namespace = [\"langchain\", \"agents\", \"runnable\"];\n\n  // TODO: Rename input to \"intermediate_steps\"\n  runnable: Runnable<\n    ChainValues & { steps: AgentStep[] },\n    AgentAction[] | AgentAction | AgentFinish\n  >;\n\n  defaultRunName = \"RunnableAgent\";\n\n  stop?: string[];\n\n  streamRunnable = true;\n\n  get inputKeys(): string[] {\n    return [];\n  }\n\n  constructor(fields: RunnableMultiActionAgentInput) {\n    super(fields);\n    this.runnable = fields.runnable;\n    this.stop = fields.stop;\n    this.defaultRunName =\n      fields.defaultRunName ?? this.runnable.name ?? this.defaultRunName;\n    this.streamRunnable = fields.streamRunnable ?? this.streamRunnable;\n  }\n\n  async plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager,\n    config?: RunnableConfig\n  ): Promise<AgentAction[] | AgentFinish> {\n    const combinedInput = { ...inputs, steps };\n    const combinedConfig = patchConfig(config, {\n      callbacks: callbackManager,\n      runName: this.defaultRunName,\n    });\n    let output;\n    if (this.streamRunnable) {\n      const stream = await this.runnable.stream(combinedInput, combinedConfig);\n      let finalOutput: AgentAction | AgentFinish | AgentAction[] | undefined;\n      for await (const chunk of stream) {\n        if (finalOutput === undefined) {\n          finalOutput = chunk;\n        } else {\n          throw new Error(\n            [\n              `Multiple agent actions/finishes received in streamed agent output.`,\n              `Set \"streamRunnable: false\" when initializing the agent to invoke this agent in non-streaming mode.`,\n            ].join(\"\\n\")\n          );\n        }\n      }\n      if (finalOutput === undefined) {\n        throw new Error(\n          [\n            \"No streaming output received from underlying runnable.\",\n            `Set \"streamRunnable: false\" when initializing the agent to invoke this agent in non-streaming mode.`,\n          ].join(\"\\n\")\n        );\n      }\n      output = finalOutput;\n    } else {\n      output = await this.runnable.invoke(combinedInput, combinedConfig);\n    }\n\n    if (isAgentAction(output)) {\n      return [output];\n    }\n\n    return output;\n  }\n}\n\nexport class RunnableAgent extends RunnableMultiActionAgent {}\n\n/**\n * Interface for input data for creating a LLMSingleActionAgent.\n */\nexport interface LLMSingleActionAgentInput {\n  llmChain: LLMChain;\n  outputParser: AgentActionOutputParser;\n  stop?: string[];\n}\n\n/**\n * Class representing a single action agent using a LLMChain in LangChain.\n * Extends the BaseSingleActionAgent class and provides methods for\n * planning agent actions based on LLMChain outputs.\n * @example\n * ```typescript\n * const customPromptTemplate = new CustomPromptTemplate({\n *   tools: [new Calculator()],\n *   inputVariables: [\"input\", \"agent_scratchpad\"],\n * });\n * const customOutputParser = new CustomOutputParser();\n * const agent = new LLMSingleActionAgent({\n *   llmChain: new LLMChain({\n *     prompt: customPromptTemplate,\n *     llm: new ChatOpenAI({ model: \"gpt-4o-mini\", temperature: 0 }),\n *   }),\n *   outputParser: customOutputParser,\n *   stop: [\"\\nObservation\"],\n * });\n * const executor = new AgentExecutor({\n *   agent,\n *   tools: [new Calculator()],\n * });\n * const result = await executor.invoke({\n *   input:\n *     \"Who is Olivia Wilde's boyfriend? What is his current age raised to the 0.23 power?\",\n * });\n * ```\n */\nexport class LLMSingleActionAgent extends BaseSingleActionAgent {\n  lc_namespace = [\"langchain\", \"agents\"];\n\n  llmChain: LLMChain;\n\n  outputParser: AgentActionOutputParser;\n\n  stop?: string[];\n\n  constructor(input: LLMSingleActionAgentInput) {\n    super(input);\n    this.stop = input.stop;\n    this.llmChain = input.llmChain;\n    this.outputParser = input.outputParser;\n  }\n\n  get inputKeys(): string[] {\n    return this.llmChain.inputKeys;\n  }\n\n  /**\n   * Decide what to do given some input.\n   *\n   * @param steps - Steps the LLM has taken so far, along with observations from each.\n   * @param inputs - User inputs.\n   * @param callbackManager - Callback manager.\n   *\n   * @returns Action specifying what tool to use.\n   */\n  async plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager\n  ): Promise<AgentAction | AgentFinish> {\n    const output = await this.llmChain.call(\n      {\n        intermediate_steps: steps,\n        stop: this.stop,\n        ...inputs,\n      },\n      callbackManager\n    );\n    return this.outputParser.parse(\n      output[this.llmChain.outputKey],\n      callbackManager\n    );\n  }\n}\n\n/**\n * Interface for arguments used to create an agent in LangChain.\n */\nexport interface AgentArgs {\n  outputParser?: AgentActionOutputParser;\n\n  callbacks?: Callbacks;\n\n  /**\n   * @deprecated Use `callbacks` instead.\n   */\n  callbackManager?: CallbackManager;\n}\n\n/**\n * Class responsible for calling a language model and deciding an action.\n *\n * @remarks This is driven by an LLMChain. The prompt in the LLMChain *must*\n * include a variable called \"agent_scratchpad\" where the agent can put its\n * intermediary work.\n */\nexport abstract class Agent extends BaseSingleActionAgent {\n  llmChain: LLMChain;\n\n  outputParser: AgentActionOutputParser | undefined;\n\n  private _allowedTools?: string[] = undefined;\n\n  get allowedTools(): string[] | undefined {\n    return this._allowedTools;\n  }\n\n  get inputKeys(): string[] {\n    return this.llmChain.inputKeys.filter((k) => k !== \"agent_scratchpad\");\n  }\n\n  constructor(input: AgentInput) {\n    super(input);\n\n    this.llmChain = input.llmChain;\n    this._allowedTools = input.allowedTools;\n    this.outputParser = input.outputParser;\n  }\n\n  /**\n   * Prefix to append the observation with.\n   */\n  abstract observationPrefix(): string;\n\n  /**\n   * Prefix to append the LLM call with.\n   */\n  abstract llmPrefix(): string;\n\n  /**\n   * Return the string type key uniquely identifying this class of agent.\n   */\n  abstract _agentType(): string;\n\n  /**\n   * Get the default output parser for this agent.\n   */\n  static getDefaultOutputParser(\n    _fields?: OutputParserArgs\n  ): AgentActionOutputParser {\n    throw new Error(\"Not implemented\");\n  }\n\n  /**\n   * Create a prompt for this class\n   *\n   * @param _tools - List of tools the agent will have access to, used to format the prompt.\n   * @param _fields - Additional fields used to format the prompt.\n   *\n   * @returns A PromptTemplate assembled from the given tools and fields.\n   * */\n  static createPrompt(\n    _tools: StructuredToolInterface[],\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _fields?: Record<string, any>\n  ): BasePromptTemplate {\n    throw new Error(\"Not implemented\");\n  }\n\n  /** Construct an agent from an LLM and a list of tools */\n  static fromLLMAndTools(\n    _llm: BaseLanguageModelInterface,\n    _tools: StructuredToolInterface[],\n\n    _args?: AgentArgs\n  ): Agent {\n    throw new Error(\"Not implemented\");\n  }\n\n  /**\n   * Validate that appropriate tools are passed in\n   */\n  static validateTools(_tools: StructuredToolInterface[]): void {}\n\n  _stop(): string[] {\n    return [`\\n${this.observationPrefix()}`];\n  }\n\n  /**\n   * Name of tool to use to terminate the chain.\n   */\n  finishToolName(): string {\n    return \"Final Answer\";\n  }\n\n  /**\n   * Construct a scratchpad to let the agent continue its thought process\n   */\n  async constructScratchPad(\n    steps: AgentStep[]\n  ): Promise<string | BaseMessage[]> {\n    return steps.reduce(\n      (thoughts, { action, observation }) =>\n        thoughts +\n        [\n          action.log,\n          `${this.observationPrefix()}${observation}`,\n          this.llmPrefix(),\n        ].join(\"\\n\"),\n      \"\"\n    );\n  }\n\n  private async _plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    suffix?: string,\n    callbackManager?: CallbackManager\n  ): Promise<AgentAction | AgentFinish> {\n    const thoughts = await this.constructScratchPad(steps);\n    const newInputs: ChainValues = {\n      ...inputs,\n      agent_scratchpad: suffix ? `${thoughts}${suffix}` : thoughts,\n    };\n\n    if (this._stop().length !== 0) {\n      newInputs.stop = this._stop();\n    }\n\n    const output = await this.llmChain.predict(newInputs, callbackManager);\n    if (!this.outputParser) {\n      throw new Error(\"Output parser not set\");\n    }\n    return this.outputParser.parse(output, callbackManager);\n  }\n\n  /**\n   * Decide what to do given some input.\n   *\n   * @param steps - Steps the LLM has taken so far, along with observations from each.\n   * @param inputs - User inputs.\n   * @param callbackManager - Callback manager to use for this call.\n   *\n   * @returns Action specifying what tool to use.\n   */\n  plan(\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager\n  ): Promise<AgentAction | AgentFinish> {\n    return this._plan(steps, inputs, undefined, callbackManager);\n  }\n\n  /**\n   * Return response when agent has been stopped due to max iterations\n   */\n  async returnStoppedResponse(\n    earlyStoppingMethod: StoppingMethod,\n    steps: AgentStep[],\n    inputs: ChainValues,\n    callbackManager?: CallbackManager\n  ): Promise<AgentFinish> {\n    if (earlyStoppingMethod === \"force\") {\n      return {\n        returnValues: { output: \"Agent stopped due to max iterations.\" },\n        log: \"\",\n      };\n    }\n\n    if (earlyStoppingMethod === \"generate\") {\n      try {\n        const action = await this._plan(\n          steps,\n          inputs,\n          \"\\n\\nI now need to return a final answer based on the previous steps:\",\n          callbackManager\n        );\n        if (\"returnValues\" in action) {\n          return action;\n        }\n\n        return { returnValues: { output: action.log }, log: action.log };\n      } catch (err) {\n        // fine to use instanceof because we're in the same module\n        // eslint-disable-next-line no-instanceof/no-instanceof\n        if (!(err instanceof ParseError)) {\n          throw err;\n        }\n        return { returnValues: { output: err.output }, log: err.output };\n      }\n    }\n\n    throw new Error(`Invalid stopping method: ${earlyStoppingMethod}`);\n  }\n\n  /**\n   * Load an agent from a json-like object describing it.\n   */\n  static async deserialize(\n    data: SerializedAgent & {\n      llm?: BaseLanguageModelInterface;\n      tools?: ToolInterface[];\n    }\n  ): Promise<Agent> {\n    switch (data._type) {\n      case \"zero-shot-react-description\": {\n        const { ZeroShotAgent } = await import(\"./mrkl/index.js\");\n        return ZeroShotAgent.deserialize(data);\n      }\n      default:\n        throw new Error(\"Unknown agent type\");\n    }\n  }\n}\n"],"mappings":"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"}