@langchain/classic 1.0.0-alpha.1

package/dist/chains/api/api_chain.cjs

@@ -0,0 +1,100 @@
+const require_base = require('../base.cjs');
+const require_llm_chain = require('../llm_chain.cjs');
+const require_prompts = require('./prompts.cjs');
+
+//#region src/chains/api/api_chain.ts
+/**
+* Class that extends BaseChain and represents a chain specifically
+* designed for making API requests and processing API responses.
+*/
+var APIChain = class APIChain extends require_base.BaseChain {
+	apiAnswerChain;
+	apiRequestChain;
+	apiDocs;
+	headers = {};
+	inputKey = "question";
+	outputKey = "output";
+	get inputKeys() {
+		return [this.inputKey];
+	}
+	get outputKeys() {
+		return [this.outputKey];
+	}
+	constructor(fields) {
+		super(fields);
+		this.apiRequestChain = fields.apiRequestChain;
+		this.apiAnswerChain = fields.apiAnswerChain;
+		this.apiDocs = fields.apiDocs;
+		this.inputKey = fields.inputKey ?? this.inputKey;
+		this.outputKey = fields.outputKey ?? this.outputKey;
+		this.headers = fields.headers ?? this.headers;
+	}
+	/** @ignore */
+	async _call(values, runManager) {
+		const question = values[this.inputKey];
+		const api_url = await this.apiRequestChain.predict({
+			question,
+			api_docs: this.apiDocs
+		}, runManager?.getChild("request"));
+		const res = await fetch(api_url, { headers: this.headers });
+		const api_response = await res.text();
+		const answer = await this.apiAnswerChain.predict({
+			question,
+			api_docs: this.apiDocs,
+			api_url,
+			api_response
+		}, runManager?.getChild("response"));
+		return { [this.outputKey]: answer };
+	}
+	_chainType() {
+		return "api_chain";
+	}
+	static async deserialize(data) {
+		const { api_request_chain, api_answer_chain, api_docs } = data;
+		if (!api_request_chain) throw new Error("LLMChain must have api_request_chain");
+		if (!api_answer_chain) throw new Error("LLMChain must have api_answer_chain");
+		if (!api_docs) throw new Error("LLMChain must have api_docs");
+		return new APIChain({
+			apiAnswerChain: await require_llm_chain.LLMChain.deserialize(api_answer_chain),
+			apiRequestChain: await require_llm_chain.LLMChain.deserialize(api_request_chain),
+			apiDocs: api_docs
+		});
+	}
+	serialize() {
+		return {
+			_type: this._chainType(),
+			api_answer_chain: this.apiAnswerChain.serialize(),
+			api_request_chain: this.apiRequestChain.serialize(),
+			api_docs: this.apiDocs
+		};
+	}
+	/**
+	* Static method to create a new APIChain from a BaseLanguageModel and API
+	* documentation.
+	* @param llm BaseLanguageModel instance.
+	* @param apiDocs API documentation.
+	* @param options Optional configuration options for the APIChain.
+	* @returns New APIChain instance.
+	*/
+	static fromLLMAndAPIDocs(llm, apiDocs, options = {}) {
+		const { apiUrlPrompt = require_prompts.API_URL_PROMPT_TEMPLATE, apiResponsePrompt = require_prompts.API_RESPONSE_PROMPT_TEMPLATE } = options;
+		const apiRequestChain = new require_llm_chain.LLMChain({
+			prompt: apiUrlPrompt,
+			llm
+		});
+		const apiAnswerChain = new require_llm_chain.LLMChain({
+			prompt: apiResponsePrompt,
+			llm
+		});
+		return new this({
+			apiAnswerChain,
+			apiRequestChain,
+			apiDocs,
+			...options
+		});
+	}
+};
+
+//#endregion
+exports.APIChain = APIChain;
+//# sourceMappingURL=api_chain.cjs.map

