@langchain/classic 1.0.0-alpha.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"initialize.d.ts","names":["_langchain_core_language_models_base2","BaseLanguageModelInterface","StructuredToolInterface","ToolInterface","CallbackManager","ChatAgent","ChatConversationalAgent","StructuredChatAgent","AgentExecutor","AgentExecutorInput","ZeroShotAgent","OpenAIAgent","XMLAgent","AgentType","initializeAgentExecutor","_________langchain_core_dist_tools_types_js0","StringInputToolSchema","BaseLanguageModelCallOptions","Promise","InitializeAgentExecutorOptions","fromLLMAndTools","Parameters","Omit","InitializeAgentExecutorOptionsStructured","initializeAgentExecutorWithOptions"],"sources":["../../src/agents/initialize.d.ts"],"sourcesContent":["import type { BaseLanguageModelInterface } from \"@langchain/core/language_models/base\";\nimport type { StructuredToolInterface, ToolInterface } from \"@langchain/core/tools\";\nimport { CallbackManager } from \"@langchain/core/callbacks/manager\";\nimport { ChatAgent } from \"./chat/index.js\";\nimport { ChatConversationalAgent } from \"./chat_convo/index.js\";\nimport { StructuredChatAgent } from \"./structured_chat/index.js\";\nimport { AgentExecutor, AgentExecutorInput } from \"./executor.js\";\nimport { ZeroShotAgent } from \"./mrkl/index.js\";\nimport { OpenAIAgent } from \"./openai_functions/index.js\";\nimport { XMLAgent } from \"./xml/index.js\";\n/**\n * Represents the type of an agent in LangChain. It can be\n * \"zero-shot-react-description\", \"chat-zero-shot-react-description\", or\n * \"chat-conversational-react-description\".\n */\ntype AgentType = \"zero-shot-react-description\" | \"chat-zero-shot-react-description\" | \"chat-conversational-react-description\";\nexport declare const initializeAgentExecutor: (tools: ToolInterface<import(\"../../../langchain-core/dist/tools/types.js\").StringInputToolSchema, any, any>[], llm: BaseLanguageModelInterface<any, import(\"@langchain/core/language_models/base\").BaseLanguageModelCallOptions>, _agentType?: AgentType | undefined, _verbose?: boolean | undefined, _callbackManager?: CallbackManager | undefined) => Promise<AgentExecutor>;\n/**\n * @interface\n */\nexport type InitializeAgentExecutorOptions = ({\n    agentType: \"zero-shot-react-description\";\n    agentArgs?: Parameters<typeof ZeroShotAgent.fromLLMAndTools>[2];\n    memory?: never;\n} & Omit<AgentExecutorInput, \"agent\" | \"tools\">) | ({\n    agentType: \"chat-zero-shot-react-description\";\n    agentArgs?: Parameters<typeof ChatAgent.fromLLMAndTools>[2];\n    memory?: never;\n} & Omit<AgentExecutorInput, \"agent\" | \"tools\">) | ({\n    agentType: \"chat-conversational-react-description\";\n    agentArgs?: Parameters<typeof ChatConversationalAgent.fromLLMAndTools>[2];\n} & Omit<AgentExecutorInput, \"agent\" | \"tools\">) | ({\n    agentType: \"xml\";\n    agentArgs?: Parameters<typeof XMLAgent.fromLLMAndTools>[2];\n} & Omit<AgentExecutorInput, \"agent\" | \"tools\">);\n/**\n * @interface\n */\nexport type InitializeAgentExecutorOptionsStructured = ({\n    agentType: \"structured-chat-zero-shot-react-description\";\n    agentArgs?: Parameters<typeof StructuredChatAgent.fromLLMAndTools>[2];\n} & Omit<AgentExecutorInput, \"agent\" | \"tools\">) | ({\n    agentType: \"openai-functions\";\n    agentArgs?: Parameters<typeof OpenAIAgent.fromLLMAndTools>[2];\n} & Omit<AgentExecutorInput, \"agent\" | \"tools\">);\n/**\n * Initialize an agent executor with options.\n * @param tools Array of tools to use in the agent\n * @param llm LLM or ChatModel to use in the agent\n * @param options Options for the agent, including agentType, agentArgs, and other options for AgentExecutor.fromAgentAndTools\n * @returns AgentExecutor\n */\nexport declare function initializeAgentExecutorWithOptions(tools: StructuredToolInterface[], llm: BaseLanguageModelInterface, options: InitializeAgentExecutorOptionsStructured): Promise<AgentExecutor>;\nexport declare function initializeAgentExecutorWithOptions(tools: ToolInterface[], llm: BaseLanguageModelInterface, options?: InitializeAgentExecutorOptions): Promise<AgentExecutor>;\nexport {};\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAS0C;AAO1C,KADKa,SAAAA,GACgBC,6BAAyY,GAAA,kCAAA,GAAA,uCAAA;AAAA,cAAzYA,uBAAyY,EAAA,CAAA,KAAA,EAAxWX,aAAwW,CAAA,qBAAA,EAAA,GAAA,EAAA,GAAA,CAAA,EAAA,EAAA,GAAA,EAA3PF,0BAA2P,CAAA,GAAA,EAA3VD,qCAAAA,CAA+KiB,4BAAAA,CAA4K,EAAA,UAAA,CAAA,EAAhIJ,SAAgI,GAAA,SAAA,EAAA,QAAA,CAAA,EAAA,OAAA,GAAA,SAAA,EAAA,gBAAA,CAAA,EAAtDT,eAAsD,GAAA,SAAA,EAAA,GAAtBc,OAAsB,CAAdV,aAAc,CAAA;;;;AAA3PP,KAIvJkB,8BAAAA,GAJuJlB,CAAAA;EAA0B,SAAiGY,EAAAA,6BAAAA;EAAS,SAAiET,CAAAA,EAMxViB,UANwVjB,CAAAA,OAMtUM,aAAAA,CAAcU,eANwThB,CAAAA,CAAAA,CAAAA,CAAAA;EAAe,MAAyBI,CAAAA,EAAAA,KAAAA;CAAa,GAQzZc,IARoYJ,CAQ/XT,kBAR+XS,EAAAA,OAAAA,GAAAA,OAAAA,CAAAA,CAAAA,GAAAA,CAAAA;EAAO,SAAA,EAAA,kCAAA;EAInYC,SAAAA,CAAAA,EAMIE,UANJF,CAAAA,OAMsBd,SAAAA,CAAUe,eANF,CAAA,CAAA,CAAA,CAAA;EAAA,MAAA,CAAA,EAAA,KAAA;CAAA,GAQtCE,IAN8BZ,CAMzBD,kBANuCW,EAAAA,OAAAA,GAAAA,OAAAA,CAAAA,CAAAA,GAAAA,CAAAA;EAAe,SAA/CC,EAAAA,uCAAAA;EAAU,SAEjBZ,CAAAA,EAMOY,UANPZ,CAAAA,OAMyBH,uBAAAA,CAAwBc,eANjDX,CAAAA,CAAAA,CAAAA,CAAAA;CAAkB,GAOvBa,IAPAA,CAOKb,kBAPLa,EAAAA,OAAAA,GAAAA,OAAAA,CAAAA,CAAAA,GAAAA,CAAAA;EAAI,SAE0BjB,EAAAA,KAAUe;EAAe,SAA3CC,CAAAA,EAOAA,UAPAA,CAAAA,OAOkBT,QAAAA,CAASQ,eAP3BC,CAAAA,CAAAA,CAAAA,CAAAA;CAAU,GAQtBC,IANKb,CAMAA,kBANAA,EAAAA,OAAAA,GAAAA,OAAAA,CAAAA,CAAAA;;;;AAGAA,KAOGc,wCAAAA,GAPHd,CAAAA;EAAkB,SAAvBa,EAAAA,6CAAAA;EAAI,SAE0BV,CAAAA,EAOlBS,UAP2BD,CAAAA,OAOTb,mBAAAA,CAAoBa,eAPXA,CAAAA,CAAAA,CAAAA,CAAAA;CAAe,GAQtDE,IARYD,CAQPZ,kBAROY,EAAAA,OAAAA,GAAAA,OAAAA,CAAAA,CAAAA,GAAAA,CAAAA;EAAU,SACjBZ,EAAAA,kBAAAA;EAAkB,SAAvBa,CAAAA,EASYD,UATZC,CAAAA,OAS8BX,WAAAA,CAAYS,eAT1CE,CAAAA,CAAAA,CAAAA,CAAAA;AAAI,CAAA,GAUJA,IAVI,CAUCb,kBAVD,EAAA,OAAA,GAAA,OAAA,CAAA,CAAA;AAIR;;;;;;;AAKgBY,iBASQG,kCAAAA,CATRH,KAAAA,EASkDnB,uBATlDmB,EAAAA,EAAAA,GAAAA,EASkFpB,0BATlFoB,EAAAA,OAAAA,EASuHE,wCATvHF,CAAAA,EASkKH,OATlKG,CAS0Kb,aAT1Ka,CAAAA;AACPZ,iBASee,kCAAAA,CATff,KAAAA,EASyDN,aATzDM,EAAAA,EAAAA,GAAAA,EAS+ER,0BAT/EQ,EAAAA,OAAAA,CAAAA,EASqHU,8BATrHV,CAAAA,EASsJS,OATtJT,CAS8JD,aAT9JC,CAAAA"}

