langchain 0.0.76 → 0.0.78

package/dist/agents/chat_convo/prompt.d.ts

@@ -1,5 +1,5 @@
 export declare const DEFAULT_PREFIX = "Assistant is a large language model trained by OpenAI.\n\nAssistant is designed to be able to assist with a wide range of tasks, from answering simple questions to providing in-depth explanations and discussions on a wide range of topics. As a language model, Assistant is able to generate human-like text based on the input it receives, allowing it to engage in natural-sounding conversations and provide responses that are coherent and relevant to the topic at hand.\n\nAssistant is constantly learning and improving, and its capabilities are constantly evolving. It is able to process and understand large amounts of text, and can use this knowledge to provide accurate and informative responses to a wide range of questions. Additionally, Assistant is able to generate its own text based on the input it receives, allowing it to engage in discussions and provide explanations and descriptions on a wide range of topics.\n\nOverall, Assistant is a powerful system that can help with a wide range of tasks and provide valuable insights and information on a wide range of topics. Whether you need help with a specific question or just want to have a conversation about a particular topic, Assistant is here to assist.";
 export declare const PREFIX_END = " However, above all else, all responses must adhere to the format of RESPONSE FORMAT INSTRUCTIONS.";
-export declare const FORMAT_INSTRUCTIONS = "RESPONSE FORMAT INSTRUCTIONS\n----------------------------\n\nWhen responding to me please, please output a response in one of two formats:\n\n**Option 1:**\nUse this if you want the human to use a tool.\nMarkdown code snippet formatted in the following schema:\n\n```json\n{{{{\n    \"action\": string \\ The action to take. Must be one of {tool_names}\n    \"action_input\": string \\ The input to the action\n}}}}\n```\n\n**Option #2:**\nUse this if you want to respond directly to the human. Markdown code snippet formatted in the following schema:\n\n```json\n{{{{\n    \"action\": \"Final Answer\",\n    \"action_input\": string \\ You should put what you want to return to use here and make sure to use valid json newline characters.\n}}}}\n```";
-export declare const DEFAULT_SUFFIX = "TOOLS\n------\nAssistant can ask the user to use tools to look up information that may be helpful in answering the users original question. The tools the human can use are:\n\n{{tools}}\n\n{format_instructions}\n\nUSER'S INPUT\n--------------------\nHere is the user's input (remember to respond with a markdown code snippet of a json blob with a single action, and NOTHING else):\n\n{{{{input}}}}";
+export declare const FORMAT_INSTRUCTIONS = "RESPONSE FORMAT INSTRUCTIONS\n----------------------------\n\nOutput a JSON markdown code snippet containing a valid JSON object in one of two formats:\n\n**Option 1:**\nUse this if you want the human to use a tool.\nMarkdown code snippet formatted in the following schema:\n\n```json\n{{{{\n    \"action\": string // The action to take. Must be one of [{tool_names}]\n    \"action_input\": string // The input to the action. May be a stringified object.\n}}}}\n```\n\n**Option #2:**\nUse this if you want to respond directly and conversationally to the human. Markdown code snippet formatted in the following schema:\n\n```json\n{{{{\n    \"action\": \"Final Answer\",\n    \"action_input\": string // You should put what you want to return to use here and make sure to use valid json newline characters.\n}}}}\n```\n\nFor both options, remember to always include the surrounding markdown code snippet delimiters (begin with \"```json\" and end with \"```\")!\n";
+export declare const DEFAULT_SUFFIX = "TOOLS\n------\nAssistant can ask the user to use tools to look up information that may be helpful in answering the users original question. The tools the human can use are:\n\n{tools}\n\n{format_instructions}\n\nUSER'S INPUT\n--------------------\nHere is the user's input (remember to respond with a markdown code snippet of a json blob with a single action, and NOTHING else):\n\n{{input}}";
 export declare const TEMPLATE_TOOL_RESPONSE = "TOOL RESPONSE:\n---------------------\n{observation}\n\nUSER'S INPUT\n--------------------\n\nOkay, so what is the response to my original question? If using information from tools, you must say it explicitly - I have forgotten all TOOL RESPONSES! Remember to respond with a markdown code snippet of a json blob with a single action, and NOTHING else.";