package/dist/chains/api/api_chain.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"api_chain.cjs","names":["BaseChain","fields: APIChainInput","values: ChainValues","runManager?: CallbackManagerForChainRun","question: string","data: SerializedAPIChain","LLMChain","llm: BaseLanguageModelInterface","apiDocs: string","options: APIChainOptions &\n      Omit<APIChainInput, \"apiAnswerChain\" | \"apiRequestChain\" | \"apiDocs\">","API_URL_PROMPT_TEMPLATE","API_RESPONSE_PROMPT_TEMPLATE"],"sources":["../../../src/chains/api/api_chain.ts"],"sourcesContent":["import type { BaseLanguageModelInterface } from \"@langchain/core/language_models/base\";\nimport { ChainValues } from \"@langchain/core/utils/types\";\nimport { CallbackManagerForChainRun } from \"@langchain/core/callbacks/manager\";\nimport { BasePromptTemplate } from \"@langchain/core/prompts\";\nimport { BaseChain, ChainInputs } from \"../base.js\";\nimport { SerializedAPIChain } from \"../serde.js\";\nimport { LLMChain } from \"../llm_chain.js\";\nimport {\n  API_URL_PROMPT_TEMPLATE,\n  API_RESPONSE_PROMPT_TEMPLATE,\n} from \"./prompts.js\";\n\n/**\n * Interface that extends ChainInputs and defines additional input\n * parameters specific to an APIChain.\n */\nexport interface APIChainInput extends Omit<ChainInputs, \"memory\"> {\n  apiAnswerChain: LLMChain;\n  apiRequestChain: LLMChain;\n  apiDocs: string;\n  inputKey?: string;\n  headers?: Record<string, string>;\n  /** Key to use for output, defaults to `output` */\n  outputKey?: string;\n}\n\n/**\n * Type that defines optional configuration options for an APIChain.\n */\nexport type APIChainOptions = {\n  headers?: Record<string, string>;\n  apiUrlPrompt?: BasePromptTemplate;\n  apiResponsePrompt?: BasePromptTemplate;\n};\n\n/**\n * Class that extends BaseChain and represents a chain specifically\n * designed for making API requests and processing API responses.\n */\nexport class APIChain extends BaseChain implements APIChainInput {\n  apiAnswerChain: LLMChain;\n\n  apiRequestChain: LLMChain;\n\n  apiDocs: string;\n\n  headers = {};\n\n  inputKey = \"question\";\n\n  outputKey = \"output\";\n\n  get inputKeys() {\n    return [this.inputKey];\n  }\n\n  get outputKeys() {\n    return [this.outputKey];\n  }\n\n  constructor(fields: APIChainInput) {\n    super(fields);\n    this.apiRequestChain = fields.apiRequestChain;\n    this.apiAnswerChain = fields.apiAnswerChain;\n    this.apiDocs = fields.apiDocs;\n    this.inputKey = fields.inputKey ?? this.inputKey;\n    this.outputKey = fields.outputKey ?? this.outputKey;\n    this.headers = fields.headers ?? this.headers;\n  }\n\n  /** @ignore */\n  async _call(\n    values: ChainValues,\n    runManager?: CallbackManagerForChainRun\n  ): Promise<ChainValues> {\n    const question: string = values[this.inputKey];\n\n    const api_url = await this.apiRequestChain.predict(\n      { question, api_docs: this.apiDocs },\n      runManager?.getChild(\"request\")\n    );\n\n    const res = await fetch(api_url, { headers: this.headers });\n    const api_response = await res.text();\n\n    const answer = await this.apiAnswerChain.predict(\n      { question, api_docs: this.apiDocs, api_url, api_response },\n      runManager?.getChild(\"response\")\n    );\n\n    return { [this.outputKey]: answer };\n  }\n\n  _chainType() {\n    return \"api_chain\" as const;\n  }\n\n  static async deserialize(data: SerializedAPIChain) {\n    const { api_request_chain, api_answer_chain, api_docs } = data;\n\n    if (!api_request_chain) {\n      throw new Error(\"LLMChain must have api_request_chain\");\n    }\n    if (!api_answer_chain) {\n      throw new Error(\"LLMChain must have api_answer_chain\");\n    }\n\n    if (!api_docs) {\n      throw new Error(\"LLMChain must have api_docs\");\n    }\n\n    return new APIChain({\n      apiAnswerChain: await LLMChain.deserialize(api_answer_chain),\n      apiRequestChain: await LLMChain.deserialize(api_request_chain),\n      apiDocs: api_docs,\n    });\n  }\n\n  serialize(): SerializedAPIChain {\n    return {\n      _type: this._chainType(),\n      api_answer_chain: this.apiAnswerChain.serialize(),\n      api_request_chain: this.apiRequestChain.serialize(),\n      api_docs: this.apiDocs,\n    };\n  }\n\n  /**\n   * Static method to create a new APIChain from a BaseLanguageModel and API\n   * documentation.\n   * @param llm BaseLanguageModel instance.\n   * @param apiDocs API documentation.\n   * @param options Optional configuration options for the APIChain.\n   * @returns New APIChain instance.\n   */\n  static fromLLMAndAPIDocs(\n    llm: BaseLanguageModelInterface,\n    apiDocs: string,\n    options: APIChainOptions &\n      Omit<APIChainInput, \"apiAnswerChain\" | \"apiRequestChain\" | \"apiDocs\"> = {}\n  ): APIChain {\n    const {\n      apiUrlPrompt = API_URL_PROMPT_TEMPLATE,\n      apiResponsePrompt = API_RESPONSE_PROMPT_TEMPLATE,\n    } = options;\n    const apiRequestChain = new LLMChain({ prompt: apiUrlPrompt, llm });\n    const apiAnswerChain = new LLMChain({ prompt: apiResponsePrompt, llm });\n    return new this({\n      apiAnswerChain,\n      apiRequestChain,\n      apiDocs,\n      ...options,\n    });\n  }\n}\n"],"mappings":";;;;;;;;;AAuCA,IAAa,WAAb,MAAa,iBAAiBA,uBAAmC;CAC/D;CAEA;CAEA;CAEA,UAAU,CAAE;CAEZ,WAAW;CAEX,YAAY;CAEZ,IAAI,YAAY;AACd,SAAO,CAAC,KAAK,QAAS;CACvB;CAED,IAAI,aAAa;AACf,SAAO,CAAC,KAAK,SAAU;CACxB;CAED,YAAYC,QAAuB;EACjC,MAAM,OAAO;EACb,KAAK,kBAAkB,OAAO;EAC9B,KAAK,iBAAiB,OAAO;EAC7B,KAAK,UAAU,OAAO;EACtB,KAAK,WAAW,OAAO,YAAY,KAAK;EACxC,KAAK,YAAY,OAAO,aAAa,KAAK;EAC1C,KAAK,UAAU,OAAO,WAAW,KAAK;CACvC;;CAGD,MAAM,MACJC,QACAC,YACsB;EACtB,MAAMC,WAAmB,OAAO,KAAK;EAErC,MAAM,UAAU,MAAM,KAAK,gBAAgB,QACzC;GAAE;GAAU,UAAU,KAAK;EAAS,GACpC,YAAY,SAAS,UAAU,CAChC;EAED,MAAM,MAAM,MAAM,MAAM,SAAS,EAAE,SAAS,KAAK,QAAS,EAAC;EAC3D,MAAM,eAAe,MAAM,IAAI,MAAM;EAErC,MAAM,SAAS,MAAM,KAAK,eAAe,QACvC;GAAE;GAAU,UAAU,KAAK;GAAS;GAAS;EAAc,GAC3D,YAAY,SAAS,WAAW,CACjC;AAED,SAAO,GAAG,KAAK,YAAY,OAAQ;CACpC;CAED,aAAa;AACX,SAAO;CACR;CAED,aAAa,YAAYC,MAA0B;EACjD,MAAM,EAAE,mBAAmB,kBAAkB,UAAU,GAAG;AAE1D,MAAI,CAAC,kBACH,OAAM,IAAI,MAAM;AAElB,MAAI,CAAC,iBACH,OAAM,IAAI,MAAM;AAGlB,MAAI,CAAC,SACH,OAAM,IAAI,MAAM;AAGlB,SAAO,IAAI,SAAS;GAClB,gBAAgB,MAAMC,2BAAS,YAAY,iBAAiB;GAC5D,iBAAiB,MAAMA,2BAAS,YAAY,kBAAkB;GAC9D,SAAS;EACV;CACF;CAED,YAAgC;AAC9B,SAAO;GACL,OAAO,KAAK,YAAY;GACxB,kBAAkB,KAAK,eAAe,WAAW;GACjD,mBAAmB,KAAK,gBAAgB,WAAW;GACnD,UAAU,KAAK;EAChB;CACF;;;;;;;;;CAUD,OAAO,kBACLC,KACAC,SACAC,UAC0E,CAAE,GAClE;EACV,MAAM,EACJ,eAAeC,yCACf,oBAAoBC,8CACrB,GAAG;EACJ,MAAM,kBAAkB,IAAIL,2BAAS;GAAE,QAAQ;GAAc;EAAK;EAClE,MAAM,iBAAiB,IAAIA,2BAAS;GAAE,QAAQ;GAAmB;EAAK;AACtE,SAAO,IAAI,KAAK;GACd;GACA;GACA;GACA,GAAG;EACJ;CACF;AACF"}

package/dist/chains/api/api_chain.d.cts