package/dist/agents/initialize.js

@@ -0,0 +1,118 @@
+import { ZeroShotAgent } from "./mrkl/index.js";
+import { AgentExecutor } from "./executor.js";
+import { BufferMemory } from "../memory/buffer_memory.js";
+import { ChatAgent } from "./chat/index.js";
+import { ChatConversationalAgent } from "./chat_convo/index.js";
+import { StructuredChatAgent } from "./structured_chat/index.js";
+import { OpenAIAgent } from "./openai_functions/index.js";
+import { XMLAgent } from "./xml/index.js";
+
+//#region src/agents/initialize.ts
+const initializeAgentExecutor = async (tools, llm, _agentType, _verbose, _callbackManager) => {
+	const agentType = _agentType ?? "zero-shot-react-description";
+	const verbose = _verbose;
+	const callbackManager = _callbackManager;
+	switch (agentType) {
+		case "zero-shot-react-description": return AgentExecutor.fromAgentAndTools({
+			agent: ZeroShotAgent.fromLLMAndTools(llm, tools),
+			tools,
+			returnIntermediateSteps: true,
+			verbose,
+			callbackManager
+		});
+		case "chat-zero-shot-react-description": return AgentExecutor.fromAgentAndTools({
+			agent: ChatAgent.fromLLMAndTools(llm, tools),
+			tools,
+			returnIntermediateSteps: true,
+			verbose,
+			callbackManager
+		});
+		case "chat-conversational-react-description": return AgentExecutor.fromAgentAndTools({
+			agent: ChatConversationalAgent.fromLLMAndTools(llm, tools),
+			tools,
+			verbose,
+			callbackManager
+		});
+		default: throw new Error("Unknown agent type");
+	}
+};
+async function initializeAgentExecutorWithOptions(tools, llm, options = { agentType: llm._modelType() === "base_chat_model" ? "chat-zero-shot-react-description" : "zero-shot-react-description" }) {
+	switch (options.agentType) {
+		case "zero-shot-react-description": {
+			const { agentArgs, tags,...rest } = options;
+			return AgentExecutor.fromAgentAndTools({
+				tags: [...tags ?? [], "zero-shot-react-description"],
+				agent: ZeroShotAgent.fromLLMAndTools(llm, tools, agentArgs),
+				tools,
+				...rest
+			});
+		}
+		case "chat-zero-shot-react-description": {
+			const { agentArgs, tags,...rest } = options;
+			return AgentExecutor.fromAgentAndTools({
+				tags: [...tags ?? [], "chat-zero-shot-react-description"],
+				agent: ChatAgent.fromLLMAndTools(llm, tools, agentArgs),
+				tools,
+				...rest
+			});
+		}
+		case "chat-conversational-react-description": {
+			const { agentArgs, memory, tags,...rest } = options;
+			const executor = AgentExecutor.fromAgentAndTools({
+				tags: [...tags ?? [], "chat-conversational-react-description"],
+				agent: ChatConversationalAgent.fromLLMAndTools(llm, tools, agentArgs),
+				tools,
+				memory: memory ?? new BufferMemory({
+					returnMessages: true,
+					memoryKey: "chat_history",
+					inputKey: "input",
+					outputKey: "output"
+				}),
+				...rest
+			});
+			return executor;
+		}
+		case "xml": {
+			const { agentArgs, tags,...rest } = options;
+			const executor = AgentExecutor.fromAgentAndTools({
+				tags: [...tags ?? [], "xml"],
+				agent: XMLAgent.fromLLMAndTools(llm, tools, agentArgs),
+				tools,
+				...rest
+			});
+			return executor;
+		}
+		case "structured-chat-zero-shot-react-description": {
+			const { agentArgs, memory, tags,...rest } = options;
+			const executor = AgentExecutor.fromAgentAndTools({
+				tags: [...tags ?? [], "structured-chat-zero-shot-react-description"],
+				agent: StructuredChatAgent.fromLLMAndTools(llm, tools, agentArgs),
+				tools,
+				memory,
+				...rest
+			});
+			return executor;
+		}
+		case "openai-functions": {
+			const { agentArgs, memory, tags,...rest } = options;
+			const executor = AgentExecutor.fromAgentAndTools({
+				tags: [...tags ?? [], "openai-functions"],
+				agent: OpenAIAgent.fromLLMAndTools(llm, tools, agentArgs),
+				tools,
+				memory: memory ?? new BufferMemory({
+					returnMessages: true,
+					memoryKey: "chat_history",
+					inputKey: "input",
+					outputKey: "output"
+				}),
+				...rest
+			});
+			return executor;
+		}
+		default: throw new Error("Unknown agent type");
+	}
+}
+
+//#endregion
+export { initializeAgentExecutor, initializeAgentExecutorWithOptions };
+//# sourceMappingURL=initialize.js.map