package/dist/agents/chat_convo/prompt.js

@@ -9,7 +9,7 @@ export const PREFIX_END = ` However, above all else, all responses must adhere t
 export const FORMAT_INSTRUCTIONS = `RESPONSE FORMAT INSTRUCTIONS
 ----------------------------
 
-When responding to me please, please output a response in one of two formats:
+Output a JSON markdown code snippet containing a valid JSON object in one of two formats:
 
 **Option 1:**
 Use this if you want the human to use a tool.
@@ -17,25 +17,28 @@ Markdown code snippet formatted in the following schema:
 
 \`\`\`json
 {{{{
-    "action": string \\ The action to take. Must be one of {tool_names}
-    "action_input": string \\ The input to the action
+    "action": string // The action to take. Must be one of [{tool_names}]
+    "action_input": string // The input to the action. May be a stringified object.
 }}}}
 \`\`\`
 
 **Option #2:**
-Use this if you want to respond directly to the human. Markdown code snippet formatted in the following schema:
+Use this if you want to respond directly and conversationally to the human. Markdown code snippet formatted in the following schema:
 
 \`\`\`json
 {{{{
     "action": "Final Answer",
-    "action_input": string \\ You should put what you want to return to use here and make sure to use valid json newline characters.
+    "action_input": string // You should put what you want to return to use here and make sure to use valid json newline characters.
 }}}}
-\`\`\``;
+\`\`\`
+
+For both options, remember to always include the surrounding markdown code snippet delimiters (begin with "\`\`\`json" and end with "\`\`\`")!
+`;
 export const DEFAULT_SUFFIX = `TOOLS
 ------
 Assistant can ask the user to use tools to look up information that may be helpful in answering the users original question. The tools the human can use are:
 
-{{tools}}
+{tools}
 
 {format_instructions}
 
@@ -43,7 +46,7 @@ USER'S INPUT
 --------------------
 Here is the user's input (remember to respond with a markdown code snippet of a json blob with a single action, and NOTHING else):
 
-{{{{input}}}}`;
+{{input}}`;
 export const TEMPLATE_TOOL_RESPONSE = `TOOL RESPONSE:
 ---------------------
 {observation}

package/dist/agents/executor.d.ts

@@ -1,13 +1,12 @@
 import { BaseChain, ChainInputs } from "../chains/base.js";
 import { BaseMultiActionAgent, BaseSingleActionAgent } from "./agent.js";