@@ -0,0 +1,63 @@
+import { SerializedAPIChain } from "../serde.cjs";
+import { BaseChain, ChainInputs } from "../base.cjs";
+import { LLMChain } from "../llm_chain.cjs";
+import { ChainValues } from "@langchain/core/utils/types";
+import { BasePromptTemplate } from "@langchain/core/prompts";
+import { BaseLanguageModelInterface } from "@langchain/core/language_models/base";
+import { CallbackManagerForChainRun } from "@langchain/core/callbacks/manager";
+
+//#region src/chains/api/api_chain.d.ts
+
+/**
+ * Interface that extends ChainInputs and defines additional input
+ * parameters specific to an APIChain.
+ */
+interface APIChainInput extends Omit<ChainInputs, "memory"> {
+  apiAnswerChain: LLMChain;
+  apiRequestChain: LLMChain;
+  apiDocs: string;
+  inputKey?: string;
+  headers?: Record<string, string>;
+  /** Key to use for output, defaults to `output` */
+  outputKey?: string;
+}
+/**
+ * Type that defines optional configuration options for an APIChain.
+ */
+type APIChainOptions = {
+  headers?: Record<string, string>;
+  apiUrlPrompt?: BasePromptTemplate;
+  apiResponsePrompt?: BasePromptTemplate;
+};
+/**
+ * Class that extends BaseChain and represents a chain specifically
+ * designed for making API requests and processing API responses.
+ */
+declare class APIChain extends BaseChain implements APIChainInput {
+  apiAnswerChain: LLMChain;
+  apiRequestChain: LLMChain;
+  apiDocs: string;
+  headers: {};
+  inputKey: string;
+  outputKey: string;
+  get inputKeys(): string[];
+  get outputKeys(): string[];
+  constructor(fields: APIChainInput);
+  /** @ignore */
+  _call(values: ChainValues, runManager?: CallbackManagerForChainRun): Promise<ChainValues>;
+  _chainType(): "api_chain";
+  static deserialize(data: SerializedAPIChain): Promise<APIChain>;
+  serialize(): SerializedAPIChain;
+  /**
+   * Static method to create a new APIChain from a BaseLanguageModel and API
+   * documentation.
+   * @param llm BaseLanguageModel instance.
+   * @param apiDocs API documentation.
+   * @param options Optional configuration options for the APIChain.
+   * @returns New APIChain instance.
+   */
+  static fromLLMAndAPIDocs(llm: BaseLanguageModelInterface, apiDocs: string, options?: APIChainOptions & Omit<APIChainInput, "apiAnswerChain" | "apiRequestChain" | "apiDocs">): APIChain;
+}
+//#endregion
+export { APIChain, APIChainInput, APIChainOptions };
+//# sourceMappingURL=api_chain.d.cts.map

package/dist/chains/api/api_chain.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api_chain.d.cts","names":["BaseLanguageModelInterface","ChainValues","CallbackManagerForChainRun","BasePromptTemplate","BaseChain","ChainInputs","SerializedAPIChain","LLMChain","APIChainInput","Record","Omit","APIChainOptions","APIChain","Promise"],"sources":["../../../src/chains/api/api_chain.d.ts"],"sourcesContent":["import type { BaseLanguageModelInterface } from \"@langchain/core/language_models/base\";\nimport { ChainValues } from \"@langchain/core/utils/types\";\nimport { CallbackManagerForChainRun } from \"@langchain/core/callbacks/manager\";\nimport { BasePromptTemplate } from \"@langchain/core/prompts\";\nimport { BaseChain, ChainInputs } from \"../base.js\";\nimport { SerializedAPIChain } from \"../serde.js\";\nimport { LLMChain } from \"../llm_chain.js\";\n/**\n * Interface that extends ChainInputs and defines additional input\n * parameters specific to an APIChain.\n */\nexport interface APIChainInput extends Omit<ChainInputs, \"memory\"> {\n    apiAnswerChain: LLMChain;\n    apiRequestChain: LLMChain;\n    apiDocs: string;\n    inputKey?: string;\n    headers?: Record<string, string>;\n    /** Key to use for output, defaults to `output` */\n    outputKey?: string;\n}\n/**\n * Type that defines optional configuration options for an APIChain.\n */\nexport type APIChainOptions = {\n    headers?: Record<string, string>;\n    apiUrlPrompt?: BasePromptTemplate;\n    apiResponsePrompt?: BasePromptTemplate;\n};\n/**\n * Class that extends BaseChain and represents a chain specifically\n * designed for making API requests and processing API responses.\n */\nexport declare class APIChain extends BaseChain implements APIChainInput {\n    apiAnswerChain: LLMChain;\n    apiRequestChain: LLMChain;\n    apiDocs: string;\n    headers: {};\n    inputKey: string;\n    outputKey: string;\n    get inputKeys(): string[];\n    get outputKeys(): string[];\n    constructor(fields: APIChainInput);\n    /** @ignore */\n    _call(values: ChainValues, runManager?: CallbackManagerForChainRun): Promise<ChainValues>;\n    _chainType(): \"api_chain\";\n    static deserialize(data: SerializedAPIChain): Promise<APIChain>;\n    serialize(): SerializedAPIChain;\n    /**\n     * Static method to create a new APIChain from a BaseLanguageModel and API\n     * documentation.\n     * @param llm BaseLanguageModel instance.\n     * @param apiDocs API documentation.\n     * @param options Optional configuration options for the APIChain.\n     * @returns New APIChain instance.\n     */\n    static fromLLMAndAPIDocs(llm: BaseLanguageModelInterface, apiDocs: string, options?: APIChainOptions & Omit<APIChainInput, \"apiAnswerChain\" | \"apiRequestChain\" | \"apiDocs\">): APIChain;\n}\n"],"mappings":";;;;;;;;;;;;AAWA;;AAA4CK,UAA3BG,aAAAA,SAAsBE,IAAKL,CAAAA,WAAAA,EAAAA,QAAAA,CAAAA,CAAAA;EAAW,cACnCE,EAAAA,QAAAA;EAAQ,eACPA,EAAAA,QAAAA;EAAQ,OAGfE,EAAAA,MAAAA;EAAM,QALmBC,CAAAA,EAAAA,MAAAA;EAAI,OAAA,CAAA,EAK7BD,MAL6B,CAAA,MAAA,EAAA,MAAA,CAAA;EAY/BE;EAAe,SAAA,CAAA,EAAA,MAAA;;;;AAGe;AAMrBC,KATTD,eAAAA,GASiB;EAAA,OAAA,CAAA,EARfF,MAQe,CAAA,MAAA,EAAA,MAAA,CAAA;EAAA,YACTF,CAAAA,EARDJ,kBAQCI;EAAQ,iBACPA,CAAAA,EARGJ,kBAQHI;CAAQ;;;;;AAWAD,cAbRM,QAAAA,SAAiBR,SAAAA,YAAqBI,aAa9BF,CAAAA;EAAkB,cAAWM,EAZtCL,QAYsCK;EAAQ,eAAhBC,EAX7BN,QAW6BM;EAAO,OACxCP,EAAAA,MAAAA;EAAkB,OASDN,EAAAA,CAAAA,CAAAA;EAA0B,QAA6BW,EAAAA,MAAAA;EAAe,SAAQH,EAAAA,MAAAA;EAAa,IAAlBE,SAAAA,CAAAA,CAAAA,EAAAA,MAAAA,EAAAA;EAAI,IAAoEE,UAAAA,CAAAA,CAAAA,EAAAA,MAAAA,EAAAA;EAAQ,WAvBrJR,CAAAA,MAAAA,EASdI,aATcJ;EAAS;EAAyB,KAAA,CAAA,MAAA,EAWtDH,WAXsD,EAAA,UAAA,CAAA,EAW5BC,0BAX4B,CAAA,EAWCW,OAXD,CAWSZ,WAXT,CAAA;;2BAa3CK,qBAAqBO,QAAQD;eACzCN;;;;;;;;;gCASiBN,uDAAuDW,kBAAkBD,KAAKF,mEAAmEI"}

package/dist/chains/api/api_chain.d.ts