package/dist/agents/initialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialize.js","names":["tools: ToolInterface[]","llm: BaseLanguageModelInterface","_agentType?: AgentType","_verbose?: boolean","_callbackManager?: CallbackManager","tools: StructuredToolInterface[] | ToolInterface[]","options:\n    | InitializeAgentExecutorOptions\n    | InitializeAgentExecutorOptionsStructured"],"sources":["../../src/agents/initialize.ts"],"sourcesContent":["import type { BaseLanguageModelInterface } from \"@langchain/core/language_models/base\";\nimport type {\n  StructuredToolInterface,\n  ToolInterface,\n} from \"@langchain/core/tools\";\nimport { CallbackManager } from \"@langchain/core/callbacks/manager\";\nimport { BufferMemory } from \"../memory/buffer_memory.js\";\nimport { ChatAgent } from \"./chat/index.js\";\nimport { ChatConversationalAgent } from \"./chat_convo/index.js\";\nimport { StructuredChatAgent } from \"./structured_chat/index.js\";\nimport { AgentExecutor, AgentExecutorInput } from \"./executor.js\";\nimport { ZeroShotAgent } from \"./mrkl/index.js\";\nimport { OpenAIAgent } from \"./openai_functions/index.js\";\nimport { XMLAgent } from \"./xml/index.js\";\n\n/**\n * Represents the type of an agent in LangChain. It can be\n * \"zero-shot-react-description\", \"chat-zero-shot-react-description\", or\n * \"chat-conversational-react-description\".\n */\ntype AgentType =\n  | \"zero-shot-react-description\"\n  | \"chat-zero-shot-react-description\"\n  | \"chat-conversational-react-description\";\n\nexport const initializeAgentExecutor = async (\n  tools: ToolInterface[],\n  llm: BaseLanguageModelInterface,\n  _agentType?: AgentType,\n  _verbose?: boolean,\n  _callbackManager?: CallbackManager\n): Promise<AgentExecutor> => {\n  const agentType = _agentType ?? \"zero-shot-react-description\";\n  const verbose = _verbose;\n  const callbackManager = _callbackManager;\n  switch (agentType) {\n    case \"zero-shot-react-description\":\n      return AgentExecutor.fromAgentAndTools({\n        agent: ZeroShotAgent.fromLLMAndTools(llm, tools),\n        tools,\n        returnIntermediateSteps: true,\n        verbose,\n        callbackManager,\n      });\n    case \"chat-zero-shot-react-description\":\n      return AgentExecutor.fromAgentAndTools({\n        agent: ChatAgent.fromLLMAndTools(llm, tools),\n        tools,\n        returnIntermediateSteps: true,\n        verbose,\n        callbackManager,\n      });\n    case \"chat-conversational-react-description\":\n      return AgentExecutor.fromAgentAndTools({\n        agent: ChatConversationalAgent.fromLLMAndTools(llm, tools),\n        tools,\n        verbose,\n        callbackManager,\n      });\n    default:\n      throw new Error(\"Unknown agent type\");\n  }\n};\n\n/**\n * @interface\n */\nexport type InitializeAgentExecutorOptions =\n  | ({\n      agentType: \"zero-shot-react-description\";\n      agentArgs?: Parameters<typeof ZeroShotAgent.fromLLMAndTools>[2];\n      memory?: never;\n    } & Omit<AgentExecutorInput, \"agent\" | \"tools\">)\n  | ({\n      agentType: \"chat-zero-shot-react-description\";\n      agentArgs?: Parameters<typeof ChatAgent.fromLLMAndTools>[2];\n      memory?: never;\n    } & Omit<AgentExecutorInput, \"agent\" | \"tools\">)\n  | ({\n      agentType: \"chat-conversational-react-description\";\n      agentArgs?: Parameters<typeof ChatConversationalAgent.fromLLMAndTools>[2];\n    } & Omit<AgentExecutorInput, \"agent\" | \"tools\">)\n  | ({\n      agentType: \"xml\";\n      agentArgs?: Parameters<typeof XMLAgent.fromLLMAndTools>[2];\n    } & Omit<AgentExecutorInput, \"agent\" | \"tools\">);\n\n/**\n * @interface\n */\nexport type InitializeAgentExecutorOptionsStructured =\n  | ({\n      agentType: \"structured-chat-zero-shot-react-description\";\n      agentArgs?: Parameters<typeof StructuredChatAgent.fromLLMAndTools>[2];\n    } & Omit<AgentExecutorInput, \"agent\" | \"tools\">)\n  | ({\n      agentType: \"openai-functions\";\n      agentArgs?: Parameters<typeof OpenAIAgent.fromLLMAndTools>[2];\n    } & Omit<AgentExecutorInput, \"agent\" | \"tools\">);\n\n/**\n * Initialize an agent executor with options.\n * @param tools Array of tools to use in the agent\n * @param llm LLM or ChatModel to use in the agent\n * @param options Options for the agent, including agentType, agentArgs, and other options for AgentExecutor.fromAgentAndTools\n * @returns AgentExecutor\n */\nexport async function initializeAgentExecutorWithOptions(\n  tools: StructuredToolInterface[],\n  llm: BaseLanguageModelInterface,\n  options: InitializeAgentExecutorOptionsStructured\n): Promise<AgentExecutor>;\nexport async function initializeAgentExecutorWithOptions(\n  tools: ToolInterface[],\n  llm: BaseLanguageModelInterface,\n  options?: InitializeAgentExecutorOptions\n): Promise<AgentExecutor>;\nexport async function initializeAgentExecutorWithOptions(\n  tools: StructuredToolInterface[] | ToolInterface[],\n  llm: BaseLanguageModelInterface,\n  options:\n    | InitializeAgentExecutorOptions\n    | InitializeAgentExecutorOptionsStructured = {\n    agentType:\n      llm._modelType() === \"base_chat_model\"\n        ? \"chat-zero-shot-react-description\"\n        : \"zero-shot-react-description\",\n  }\n): Promise<AgentExecutor> {\n  // Note this tools cast is safe as the overload signatures prevent\n  // the function from being called with a StructuredTool[] when\n  // the agentType is not in InitializeAgentExecutorOptionsStructured\n  switch (options.agentType) {\n    case \"zero-shot-react-description\": {\n      const { agentArgs, tags, ...rest } = options;\n      return AgentExecutor.fromAgentAndTools({\n        tags: [...(tags ?? []), \"zero-shot-react-description\"],\n        agent: ZeroShotAgent.fromLLMAndTools(\n          llm,\n          tools as ToolInterface[],\n          agentArgs\n        ),\n        tools,\n        ...rest,\n      });\n    }\n    case \"chat-zero-shot-react-description\": {\n      const { agentArgs, tags, ...rest } = options;\n      return AgentExecutor.fromAgentAndTools({\n        tags: [...(tags ?? []), \"chat-zero-shot-react-description\"],\n        agent: ChatAgent.fromLLMAndTools(\n          llm,\n          tools as ToolInterface[],\n          agentArgs\n        ),\n        tools,\n        ...rest,\n      });\n    }\n    case \"chat-conversational-react-description\": {\n      const { agentArgs, memory, tags, ...rest } = options;\n      const executor = AgentExecutor.fromAgentAndTools({\n        tags: [...(tags ?? []), \"chat-conversational-react-description\"],\n        agent: ChatConversationalAgent.fromLLMAndTools(\n          llm,\n          tools as ToolInterface[],\n          agentArgs\n        ),\n        tools,\n        memory:\n          memory ??\n          new BufferMemory({\n            returnMessages: true,\n            memoryKey: \"chat_history\",\n            inputKey: \"input\",\n            outputKey: \"output\",\n          }),\n        ...rest,\n      });\n      return executor;\n    }\n    case \"xml\": {\n      const { agentArgs, tags, ...rest } = options;\n      const executor = AgentExecutor.fromAgentAndTools({\n        tags: [...(tags ?? []), \"xml\"],\n        agent: XMLAgent.fromLLMAndTools(\n          llm,\n          tools as ToolInterface[],\n          agentArgs\n        ),\n        tools,\n        ...rest,\n      });\n      return executor;\n    }\n    case \"structured-chat-zero-shot-react-description\": {\n      const { agentArgs, memory, tags, ...rest } = options;\n      const executor = AgentExecutor.fromAgentAndTools({\n        tags: [...(tags ?? []), \"structured-chat-zero-shot-react-description\"],\n        agent: StructuredChatAgent.fromLLMAndTools(llm, tools, agentArgs),\n        tools,\n        memory,\n        ...rest,\n      });\n      return executor;\n    }\n    case \"openai-functions\": {\n      const { agentArgs, memory, tags, ...rest } = options;\n      const executor = AgentExecutor.fromAgentAndTools({\n        tags: [...(tags ?? []), \"openai-functions\"],\n        agent: OpenAIAgent.fromLLMAndTools(llm, tools, agentArgs),\n        tools,\n        memory:\n          memory ??\n          new BufferMemory({\n            returnMessages: true,\n            memoryKey: \"chat_history\",\n            inputKey: \"input\",\n            outputKey: \"output\",\n          }),\n        ...rest,\n      });\n      return executor;\n    }\n    default: {\n      throw new Error(\"Unknown agent type\");\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;AAyBA,MAAa,0BAA0B,OACrCA,OACAC,KACAC,YACAC,UACAC,qBAC2B;CAC3B,MAAM,YAAY,cAAc;CAChC,MAAM,UAAU;CAChB,MAAM,kBAAkB;AACxB,SAAQ,WAAR;EACE,KAAK,8BACH,QAAO,cAAc,kBAAkB;GACrC,OAAO,cAAc,gBAAgB,KAAK,MAAM;GAChD;GACA,yBAAyB;GACzB;GACA;EACD,EAAC;EACJ,KAAK,mCACH,QAAO,cAAc,kBAAkB;GACrC,OAAO,UAAU,gBAAgB,KAAK,MAAM;GAC5C;GACA,yBAAyB;GACzB;GACA;EACD,EAAC;EACJ,KAAK,wCACH,QAAO,cAAc,kBAAkB;GACrC,OAAO,wBAAwB,gBAAgB,KAAK,MAAM;GAC1D;GACA;GACA;EACD,EAAC;EACJ,QACE,OAAM,IAAI,MAAM;CACnB;AACF;AAuDD,eAAsB,mCACpBC,OACAJ,KACAK,UAE+C,EAC7C,WACE,IAAI,YAAY,KAAK,oBACjB,qCACA,8BACP,GACuB;AAIxB,SAAQ,QAAQ,WAAhB;EACE,KAAK,+BAA+B;GAClC,MAAM,EAAE,WAAW,KAAM,GAAG,MAAM,GAAG;AACrC,UAAO,cAAc,kBAAkB;IACrC,MAAM,CAAC,GAAI,QAAQ,CAAE,GAAG,6BAA8B;IACtD,OAAO,cAAc,gBACnB,KACA,OACA,UACD;IACD;IACA,GAAG;GACJ,EAAC;EACH;EACD,KAAK,oCAAoC;GACvC,MAAM,EAAE,WAAW,KAAM,GAAG,MAAM,GAAG;AACrC,UAAO,cAAc,kBAAkB;IACrC,MAAM,CAAC,GAAI,QAAQ,CAAE,GAAG,kCAAmC;IAC3D,OAAO,UAAU,gBACf,KACA,OACA,UACD;IACD;IACA,GAAG;GACJ,EAAC;EACH;EACD,KAAK,yCAAyC;GAC5C,MAAM,EAAE,WAAW,QAAQ,KAAM,GAAG,MAAM,GAAG;GAC7C,MAAM,WAAW,cAAc,kBAAkB;IAC/C,MAAM,CAAC,GAAI,QAAQ,CAAE,GAAG,uCAAwC;IAChE,OAAO,wBAAwB,gBAC7B,KACA,OACA,UACD;IACD;IACA,QACE,UACA,IAAI,aAAa;KACf,gBAAgB;KAChB,WAAW;KACX,UAAU;KACV,WAAW;IACZ;IACH,GAAG;GACJ,EAAC;AACF,UAAO;EACR;EACD,KAAK,OAAO;GACV,MAAM,EAAE,WAAW,KAAM,GAAG,MAAM,GAAG;GACrC,MAAM,WAAW,cAAc,kBAAkB;IAC/C,MAAM,CAAC,GAAI,QAAQ,CAAE,GAAG,KAAM;IAC9B,OAAO,SAAS,gBACd,KACA,OACA,UACD;IACD;IACA,GAAG;GACJ,EAAC;AACF,UAAO;EACR;EACD,KAAK,+CAA+C;GAClD,MAAM,EAAE,WAAW,QAAQ,KAAM,GAAG,MAAM,GAAG;GAC7C,MAAM,WAAW,cAAc,kBAAkB;IAC/C,MAAM,CAAC,GAAI,QAAQ,CAAE,GAAG,6CAA8C;IACtE,OAAO,oBAAoB,gBAAgB,KAAK,OAAO,UAAU;IACjE;IACA;IACA,GAAG;GACJ,EAAC;AACF,UAAO;EACR;EACD,KAAK,oBAAoB;GACvB,MAAM,EAAE,WAAW,QAAQ,KAAM,GAAG,MAAM,GAAG;GAC7C,MAAM,WAAW,cAAc,kBAAkB;IAC/C,MAAM,CAAC,GAAI,QAAQ,CAAE,GAAG,kBAAmB;IAC3C,OAAO,YAAY,gBAAgB,KAAK,OAAO,UAAU;IACzD;IACA,QACE,UACA,IAAI,aAAa;KACf,gBAAgB;KAChB,WAAW;KACX,UAAU;KACV,WAAW;IACZ;IACH,GAAG;GACJ,EAAC;AACF,UAAO;EACR;EACD,QACE,OAAM,IAAI,MAAM;CAEnB;AACF"}

