langchain 0.0.87 → 0.0.89

package/dist/agents/chat_convo/prompt.cjs

@@ -20,7 +20,7 @@ Markdown code snippet formatted in the following schema:
 
 \`\`\`json
 {{{{
-    "action": string // The action to take. Must be one of [{tool_names}]
+    "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.
 }}}}
 \`\`\`
@@ -57,4 +57,4 @@ exports.TEMPLATE_TOOL_RESPONSE = `TOOL RESPONSE:
 USER'S INPUT
 --------------------
 
-Okay, 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.`;
+Okay, so what is the response to my last comment? If using information obtained from the tools you must mention it explicitly without mentioning the tool names - 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.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\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 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.";
+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 last comment? If using information obtained from the tools you must mention it explicitly without mentioning the tool names - 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

@@ -17,7 +17,7 @@ Markdown code snippet formatted in the following schema:
 
 \`\`\`json
 {{{{
-    "action": string // The action to take. Must be one of [{tool_names}]
+    "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.
 }}}}
 \`\`\`
@@ -54,4 +54,4 @@ export const TEMPLATE_TOOL_RESPONSE = `TOOL RESPONSE:
 USER'S INPUT
 --------------------
 
-Okay, 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.`;
+Okay, so what is the response to my last comment? If using information obtained from the tools you must mention it explicitly without mentioning the tool names - 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/structured_chat/outputParser.cjs

@@ -67,9 +67,9 @@ class StructuredChatOutputParserWithRetries extends types_js_1.AgentActionOutput
             fields?.baseParser ?? new StructuredChatOutputParser(this.toolNames);
         this.outputFixingParser = fields?.outputFixingParser;
     }
-    async parse(text) {
+    async parse(text, callbacks) {
         if (this.outputFixingParser !== undefined) {
-            return this.outputFixingParser.parse(text);
+            return this.outputFixingParser.parse(text, callbacks);
         }
         return this.baseParser.parse(text);
     }

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

@@ -2,6 +2,7 @@ import { AgentActionOutputParser } from "../types.js";
 import { OutputFixingParser } from "../../output_parsers/fix.js";
 import { BaseLanguageModel } from "../../base_language/index.js";
 import { AgentAction, AgentFinish } from "../../schema/index.js";
+import { Callbacks } from "../../callbacks/manager.js";
 export declare class StructuredChatOutputParser extends AgentActionOutputParser {
     private toolNames;
     constructor(toolNames: string[]);
@@ -18,7 +19,7 @@ export declare class StructuredChatOutputParserWithRetries extends AgentActionOu
     private outputFixingParser?;
     private toolNames;
     constructor(fields: StructuredChatOutputParserArgs);
-    parse(text: string): Promise<AgentAction | AgentFinish>;
+    parse(text: string, callbacks?: Callbacks): Promise<AgentAction | AgentFinish>;
     getFormatInstructions(): string;
     static fromLLM(llm: BaseLanguageModel, options: Omit<StructuredChatOutputParserArgs, "outputFixingParser">): StructuredChatOutputParserWithRetries;
 }

package/dist/agents/structured_chat/outputParser.js

@@ -63,9 +63,9 @@ export class StructuredChatOutputParserWithRetries extends AgentActionOutputPars
             fields?.baseParser ?? new StructuredChatOutputParser(this.toolNames);
         this.outputFixingParser = fields?.outputFixingParser;
     }
-    async parse(text) {
+    async parse(text, callbacks) {
         if (this.outputFixingParser !== undefined) {
-            return this.outputFixingParser.parse(text);
+            return this.outputFixingParser.parse(text, callbacks);
         }
         return this.baseParser.parse(text);
     }

package/dist/agents/structured_chat/prompt.cjs

@@ -11,7 +11,7 @@ The $JSON_BLOB must be valid, parseable JSON and only contain a SINGLE action. H
 
 \`\`\`json
 {{
-  "action": $TOOL_NAME
+  "action": $TOOL_NAME,
   "action_input": $INPUT
 }}
 \`\`\`

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

@@ -1,4 +1,4 @@
 export declare const PREFIX = "Answer the following questions truthfully and as best you can.";
-export declare const AGENT_ACTION_FORMAT_INSTRUCTIONS = "Output a JSON markdown code snippet containing a valid JSON blob (denoted below by $JSON_BLOB).\nThis $JSON_BLOB must have a \"action\" key (with the name of the tool to use) and an \"action_input\" key (tool input).\n\nValid \"action\" values: \"Final Answer\" (which you must use when giving your final response to the user), or one of [{tool_names}].\n\nThe $JSON_BLOB must be valid, parseable JSON and only contain a SINGLE action. Here is an example of an acceptable output:\n\n```json\n{{\n  \"action\": $TOOL_NAME\n  \"action_input\": $INPUT\n}}\n```\n\nRemember to include the surrounding markdown code snippet delimiters (begin with \"```\" json and close with \"```\")!\n";
+export declare const AGENT_ACTION_FORMAT_INSTRUCTIONS = "Output a JSON markdown code snippet containing a valid JSON blob (denoted below by $JSON_BLOB).\nThis $JSON_BLOB must have a \"action\" key (with the name of the tool to use) and an \"action_input\" key (tool input).\n\nValid \"action\" values: \"Final Answer\" (which you must use when giving your final response to the user), or one of [{tool_names}].\n\nThe $JSON_BLOB must be valid, parseable JSON and only contain a SINGLE action. Here is an example of an acceptable output:\n\n```json\n{{\n  \"action\": $TOOL_NAME,\n  \"action_input\": $INPUT\n}}\n```\n\nRemember to include the surrounding markdown code snippet delimiters (begin with \"```\" json and close with \"```\")!\n";
 export declare const FORMAT_INSTRUCTIONS: string;
 export declare const SUFFIX = "Begin! Reminder to ALWAYS use the above format, and to use tools if appropriate.";

package/dist/agents/structured_chat/prompt.js

@@ -8,7 +8,7 @@ The $JSON_BLOB must be valid, parseable JSON and only contain a SINGLE action. H
 
 \`\`\`json
 {{
-  "action": $TOOL_NAME
+  "action": $TOOL_NAME,
   "action_input": $INPUT
 }}
 \`\`\`

package/dist/chains/query_constructor/index.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadQueryContstructorChain = exports.formatAttributeInfo = exports.StructuredQueryOutputParser = exports.EXAMPLE_PROMPT = exports.DEFAULT_SUFFIX = exports.DEFAULT_SCHEMA = exports.DEFAULT_PREFIX = exports.DEFAULT_EXAMPLES = exports.QueryTransformer = void 0;
+exports.loadQueryConstructorChain = exports.formatAttributeInfo = exports.StructuredQueryOutputParser = exports.EXAMPLE_PROMPT = exports.DEFAULT_SUFFIX = exports.DEFAULT_SCHEMA = exports.DEFAULT_PREFIX = exports.DEFAULT_EXAMPLES = exports.QueryTransformer = void 0;
 const zod_1 = require("zod");
 const parser_js_1 = require("./parser.cjs");
 Object.defineProperty(exports, "QueryTransformer", { enumerable: true, get: function () { return parser_js_1.QueryTransformer; } });
@@ -95,11 +95,11 @@ function _getPrompt(documentContents, attributeInfo, allowedComparators, allowed
         outputParser,
     });
 }
-function loadQueryContstructorChain(opts) {
+function loadQueryConstructorChain(opts) {
     const prompt = _getPrompt(opts.documentContents, opts.attributeInfo, opts.allowedComparators, opts.allowedOperators, opts.examples);
     return new llm_chain_js_1.LLMChain({
         llm: opts.llm,
         prompt,
     });
 }
-exports.loadQueryContstructorChain = loadQueryContstructorChain;
+exports.loadQueryConstructorChain = loadQueryConstructorChain;

package/dist/chains/query_constructor/index.d.ts

@@ -34,4 +34,4 @@ export type QueryConstructorChainOptions = {
     allowedComparators?: Comparator[];
     allowedOperators?: Operator[];
 };
-export declare function loadQueryContstructorChain(opts: QueryConstructorChainOptions): LLMChain<string>;
+export declare function loadQueryConstructorChain(opts: QueryConstructorChainOptions): LLMChain<string>;

package/dist/chains/query_constructor/index.js

@@ -86,7 +86,7 @@ function _getPrompt(documentContents, attributeInfo, allowedComparators, allowed
         outputParser,
     });
 }
-export function loadQueryContstructorChain(opts) {
+export function loadQueryConstructorChain(opts) {
     const prompt = _getPrompt(opts.documentContents, opts.attributeInfo, opts.allowedComparators, opts.allowedOperators, opts.examples);
     return new LLMChain({
         llm: opts.llm,

package/dist/chat_models/openai.cjs

@@ -3,13 +3,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ChatOpenAI = void 0;
+exports.PromptLayerChatOpenAI = exports.ChatOpenAI = void 0;
 const openai_1 = require("openai");
 const env_js_1 = require("../util/env.cjs");
 const axios_fetch_adapter_js_1 = __importDefault(require("../util/axios-fetch-adapter.cjs"));
 const base_js_1 = require("./base.cjs");
 const index_js_1 = require("../schema/index.cjs");
 const count_tokens_js_1 = require("../base_language/count_tokens.cjs");
+const prompt_layer_js_1 = require("../util/prompt-layer.cjs");
 function messageTypeToOpenAIRole(type) {
     switch (type) {
         case "system":
@@ -447,3 +448,112 @@ class ChatOpenAI extends base_js_1.BaseChatModel {
     }
 }
 exports.ChatOpenAI = ChatOpenAI;
+class PromptLayerChatOpenAI extends ChatOpenAI {
+    constructor(fields) {
+        super(fields);
+        Object.defineProperty(this, "promptLayerApiKey", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "plTags", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "returnPromptLayerId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.promptLayerApiKey =
+            fields?.promptLayerApiKey ??
+                (typeof process !== "undefined"
+                    ? // eslint-disable-next-line no-process-env
+                        process.env?.PROMPTLAYER_API_KEY
+                    : undefined);
+        this.plTags = fields?.plTags ?? [];
+        this.returnPromptLayerId = fields?.returnPromptLayerId ?? false;
+    }
+    async _generate(messages, options, runManager) {
+        const requestStartTime = Date.now();
+        let parsedOptions;
+        if (Array.isArray(options)) {
+            parsedOptions = { stop: options };
+        }
+        else if (options?.timeout && !options.signal) {
+            parsedOptions = {
+                ...options,
+                signal: AbortSignal.timeout(options.timeout),
+            };
+        }
+        else {
+            parsedOptions = options ?? {};
+        }
+        const generatedResponses = await super._generate(messages, parsedOptions, runManager);
+        const requestEndTime = Date.now();
+        const _convertMessageToDict = (message) => {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            let messageDict;
+            if (message._getType() === "human") {
+                messageDict = { role: "user", content: message.text };
+            }
+            else if (message._getType() === "ai") {
+                messageDict = { role: "assistant", content: message.text };
+            }
+            else if (message._getType() === "system") {
+                messageDict = { role: "system", content: message.text };
+            }
+            else if (message._getType() === "generic") {
+                messageDict = {
+                    role: message.role,
+                    content: message.text,
+                };
+            }
+            else {
+                throw new Error(`Got unknown type ${message}`);
+            }
+            return messageDict;
+        };
+        const _createMessageDicts = (messages, callOptions) => {
+            const params = {
+                ...this.invocationParams(),
+                model: this.modelName,
+            };
+            if (callOptions?.stop) {
+                if (Object.keys(params).includes("stop")) {
+                    throw new Error("`stop` found in both the input and default params.");
+                }
+            }
+            const messageDicts = messages.map((message) => _convertMessageToDict(message));
+            return messageDicts;
+        };
+        for (let i = 0; i < generatedResponses.generations.length; i += 1) {
+            const generation = generatedResponses.generations[i];
+            const messageDicts = _createMessageDicts(messages, parsedOptions);
+            let promptLayerRequestId;
+            const parsedResp = [
+                {
+                    content: generation.text,
+                    role: messageTypeToOpenAIRole(generation.message._getType()),
+                },
+            ];
+            const promptLayerRespBody = await (0, prompt_layer_js_1.promptLayerTrackRequest)(this.caller, "langchain.PromptLayerChatOpenAI", messageDicts, this._identifyingParams(), this.plTags, parsedResp, requestStartTime, requestEndTime, this.promptLayerApiKey);
+            if (this.returnPromptLayerId === true) {
+                if (promptLayerRespBody.success === true) {
+                    promptLayerRequestId = promptLayerRespBody.request_id;
+                }
+                if (!generation.generationInfo ||
+                    typeof generation.generationInfo !== "object") {
+                    generation.generationInfo = {};
+                }
+                generation.generationInfo.promptLayerRequestId = promptLayerRequestId;
+            }
+        }
+        return generatedResponses;
+    }
+}
+exports.PromptLayerChatOpenAI = PromptLayerChatOpenAI;

package/dist/chat_models/openai.d.ts

@@ -121,3 +121,14 @@ export declare class ChatOpenAI extends BaseChatModel implements OpenAIChatInput
     /** @ignore */
     _combineLLMOutput(...llmOutputs: OpenAILLMOutput[]): OpenAILLMOutput;
 }
+export declare class PromptLayerChatOpenAI extends ChatOpenAI {
+    promptLayerApiKey?: string;
+    plTags?: string[];
+    returnPromptLayerId?: boolean;
+    constructor(fields?: ConstructorParameters<typeof ChatOpenAI>[0] & {
+        promptLayerApiKey?: string;
+        plTags?: string[];
+        returnPromptLayerId?: boolean;
+    });
+    _generate(messages: BaseChatMessage[], options?: string[] | this["CallOptions"], runManager?: CallbackManagerForLLMRun): Promise<ChatResult>;
+}

package/dist/chat_models/openai.js

@@ -4,6 +4,7 @@ import fetchAdapter from "../util/axios-fetch-adapter.js";
 import { BaseChatModel } from "./base.js";
 import { AIChatMessage, ChatMessage, HumanChatMessage, SystemChatMessage, } from "../schema/index.js";
 import { getModelNameForTiktoken } from "../base_language/count_tokens.js";
+import { promptLayerTrackRequest } from "../util/prompt-layer.js";
 function messageTypeToOpenAIRole(type) {
     switch (type) {
         case "system":
@@ -440,3 +441,111 @@ export class ChatOpenAI extends BaseChatModel {
         });
     }
 }
+export class PromptLayerChatOpenAI extends ChatOpenAI {
+    constructor(fields) {
+        super(fields);
+        Object.defineProperty(this, "promptLayerApiKey", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "plTags", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "returnPromptLayerId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.promptLayerApiKey =
+            fields?.promptLayerApiKey ??
+                (typeof process !== "undefined"
+                    ? // eslint-disable-next-line no-process-env
+                        process.env?.PROMPTLAYER_API_KEY
+                    : undefined);
+        this.plTags = fields?.plTags ?? [];
+        this.returnPromptLayerId = fields?.returnPromptLayerId ?? false;
+    }
+    async _generate(messages, options, runManager) {
+        const requestStartTime = Date.now();
+        let parsedOptions;
+        if (Array.isArray(options)) {
+            parsedOptions = { stop: options };
+        }
+        else if (options?.timeout && !options.signal) {
+            parsedOptions = {
+                ...options,
+                signal: AbortSignal.timeout(options.timeout),
+            };
+        }
+        else {
+            parsedOptions = options ?? {};
+        }
+        const generatedResponses = await super._generate(messages, parsedOptions, runManager);
+        const requestEndTime = Date.now();
+        const _convertMessageToDict = (message) => {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            let messageDict;
+            if (message._getType() === "human") {
+                messageDict = { role: "user", content: message.text };
+            }
+            else if (message._getType() === "ai") {
+                messageDict = { role: "assistant", content: message.text };
+            }
+            else if (message._getType() === "system") {
+                messageDict = { role: "system", content: message.text };
+            }
+            else if (message._getType() === "generic") {
+                messageDict = {
+                    role: message.role,
+                    content: message.text,
+                };
+            }
+            else {
+                throw new Error(`Got unknown type ${message}`);
+            }
+            return messageDict;
+        };
+        const _createMessageDicts = (messages, callOptions) => {
+            const params = {
+                ...this.invocationParams(),
+                model: this.modelName,
+            };
+            if (callOptions?.stop) {
+                if (Object.keys(params).includes("stop")) {
+                    throw new Error("`stop` found in both the input and default params.");
+                }
+            }
+            const messageDicts = messages.map((message) => _convertMessageToDict(message));
+            return messageDicts;
+        };
+        for (let i = 0; i < generatedResponses.generations.length; i += 1) {
+            const generation = generatedResponses.generations[i];
+            const messageDicts = _createMessageDicts(messages, parsedOptions);
+            let promptLayerRequestId;
+            const parsedResp = [
+                {
+                    content: generation.text,
+                    role: messageTypeToOpenAIRole(generation.message._getType()),
+                },
+            ];
+            const promptLayerRespBody = await promptLayerTrackRequest(this.caller, "langchain.PromptLayerChatOpenAI", messageDicts, this._identifyingParams(), this.plTags, parsedResp, requestStartTime, requestEndTime, this.promptLayerApiKey);
+            if (this.returnPromptLayerId === true) {
+                if (promptLayerRespBody.success === true) {
+                    promptLayerRequestId = promptLayerRespBody.request_id;
+                }
+                if (!generation.generationInfo ||
+                    typeof generation.generationInfo !== "object") {
+                    generation.generationInfo = {};
+                }
+                generation.generationInfo.promptLayerRequestId = promptLayerRequestId;
+            }
+        }
+        return generatedResponses;
+    }
+}

package/dist/document_loaders/fs/unstructured.cjs

@@ -16,10 +16,16 @@ const UNSTRUCTURED_API_FILETYPES = [
     ".jpeg",
     ".eml",
     ".html",
+    ".htm",
     ".md",
     ".pptx",
     ".ppt",
     ".msg",
+    ".rtf",
+    ".xlsx",
+    ".xls",
+    ".odt",
+    ".epub",
 ];
 class UnstructuredLoader extends base_js_1.BaseDocumentLoader {
     constructor(filePathOrLegacyApiUrl, optionsOrLegacyFilePath = {}) {

package/dist/document_loaders/fs/unstructured.js

@@ -12,10 +12,16 @@ const UNSTRUCTURED_API_FILETYPES = [
     ".jpeg",
     ".eml",
     ".html",
+    ".htm",
     ".md",
     ".pptx",
     ".ppt",
     ".msg",
+    ".rtf",
+    ".xlsx",
+    ".xls",
+    ".odt",
+    ".epub",
 ];
 export class UnstructuredLoader extends BaseDocumentLoader {
     constructor(filePathOrLegacyApiUrl, optionsOrLegacyFilePath = {}) {