@@ -0,0 +1,63 @@
+import { SerializedAPIChain } from "../serde.js";
+import { BaseChain, ChainInputs } from "../base.js";
+import { LLMChain } from "../llm_chain.js";
+import { BasePromptTemplate } from "@langchain/core/prompts";
+import { BaseLanguageModelInterface } from "@langchain/core/language_models/base";
+import { CallbackManagerForChainRun } from "@langchain/core/callbacks/manager";
+import { ChainValues } from "@langchain/core/utils/types";
+
+//#region src/chains/api/api_chain.d.ts
+
+/**
+ * Interface that extends ChainInputs and defines additional input
+ * parameters specific to an APIChain.
+ */
+interface APIChainInput extends Omit<ChainInputs, "memory"> {
+  apiAnswerChain: LLMChain;
+  apiRequestChain: LLMChain;
+  apiDocs: string;
+  inputKey?: string;
+  headers?: Record<string, string>;
+  /** Key to use for output, defaults to `output` */
+  outputKey?: string;
+}
+/**
+ * Type that defines optional configuration options for an APIChain.
+ */
+type APIChainOptions = {
+  headers?: Record<string, string>;
+  apiUrlPrompt?: BasePromptTemplate;
+  apiResponsePrompt?: BasePromptTemplate;
+};
+/**
+ * Class that extends BaseChain and represents a chain specifically
+ * designed for making API requests and processing API responses.
+ */
+declare class APIChain extends BaseChain implements APIChainInput {
+  apiAnswerChain: LLMChain;
+  apiRequestChain: LLMChain;
+  apiDocs: string;
+  headers: {};
+  inputKey: string;
+  outputKey: string;
+  get inputKeys(): string[];
+  get outputKeys(): string[];
+  constructor(fields: APIChainInput);
+  /** @ignore */
+  _call(values: ChainValues, runManager?: CallbackManagerForChainRun): Promise<ChainValues>;
+  _chainType(): "api_chain";
+  static deserialize(data: SerializedAPIChain): Promise<APIChain>;
+  serialize(): SerializedAPIChain;
+  /**
+   * Static method to create a new APIChain from a BaseLanguageModel and API
+   * documentation.
+   * @param llm BaseLanguageModel instance.
+   * @param apiDocs API documentation.
+   * @param options Optional configuration options for the APIChain.
+   * @returns New APIChain instance.
+   */
+  static fromLLMAndAPIDocs(llm: BaseLanguageModelInterface, apiDocs: string, options?: APIChainOptions & Omit<APIChainInput, "apiAnswerChain" | "apiRequestChain" | "apiDocs">): APIChain;
+}
+//#endregion
+export { APIChain, APIChainInput, APIChainOptions };
+//# sourceMappingURL=api_chain.d.ts.map

package/dist/chains/api/api_chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api_chain.d.ts","names":["BaseLanguageModelInterface","ChainValues","CallbackManagerForChainRun","BasePromptTemplate","BaseChain","ChainInputs","SerializedAPIChain","LLMChain","APIChainInput","Record","Omit","APIChainOptions","APIChain","Promise"],"sources":["../../../src/chains/api/api_chain.d.ts"],"sourcesContent":["import type { BaseLanguageModelInterface } from \"@langchain/core/language_models/base\";\nimport { ChainValues } from \"@langchain/core/utils/types\";\nimport { CallbackManagerForChainRun } from \"@langchain/core/callbacks/manager\";\nimport { BasePromptTemplate } from \"@langchain/core/prompts\";\nimport { BaseChain, ChainInputs } from \"../base.js\";\nimport { SerializedAPIChain } from \"../serde.js\";\nimport { LLMChain } from \"../llm_chain.js\";\n/**\n * Interface that extends ChainInputs and defines additional input\n * parameters specific to an APIChain.\n */\nexport interface APIChainInput extends Omit<ChainInputs, \"memory\"> {\n    apiAnswerChain: LLMChain;\n    apiRequestChain: LLMChain;\n    apiDocs: string;\n    inputKey?: string;\n    headers?: Record<string, string>;\n    /** Key to use for output, defaults to `output` */\n    outputKey?: string;\n}\n/**\n * Type that defines optional configuration options for an APIChain.\n */\nexport type APIChainOptions = {\n    headers?: Record<string, string>;\n    apiUrlPrompt?: BasePromptTemplate;\n    apiResponsePrompt?: BasePromptTemplate;\n};\n/**\n * Class that extends BaseChain and represents a chain specifically\n * designed for making API requests and processing API responses.\n */\nexport declare class APIChain extends BaseChain implements APIChainInput {\n    apiAnswerChain: LLMChain;\n    apiRequestChain: LLMChain;\n    apiDocs: string;\n    headers: {};\n    inputKey: string;\n    outputKey: string;\n    get inputKeys(): string[];\n    get outputKeys(): string[];\n    constructor(fields: APIChainInput);\n    /** @ignore */\n    _call(values: ChainValues, runManager?: CallbackManagerForChainRun): Promise<ChainValues>;\n    _chainType(): \"api_chain\";\n    static deserialize(data: SerializedAPIChain): Promise<APIChain>;\n    serialize(): SerializedAPIChain;\n    /**\n     * Static method to create a new APIChain from a BaseLanguageModel and API\n     * documentation.\n     * @param llm BaseLanguageModel instance.\n     * @param apiDocs API documentation.\n     * @param options Optional configuration options for the APIChain.\n     * @returns New APIChain instance.\n     */\n    static fromLLMAndAPIDocs(llm: BaseLanguageModelInterface, apiDocs: string, options?: APIChainOptions & Omit<APIChainInput, \"apiAnswerChain\" | \"apiRequestChain\" | \"apiDocs\">): APIChain;\n}\n"],"mappings":";;;;;;;;;;;;AAWA;;AAA4CK,UAA3BG,aAAAA,SAAsBE,IAAKL,CAAAA,WAAAA,EAAAA,QAAAA,CAAAA,CAAAA;EAAW,cACnCE,EAAAA,QAAAA;EAAQ,eACPA,EAAAA,QAAAA;EAAQ,OAGfE,EAAAA,MAAAA;EAAM,QALmBC,CAAAA,EAAAA,MAAAA;EAAI,OAAA,CAAA,EAK7BD,MAL6B,CAAA,MAAA,EAAA,MAAA,CAAA;EAY/BE;EAAe,SAAA,CAAA,EAAA,MAAA;;;;AAGe;AAMrBC,KATTD,eAAAA,GASiB;EAAA,OAAA,CAAA,EARfF,MAQe,CAAA,MAAA,EAAA,MAAA,CAAA;EAAA,YACTF,CAAAA,EARDJ,kBAQCI;EAAQ,iBACPA,CAAAA,EARGJ,kBAQHI;CAAQ;;;;;AAWAD,cAbRM,QAAAA,SAAiBR,SAAAA,YAAqBI,aAa9BF,CAAAA;EAAkB,cAAWM,EAZtCL,QAYsCK;EAAQ,eAAhBC,EAX7BN,QAW6BM;EAAO,OACxCP,EAAAA,MAAAA;EAAkB,OASDN,EAAAA,CAAAA,CAAAA;EAA0B,QAA6BW,EAAAA,MAAAA;EAAe,SAAQH,EAAAA,MAAAA;EAAa,IAAlBE,SAAAA,CAAAA,CAAAA,EAAAA,MAAAA,EAAAA;EAAI,IAAoEE,UAAAA,CAAAA,CAAAA,EAAAA,MAAAA,EAAAA;EAAQ,WAvBrJR,CAAAA,MAAAA,EASdI,aATcJ;EAAS;EAAyB,KAAA,CAAA,MAAA,EAWtDH,WAXsD,EAAA,UAAA,CAAA,EAW5BC,0BAX4B,CAAA,EAWCW,OAXD,CAWSZ,WAXT,CAAA;;2BAa3CK,qBAAqBO,QAAQD;eACzCN;;;;;;;;;gCASiBN,uDAAuDW,kBAAkBD,KAAKF,mEAAmEI"}