package/dist/agents/load.cjs

@@ -0,0 +1,31 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_agent = require('./agent.cjs');
+const require_hub = require('../util/hub.cjs');
+const require_load = require('../util/load.cjs');
+const require_parse = require('../util/parse.cjs');
+
+//#region src/agents/load.ts
+var load_exports = {};
+require_rolldown_runtime.__export(load_exports, { loadAgent: () => loadAgent });
+const loadAgentFromFile = async (file, path, llmAndTools) => {
+	const serialized = require_parse.parseFileConfig(file, path);
+	return require_agent.Agent.deserialize({
+		...serialized,
+		...llmAndTools
+	});
+};
+const loadAgent = async (uri, llmAndTools) => {
+	const hubResult = await require_hub.loadFromHub(uri, loadAgentFromFile, "agents", new Set(["json", "yaml"]), llmAndTools);
+	if (hubResult) return hubResult;
+	return require_load.loadFromFile(uri, loadAgentFromFile, llmAndTools);
+};
+
+//#endregion
+exports.loadAgent = loadAgent;
+Object.defineProperty(exports, 'load_exports', {
+  enumerable: true,
+  get: function () {
+    return load_exports;
+  }
+});
+//# sourceMappingURL=load.cjs.map

package/dist/agents/load.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.cjs","names":["loadAgentFromFile: FileLoader<Agent>","file: string","path: string","llmAndTools?: { llm?: BaseLanguageModelInterface; tools?: ToolInterface[] }","parseFileConfig","Agent","uri: string","loadFromHub","loadFromFile"],"sources":["../../src/agents/load.ts"],"sourcesContent":["import type { BaseLanguageModelInterface } from \"@langchain/core/language_models/base\";\nimport type { ToolInterface } from \"@langchain/core/tools\";\nimport { Agent } from \"./agent.js\";\nimport { loadFromHub } from \"../util/hub.js\";\nimport { FileLoader, loadFromFile } from \"../util/load.js\";\nimport { parseFileConfig } from \"../util/parse.js\";\n\nconst loadAgentFromFile: FileLoader<Agent> = async (\n  file: string,\n  path: string,\n  llmAndTools?: { llm?: BaseLanguageModelInterface; tools?: ToolInterface[] }\n) => {\n  const serialized = parseFileConfig(file, path);\n  return Agent.deserialize({ ...serialized, ...llmAndTools });\n};\n\nexport const loadAgent = async (\n  uri: string,\n  llmAndTools?: { llm?: BaseLanguageModelInterface; tools?: ToolInterface[] }\n): Promise<Agent> => {\n  const hubResult = await loadFromHub(\n    uri,\n    loadAgentFromFile,\n    \"agents\",\n    new Set([\"json\", \"yaml\"]),\n    llmAndTools\n  );\n  if (hubResult) {\n    return hubResult;\n  }\n\n  return loadFromFile(uri, loadAgentFromFile, llmAndTools);\n};\n"],"mappings":";;;;;;;;;AAOA,MAAMA,oBAAuC,OAC3CC,MACAC,MACAC,gBACG;CACH,MAAM,aAAaC,8BAAgB,MAAM,KAAK;AAC9C,QAAOC,oBAAM,YAAY;EAAE,GAAG;EAAY,GAAG;CAAa,EAAC;AAC5D;AAED,MAAa,YAAY,OACvBC,KACAH,gBACmB;CACnB,MAAM,YAAY,MAAMI,wBACtB,KACA,mBACA,UACA,IAAI,IAAI,CAAC,QAAQ,MAAO,IACxB,YACD;AACD,KAAI,UACF,QAAO;AAGT,QAAOC,0BAAa,KAAK,mBAAmB,YAAY;AACzD"}

package/dist/agents/load.d.cts

@@ -0,0 +1,14 @@
+import { Agent } from "./agent.cjs";
+import { StringInputToolSchema } from "../langchain-core/dist/tools/types.cjs";
+import * as _langchain_core_language_models_base0 from "@langchain/core/language_models/base";
+import { BaseLanguageModelInterface } from "@langchain/core/language_models/base";
+import { ToolInterface } from "@langchain/core/tools";
+
+//#region src/agents/load.d.ts
+declare const loadAgent: (uri: string, llmAndTools?: {
+  llm?: BaseLanguageModelInterface<any, _langchain_core_language_models_base0.BaseLanguageModelCallOptions> | undefined;
+  tools?: ToolInterface<StringInputToolSchema, any, any>[] | undefined;
+} | undefined) => Promise<Agent>;
+//#endregion
+export { loadAgent };
+//# sourceMappingURL=load.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.cts","names":["_________langchain_core_dist_tools_types_js0","BaseLanguageModelInterface","ToolInterface","Agent","loadAgent","_langchain_core_language_models_base0","BaseLanguageModelCallOptions","StringInputToolSchema","Promise"],"sources":["../../src/agents/load.d.ts"],"sourcesContent":["import type { BaseLanguageModelInterface } from \"@langchain/core/language_models/base\";\nimport type { ToolInterface } from \"@langchain/core/tools\";\nimport { Agent } from \"./agent.js\";\nexport declare const loadAgent: (uri: string, llmAndTools?: {\n    llm?: BaseLanguageModelInterface<any, import(\"@langchain/core/language_models/base\").BaseLanguageModelCallOptions> | undefined;\n    tools?: ToolInterface<import(\"../../../langchain-core/dist/tools/types.js\").StringInputToolSchema, any, any>[] | undefined;\n} | undefined) => Promise<Agent>;\n"],"mappings":";;;;;;;cAGqBI;QACXH,gCAEsBI,qCAAAA,CAFyDC,4BAAAA;UAC7EJ,cADwB,qBAAA;kBAElBM,QAAQL"}

package/dist/agents/load.d.ts

@@ -0,0 +1,14 @@
+import { Agent } from "./agent.js";
+import { StringInputToolSchema } from "../libs/langchain-core/dist/tools/types.js";
+import { ToolInterface } from "@langchain/core/tools";
+import * as _langchain_core_language_models_base0 from "@langchain/core/language_models/base";
+import { BaseLanguageModelInterface } from "@langchain/core/language_models/base";
+
+//#region src/agents/load.d.ts
+declare const loadAgent: (uri: string, llmAndTools?: {
+  llm?: BaseLanguageModelInterface<any, _langchain_core_language_models_base0.BaseLanguageModelCallOptions> | undefined;
+  tools?: ToolInterface<StringInputToolSchema, any, any>[] | undefined;
+} | undefined) => Promise<Agent>;
+//#endregion
+export { loadAgent };
+//# sourceMappingURL=load.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","names":["_________langchain_core_dist_tools_types_js0","BaseLanguageModelInterface","ToolInterface","Agent","loadAgent","_langchain_core_language_models_base0","BaseLanguageModelCallOptions","StringInputToolSchema","Promise"],"sources":["../../src/agents/load.d.ts"],"sourcesContent":["import type { BaseLanguageModelInterface } from \"@langchain/core/language_models/base\";\nimport type { ToolInterface } from \"@langchain/core/tools\";\nimport { Agent } from \"./agent.js\";\nexport declare const loadAgent: (uri: string, llmAndTools?: {\n    llm?: BaseLanguageModelInterface<any, import(\"@langchain/core/language_models/base\").BaseLanguageModelCallOptions> | undefined;\n    tools?: ToolInterface<import(\"../../../langchain-core/dist/tools/types.js\").StringInputToolSchema, any, any>[] | undefined;\n} | undefined) => Promise<Agent>;\n"],"mappings":";;;;;;;cAGqBI;QACXH,gCAEsBI,qCAAAA,CAFyDC,4BAAAA;UAC7EJ,cADwB,qBAAA;kBAElBM,QAAQL"}