-import { Tool } from "../tools/base.js";
 import { StoppingMethod } from "./types.js";
 import { SerializedLLMChain } from "../chains/serde.js";
 import { ChainValues } from "../schema/index.js";
 import { CallbackManagerForChainRun } from "../callbacks/manager.js";
 export interface AgentExecutorInput extends ChainInputs {
     agent: BaseSingleActionAgent | BaseMultiActionAgent;
-    tools: Tool[];
+    tools: this["agent"]["ToolType"][];
     returnIntermediateSteps?: boolean;
     maxIterations?: number;
     earlyStoppingMethod?: StoppingMethod;
@@ -18,7 +17,7 @@ export interface AgentExecutorInput extends ChainInputs {
  */
 export declare class AgentExecutor extends BaseChain {
     agent: BaseSingleActionAgent | BaseMultiActionAgent;
-    tools: Tool[];
+    tools: this["agent"]["ToolType"][];
     returnIntermediateSteps: boolean;
     maxIterations?: number;
     earlyStoppingMethod: StoppingMethod;

package/dist/agents/index.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgentActionOutputParser = exports.ZeroShotAgentOutputParser = exports.ZeroShotAgent = exports.initializeAgentExecutorWithOptions = exports.initializeAgentExecutor = exports.AgentExecutor = exports.ChatConversationalAgentOutputParser = exports.ChatConversationalAgent = exports.ChatAgentOutputParser = exports.ChatAgent = exports.Toolkit = exports.createVectorStoreRouterAgent = exports.createVectorStoreAgent = exports.createSqlAgent = exports.createOpenApiAgent = exports.createJsonAgent = exports.ZapierToolKit = exports.VectorStoreToolkit = exports.VectorStoreRouterToolkit = exports.SqlToolkit = exports.RequestsToolkit = exports.OpenApiToolkit = exports.JsonToolkit = exports.LLMSingleActionAgent = exports.BaseSingleActionAgent = exports.Agent = void 0;
+exports.StructuredChatOutputParserWithRetries = exports.StructuredChatOutputParser = exports.StructuredChatAgent = exports.AgentActionOutputParser = exports.ZeroShotAgentOutputParser = exports.ZeroShotAgent = exports.initializeAgentExecutorWithOptions = exports.initializeAgentExecutor = exports.AgentExecutor = exports.ChatConversationalAgentOutputParser = exports.ChatConversationalAgent = exports.ChatAgentOutputParser = exports.ChatAgent = exports.Toolkit = exports.createVectorStoreRouterAgent = exports.createVectorStoreAgent = exports.createSqlAgent = exports.createOpenApiAgent = exports.createJsonAgent = exports.ZapierToolKit = exports.VectorStoreToolkit = exports.VectorStoreRouterToolkit = exports.SqlToolkit = exports.RequestsToolkit = exports.OpenApiToolkit = exports.JsonToolkit = exports.LLMSingleActionAgent = exports.BaseSingleActionAgent = exports.Agent = void 0;
 var agent_js_1 = require("./agent.cjs");
 Object.defineProperty(exports, "Agent", { enumerable: true, get: function () { return agent_js_1.Agent; } });
 Object.defineProperty(exports, "BaseSingleActionAgent", { enumerable: true, get: function () { return agent_js_1.BaseSingleActionAgent; } });
@@ -39,3 +39,8 @@ var outputParser_js_3 = require("./mrkl/outputParser.cjs");
 Object.defineProperty(exports, "ZeroShotAgentOutputParser", { enumerable: true, get: function () { return outputParser_js_3.ZeroShotAgentOutputParser; } });
 var types_js_1 = require("./types.cjs");
 Object.defineProperty(exports, "AgentActionOutputParser", { enumerable: true, get: function () { return types_js_1.AgentActionOutputParser; } });
+var index_js_5 = require("./structured_chat/index.cjs");
+Object.defineProperty(exports, "StructuredChatAgent", { enumerable: true, get: function () { return index_js_5.StructuredChatAgent; } });
+var outputParser_js_4 = require("./structured_chat/outputParser.cjs");
+Object.defineProperty(exports, "StructuredChatOutputParser", { enumerable: true, get: function () { return outputParser_js_4.StructuredChatOutputParser; } });
+Object.defineProperty(exports, "StructuredChatOutputParserWithRetries", { enumerable: true, get: function () { return outputParser_js_4.StructuredChatOutputParserWithRetries; } });

package/dist/agents/index.d.ts

@@ -10,3 +10,5 @@ export { initializeAgentExecutor, initializeAgentExecutorWithOptions, Initialize
 export { ZeroShotAgent, ZeroShotAgentInput, ZeroShotCreatePromptArgs, } from "./mrkl/index.js";
 export { ZeroShotAgentOutputParser } from "./mrkl/outputParser.js";
 export { AgentActionOutputParser, AgentInput, SerializedAgent, SerializedAgentT, SerializedZeroShotAgent, StoppingMethod, } from "./types.js";
+export { StructuredChatAgent, StructuredChatAgentInput, StructuredChatCreatePromptArgs, } from "./structured_chat/index.js";
+export { StructuredChatOutputParser, StructuredChatOutputParserWithRetries, } from "./structured_chat/outputParser.js";

package/dist/agents/index.js

@@ -10,3 +10,5 @@ export { initializeAgentExecutor, initializeAgentExecutorWithOptions, } from "./
 export { ZeroShotAgent, } from "./mrkl/index.js";
 export { ZeroShotAgentOutputParser } from "./mrkl/outputParser.js";
 export { AgentActionOutputParser, } from "./types.js";
+export { StructuredChatAgent, } from "./structured_chat/index.js";
+export { StructuredChatOutputParser, StructuredChatOutputParserWithRetries, } from "./structured_chat/outputParser.js";

package/dist/agents/initialize.cjs

@@ -4,8 +4,9 @@ exports.initializeAgentExecutorWithOptions = exports.initializeAgentExecutor = v
 const buffer_memory_js_1 = require("../memory/buffer_memory.cjs");
 const index_js_1 = require("./chat/index.cjs");
 const index_js_2 = require("./chat_convo/index.cjs");
+const index_js_3 = require("./structured_chat/index.cjs");
 const executor_js_1 = require("./executor.cjs");
-const index_js_3 = require("./mrkl/index.cjs");
+const index_js_4 = require("./mrkl/index.cjs");
 /**
  * @deprecated use initializeAgentExecutorWithOptions instead
  */
@@ -16,7 +17,7 @@ const initializeAgentExecutor = async (tools, llm, _agentType, _verbose, _callba
     switch (agentType) {
         case "zero-shot-react-description":
             return executor_js_1.AgentExecutor.fromAgentAndTools({
-                agent: index_js_3.ZeroShotAgent.fromLLMAndTools(llm, tools),
+                agent: index_js_4.ZeroShotAgent.fromLLMAndTools(llm, tools),
                 tools,
                 returnIntermediateSteps: true,
                 verbose,
@@ -42,23 +43,19 @@ const initializeAgentExecutor = async (tools, llm, _agentType, _verbose, _callba
     }
 };
 exports.initializeAgentExecutor = initializeAgentExecutor;
-/**
- * Initialize an agent executor with options
- * @param tools Array of tools to use in the agent
- * @param llm LLM or ChatModel to use in the agent
- * @param options Options for the agent, including agentType, agentArgs, and other options for AgentExecutor.fromAgentAndTools
- * @returns AgentExecutor
- */
-const initializeAgentExecutorWithOptions = async (tools, llm, options = {
+async function initializeAgentExecutorWithOptions(tools, llm, options = {
     agentType: llm._modelType() === "base_chat_model"
         ? "chat-zero-shot-react-description"
         : "zero-shot-react-description",
-}) => {
+}) {
+    // Note this tools cast is safe as the overload signatures prevent
+    // the function from being called with a StructuredTool[] when
+    // the agentType is not in InitializeAgentExecutorOptionsStructured
     switch (options.agentType) {
         case "zero-shot-react-description": {
             const { agentArgs, ...rest } = options;
             return executor_js_1.AgentExecutor.fromAgentAndTools({
-                agent: index_js_3.ZeroShotAgent.fromLLMAndTools(llm, tools, agentArgs),
+                agent: index_js_4.ZeroShotAgent.fromLLMAndTools(llm, tools, agentArgs),
                 tools,
                 ...rest,
             });
@@ -86,9 +83,18 @@ const initializeAgentExecutorWithOptions = async (tools, llm, options = {
             });
             return executor;
         }
+        case "structured-chat-zero-shot-react-description": {
+            const { agentArgs, ...rest } = options;
+            const executor = executor_js_1.AgentExecutor.fromAgentAndTools({
+                agent: index_js_3.StructuredChatAgent.fromLLMAndTools(llm, tools, agentArgs),
+                tools,
+                ...rest,
+            });
+            return executor;
+        }
         default: {
             throw new Error("Unknown agent type");
         }
     }
-};
+}
 exports.initializeAgentExecutorWithOptions = initializeAgentExecutorWithOptions;

package/dist/agents/initialize.d.ts

@@ -1,8 +1,9 @@
 import { BaseLanguageModel } from "../base_language/index.js";
 import { CallbackManager } from "../callbacks/manager.js";
-import { Tool } from "../tools/base.js";
+import { StructuredTool, Tool } from "../tools/base.js";
 import { ChatAgent } from "./chat/index.js";
 import { ChatConversationalAgent } from "./chat_convo/index.js";
+import { StructuredChatAgent } from "./structured_chat/index.js";
 import { AgentExecutor, AgentExecutorInput } from "./executor.js";
 import { ZeroShotAgent } from "./mrkl/index.js";
 type AgentType = "zero-shot-react-description" | "chat-zero-shot-react-description" | "chat-conversational-react-description";
@@ -25,6 +26,14 @@ export type InitializeAgentExecutorOptions = ({
     agentType: "chat-conversational-react-description";
     agentArgs?: Parameters<typeof ChatConversationalAgent.fromLLMAndTools>[2];
 } & Omit<AgentExecutorInput, "agent" | "tools">);
+/**
+ * @interface
+ */
+export type InitializeAgentExecutorOptionsStructured = {
+    agentType: "structured-chat-zero-shot-react-description";
+    agentArgs?: Parameters<typeof StructuredChatAgent.fromLLMAndTools>[2];
+    memory?: never;
+} & Omit<AgentExecutorInput, "agent" | "tools">;
 /**
  * Initialize an agent executor with options
  * @param tools Array of tools to use in the agent
@@ -32,5 +41,6 @@ export type InitializeAgentExecutorOptions = ({
  * @param options Options for the agent, including agentType, agentArgs, and other options for AgentExecutor.fromAgentAndTools
  * @returns AgentExecutor
  */
-export declare const initializeAgentExecutorWithOptions: (tools: Tool[], llm: BaseLanguageModel, options?: InitializeAgentExecutorOptions) => Promise<AgentExecutor>;
+export declare function initializeAgentExecutorWithOptions(tools: StructuredTool[], llm: BaseLanguageModel, options: InitializeAgentExecutorOptionsStructured): Promise<AgentExecutor>;
+export declare function initializeAgentExecutorWithOptions(tools: Tool[], llm: BaseLanguageModel, options?: InitializeAgentExecutorOptions): Promise<AgentExecutor>;
 export {};

package/dist/agents/initialize.js

@@ -1,6 +1,7 @@
 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 { AgentExecutor } from "./executor.js";
 import { ZeroShotAgent } from "./mrkl/index.js";
 /**
@@ -38,18 +39,14 @@ export const initializeAgentExecutor = async (tools, llm, _agentType, _verbose,
             throw new Error("Unknown agent type");
     }
 };
-/**
- * Initialize an agent executor with options
- * @param tools Array of tools to use in the agent
- * @param llm LLM or ChatModel to use in the agent
- * @param options Options for the agent, including agentType, agentArgs, and other options for AgentExecutor.fromAgentAndTools
- * @returns AgentExecutor
- */
-export const initializeAgentExecutorWithOptions = async (tools, llm, options = {
+export async function initializeAgentExecutorWithOptions(tools, llm, options = {
     agentType: llm._modelType() === "base_chat_model"
         ? "chat-zero-shot-react-description"
         : "zero-shot-react-description",
-}) => {
+}) {
+    // Note this tools cast is safe as the overload signatures prevent
+    // the function from being called with a StructuredTool[] when
+    // the agentType is not in InitializeAgentExecutorOptionsStructured
     switch (options.agentType) {
         case "zero-shot-react-description": {
             const { agentArgs, ...rest } = options;
@@ -82,8 +79,17 @@ export const initializeAgentExecutorWithOptions = async (tools, llm, options = {
             });
             return executor;
         }
+        case "structured-chat-zero-shot-react-description": {
+            const { agentArgs, ...rest } = options;
+            const executor = AgentExecutor.fromAgentAndTools({
+                agent: StructuredChatAgent.fromLLMAndTools(llm, tools, agentArgs),
+                tools,
+                ...rest,
+            });
+            return executor;
+        }
         default: {
             throw new Error("Unknown agent type");
         }
     }
-};
+}

package/dist/agents/mrkl/index.cjs

@@ -30,9 +30,9 @@ class ZeroShotAgent extends agent_js_1.Agent {
         return new outputParser_js_1.ZeroShotAgentOutputParser(fields);
     }
     static validateTools(tools) {
-        const invalidTool = tools.find((tool) => !tool.description);
-        if (invalidTool) {
-            const msg = `Got a tool ${invalidTool.name} without a description.` +
+        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);
         }

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

@@ -19,6 +19,7 @@ export type ZeroShotAgentInput = Optional<AgentInput, "outputParser">;
  * @augments Agent
  */
 export declare class ZeroShotAgent extends Agent {
+    ToolType: Tool;
     constructor(input: ZeroShotAgentInput);
     _agentType(): "zero-shot-react-description";
     observationPrefix(): string;

package/dist/agents/mrkl/index.js

@@ -27,9 +27,9 @@ export class ZeroShotAgent extends Agent {
         return new ZeroShotAgentOutputParser(fields);
     }
     static validateTools(tools) {
-        const invalidTool = tools.find((tool) => !tool.description);
-        if (invalidTool) {
-            const msg = `Got a tool ${invalidTool.name} without a description.` +
+        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);
         }

package/dist/agents/mrkl/outputParser.cjs

@@ -24,13 +24,13 @@ class ZeroShotAgentOutputParser extends types_js_1.AgentActionOutputParser {
                 log: text,
             };
         }
-        const match = /Action: (.*)\nAction Input: (.*)/s.exec(text);
+        const match = /Action: ([\s\S]*?)(?:\nAction Input: ([\s\S]*?))?$/.exec(text);
         if (!match) {
             throw new Error(`Could not parse LLM output: ${text}`);
         }
         return {
             tool: match[1].trim(),
-            toolInput: match[2].trim().replace(/^"+|"+$/g, "") ?? "",
+            toolInput: match[2].trim().replace(/^("+)(.*?)(\1)$/, "$2") ?? "",
             log: text,
         };
     }

package/dist/agents/mrkl/outputParser.js

@@ -21,13 +21,13 @@ export class ZeroShotAgentOutputParser extends AgentActionOutputParser {
                 log: text,
             };
         }
-        const match = /Action: (.*)\nAction Input: (.*)/s.exec(text);
+        const match = /Action: ([\s\S]*?)(?:\nAction Input: ([\s\S]*?))?$/.exec(text);
         if (!match) {
             throw new Error(`Could not parse LLM output: ${text}`);
         }
         return {
             tool: match[1].trim(),
-            toolInput: match[2].trim().replace(/^"+|"+$/g, "") ?? "",
+            toolInput: match[2].trim().replace(/^("+)(.*?)(\1)$/, "$2") ?? "",
             log: text,
         };
     }

package/dist/agents/structured_chat/index.cjs

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StructuredChatAgent = void 0;
+const zod_to_json_schema_1 = require("zod-to-json-schema");
+const llm_chain_js_1 = require("../../chains/llm_chain.cjs");
+const prompt_js_1 = require("../../prompts/prompt.cjs");
+const chat_js_1 = require("../../prompts/chat.cjs");
+const agent_js_1 = require("../agent.cjs");
+const outputParser_js_1 = require("./outputParser.cjs");
+const prompt_js_2 = require("./prompt.cjs");
+/**
+ * Agent that interoperates with Structured Tools using React logic.
+ * @augments Agent
+ */
+class StructuredChatAgent extends agent_js_1.Agent {
+    constructor(input) {
+        const outputParser = input?.outputParser ?? StructuredChatAgent.getDefaultOutputParser();
+        super({ ...input, outputParser });
+    }
+    _agentType() {
+        return "structured-chat-zero-shot-react-description";
+    }
+    observationPrefix() {
+        return "Observation: ";
+    }
+    llmPrefix() {
+        return "Thought:";
+    }
+    _stop() {
+        return ["Observation:"];
+    }
+    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);
+        }
+    }
+    static getDefaultOutputParser(fields) {
+        if (fields?.llm) {
+            return outputParser_js_1.StructuredChatOutputParserWithRetries.fromLLM(fields.llm, {
+                toolNames: fields.toolNames,
+            });
+        }
+        return new outputParser_js_1.StructuredChatOutputParserWithRetries({
+            toolNames: fields?.toolNames,
+        });
+    }
+    async constructScratchPad(steps) {
+        const agentScratchpad = await super.constructScratchPad(steps);
+        if (agentScratchpad) {
+            return `This was your previous work (but I haven't seen any of it! I only see what you return as final answer):\n${agentScratchpad}`;
+        }
+        return agentScratchpad;
+    }
+    static createToolSchemasString(tools) {
+        return tools
+            .map((tool) => `${tool.name}: ${tool.description}, args: ${JSON.stringify((0, zod_to_json_schema_1.zodToJsonSchema)(tool.schema).properties)}`)
+            .join("\n");
+    }
+    /**
+     * Create prompt in the style of the 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.
+     */
+    static createPrompt(tools, args) {
+        const { prefix = prompt_js_2.PREFIX, suffix = prompt_js_2.SUFFIX } = args ?? {};
+        const template = [prefix, prompt_js_2.FORMAT_INSTRUCTIONS, suffix].join("\n\n");
+        const messages = [
+            new chat_js_1.SystemMessagePromptTemplate(new prompt_js_1.PromptTemplate({
+                template,
+                inputVariables: [],
+                partialVariables: {
+                    tool_schemas: StructuredChatAgent.createToolSchemasString(tools),
+                    tool_names: tools.map((tool) => tool.name).join(", "),
+                },
+            })),
+            chat_js_1.HumanMessagePromptTemplate.fromTemplate("{input}\n\n{agent_scratchpad}"),
+        ];
+        return chat_js_1.ChatPromptTemplate.fromPromptMessages(messages);
+    }
+    static fromLLMAndTools(llm, tools, args) {
+        StructuredChatAgent.validateTools(tools);
+        const prompt = StructuredChatAgent.createPrompt(tools, args);
+        const outputParser = args?.outputParser ??
+            StructuredChatAgent.getDefaultOutputParser({
+                llm,
+                toolNames: tools.map((tool) => tool.name),
+            });
+        const chain = new llm_chain_js_1.LLMChain({
+            prompt,
+            llm,
+            callbacks: args?.callbacks,
+        });
+        return new StructuredChatAgent({
+            llmChain: chain,
+            outputParser,
+            allowedTools: tools.map((t) => t.name),
+        });
+    }
+}
+exports.StructuredChatAgent = StructuredChatAgent;

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

@@ -0,0 +1,44 @@
+import { BaseLanguageModel } from "../../base_language/index.js";
+import { ChatPromptTemplate } from "../../prompts/chat.js";
+import { AgentStep } from "../../schema/index.js";
+import { StructuredTool } from "../../tools/base.js";
+import { Optional } from "../../types/type-utils.js";
+import { Agent, AgentArgs, OutputParserArgs } from "../agent.js";
+import { AgentInput } from "../types.js";
+import { StructuredChatOutputParserWithRetries } from "./outputParser.js";
+export interface StructuredChatCreatePromptArgs {
+    /** 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[];
+}
+export type StructuredChatAgentInput = Optional<AgentInput, "outputParser">;
+/**
+ * Agent that interoperates with Structured Tools using React logic.
+ * @augments Agent
+ */
+export declare class StructuredChatAgent extends Agent {
+    constructor(input: StructuredChatAgentInput);
+    _agentType(): "structured-chat-zero-shot-react-description";
+    observationPrefix(): string;
+    llmPrefix(): string;
+    _stop(): string[];
+    static validateTools(tools: StructuredTool[]): void;
+    static getDefaultOutputParser(fields?: OutputParserArgs & {
+        toolNames: string[];
+    }): StructuredChatOutputParserWithRetries;
+    constructScratchPad(steps: AgentStep[]): Promise<string>;
+    static createToolSchemasString(tools: StructuredTool[]): string;
+    /**
+     * Create prompt in the style of the 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.
+     */
+    static createPrompt(tools: StructuredTool[], args?: StructuredChatCreatePromptArgs): ChatPromptTemplate;
+    static fromLLMAndTools(llm: BaseLanguageModel, tools: StructuredTool[], args?: StructuredChatCreatePromptArgs & AgentArgs): StructuredChatAgent;
+}

package/dist/agents/structured_chat/index.js

@@ -0,0 +1,102 @@
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { LLMChain } from "../../chains/llm_chain.js";
+import { PromptTemplate } from "../../prompts/prompt.js";
+import { ChatPromptTemplate, HumanMessagePromptTemplate, SystemMessagePromptTemplate, } from "../../prompts/chat.js";
+import { Agent } from "../agent.js";
+import { StructuredChatOutputParserWithRetries } from "./outputParser.js";
+import { FORMAT_INSTRUCTIONS, PREFIX, SUFFIX } from "./prompt.js";
+/**
+ * Agent that interoperates with Structured Tools using React logic.
+ * @augments Agent
+ */
+export class StructuredChatAgent extends Agent {
+    constructor(input) {
+        const outputParser = input?.outputParser ?? StructuredChatAgent.getDefaultOutputParser();
+        super({ ...input, outputParser });
+    }
+    _agentType() {
+        return "structured-chat-zero-shot-react-description";
+    }
+    observationPrefix() {
+        return "Observation: ";
+    }
+    llmPrefix() {
+        return "Thought:";
+    }
+    _stop() {
+        return ["Observation:"];
+    }
+    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);
+        }
+    }
+    static getDefaultOutputParser(fields) {
+        if (fields?.llm) {
+            return StructuredChatOutputParserWithRetries.fromLLM(fields.llm, {
+                toolNames: fields.toolNames,
+            });
+        }
+        return new StructuredChatOutputParserWithRetries({
+            toolNames: fields?.toolNames,
+        });
+    }
+    async constructScratchPad(steps) {
+        const agentScratchpad = await super.constructScratchPad(steps);
+        if (agentScratchpad) {
+            return `This was your previous work (but I haven't seen any of it! I only see what you return as final answer):\n${agentScratchpad}`;
+        }
+        return agentScratchpad;
+    }
+    static createToolSchemasString(tools) {
+        return tools
+            .map((tool) => `${tool.name}: ${tool.description}, args: ${JSON.stringify(zodToJsonSchema(tool.schema).properties)}`)
+            .join("\n");
+    }
+    /**
+     * Create prompt in the style of the 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.
+     */
+    static createPrompt(tools, args) {
+        const { prefix = PREFIX, suffix = SUFFIX } = args ?? {};
+        const template = [prefix, FORMAT_INSTRUCTIONS, suffix].join("\n\n");
+        const messages = [
+            new SystemMessagePromptTemplate(new PromptTemplate({
+                template,
+                inputVariables: [],
+                partialVariables: {
+                    tool_schemas: StructuredChatAgent.createToolSchemasString(tools),
+                    tool_names: tools.map((tool) => tool.name).join(", "),
+                },
+            })),
+            HumanMessagePromptTemplate.fromTemplate("{input}\n\n{agent_scratchpad}"),
+        ];
+        return ChatPromptTemplate.fromPromptMessages(messages);
+    }
+    static fromLLMAndTools(llm, tools, args) {
+        StructuredChatAgent.validateTools(tools);
+        const prompt = StructuredChatAgent.createPrompt(tools, args);
+        const outputParser = args?.outputParser ??
+            StructuredChatAgent.getDefaultOutputParser({
+                llm,
+                toolNames: tools.map((tool) => tool.name),
+            });
+        const chain = new LLMChain({
+            prompt,
+            llm,
+            callbacks: args?.callbacks,
+        });
+        return new StructuredChatAgent({
+            llmChain: chain,
+            outputParser,
+            allowedTools: tools.map((t) => t.name),
+        });
+    }
+}