package/dist/chains/api/api_chain.js

@@ -0,0 +1,100 @@
+import { BaseChain } from "../base.js";
+import { LLMChain } from "../llm_chain.js";
+import { API_RESPONSE_PROMPT_TEMPLATE, API_URL_PROMPT_TEMPLATE } from "./prompts.js";
+
+//#region src/chains/api/api_chain.ts
+/**
+* Class that extends BaseChain and represents a chain specifically
+* designed for making API requests and processing API responses.
+*/
+var APIChain = class APIChain extends BaseChain {
+	apiAnswerChain;
+	apiRequestChain;
+	apiDocs;
+	headers = {};
+	inputKey = "question";
+	outputKey = "output";
+	get inputKeys() {
+		return [this.inputKey];
+	}
+	get outputKeys() {
+		return [this.outputKey];
+	}
+	constructor(fields) {
+		super(fields);
+		this.apiRequestChain = fields.apiRequestChain;
+		this.apiAnswerChain = fields.apiAnswerChain;
+		this.apiDocs = fields.apiDocs;
+		this.inputKey = fields.inputKey ?? this.inputKey;
+		this.outputKey = fields.outputKey ?? this.outputKey;
+		this.headers = fields.headers ?? this.headers;
+	}
+	/** @ignore */
+	async _call(values, runManager) {
+		const question = values[this.inputKey];
+		const api_url = await this.apiRequestChain.predict({
+			question,
+			api_docs: this.apiDocs
+		}, runManager?.getChild("request"));
+		const res = await fetch(api_url, { headers: this.headers });
+		const api_response = await res.text();
+		const answer = await this.apiAnswerChain.predict({
+			question,
+			api_docs: this.apiDocs,
+			api_url,
+			api_response
+		}, runManager?.getChild("response"));
+		return { [this.outputKey]: answer };
+	}
+	_chainType() {
+		return "api_chain";
+	}
+	static async deserialize(data) {
+		const { api_request_chain, api_answer_chain, api_docs } = data;
+		if (!api_request_chain) throw new Error("LLMChain must have api_request_chain");
+		if (!api_answer_chain) throw new Error("LLMChain must have api_answer_chain");
+		if (!api_docs) throw new Error("LLMChain must have api_docs");
+		return new APIChain({
+			apiAnswerChain: await LLMChain.deserialize(api_answer_chain),
+			apiRequestChain: await LLMChain.deserialize(api_request_chain),
+			apiDocs: api_docs
+		});
+	}
+	serialize() {
+		return {
+			_type: this._chainType(),
+			api_answer_chain: this.apiAnswerChain.serialize(),
+			api_request_chain: this.apiRequestChain.serialize(),
+			api_docs: this.apiDocs
+		};
+	}
+	/**
+	* Static method to create a new APIChain from a BaseLanguageModel and API
+	* documentation.
+	* @param llm BaseLanguageModel instance.
+	* @param apiDocs API documentation.
+	* @param options Optional configuration options for the APIChain.
+	* @returns New APIChain instance.
+	*/
+	static fromLLMAndAPIDocs(llm, apiDocs, options = {}) {
+		const { apiUrlPrompt = API_URL_PROMPT_TEMPLATE, apiResponsePrompt = API_RESPONSE_PROMPT_TEMPLATE } = options;
+		const apiRequestChain = new LLMChain({
+			prompt: apiUrlPrompt,
+			llm
+		});
+		const apiAnswerChain = new LLMChain({
+			prompt: apiResponsePrompt,
+			llm
+		});
+		return new this({
+			apiAnswerChain,
+			apiRequestChain,
+			apiDocs,
+			...options
+		});
+	}
+};
+
+//#endregion
+export { APIChain };
+//# sourceMappingURL=api_chain.js.map