package/dist/agents/load.js

@@ -0,0 +1,25 @@
+import { __export } from "../_virtual/rolldown_runtime.js";
+import { Agent } from "./agent.js";
+import { loadFromHub } from "../util/hub.js";
+import { loadFromFile } from "../util/load.js";
+import { parseFileConfig } from "../util/parse.js";
+
+//#region src/agents/load.ts
+var load_exports = {};
+__export(load_exports, { loadAgent: () => loadAgent });
+const loadAgentFromFile = async (file, path, llmAndTools) => {
+	const serialized = parseFileConfig(file, path);
+	return Agent.deserialize({
+		...serialized,
+		...llmAndTools
+	});
+};
+const loadAgent = async (uri, llmAndTools) => {
+	const hubResult = await loadFromHub(uri, loadAgentFromFile, "agents", new Set(["json", "yaml"]), llmAndTools);
+	if (hubResult) return hubResult;
+	return loadFromFile(uri, loadAgentFromFile, llmAndTools);
+};
+
+//#endregion
+export { loadAgent, load_exports };
+//# sourceMappingURL=load.js.map

package/dist/agents/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","names":["loadAgentFromFile: FileLoader<Agent>","file: string","path: string","llmAndTools?: { llm?: BaseLanguageModelInterface; tools?: ToolInterface[] }","uri: string"],"sources":["../../src/agents/load.ts"],"sourcesContent":["import type { BaseLanguageModelInterface } from \"@langchain/core/language_models/base\";\nimport type { ToolInterface } from \"@langchain/core/tools\";\nimport { Agent } from \"./agent.js\";\nimport { loadFromHub } from \"../util/hub.js\";\nimport { FileLoader, loadFromFile } from \"../util/load.js\";\nimport { parseFileConfig } from \"../util/parse.js\";\n\nconst loadAgentFromFile: FileLoader<Agent> = async (\n  file: string,\n  path: string,\n  llmAndTools?: { llm?: BaseLanguageModelInterface; tools?: ToolInterface[] }\n) => {\n  const serialized = parseFileConfig(file, path);\n  return Agent.deserialize({ ...serialized, ...llmAndTools });\n};\n\nexport const loadAgent = async (\n  uri: string,\n  llmAndTools?: { llm?: BaseLanguageModelInterface; tools?: ToolInterface[] }\n): Promise<Agent> => {\n  const hubResult = await loadFromHub(\n    uri,\n    loadAgentFromFile,\n    \"agents\",\n    new Set([\"json\", \"yaml\"]),\n    llmAndTools\n  );\n  if (hubResult) {\n    return hubResult;\n  }\n\n  return loadFromFile(uri, loadAgentFromFile, llmAndTools);\n};\n"],"mappings":";;;;;;;;;AAOA,MAAMA,oBAAuC,OAC3CC,MACAC,MACAC,gBACG;CACH,MAAM,aAAa,gBAAgB,MAAM,KAAK;AAC9C,QAAO,MAAM,YAAY;EAAE,GAAG;EAAY,GAAG;CAAa,EAAC;AAC5D;AAED,MAAa,YAAY,OACvBC,KACAD,gBACmB;CACnB,MAAM,YAAY,MAAM,YACtB,KACA,mBACA,UACA,IAAI,IAAI,CAAC,QAAQ,MAAO,IACxB,YACD;AACD,KAAI,UACF,QAAO;AAGT,QAAO,aAAa,KAAK,mBAAmB,YAAY;AACzD"}

package/dist/agents/mrkl/index.cjs

@@ -0,0 +1,139 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_agent = require('../agent.cjs');
+const require_llm_chain = require('../../chains/llm_chain.cjs');
+const require_helpers = require('../helpers.cjs');
+const require_prompt = require('./prompt.cjs');
+const require_outputParser = require('./outputParser.cjs');
+const __langchain_core_prompts = require_rolldown_runtime.__toESM(require("@langchain/core/prompts"));
+
+//#region src/agents/mrkl/index.ts
+/**
+* Agent for the MRKL chain.
+* @augments Agent
+* @example
+* ```typescript
+*
+* const agent = new ZeroShotAgent({
+*   llmChain: new LLMChain({
+*     llm: new ChatOpenAI({ model: "gpt-4o-mini", temperature: 0 }),
+*     prompt: ZeroShotAgent.createPrompt([new SerpAPI(), new Calculator()], {
+*       prefix: `Answer the following questions as best you can, but speaking as a pirate might speak. You have access to the following tools:`,
+*       suffix: `Begin! Remember to speak as a pirate when giving your final answer. Use lots of "Args"
+* Question: {input}
+* {agent_scratchpad}`,
+*       inputVariables: ["input", "agent_scratchpad"],
+*     }),
+*   }),
+*   allowedTools: ["search", "calculator"],
+* });
+*
+* const result = await agent.invoke({
+*   input: `Who is Olivia Wilde's boyfriend? What is his current age raised to the 0.23 power?`,
+* });
+* ```
+*/
+var ZeroShotAgent = class ZeroShotAgent extends require_agent.Agent {
+	static lc_name() {
+		return "ZeroShotAgent";
+	}
+	lc_namespace = [
+		"langchain",
+		"agents",
+		"mrkl"
+	];
+	constructor(input) {
+		const outputParser = input?.outputParser ?? ZeroShotAgent.getDefaultOutputParser();
+		super({
+			...input,
+			outputParser
+		});
+	}
+	_agentType() {
+		return "zero-shot-react-description";
+	}
+	observationPrefix() {
+		return "Observation: ";
+	}
+	llmPrefix() {
+		return "Thought:";
+	}
+	/**
+	* Returns the default output parser for the ZeroShotAgent.
+	* @param fields Optional arguments for the output parser.
+	* @returns An instance of ZeroShotAgentOutputParser.
+	*/
+	static getDefaultOutputParser(fields) {
+		return new require_outputParser.ZeroShotAgentOutputParser(fields);
+	}
+	/**
+	* Validates the tools for the ZeroShotAgent. Throws an error if any tool
+	* does not have a description.
+	* @param tools List of tools to validate.
+	*/
+	static validateTools(tools) {
+		const descriptionlessTool = tools.find((tool) => !tool.description);
+		if (descriptionlessTool) {
+			const msg = `Got a tool ${descriptionlessTool.name} without a description. This agent requires descriptions for all tools.`;
+			throw new Error(msg);
+		}
+	}
+	/**
+	* Create prompt in the style of the zero shot agent.
+	*
+	* @param tools - List of tools the agent will have access to, used to format the prompt.
+	* @param args - Arguments to create the prompt with.
+	* @param args.suffix - String to put after the list of tools.
+	* @param args.prefix - String to put before the list of tools.
+	* @param args.inputVariables - List of input variables the final prompt will expect.
+	*/
+	static createPrompt(tools, args) {
+		const { prefix = require_prompt.PREFIX, suffix = require_prompt.SUFFIX, inputVariables = ["input", "agent_scratchpad"] } = args ?? {};
+		const toolStrings = tools.map((tool) => `${tool.name}: ${tool.description}`).join("\n");
+		const toolNames = tools.map((tool) => `"${tool.name}"`).join(", ");
+		const formatInstructions = (0, __langchain_core_prompts.renderTemplate)(require_prompt.FORMAT_INSTRUCTIONS, "f-string", { tool_names: toolNames });
+		const template = [
+			prefix,
+			toolStrings,
+			formatInstructions,
+			suffix
+		].join("\n\n");
+		return new __langchain_core_prompts.PromptTemplate({
+			template,
+			inputVariables
+		});
+	}
+	/**
+	* Creates a ZeroShotAgent from a Large Language Model and a set of tools.
+	* @param llm The Large Language Model to use.
+	* @param tools The tools for the agent to use.
+	* @param args Optional arguments for creating the agent.
+	* @returns A new instance of ZeroShotAgent.
+	*/
+	static fromLLMAndTools(llm, tools, args) {
+		ZeroShotAgent.validateTools(tools);
+		const prompt = ZeroShotAgent.createPrompt(tools, args);
+		const outputParser = args?.outputParser ?? ZeroShotAgent.getDefaultOutputParser();
+		const chain = new require_llm_chain.LLMChain({
+			prompt,
+			llm,
+			callbacks: args?.callbacks ?? args?.callbackManager
+		});
+		return new ZeroShotAgent({
+			llmChain: chain,
+			allowedTools: tools.map((t) => t.name),
+			outputParser
+		});
+	}
+	static async deserialize(data) {
+		const { llm, tools,...rest } = data;
+		return require_helpers.deserializeHelper(llm, tools, rest, (llm$1, tools$1, args) => ZeroShotAgent.fromLLMAndTools(llm$1, tools$1, {
+			prefix: args.prefix,
+			suffix: args.suffix,
+			inputVariables: args.input_variables
+		}), (args) => new ZeroShotAgent(args));
+	}
+};
+
+//#endregion
+exports.ZeroShotAgent = ZeroShotAgent;
+//# sourceMappingURL=index.cjs.map

package/dist/agents/mrkl/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["Agent","input: ZeroShotAgentInput","fields?: OutputParserArgs","ZeroShotAgentOutputParser","tools: ToolInterface[]","args?: ZeroShotCreatePromptArgs","PREFIX","SUFFIX","FORMAT_INSTRUCTIONS","PromptTemplate","llm: BaseLanguageModelInterface","args?: ZeroShotCreatePromptArgs & AgentArgs","LLMChain","data: SerializedZeroShotAgent & {\n      llm?: BaseLanguageModelInterface;\n      tools?: ToolInterface[];\n    }","deserializeHelper","args: SerializedFromLLMAndTools","llm","tools"],"sources":["../../../src/agents/mrkl/index.ts"],"sourcesContent":["import type { BaseLanguageModelInterface } from \"@langchain/core/language_models/base\";\nimport { ToolInterface } from \"@langchain/core/tools\";\nimport { PromptTemplate, renderTemplate } from \"@langchain/core/prompts\";\nimport { LLMChain } from \"../../chains/llm_chain.js\";\nimport { Optional } from \"../../types/type-utils.js\";\nimport { Agent, AgentArgs, OutputParserArgs } from \"../agent.js\";\nimport { deserializeHelper } from \"../helpers.js\";\nimport {\n  AgentInput,\n  SerializedFromLLMAndTools,\n  SerializedZeroShotAgent,\n} from \"../types.js\";\nimport { ZeroShotAgentOutputParser } from \"./outputParser.js\";\nimport { FORMAT_INSTRUCTIONS, PREFIX, SUFFIX } from \"./prompt.js\";\n\n/**\n * Interface for creating a prompt for the ZeroShotAgent.\n */\nexport interface ZeroShotCreatePromptArgs {\n  /** String to put after the list of tools. */\n  suffix?: string;\n  /** String to put before the list of tools. */\n  prefix?: string;\n  /** List of input variables the final prompt will expect. */\n  inputVariables?: string[];\n}\n\n/**\n * Type for the input to the ZeroShotAgent, with the 'outputParser'\n * property made optional.\n */\nexport type ZeroShotAgentInput = Optional<AgentInput, \"outputParser\">;\n\n/**\n * Agent for the MRKL chain.\n * @augments Agent\n * @example\n * ```typescript\n *\n * const agent = new ZeroShotAgent({\n *   llmChain: new LLMChain({\n *     llm: new ChatOpenAI({ model: \"gpt-4o-mini\", temperature: 0 }),\n *     prompt: ZeroShotAgent.createPrompt([new SerpAPI(), new Calculator()], {\n *       prefix: `Answer the following questions as best you can, but speaking as a pirate might speak. You have access to the following tools:`,\n *       suffix: `Begin! Remember to speak as a pirate when giving your final answer. Use lots of \"Args\"\n * Question: {input}\n * {agent_scratchpad}`,\n *       inputVariables: [\"input\", \"agent_scratchpad\"],\n *     }),\n *   }),\n *   allowedTools: [\"search\", \"calculator\"],\n * });\n *\n * const result = await agent.invoke({\n *   input: `Who is Olivia Wilde's boyfriend? What is his current age raised to the 0.23 power?`,\n * });\n * ```\n */\nexport class ZeroShotAgent extends Agent {\n  static lc_name() {\n    return \"ZeroShotAgent\";\n  }\n\n  lc_namespace = [\"langchain\", \"agents\", \"mrkl\"];\n\n  declare ToolType: ToolInterface;\n\n  constructor(input: ZeroShotAgentInput) {\n    const outputParser =\n      input?.outputParser ?? ZeroShotAgent.getDefaultOutputParser();\n    super({ ...input, outputParser });\n  }\n\n  _agentType() {\n    return \"zero-shot-react-description\" as const;\n  }\n\n  observationPrefix() {\n    return \"Observation: \";\n  }\n\n  llmPrefix() {\n    return \"Thought:\";\n  }\n\n  /**\n   * Returns the default output parser for the ZeroShotAgent.\n   * @param fields Optional arguments for the output parser.\n   * @returns An instance of ZeroShotAgentOutputParser.\n   */\n  static getDefaultOutputParser(fields?: OutputParserArgs) {\n    return new ZeroShotAgentOutputParser(fields);\n  }\n\n  /**\n   * Validates the tools for the ZeroShotAgent. Throws an error if any tool\n   * does not have a description.\n   * @param tools List of tools to validate.\n   */\n  static validateTools(tools: ToolInterface[]) {\n    const descriptionlessTool = tools.find((tool) => !tool.description);\n    if (descriptionlessTool) {\n      const msg =\n        `Got a tool ${descriptionlessTool.name} without a description.` +\n        ` This agent requires descriptions for all tools.`;\n      throw new Error(msg);\n    }\n  }\n\n  /**\n   * Create prompt in the style of the zero shot agent.\n   *\n   * @param tools - List of tools the agent will have access to, used to format the prompt.\n   * @param args - Arguments to create the prompt with.\n   * @param args.suffix - String to put after the list of tools.\n   * @param args.prefix - String to put before the list of tools.\n   * @param args.inputVariables - List of input variables the final prompt will expect.\n   */\n  static createPrompt(tools: ToolInterface[], args?: ZeroShotCreatePromptArgs) {\n    const {\n      prefix = PREFIX,\n      suffix = SUFFIX,\n      inputVariables = [\"input\", \"agent_scratchpad\"],\n    } = args ?? {};\n    const toolStrings = tools\n      .map((tool) => `${tool.name}: ${tool.description}`)\n      .join(\"\\n\");\n\n    const toolNames = tools.map((tool) => `\"${tool.name}\"`).join(\", \");\n\n    const formatInstructions = renderTemplate(FORMAT_INSTRUCTIONS, \"f-string\", {\n      tool_names: toolNames,\n    });\n\n    const template = [prefix, toolStrings, formatInstructions, suffix].join(\n      \"\\n\\n\"\n    );\n\n    return new PromptTemplate({\n      template,\n      inputVariables,\n    });\n  }\n\n  /**\n   * Creates a ZeroShotAgent from a Large Language Model and a set of tools.\n   * @param llm The Large Language Model to use.\n   * @param tools The tools for the agent to use.\n   * @param args Optional arguments for creating the agent.\n   * @returns A new instance of ZeroShotAgent.\n   */\n  static fromLLMAndTools(\n    llm: BaseLanguageModelInterface,\n    tools: ToolInterface[],\n    args?: ZeroShotCreatePromptArgs & AgentArgs\n  ) {\n    ZeroShotAgent.validateTools(tools);\n    const prompt = ZeroShotAgent.createPrompt(tools, args);\n    const outputParser =\n      args?.outputParser ?? ZeroShotAgent.getDefaultOutputParser();\n    const chain = new LLMChain({\n      prompt,\n      llm,\n      callbacks: args?.callbacks ?? args?.callbackManager,\n    });\n\n    return new ZeroShotAgent({\n      llmChain: chain,\n      allowedTools: tools.map((t) => t.name),\n      outputParser,\n    });\n  }\n\n  static async deserialize(\n    data: SerializedZeroShotAgent & {\n      llm?: BaseLanguageModelInterface;\n      tools?: ToolInterface[];\n    }\n  ): Promise<ZeroShotAgent> {\n    const { llm, tools, ...rest } = data;\n    return deserializeHelper(\n      llm,\n      tools,\n      rest,\n      (\n        llm: BaseLanguageModelInterface,\n        tools: ToolInterface[],\n        args: SerializedFromLLMAndTools\n      ) =>\n        ZeroShotAgent.fromLLMAndTools(llm, tools, {\n          prefix: args.prefix,\n          suffix: args.suffix,\n          inputVariables: args.input_variables,\n        }),\n      (args) => new ZeroShotAgent(args)\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0DA,IAAa,gBAAb,MAAa,sBAAsBA,oBAAM;CACvC,OAAO,UAAU;AACf,SAAO;CACR;CAED,eAAe;EAAC;EAAa;EAAU;CAAO;CAI9C,YAAYC,OAA2B;EACrC,MAAM,eACJ,OAAO,gBAAgB,cAAc,wBAAwB;EAC/D,MAAM;GAAE,GAAG;GAAO;EAAc,EAAC;CAClC;CAED,aAAa;AACX,SAAO;CACR;CAED,oBAAoB;AAClB,SAAO;CACR;CAED,YAAY;AACV,SAAO;CACR;;;;;;CAOD,OAAO,uBAAuBC,QAA2B;AACvD,SAAO,IAAIC,+CAA0B;CACtC;;;;;;CAOD,OAAO,cAAcC,OAAwB;EAC3C,MAAM,sBAAsB,MAAM,KAAK,CAAC,SAAS,CAAC,KAAK,YAAY;AACnE,MAAI,qBAAqB;GACvB,MAAM,MACJ,CAAC,WAAW,EAAE,oBAAoB,KAAK,uEAAuB,CACZ;AACpD,SAAM,IAAI,MAAM;EACjB;CACF;;;;;;;;;;CAWD,OAAO,aAAaA,OAAwBC,MAAiC;EAC3E,MAAM,EACJ,SAASC,uBACT,SAASC,uBACT,iBAAiB,CAAC,SAAS,kBAAmB,GAC/C,GAAG,QAAQ,CAAE;EACd,MAAM,cAAc,MACjB,IAAI,CAAC,SAAS,GAAG,KAAK,KAAK,EAAE,EAAE,KAAK,aAAa,CAAC,CAClD,KAAK,KAAK;EAEb,MAAM,YAAY,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK;EAElE,MAAM,kEAAoCC,oCAAqB,YAAY,EACzE,YAAY,UACb,EAAC;EAEF,MAAM,WAAW;GAAC;GAAQ;GAAa;GAAoB;EAAO,EAAC,KACjE,OACD;AAED,SAAO,IAAIC,wCAAe;GACxB;GACA;EACD;CACF;;;;;;;;CASD,OAAO,gBACLC,KACAN,OACAO,MACA;EACA,cAAc,cAAc,MAAM;EAClC,MAAM,SAAS,cAAc,aAAa,OAAO,KAAK;EACtD,MAAM,eACJ,MAAM,gBAAgB,cAAc,wBAAwB;EAC9D,MAAM,QAAQ,IAAIC,2BAAS;GACzB;GACA;GACA,WAAW,MAAM,aAAa,MAAM;EACrC;AAED,SAAO,IAAI,cAAc;GACvB,UAAU;GACV,cAAc,MAAM,IAAI,CAAC,MAAM,EAAE,KAAK;GACtC;EACD;CACF;CAED,aAAa,YACXC,MAIwB;EACxB,MAAM,EAAE,KAAK,MAAO,GAAG,MAAM,GAAG;AAChC,SAAOC,kCACL,KACA,OACA,MACA,CACEJ,OACAN,SACAW,SAEA,cAAc,gBAAgBC,OAAKC,SAAO;GACxC,QAAQ,KAAK;GACb,QAAQ,KAAK;GACb,gBAAgB,KAAK;EACtB,EAAC,EACJ,CAAC,SAAS,IAAI,cAAc,MAC7B;CACF;AACF"}