package/dist/chains/api/api_chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api_chain.js","names":["fields: APIChainInput","values: ChainValues","runManager?: CallbackManagerForChainRun","question: string","data: SerializedAPIChain","llm: BaseLanguageModelInterface","apiDocs: string","options: APIChainOptions &\n      Omit<APIChainInput, \"apiAnswerChain\" | \"apiRequestChain\" | \"apiDocs\">"],"sources":["../../../src/chains/api/api_chain.ts"],"sourcesContent":["import type { BaseLanguageModelInterface } from \"@langchain/core/language_models/base\";\nimport { ChainValues } from \"@langchain/core/utils/types\";\nimport { CallbackManagerForChainRun } from \"@langchain/core/callbacks/manager\";\nimport { BasePromptTemplate } from \"@langchain/core/prompts\";\nimport { BaseChain, ChainInputs } from \"../base.js\";\nimport { SerializedAPIChain } from \"../serde.js\";\nimport { LLMChain } from \"../llm_chain.js\";\nimport {\n  API_URL_PROMPT_TEMPLATE,\n  API_RESPONSE_PROMPT_TEMPLATE,\n} from \"./prompts.js\";\n\n/**\n * Interface that extends ChainInputs and defines additional input\n * parameters specific to an APIChain.\n */\nexport interface APIChainInput extends Omit<ChainInputs, \"memory\"> {\n  apiAnswerChain: LLMChain;\n  apiRequestChain: LLMChain;\n  apiDocs: string;\n  inputKey?: string;\n  headers?: Record<string, string>;\n  /** Key to use for output, defaults to `output` */\n  outputKey?: string;\n}\n\n/**\n * Type that defines optional configuration options for an APIChain.\n */\nexport type APIChainOptions = {\n  headers?: Record<string, string>;\n  apiUrlPrompt?: BasePromptTemplate;\n  apiResponsePrompt?: BasePromptTemplate;\n};\n\n/**\n * Class that extends BaseChain and represents a chain specifically\n * designed for making API requests and processing API responses.\n */\nexport class APIChain extends BaseChain implements APIChainInput {\n  apiAnswerChain: LLMChain;\n\n  apiRequestChain: LLMChain;\n\n  apiDocs: string;\n\n  headers = {};\n\n  inputKey = \"question\";\n\n  outputKey = \"output\";\n\n  get inputKeys() {\n    return [this.inputKey];\n  }\n\n  get outputKeys() {\n    return [this.outputKey];\n  }\n\n  constructor(fields: APIChainInput) {\n    super(fields);\n    this.apiRequestChain = fields.apiRequestChain;\n    this.apiAnswerChain = fields.apiAnswerChain;\n    this.apiDocs = fields.apiDocs;\n    this.inputKey = fields.inputKey ?? this.inputKey;\n    this.outputKey = fields.outputKey ?? this.outputKey;\n    this.headers = fields.headers ?? this.headers;\n  }\n\n  /** @ignore */\n  async _call(\n    values: ChainValues,\n    runManager?: CallbackManagerForChainRun\n  ): Promise<ChainValues> {\n    const question: string = values[this.inputKey];\n\n    const api_url = await this.apiRequestChain.predict(\n      { question, api_docs: this.apiDocs },\n      runManager?.getChild(\"request\")\n    );\n\n    const res = await fetch(api_url, { headers: this.headers });\n    const api_response = await res.text();\n\n    const answer = await this.apiAnswerChain.predict(\n      { question, api_docs: this.apiDocs, api_url, api_response },\n      runManager?.getChild(\"response\")\n    );\n\n    return { [this.outputKey]: answer };\n  }\n\n  _chainType() {\n    return \"api_chain\" as const;\n  }\n\n  static async deserialize(data: SerializedAPIChain) {\n    const { api_request_chain, api_answer_chain, api_docs } = data;\n\n    if (!api_request_chain) {\n      throw new Error(\"LLMChain must have api_request_chain\");\n    }\n    if (!api_answer_chain) {\n      throw new Error(\"LLMChain must have api_answer_chain\");\n    }\n\n    if (!api_docs) {\n      throw new Error(\"LLMChain must have api_docs\");\n    }\n\n    return new APIChain({\n      apiAnswerChain: await LLMChain.deserialize(api_answer_chain),\n      apiRequestChain: await LLMChain.deserialize(api_request_chain),\n      apiDocs: api_docs,\n    });\n  }\n\n  serialize(): SerializedAPIChain {\n    return {\n      _type: this._chainType(),\n      api_answer_chain: this.apiAnswerChain.serialize(),\n      api_request_chain: this.apiRequestChain.serialize(),\n      api_docs: this.apiDocs,\n    };\n  }\n\n  /**\n   * Static method to create a new APIChain from a BaseLanguageModel and API\n   * documentation.\n   * @param llm BaseLanguageModel instance.\n   * @param apiDocs API documentation.\n   * @param options Optional configuration options for the APIChain.\n   * @returns New APIChain instance.\n   */\n  static fromLLMAndAPIDocs(\n    llm: BaseLanguageModelInterface,\n    apiDocs: string,\n    options: APIChainOptions &\n      Omit<APIChainInput, \"apiAnswerChain\" | \"apiRequestChain\" | \"apiDocs\"> = {}\n  ): APIChain {\n    const {\n      apiUrlPrompt = API_URL_PROMPT_TEMPLATE,\n      apiResponsePrompt = API_RESPONSE_PROMPT_TEMPLATE,\n    } = options;\n    const apiRequestChain = new LLMChain({ prompt: apiUrlPrompt, llm });\n    const apiAnswerChain = new LLMChain({ prompt: apiResponsePrompt, llm });\n    return new this({\n      apiAnswerChain,\n      apiRequestChain,\n      apiDocs,\n      ...options,\n    });\n  }\n}\n"],"mappings":";;;;;;;;;AAuCA,IAAa,WAAb,MAAa,iBAAiB,UAAmC;CAC/D;CAEA;CAEA;CAEA,UAAU,CAAE;CAEZ,WAAW;CAEX,YAAY;CAEZ,IAAI,YAAY;AACd,SAAO,CAAC,KAAK,QAAS;CACvB;CAED,IAAI,aAAa;AACf,SAAO,CAAC,KAAK,SAAU;CACxB;CAED,YAAYA,QAAuB;EACjC,MAAM,OAAO;EACb,KAAK,kBAAkB,OAAO;EAC9B,KAAK,iBAAiB,OAAO;EAC7B,KAAK,UAAU,OAAO;EACtB,KAAK,WAAW,OAAO,YAAY,KAAK;EACxC,KAAK,YAAY,OAAO,aAAa,KAAK;EAC1C,KAAK,UAAU,OAAO,WAAW,KAAK;CACvC;;CAGD,MAAM,MACJC,QACAC,YACsB;EACtB,MAAMC,WAAmB,OAAO,KAAK;EAErC,MAAM,UAAU,MAAM,KAAK,gBAAgB,QACzC;GAAE;GAAU,UAAU,KAAK;EAAS,GACpC,YAAY,SAAS,UAAU,CAChC;EAED,MAAM,MAAM,MAAM,MAAM,SAAS,EAAE,SAAS,KAAK,QAAS,EAAC;EAC3D,MAAM,eAAe,MAAM,IAAI,MAAM;EAErC,MAAM,SAAS,MAAM,KAAK,eAAe,QACvC;GAAE;GAAU,UAAU,KAAK;GAAS;GAAS;EAAc,GAC3D,YAAY,SAAS,WAAW,CACjC;AAED,SAAO,GAAG,KAAK,YAAY,OAAQ;CACpC;CAED,aAAa;AACX,SAAO;CACR;CAED,aAAa,YAAYC,MAA0B;EACjD,MAAM,EAAE,mBAAmB,kBAAkB,UAAU,GAAG;AAE1D,MAAI,CAAC,kBACH,OAAM,IAAI,MAAM;AAElB,MAAI,CAAC,iBACH,OAAM,IAAI,MAAM;AAGlB,MAAI,CAAC,SACH,OAAM,IAAI,MAAM;AAGlB,SAAO,IAAI,SAAS;GAClB,gBAAgB,MAAM,SAAS,YAAY,iBAAiB;GAC5D,iBAAiB,MAAM,SAAS,YAAY,kBAAkB;GAC9D,SAAS;EACV;CACF;CAED,YAAgC;AAC9B,SAAO;GACL,OAAO,KAAK,YAAY;GACxB,kBAAkB,KAAK,eAAe,WAAW;GACjD,mBAAmB,KAAK,gBAAgB,WAAW;GACnD,UAAU,KAAK;EAChB;CACF;;;;;;;;;CAUD,OAAO,kBACLC,KACAC,SACAC,UAC0E,CAAE,GAClE;EACV,MAAM,EACJ,eAAe,yBACf,oBAAoB,8BACrB,GAAG;EACJ,MAAM,kBAAkB,IAAI,SAAS;GAAE,QAAQ;GAAc;EAAK;EAClE,MAAM,iBAAiB,IAAI,SAAS;GAAE,QAAQ;GAAmB;EAAK;AACtE,SAAO,IAAI,KAAK;GACd;GACA;GACA;GACA,GAAG;EACJ;CACF;AACF"}

package/dist/chains/api/prompts.cjs