package/dist/agents/mrkl/index.d.cts

@@ -0,0 +1,97 @@
+import { AgentInput, SerializedZeroShotAgent } from "../types.cjs";
+import { Agent, AgentArgs, OutputParserArgs } from "../agent.cjs";
+import { Optional } from "../../types/type-utils.cjs";
+import { ZeroShotAgentOutputParser } from "./outputParser.cjs";
+import { PromptTemplate } from "@langchain/core/prompts";
+import { BaseLanguageModelInterface } from "@langchain/core/language_models/base";
+import { ToolInterface } from "@langchain/core/tools";
+
+//#region src/agents/mrkl/index.d.ts
+
+/**
+ * Interface for creating a prompt for the ZeroShotAgent.
+ */
+interface ZeroShotCreatePromptArgs {
+  /** String to put after the list of tools. */
+  suffix?: string;
+  /** String to put before the list of tools. */
+  prefix?: string;
+  /** List of input variables the final prompt will expect. */
+  inputVariables?: string[];
+}
+/**
+ * Type for the input to the ZeroShotAgent, with the 'outputParser'
+ * property made optional.
+ */
+type ZeroShotAgentInput = Optional<AgentInput, "outputParser">;
+/**
+ * Agent for the MRKL chain.
+ * @augments Agent
+ * @example
+ * ```typescript
+ *
+ * const agent = new ZeroShotAgent({
+ *   llmChain: new LLMChain({
+ *     llm: new ChatOpenAI({ model: "gpt-4o-mini", temperature: 0 }),
+ *     prompt: ZeroShotAgent.createPrompt([new SerpAPI(), new Calculator()], {
+ *       prefix: `Answer the following questions as best you can, but speaking as a pirate might speak. You have access to the following tools:`,
+ *       suffix: `Begin! Remember to speak as a pirate when giving your final answer. Use lots of "Args"
+ * Question: {input}
+ * {agent_scratchpad}`,
+ *       inputVariables: ["input", "agent_scratchpad"],
+ *     }),
+ *   }),
+ *   allowedTools: ["search", "calculator"],
+ * });
+ *
+ * const result = await agent.invoke({
+ *   input: `Who is Olivia Wilde's boyfriend? What is his current age raised to the 0.23 power?`,
+ * });
+ * ```
+ */
+declare class ZeroShotAgent extends Agent {
+  static lc_name(): string;
+  lc_namespace: string[];
+  ToolType: ToolInterface;
+  constructor(input: ZeroShotAgentInput);
+  _agentType(): "zero-shot-react-description";
+  observationPrefix(): string;
+  llmPrefix(): string;
+  /**
+   * Returns the default output parser for the ZeroShotAgent.
+   * @param fields Optional arguments for the output parser.
+   * @returns An instance of ZeroShotAgentOutputParser.
+   */
+  static getDefaultOutputParser(fields?: OutputParserArgs): ZeroShotAgentOutputParser;
+  /**
+   * Validates the tools for the ZeroShotAgent. Throws an error if any tool
+   * does not have a description.
+   * @param tools List of tools to validate.
+   */
+  static validateTools(tools: ToolInterface[]): void;
+  /**
+   * Create prompt in the style of the zero shot agent.
+   *
+   * @param tools - List of tools the agent will have access to, used to format the prompt.
+   * @param args - Arguments to create the prompt with.
+   * @param args.suffix - String to put after the list of tools.
+   * @param args.prefix - String to put before the list of tools.
+   * @param args.inputVariables - List of input variables the final prompt will expect.
+   */
+  static createPrompt(tools: ToolInterface[], args?: ZeroShotCreatePromptArgs): PromptTemplate<any, any>;
+  /**
+   * Creates a ZeroShotAgent from a Large Language Model and a set of tools.
+   * @param llm The Large Language Model to use.
+   * @param tools The tools for the agent to use.
+   * @param args Optional arguments for creating the agent.
+   * @returns A new instance of ZeroShotAgent.
+   */
+  static fromLLMAndTools(llm: BaseLanguageModelInterface, tools: ToolInterface[], args?: ZeroShotCreatePromptArgs & AgentArgs): ZeroShotAgent;
+  static deserialize(data: SerializedZeroShotAgent & {
+    llm?: BaseLanguageModelInterface;
+    tools?: ToolInterface[];
+  }): Promise<ZeroShotAgent>;
+}
+//#endregion
+export { ZeroShotAgent, ZeroShotAgentInput, ZeroShotCreatePromptArgs };
+//# sourceMappingURL=index.d.cts.map

package/dist/agents/mrkl/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":["BaseLanguageModelInterface","ToolInterface","PromptTemplate","Optional","Agent","AgentArgs","OutputParserArgs","AgentInput","SerializedZeroShotAgent","ZeroShotAgentOutputParser","ZeroShotCreatePromptArgs","ZeroShotAgentInput","ZeroShotAgent","Promise"],"sources":["../../../src/agents/mrkl/index.d.ts"],"sourcesContent":["import type { BaseLanguageModelInterface } from \"@langchain/core/language_models/base\";\nimport { ToolInterface } from \"@langchain/core/tools\";\nimport { PromptTemplate } from \"@langchain/core/prompts\";\nimport { Optional } from \"../../types/type-utils.js\";\nimport { Agent, AgentArgs, OutputParserArgs } from \"../agent.js\";\nimport { AgentInput, SerializedZeroShotAgent } from \"../types.js\";\nimport { ZeroShotAgentOutputParser } from \"./outputParser.js\";\n/**\n * Interface for creating a prompt for the ZeroShotAgent.\n */\nexport interface ZeroShotCreatePromptArgs {\n    /** String to put after the list of tools. */\n    suffix?: string;\n    /** String to put before the list of tools. */\n    prefix?: string;\n    /** List of input variables the final prompt will expect. */\n    inputVariables?: string[];\n}\n/**\n * Type for the input to the ZeroShotAgent, with the 'outputParser'\n * property made optional.\n */\nexport type ZeroShotAgentInput = Optional<AgentInput, \"outputParser\">;\n/**\n * Agent for the MRKL chain.\n * @augments Agent\n * @example\n * ```typescript\n *\n * const agent = new ZeroShotAgent({\n *   llmChain: new LLMChain({\n *     llm: new ChatOpenAI({ model: \"gpt-4o-mini\", temperature: 0 }),\n *     prompt: ZeroShotAgent.createPrompt([new SerpAPI(), new Calculator()], {\n *       prefix: `Answer the following questions as best you can, but speaking as a pirate might speak. You have access to the following tools:`,\n *       suffix: `Begin! Remember to speak as a pirate when giving your final answer. Use lots of \"Args\"\n * Question: {input}\n * {agent_scratchpad}`,\n *       inputVariables: [\"input\", \"agent_scratchpad\"],\n *     }),\n *   }),\n *   allowedTools: [\"search\", \"calculator\"],\n * });\n *\n * const result = await agent.invoke({\n *   input: `Who is Olivia Wilde's boyfriend? What is his current age raised to the 0.23 power?`,\n * });\n * ```\n */\nexport declare class ZeroShotAgent extends Agent {\n    static lc_name(): string;\n    lc_namespace: string[];\n    ToolType: ToolInterface;\n    constructor(input: ZeroShotAgentInput);\n    _agentType(): \"zero-shot-react-description\";\n    observationPrefix(): string;\n    llmPrefix(): string;\n    /**\n     * Returns the default output parser for the ZeroShotAgent.\n     * @param fields Optional arguments for the output parser.\n     * @returns An instance of ZeroShotAgentOutputParser.\n     */\n    static getDefaultOutputParser(fields?: OutputParserArgs): ZeroShotAgentOutputParser;\n    /**\n     * Validates the tools for the ZeroShotAgent. Throws an error if any tool\n     * does not have a description.\n     * @param tools List of tools to validate.\n     */\n    static validateTools(tools: ToolInterface[]): void;\n    /**\n     * Create prompt in the style of the zero shot agent.\n     *\n     * @param tools - List of tools the agent will have access to, used to format the prompt.\n     * @param args - Arguments to create the prompt with.\n     * @param args.suffix - String to put after the list of tools.\n     * @param args.prefix - String to put before the list of tools.\n     * @param args.inputVariables - List of input variables the final prompt will expect.\n     */\n    static createPrompt(tools: ToolInterface[], args?: ZeroShotCreatePromptArgs): PromptTemplate<any, any>;\n    /**\n     * Creates a ZeroShotAgent from a Large Language Model and a set of tools.\n     * @param llm The Large Language Model to use.\n     * @param tools The tools for the agent to use.\n     * @param args Optional arguments for creating the agent.\n     * @returns A new instance of ZeroShotAgent.\n     */\n    static fromLLMAndTools(llm: BaseLanguageModelInterface, tools: ToolInterface[], args?: ZeroShotCreatePromptArgs & AgentArgs): ZeroShotAgent;\n    static deserialize(data: SerializedZeroShotAgent & {\n        llm?: BaseLanguageModelInterface;\n        tools?: ToolInterface[];\n    }): Promise<ZeroShotAgent>;\n}\n"],"mappings":";;;;;;;;;;;;AAUA;AAYYW,UAZKD,wBAAAA,CAYa;EAAA;EAAA,MAAYH,CAAAA,EAAAA,MAAAA;EAAU;EAAX,MAAA,CAAA,EAAA,MAAA;EA0BpBK;EAAa,cAAA,CAAA,EAAA,MAAA,EAAA;;;;;;AA6BHX,KAvDnBU,kBAAAA,GAAqBR,QAuDFF,CAvDWM,UAuDXN,EAAAA,cAAAA,CAAAA;;;;;;;;;;;;;;AA7BiB;;;;;;;;;;;;cAA3BW,aAAAA,SAAsBR,KAAAA;;;YAG7BH;qBACSU;;;;;;;;;yCASoBL,mBAAmBG;;;;;;8BAM9BR;;;;;;;;;;6BAUDA,wBAAwBS,2BAA2BR;;;;;;;;8BAQlDF,mCAAmCC,wBAAwBS,2BAA2BL,YAAYO;2BACrGJ;UACfR;YACEC;MACRY,QAAQD"}

package/dist/agents/mrkl/index.d.ts

@@ -0,0 +1,97 @@
+import { AgentInput, SerializedZeroShotAgent } from "../types.js";
+import { Agent, AgentArgs, OutputParserArgs } from "../agent.js";
+import { Optional } from "../../types/type-utils.js";
+import { ZeroShotAgentOutputParser } from "./outputParser.js";
+import { PromptTemplate } from "@langchain/core/prompts";
+import { ToolInterface } from "@langchain/core/tools";
+import { BaseLanguageModelInterface } from "@langchain/core/language_models/base";
+
+//#region src/agents/mrkl/index.d.ts
+
+/**
+ * Interface for creating a prompt for the ZeroShotAgent.
+ */
+interface ZeroShotCreatePromptArgs {
+  /** String to put after the list of tools. */
+  suffix?: string;
+  /** String to put before the list of tools. */
+  prefix?: string;
+  /** List of input variables the final prompt will expect. */
+  inputVariables?: string[];
+}
+/**
+ * Type for the input to the ZeroShotAgent, with the 'outputParser'
+ * property made optional.
+ */
+type ZeroShotAgentInput = Optional<AgentInput, "outputParser">;
+/**
+ * Agent for the MRKL chain.
+ * @augments Agent
+ * @example
+ * ```typescript
+ *
+ * const agent = new ZeroShotAgent({
+ *   llmChain: new LLMChain({
+ *     llm: new ChatOpenAI({ model: "gpt-4o-mini", temperature: 0 }),
+ *     prompt: ZeroShotAgent.createPrompt([new SerpAPI(), new Calculator()], {
+ *       prefix: `Answer the following questions as best you can, but speaking as a pirate might speak. You have access to the following tools:`,
+ *       suffix: `Begin! Remember to speak as a pirate when giving your final answer. Use lots of "Args"
+ * Question: {input}
+ * {agent_scratchpad}`,
+ *       inputVariables: ["input", "agent_scratchpad"],
+ *     }),
+ *   }),
+ *   allowedTools: ["search", "calculator"],
+ * });
+ *
+ * const result = await agent.invoke({
+ *   input: `Who is Olivia Wilde's boyfriend? What is his current age raised to the 0.23 power?`,
+ * });
+ * ```
+ */
+declare class ZeroShotAgent extends Agent {
+  static lc_name(): string;
+  lc_namespace: string[];
+  ToolType: ToolInterface;
+  constructor(input: ZeroShotAgentInput);
+  _agentType(): "zero-shot-react-description";
+  observationPrefix(): string;
+  llmPrefix(): string;
+  /**
+   * Returns the default output parser for the ZeroShotAgent.
+   * @param fields Optional arguments for the output parser.
+   * @returns An instance of ZeroShotAgentOutputParser.
+   */
+  static getDefaultOutputParser(fields?: OutputParserArgs): ZeroShotAgentOutputParser;
+  /**
+   * Validates the tools for the ZeroShotAgent. Throws an error if any tool
+   * does not have a description.
+   * @param tools List of tools to validate.
+   */
+  static validateTools(tools: ToolInterface[]): void;
+  /**
+   * Create prompt in the style of the zero shot agent.
+   *
+   * @param tools - List of tools the agent will have access to, used to format the prompt.
+   * @param args - Arguments to create the prompt with.
+   * @param args.suffix - String to put after the list of tools.
+   * @param args.prefix - String to put before the list of tools.
+   * @param args.inputVariables - List of input variables the final prompt will expect.
+   */
+  static createPrompt(tools: ToolInterface[], args?: ZeroShotCreatePromptArgs): PromptTemplate<any, any>;
+  /**
+   * Creates a ZeroShotAgent from a Large Language Model and a set of tools.
+   * @param llm The Large Language Model to use.
+   * @param tools The tools for the agent to use.
+   * @param args Optional arguments for creating the agent.
+   * @returns A new instance of ZeroShotAgent.
+   */
+  static fromLLMAndTools(llm: BaseLanguageModelInterface, tools: ToolInterface[], args?: ZeroShotCreatePromptArgs & AgentArgs): ZeroShotAgent;
+  static deserialize(data: SerializedZeroShotAgent & {
+    llm?: BaseLanguageModelInterface;
+    tools?: ToolInterface[];
+  }): Promise<ZeroShotAgent>;
+}
+//#endregion
+export { ZeroShotAgent, ZeroShotAgentInput, ZeroShotCreatePromptArgs };
+//# sourceMappingURL=index.d.ts.map