@@ -0,0 +1,38 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const __langchain_core_prompts = require_rolldown_runtime.__toESM(require("@langchain/core/prompts"));
+
+//#region src/chains/api/prompts.ts
+const API_URL_RAW_PROMPT_TEMPLATE = `You are given the below API Documentation:
+{api_docs}
+Using this documentation, generate the full API url to call for answering the user question.
+You should build the API url in order to get a response that is as short as possible, while still getting the necessary information to answer the question. Pay attention to deliberately exclude any unnecessary pieces of data in the API call.
+
+Question:{question}
+API url:`;
+const API_URL_PROMPT_TEMPLATE = /* @__PURE__ */ new __langchain_core_prompts.PromptTemplate({
+	inputVariables: ["api_docs", "question"],
+	template: API_URL_RAW_PROMPT_TEMPLATE
+});
+const API_RESPONSE_RAW_PROMPT_TEMPLATE = `${API_URL_RAW_PROMPT_TEMPLATE} {api_url}
+
+Here is the response from the API:
+
+{api_response}
+
+Summarize this response to answer the original question.
+
+Summary:`;
+const API_RESPONSE_PROMPT_TEMPLATE = /* @__PURE__ */ new __langchain_core_prompts.PromptTemplate({
+	inputVariables: [
+		"api_docs",
+		"question",
+		"api_url",
+		"api_response"
+	],
+	template: API_RESPONSE_RAW_PROMPT_TEMPLATE
+});
+
+//#endregion
+exports.API_RESPONSE_PROMPT_TEMPLATE = API_RESPONSE_PROMPT_TEMPLATE;
+exports.API_URL_PROMPT_TEMPLATE = API_URL_PROMPT_TEMPLATE;
+//# sourceMappingURL=prompts.cjs.map

package/dist/chains/api/prompts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.cjs","names":["PromptTemplate"],"sources":["../../../src/chains/api/prompts.ts"],"sourcesContent":["import { PromptTemplate } from \"@langchain/core/prompts\";\n\nexport const API_URL_RAW_PROMPT_TEMPLATE = `You are given the below API Documentation:\n{api_docs}\nUsing this documentation, generate the full API url to call for answering the user question.\nYou should build the API url in order to get a response that is as short as possible, while still getting the necessary information to answer the question. Pay attention to deliberately exclude any unnecessary pieces of data in the API call.\n\nQuestion:{question}\nAPI url:`;\n\nexport const API_URL_PROMPT_TEMPLATE = /* #__PURE__ */ new PromptTemplate({\n  inputVariables: [\"api_docs\", \"question\"],\n  template: API_URL_RAW_PROMPT_TEMPLATE,\n});\n\nexport const API_RESPONSE_RAW_PROMPT_TEMPLATE = `${API_URL_RAW_PROMPT_TEMPLATE} {api_url}\n\nHere is the response from the API:\n\n{api_response}\n\nSummarize this response to answer the original question.\n\nSummary:`;\nexport const API_RESPONSE_PROMPT_TEMPLATE = /* #__PURE__ */ new PromptTemplate({\n  inputVariables: [\"api_docs\", \"question\", \"api_url\", \"api_response\"],\n  template: API_RESPONSE_RAW_PROMPT_TEMPLATE,\n});\n"],"mappings":";;;;AAEA,MAAa,8BAA8B,CAAC;;;;;;QAMpC,CAAC;AAET,MAAa,0CAA0C,IAAIA,wCAAe;CACxE,gBAAgB,CAAC,YAAY,UAAW;CACxC,UAAU;AACX;AAED,MAAa,mCAAmC,GAAG,4BAA4B;;;;;;;;QAQvE,CAAC;AACT,MAAa,+CAA+C,IAAIA,wCAAe;CAC7E,gBAAgB;EAAC;EAAY;EAAY;EAAW;CAAe;CACnE,UAAU;AACX"}

package/dist/chains/api/prompts.js

@@ -0,0 +1,36 @@
+import { PromptTemplate } from "@langchain/core/prompts";
+
+//#region src/chains/api/prompts.ts
+const API_URL_RAW_PROMPT_TEMPLATE = `You are given the below API Documentation:
+{api_docs}
+Using this documentation, generate the full API url to call for answering the user question.
+You should build the API url in order to get a response that is as short as possible, while still getting the necessary information to answer the question. Pay attention to deliberately exclude any unnecessary pieces of data in the API call.
+
+Question:{question}
+API url:`;
+const API_URL_PROMPT_TEMPLATE = /* @__PURE__ */ new PromptTemplate({
+	inputVariables: ["api_docs", "question"],
+	template: API_URL_RAW_PROMPT_TEMPLATE
+});
+const API_RESPONSE_RAW_PROMPT_TEMPLATE = `${API_URL_RAW_PROMPT_TEMPLATE} {api_url}
+
+Here is the response from the API:
+
+{api_response}
+
+Summarize this response to answer the original question.
+
+Summary:`;
+const API_RESPONSE_PROMPT_TEMPLATE = /* @__PURE__ */ new PromptTemplate({
+	inputVariables: [
+		"api_docs",
+		"question",
+		"api_url",
+		"api_response"
+	],
+	template: API_RESPONSE_RAW_PROMPT_TEMPLATE
+});
+
+//#endregion
+export { API_RESPONSE_PROMPT_TEMPLATE, API_URL_PROMPT_TEMPLATE };
+//# sourceMappingURL=prompts.js.map

package/dist/chains/api/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","names":[],"sources":["../../../src/chains/api/prompts.ts"],"sourcesContent":["import { PromptTemplate } from \"@langchain/core/prompts\";\n\nexport const API_URL_RAW_PROMPT_TEMPLATE = `You are given the below API Documentation:\n{api_docs}\nUsing this documentation, generate the full API url to call for answering the user question.\nYou should build the API url in order to get a response that is as short as possible, while still getting the necessary information to answer the question. Pay attention to deliberately exclude any unnecessary pieces of data in the API call.\n\nQuestion:{question}\nAPI url:`;\n\nexport const API_URL_PROMPT_TEMPLATE = /* #__PURE__ */ new PromptTemplate({\n  inputVariables: [\"api_docs\", \"question\"],\n  template: API_URL_RAW_PROMPT_TEMPLATE,\n});\n\nexport const API_RESPONSE_RAW_PROMPT_TEMPLATE = `${API_URL_RAW_PROMPT_TEMPLATE} {api_url}\n\nHere is the response from the API:\n\n{api_response}\n\nSummarize this response to answer the original question.\n\nSummary:`;\nexport const API_RESPONSE_PROMPT_TEMPLATE = /* #__PURE__ */ new PromptTemplate({\n  inputVariables: [\"api_docs\", \"question\", \"api_url\", \"api_response\"],\n  template: API_RESPONSE_RAW_PROMPT_TEMPLATE,\n});\n"],"mappings":";;;AAEA,MAAa,8BAA8B,CAAC;;;;;;QAMpC,CAAC;AAET,MAAa,0CAA0C,IAAI,eAAe;CACxE,gBAAgB,CAAC,YAAY,UAAW;CACxC,UAAU;AACX;AAED,MAAa,mCAAmC,GAAG,4BAA4B;;;;;;;;QAQvE,CAAC;AACT,MAAa,+CAA+C,IAAI,eAAe;CAC7E,gBAAgB;EAAC;EAAY;EAAY;EAAW;CAAe;CACnE,UAAU;AACX"}

package/dist/chains/base.cjs

@@ -0,0 +1,180 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const __langchain_core_runnables = require_rolldown_runtime.__toESM(require("@langchain/core/runnables"));
+const __langchain_core_language_models_base = require_rolldown_runtime.__toESM(require("@langchain/core/language_models/base"));
+const __langchain_core_outputs = require_rolldown_runtime.__toESM(require("@langchain/core/outputs"));
+const __langchain_core_callbacks_manager = require_rolldown_runtime.__toESM(require("@langchain/core/callbacks/manager"));
+
+//#region src/chains/base.ts
+/**
+* Base interface that all chains must implement.
+*/
+var BaseChain = class extends __langchain_core_language_models_base.BaseLangChain {
+	get lc_namespace() {
+		return [
+			"langchain",
+			"chains",
+			this._chainType()
+		];
+	}
+	constructor(fields, verbose, callbacks) {
+		if (arguments.length === 1 && typeof fields === "object" && !("saveContext" in fields)) {
+			const { memory, callbackManager,...rest } = fields;
+			super({
+				...rest,
+				callbacks: callbackManager ?? rest.callbacks
+			});
+			this.memory = memory;
+		} else {
+			super({
+				verbose,
+				callbacks
+			});
+			this.memory = fields;
+		}
+	}
+	/** @ignore */
+	_selectMemoryInputs(values) {
+		const valuesForMemory = { ...values };
+		if ("signal" in valuesForMemory) delete valuesForMemory.signal;
+		if ("timeout" in valuesForMemory) delete valuesForMemory.timeout;
+		return valuesForMemory;
+	}
+	/**
+	* Invoke the chain with the provided input and returns the output.
+	* @param input Input values for the chain run.
+	* @param config Optional configuration for the Runnable.
+	* @returns Promise that resolves with the output of the chain run.
+	*/
+	async invoke(input, options) {
+		const config = (0, __langchain_core_runnables.ensureConfig)(options);
+		const fullValues = await this._formatValues(input);
+		const callbackManager_ = await __langchain_core_callbacks_manager.CallbackManager.configure(config?.callbacks, this.callbacks, config?.tags, this.tags, config?.metadata, this.metadata, { verbose: this.verbose });
+		const runManager = await callbackManager_?.handleChainStart(this.toJSON(), fullValues, void 0, void 0, void 0, void 0, config?.runName);
+		let outputValues;
+		try {
+			outputValues = await (fullValues.signal ? Promise.race([this._call(fullValues, runManager, config), new Promise((_, reject) => {
+				fullValues.signal?.addEventListener("abort", () => {
+					reject(/* @__PURE__ */ new Error("AbortError"));
+				});
+			})]) : this._call(fullValues, runManager, config));
+		} catch (e) {
+			await runManager?.handleChainError(e);
+			throw e;
+		}
+		if (!(this.memory == null)) await this.memory.saveContext(this._selectMemoryInputs(input), outputValues);
+		await runManager?.handleChainEnd(outputValues);
+		Object.defineProperty(outputValues, __langchain_core_outputs.RUN_KEY, {
+			value: runManager ? { runId: runManager?.runId } : void 0,
+			configurable: true
+		});
+		return outputValues;
+	}
+	_validateOutputs(outputs) {
+		const missingKeys = this.outputKeys.filter((k) => !(k in outputs));
+		if (missingKeys.length) throw new Error(`Missing output keys: ${missingKeys.join(", ")} from chain ${this._chainType()}`);
+	}
+	async prepOutputs(inputs, outputs, returnOnlyOutputs = false) {
+		this._validateOutputs(outputs);
+		if (this.memory) await this.memory.saveContext(inputs, outputs);
+		if (returnOnlyOutputs) return outputs;
+		return {
+			...inputs,
+			...outputs
+		};
+	}
+	/**
+	* Return a json-like object representing this chain.
+	*/
+	serialize() {
+		throw new Error("Method not implemented.");
+	}
+	/** @deprecated Use .invoke() instead. Will be removed in 0.2.0. */
+	async run(input, config) {
+		const inputKeys = this.inputKeys.filter((k) => !this.memory?.memoryKeys.includes(k));
+		const isKeylessInput = inputKeys.length <= 1;
+		if (!isKeylessInput) throw new Error(`Chain ${this._chainType()} expects multiple inputs, cannot use 'run' `);
+		const values = inputKeys.length ? { [inputKeys[0]]: input } : {};
+		const returnValues = await this.call(values, config);
+		const keys = Object.keys(returnValues);
+		if (keys.length === 1) return returnValues[keys[0]];
+		throw new Error("return values have multiple keys, `run` only supported when one key currently");
+	}
+	async _formatValues(values) {
+		const fullValues = { ...values };
+		if (fullValues.timeout && !fullValues.signal) {
+			fullValues.signal = AbortSignal.timeout(fullValues.timeout);
+			delete fullValues.timeout;
+		}
+		if (!(this.memory == null)) {
+			const newValues = await this.memory.loadMemoryVariables(this._selectMemoryInputs(values));
+			for (const [key, value] of Object.entries(newValues)) fullValues[key] = value;
+		}
+		return fullValues;
+	}
+	/**
+	* @deprecated Use .invoke() instead. Will be removed in 0.2.0.
+	*
+	* Run the core logic of this chain and add to output if desired.
+	*
+	* Wraps _call and handles memory.
+	*/
+	async call(values, config, tags) {
+		const parsedConfig = {
+			tags,
+			...(0, __langchain_core_callbacks_manager.parseCallbackConfigArg)(config)
+		};
+		return this.invoke(values, parsedConfig);
+	}
+	/**
+	* @deprecated Use .batch() instead. Will be removed in 0.2.0.
+	*
+	* Call the chain on all inputs in the list
+	*/
+	async apply(inputs, config) {
+		return Promise.all(inputs.map(async (i, idx) => this.call(i, config?.[idx])));
+	}
+	/**
+	* Load a chain from a json-like object describing it.
+	*/
+	static async deserialize(data, values = {}) {
+		switch (data._type) {
+			case "llm_chain": {
+				const { LLMChain } = await Promise.resolve().then(() => require("./llm_chain.cjs"));
+				return LLMChain.deserialize(data);
+			}
+			case "sequential_chain": {
+				const { SequentialChain } = await Promise.resolve().then(() => require("./sequential_chain.cjs"));
+				return SequentialChain.deserialize(data);
+			}
+			case "simple_sequential_chain": {
+				const { SimpleSequentialChain } = await Promise.resolve().then(() => require("./sequential_chain.cjs"));
+				return SimpleSequentialChain.deserialize(data);
+			}
+			case "stuff_documents_chain": {
+				const { StuffDocumentsChain } = await Promise.resolve().then(() => require("./combine_docs_chain.cjs"));
+				return StuffDocumentsChain.deserialize(data);
+			}
+			case "map_reduce_documents_chain": {
+				const { MapReduceDocumentsChain } = await Promise.resolve().then(() => require("./combine_docs_chain.cjs"));
+				return MapReduceDocumentsChain.deserialize(data);
+			}
+			case "refine_documents_chain": {
+				const { RefineDocumentsChain } = await Promise.resolve().then(() => require("./combine_docs_chain.cjs"));
+				return RefineDocumentsChain.deserialize(data);
+			}
+			case "vector_db_qa": {
+				const { VectorDBQAChain } = await Promise.resolve().then(() => require("./vector_db_qa.cjs"));
+				return VectorDBQAChain.deserialize(data, values);
+			}
+			case "api_chain": {
+				const { APIChain } = await Promise.resolve().then(() => require("./api/api_chain.cjs"));
+				return APIChain.deserialize(data);
+			}
+			default: throw new Error(`Invalid prompt type in config: ${data._type}`);
+		}
+	}
+};
+
+//#endregion
+exports.BaseChain = BaseChain;
+//# sourceMappingURL=base.cjs.map