@librechat/agents 3.2.31 → 3.2.33

package/dist/cjs/common/enum.cjs

@@ -1,253 +1,246 @@
-'use strict';
-
+//#region src/common/enum.ts
 /**
- * Enum representing the various event types emitted during the execution of runnables.
- * These events provide real-time information about the progress and state of different components.
- *
- * @enum {string}
- */
-exports.GraphEvents = void 0;
-(function (GraphEvents) {
-    /* Custom Events */
-    /** [Custom] Agent update event in multi-agent graph/workflow */
-    GraphEvents["ON_AGENT_UPDATE"] = "on_agent_update";
-    /** [Custom] Delta event for run steps (message creation and tool calls) */
-    GraphEvents["ON_RUN_STEP"] = "on_run_step";
-    /** [Custom] Delta event for run steps (tool calls) */
-    GraphEvents["ON_RUN_STEP_DELTA"] = "on_run_step_delta";
-    /** [Custom] Completed event for run steps (tool calls) */
-    GraphEvents["ON_RUN_STEP_COMPLETED"] = "on_run_step_completed";
-    /** [Custom] Delta events for messages */
-    GraphEvents["ON_MESSAGE_DELTA"] = "on_message_delta";
-    /** [Custom] Reasoning Delta events for messages */
-    GraphEvents["ON_REASONING_DELTA"] = "on_reasoning_delta";
-    /** [Custom] Request to execute tools - dispatched by ToolNode, handled by host */
-    GraphEvents["ON_TOOL_EXECUTE"] = "on_tool_execute";
-    /** [Custom] Emitted when the summarize node begins generating a summary */
-    GraphEvents["ON_SUMMARIZE_START"] = "on_summarize_start";
-    /** [Custom] Delta event carrying the completed summary content */
-    GraphEvents["ON_SUMMARIZE_DELTA"] = "on_summarize_delta";
-    /** [Custom] Emitted when the summarize node completes with the final summary */
-    GraphEvents["ON_SUMMARIZE_COMPLETE"] = "on_summarize_complete";
-    /** [Custom] Progress update from a running subagent (wraps child-graph events so hosts can display activity separately from parent). */
-    GraphEvents["ON_SUBAGENT_UPDATE"] = "on_subagent_update";
-    /** [Custom] Diagnostic logging event for context management observability */
-    GraphEvents["ON_AGENT_LOG"] = "on_agent_log";
-    /* Official Events */
-    /** Custom event, emitted by system */
-    GraphEvents["ON_CUSTOM_EVENT"] = "on_custom_event";
-    /** Emitted when a chat model starts processing. */
-    GraphEvents["CHAT_MODEL_START"] = "on_chat_model_start";
-    /** Emitted when a chat model streams a chunk of its response. */
-    GraphEvents["CHAT_MODEL_STREAM"] = "on_chat_model_stream";
-    /** Emitted when a chat model completes its processing. */
-    GraphEvents["CHAT_MODEL_END"] = "on_chat_model_end";
-    /** Emitted when a language model starts processing. */
-    GraphEvents["LLM_START"] = "on_llm_start";
-    /** Emitted when a language model streams a chunk of its response. */
-    GraphEvents["LLM_STREAM"] = "on_llm_stream";
-    /** Emitted when a language model completes its processing. */
-    GraphEvents["LLM_END"] = "on_llm_end";
-    /** Emitted when a chain starts processing. */
-    GraphEvents["CHAIN_START"] = "on_chain_start";
-    /** Emitted when a chain streams a chunk of its output. */
-    GraphEvents["CHAIN_STREAM"] = "on_chain_stream";
-    /** Emitted when a chain completes its processing. */
-    GraphEvents["CHAIN_END"] = "on_chain_end";
-    /** Emitted when a tool starts its operation. */
-    GraphEvents["TOOL_START"] = "on_tool_start";
-    /** Emitted when a tool completes its operation. */
-    GraphEvents["TOOL_END"] = "on_tool_end";
-    /** Emitted when a retriever starts its operation. */
-    GraphEvents["RETRIEVER_START"] = "on_retriever_start";
-    /** Emitted when a retriever completes its operation. */
-    GraphEvents["RETRIEVER_END"] = "on_retriever_end";
-    /** Emitted when a prompt starts processing. */
-    GraphEvents["PROMPT_START"] = "on_prompt_start";
-    /** Emitted when a prompt completes its processing. */
-    GraphEvents["PROMPT_END"] = "on_prompt_end";
-})(exports.GraphEvents || (exports.GraphEvents = {}));
-exports.Providers = void 0;
-(function (Providers) {
-    Providers["OPENAI"] = "openAI";
-    Providers["VERTEXAI"] = "vertexai";
-    Providers["BEDROCK"] = "bedrock";
-    Providers["ANTHROPIC"] = "anthropic";
-    Providers["MISTRALAI"] = "mistralai";
-    Providers["MISTRAL"] = "mistral";
-    Providers["GOOGLE"] = "google";
-    Providers["AZURE"] = "azureOpenAI";
-    Providers["DEEPSEEK"] = "deepseek";
-    Providers["OPENROUTER"] = "openrouter";
-    Providers["XAI"] = "xai";
-    Providers["MOONSHOT"] = "moonshot";
-})(exports.Providers || (exports.Providers = {}));
-exports.GraphNodeKeys = void 0;
-(function (GraphNodeKeys) {
-    GraphNodeKeys["TOOLS"] = "tools=";
-    GraphNodeKeys["AGENT"] = "agent=";
-    GraphNodeKeys["SUMMARIZE"] = "summarize=";
-    GraphNodeKeys["ROUTER"] = "router";
-    GraphNodeKeys["PRE_TOOLS"] = "pre_tools";
-    GraphNodeKeys["POST_TOOLS"] = "post_tools";
-})(exports.GraphNodeKeys || (exports.GraphNodeKeys = {}));
-exports.GraphNodeActions = void 0;
-(function (GraphNodeActions) {
-    GraphNodeActions["TOOL_NODE"] = "tool_node";
-    GraphNodeActions["CALL_MODEL"] = "call_model";
-    GraphNodeActions["ROUTE_MESSAGE"] = "route_message";
-})(exports.GraphNodeActions || (exports.GraphNodeActions = {}));
-exports.CommonEvents = void 0;
-(function (CommonEvents) {
-    CommonEvents["LANGGRAPH"] = "LangGraph";
-})(exports.CommonEvents || (exports.CommonEvents = {}));
-exports.StepTypes = void 0;
-(function (StepTypes) {
-    StepTypes["TOOL_CALLS"] = "tool_calls";
-    StepTypes["MESSAGE_CREATION"] = "message_creation";
-})(exports.StepTypes || (exports.StepTypes = {}));
-exports.ContentTypes = void 0;
-(function (ContentTypes) {
-    ContentTypes["TEXT"] = "text";
-    ContentTypes["ERROR"] = "error";
-    ContentTypes["THINK"] = "think";
-    ContentTypes["TOOL_CALL"] = "tool_call";
-    ContentTypes["IMAGE_URL"] = "image_url";
-    ContentTypes["IMAGE_FILE"] = "image_file";
-    /** Anthropic */
-    ContentTypes["THINKING"] = "thinking";
-    /** Vertex AI / Google Common */
-    ContentTypes["REASONING"] = "reasoning";
-    /** Multi-Agent Switch */
-    ContentTypes["AGENT_UPDATE"] = "agent_update";
-    /** Framework-level conversation summary block */
-    ContentTypes["SUMMARY"] = "summary";
-    /** Bedrock */
-    ContentTypes["REASONING_CONTENT"] = "reasoning_content";
-})(exports.ContentTypes || (exports.ContentTypes = {}));
-exports.ToolCallTypes = void 0;
-(function (ToolCallTypes) {
-    ToolCallTypes["FUNCTION"] = "function";
-    ToolCallTypes["RETRIEVAL"] = "retrieval";
-    ToolCallTypes["FILE_SEARCH"] = "file_search";
-    ToolCallTypes["CODE_INTERPRETER"] = "code_interpreter";
-    /* Agents Tool Call */
-    ToolCallTypes["TOOL_CALL"] = "tool_call";
-})(exports.ToolCallTypes || (exports.ToolCallTypes = {}));
-exports.Callback = void 0;
-(function (Callback) {
-    Callback["TOOL_ERROR"] = "handleToolError";
-    Callback["TOOL_START"] = "handleToolStart";
-    Callback["TOOL_END"] = "handleToolEnd";
-    Callback["CUSTOM_EVENT"] = "handleCustomEvent";
-    /*
-    LLM_START = 'handleLLMStart',
-    LLM_NEW_TOKEN = 'handleLLMNewToken',
-    LLM_ERROR = 'handleLLMError',
-    LLM_END = 'handleLLMEnd',
-    CHAT_MODEL_START = 'handleChatModelStart',
-    CHAIN_START = 'handleChainStart',
-    CHAIN_ERROR = 'handleChainError',
-    CHAIN_END = 'handleChainEnd',
-    TEXT = 'handleText',
-    AGENT_ACTION = 'handleAgentAction',
-    AGENT_END = 'handleAgentEnd',
-    RETRIEVER_START = 'handleRetrieverStart',
-    RETRIEVER_END = 'handleRetrieverEnd',
-    RETRIEVER_ERROR = 'handleRetrieverError',
-    */
-})(exports.Callback || (exports.Callback = {}));
-exports.Constants = void 0;
-(function (Constants) {
-    Constants["OFFICIAL_CODE_BASEURL"] = "https://api.librechat.ai/v1";
-    Constants["EXECUTE_CODE"] = "execute_code";
-    Constants["TOOL_SEARCH"] = "tool_search";
-    Constants["PROGRAMMATIC_TOOL_CALLING"] = "run_tools_with_code";
-    Constants["WEB_SEARCH"] = "web_search";
-    Constants["CONTENT_AND_ARTIFACT"] = "content_and_artifact";
-    Constants["LC_TRANSFER_TO_"] = "lc_transfer_to_";
-    /** Delimiter for MCP tools: toolName_mcp_serverName */
-    Constants["MCP_DELIMITER"] = "_mcp_";
-    /** Anthropic server tool ID prefix (web_search, code_execution, etc.) */
-    Constants["ANTHROPIC_SERVER_TOOL_PREFIX"] = "srvtoolu_";
-    Constants["SKILL_TOOL"] = "skill";
-    Constants["READ_FILE"] = "read_file";
-    Constants["BASH_TOOL"] = "bash_tool";
-    Constants["BASH_PROGRAMMATIC_TOOL_CALLING"] = "run_tools_with_bash";
-    Constants["SUBAGENT"] = "subagent";
-    /**
-     * Local-engine coding tool names. Promoted to `Constants.*` (rather
-     * than left as per-file `*ToolName` consts) so consumer UIs — most
-     * importantly LibreChat's `getToolIconType` map — can match against
-     * canonical strings instead of guessing. Existing matched names:
-     * `bash_tool`, `read_file`, `execute_code`, `run_tools_with_code`.
-     * The rest below are new and currently fall through to the generic
-     * tool icon; once LibreChat adds icons keyed on the same names, the
-     * wiring will work without an SDK change.
-     */
-    Constants["WRITE_FILE"] = "write_file";
-    Constants["EDIT_FILE"] = "edit_file";
-    Constants["GREP_SEARCH"] = "grep_search";
-    Constants["GLOB_SEARCH"] = "glob_search";
-    Constants["LIST_DIRECTORY"] = "list_directory";
-    Constants["COMPILE_CHECK"] = "compile_check";
-})(exports.Constants || (exports.Constants = {}));
+* Enum representing the various event types emitted during the execution of runnables.
+* These events provide real-time information about the progress and state of different components.
+*
+* @enum {string}
+*/
+let GraphEvents = /* @__PURE__ */ function(GraphEvents) {
+	/** [Custom] Agent update event in multi-agent graph/workflow */
+	GraphEvents["ON_AGENT_UPDATE"] = "on_agent_update";
+	/** [Custom] Delta event for run steps (message creation and tool calls) */
+	GraphEvents["ON_RUN_STEP"] = "on_run_step";
+	/** [Custom] Delta event for run steps (tool calls) */
+	GraphEvents["ON_RUN_STEP_DELTA"] = "on_run_step_delta";
+	/** [Custom] Completed event for run steps (tool calls) */
+	GraphEvents["ON_RUN_STEP_COMPLETED"] = "on_run_step_completed";
+	/** [Custom] Delta events for messages */
+	GraphEvents["ON_MESSAGE_DELTA"] = "on_message_delta";
+	/** [Custom] Reasoning Delta events for messages */
+	GraphEvents["ON_REASONING_DELTA"] = "on_reasoning_delta";
+	/** [Custom] Request to execute tools - dispatched by ToolNode, handled by host */
+	GraphEvents["ON_TOOL_EXECUTE"] = "on_tool_execute";
+	/** [Custom] Emitted when the summarize node begins generating a summary */
+	GraphEvents["ON_SUMMARIZE_START"] = "on_summarize_start";
+	/** [Custom] Delta event carrying the completed summary content */
+	GraphEvents["ON_SUMMARIZE_DELTA"] = "on_summarize_delta";
+	/** [Custom] Emitted when the summarize node completes with the final summary */
+	GraphEvents["ON_SUMMARIZE_COMPLETE"] = "on_summarize_complete";
+	/** [Custom] Progress update from a running subagent (wraps child-graph events so hosts can display activity separately from parent). */
+	GraphEvents["ON_SUBAGENT_UPDATE"] = "on_subagent_update";
+	/** [Custom] Diagnostic logging event for context management observability */
+	GraphEvents["ON_AGENT_LOG"] = "on_agent_log";
+	/** Custom event, emitted by system */
+	GraphEvents["ON_CUSTOM_EVENT"] = "on_custom_event";
+	/** Emitted when a chat model starts processing. */
+	GraphEvents["CHAT_MODEL_START"] = "on_chat_model_start";
+	/** Emitted when a chat model streams a chunk of its response. */
+	GraphEvents["CHAT_MODEL_STREAM"] = "on_chat_model_stream";
+	/** Emitted when a chat model completes its processing. */
+	GraphEvents["CHAT_MODEL_END"] = "on_chat_model_end";
+	/** Emitted when a language model starts processing. */
+	GraphEvents["LLM_START"] = "on_llm_start";
+	/** Emitted when a language model streams a chunk of its response. */
+	GraphEvents["LLM_STREAM"] = "on_llm_stream";
+	/** Emitted when a language model completes its processing. */
+	GraphEvents["LLM_END"] = "on_llm_end";
+	/** Emitted when a chain starts processing. */
+	GraphEvents["CHAIN_START"] = "on_chain_start";
+	/** Emitted when a chain streams a chunk of its output. */
+	GraphEvents["CHAIN_STREAM"] = "on_chain_stream";
+	/** Emitted when a chain completes its processing. */
+	GraphEvents["CHAIN_END"] = "on_chain_end";
+	/** Emitted when a tool starts its operation. */
+	GraphEvents["TOOL_START"] = "on_tool_start";
+	/** Emitted when a tool completes its operation. */
+	GraphEvents["TOOL_END"] = "on_tool_end";
+	/** Emitted when a retriever starts its operation. */
+	GraphEvents["RETRIEVER_START"] = "on_retriever_start";
+	/** Emitted when a retriever completes its operation. */
+	GraphEvents["RETRIEVER_END"] = "on_retriever_end";
+	/** Emitted when a prompt starts processing. */
+	GraphEvents["PROMPT_START"] = "on_prompt_start";
+	/** Emitted when a prompt completes its processing. */
+	GraphEvents["PROMPT_END"] = "on_prompt_end";
+	return GraphEvents;
+}({});
+let Providers = /* @__PURE__ */ function(Providers) {
+	Providers["OPENAI"] = "openAI";
+	Providers["VERTEXAI"] = "vertexai";
+	Providers["BEDROCK"] = "bedrock";
+	Providers["ANTHROPIC"] = "anthropic";
+	Providers["MISTRALAI"] = "mistralai";
+	Providers["MISTRAL"] = "mistral";
+	Providers["GOOGLE"] = "google";
+	Providers["AZURE"] = "azureOpenAI";
+	Providers["DEEPSEEK"] = "deepseek";
+	Providers["OPENROUTER"] = "openrouter";
+	Providers["XAI"] = "xai";
+	Providers["MOONSHOT"] = "moonshot";
+	return Providers;
+}({});
+let GraphNodeKeys = /* @__PURE__ */ function(GraphNodeKeys) {
+	GraphNodeKeys["TOOLS"] = "tools=";
+	GraphNodeKeys["AGENT"] = "agent=";
+	GraphNodeKeys["SUMMARIZE"] = "summarize=";
+	GraphNodeKeys["ROUTER"] = "router";
+	GraphNodeKeys["PRE_TOOLS"] = "pre_tools";
+	GraphNodeKeys["POST_TOOLS"] = "post_tools";
+	return GraphNodeKeys;
+}({});
+let GraphNodeActions = /* @__PURE__ */ function(GraphNodeActions) {
+	GraphNodeActions["TOOL_NODE"] = "tool_node";
+	GraphNodeActions["CALL_MODEL"] = "call_model";
+	GraphNodeActions["ROUTE_MESSAGE"] = "route_message";
+	return GraphNodeActions;
+}({});
+let CommonEvents = /* @__PURE__ */ function(CommonEvents) {
+	CommonEvents["LANGGRAPH"] = "LangGraph";
+	return CommonEvents;
+}({});
+let StepTypes = /* @__PURE__ */ function(StepTypes) {
+	StepTypes["TOOL_CALLS"] = "tool_calls";
+	StepTypes["MESSAGE_CREATION"] = "message_creation";
+	return StepTypes;
+}({});
+let ContentTypes = /* @__PURE__ */ function(ContentTypes) {
+	ContentTypes["TEXT"] = "text";
+	ContentTypes["ERROR"] = "error";
+	ContentTypes["THINK"] = "think";
+	ContentTypes["TOOL_CALL"] = "tool_call";
+	ContentTypes["IMAGE_URL"] = "image_url";
+	ContentTypes["IMAGE_FILE"] = "image_file";
+	/** Anthropic */
+	ContentTypes["THINKING"] = "thinking";
+	/** Vertex AI / Google Common */
+	ContentTypes["REASONING"] = "reasoning";
+	/** Multi-Agent Switch */
+	ContentTypes["AGENT_UPDATE"] = "agent_update";
+	/** Framework-level conversation summary block */
+	ContentTypes["SUMMARY"] = "summary";
+	/** Bedrock */
+	ContentTypes["REASONING_CONTENT"] = "reasoning_content";
+	return ContentTypes;
+}({});
+let ToolCallTypes = /* @__PURE__ */ function(ToolCallTypes) {
+	ToolCallTypes["FUNCTION"] = "function";
+	ToolCallTypes["RETRIEVAL"] = "retrieval";
+	ToolCallTypes["FILE_SEARCH"] = "file_search";
+	ToolCallTypes["CODE_INTERPRETER"] = "code_interpreter";
+	ToolCallTypes["TOOL_CALL"] = "tool_call";
+	return ToolCallTypes;
+}({});
+let Callback = /* @__PURE__ */ function(Callback) {
+	Callback["TOOL_ERROR"] = "handleToolError";
+	Callback["TOOL_START"] = "handleToolStart";
+	Callback["TOOL_END"] = "handleToolEnd";
+	Callback["CUSTOM_EVENT"] = "handleCustomEvent";
+	return Callback;
+}({});
+let Constants = /* @__PURE__ */ function(Constants) {
+	Constants["OFFICIAL_CODE_BASEURL"] = "https://api.librechat.ai/v1";
+	Constants["EXECUTE_CODE"] = "execute_code";
+	Constants["TOOL_SEARCH"] = "tool_search";
+	Constants["PROGRAMMATIC_TOOL_CALLING"] = "run_tools_with_code";
+	Constants["WEB_SEARCH"] = "web_search";
+	Constants["CONTENT_AND_ARTIFACT"] = "content_and_artifact";
+	Constants["LC_TRANSFER_TO_"] = "lc_transfer_to_";
+	/** Delimiter for MCP tools: toolName_mcp_serverName */
+	Constants["MCP_DELIMITER"] = "_mcp_";
+	/** Anthropic server tool ID prefix (web_search, code_execution, etc.) */
+	Constants["ANTHROPIC_SERVER_TOOL_PREFIX"] = "srvtoolu_";
+	Constants["SKILL_TOOL"] = "skill";
+	Constants["READ_FILE"] = "read_file";
+	Constants["BASH_TOOL"] = "bash_tool";
+	Constants["BASH_PROGRAMMATIC_TOOL_CALLING"] = "run_tools_with_bash";
+	Constants["SUBAGENT"] = "subagent";
+	/**
+	* Local-engine coding tool names. Promoted to `Constants.*` (rather
+	* than left as per-file `*ToolName` consts) so consumer UIs — most
+	* importantly LibreChat's `getToolIconType` map — can match against
+	* canonical strings instead of guessing. Existing matched names:
+	* `bash_tool`, `read_file`, `execute_code`, `run_tools_with_code`.
+	* The rest below are new and currently fall through to the generic
+	* tool icon; once LibreChat adds icons keyed on the same names, the
+	* wiring will work without an SDK change.
+	*/
+	Constants["WRITE_FILE"] = "write_file";
+	Constants["EDIT_FILE"] = "edit_file";
+	Constants["GREP_SEARCH"] = "grep_search";
+	Constants["GLOB_SEARCH"] = "glob_search";
+	Constants["LIST_DIRECTORY"] = "list_directory";
+	Constants["COMPILE_CHECK"] = "compile_check";
+	return Constants;
+}({});
 /** Tool names that use the code execution environment (shared session, file tracking). */
 const CODE_EXECUTION_TOOLS = new Set([
-    exports.Constants.EXECUTE_CODE,
-    exports.Constants.BASH_TOOL,
-    exports.Constants.PROGRAMMATIC_TOOL_CALLING,
-    exports.Constants.BASH_PROGRAMMATIC_TOOL_CALLING,
+	"execute_code",
+	"bash_tool",
+	"run_tools_with_code",
+	"run_tools_with_bash"
 ]);
 /**
- * Canonical names of the local-engine-specific coding tools — the
- * file/edit/search/typecheck surface that doesn't exist in the
- * remote (sandbox-API) engine. Single source of truth; the per-tool
- * factories, registry definitions, and `createWorkspacePolicyHook`
- * default extractors all key off these.
- *
- * `read_file` is on this list (the existing ReadFile tool is
- * remote-specific; the local engine's `read_file` is a parallel
- * implementation that shares the canonical name so consumer UIs
- * — most importantly LibreChat's `getToolIconType` — render both
- * with the same icon).
- */
+* Canonical names of the local-engine-specific coding tools — the
+* file/edit/search/typecheck surface that doesn't exist in the
+* remote (sandbox-API) engine. Single source of truth; the per-tool
+* factories, registry definitions, and `createWorkspacePolicyHook`
+* default extractors all key off these.
+*
+* `read_file` is on this list (the existing ReadFile tool is
+* remote-specific; the local engine's `read_file` is a parallel
+* implementation that shares the canonical name so consumer UIs
+* — most importantly LibreChat's `getToolIconType` — render both
+* with the same icon).
+*/
 const LOCAL_CODING_TOOL_NAMES = [
-    exports.Constants.READ_FILE,
-    exports.Constants.WRITE_FILE,
-    exports.Constants.EDIT_FILE,
-    exports.Constants.GREP_SEARCH,
-    exports.Constants.GLOB_SEARCH,
-    exports.Constants.LIST_DIRECTORY,
-    exports.Constants.COMPILE_CHECK,
+	"read_file",
+	"write_file",
+	"edit_file",
+	"grep_search",
+	"glob_search",
+	"list_directory",
+	"compile_check"
 ];
 /**
- * Every tool name the local coding bundle (`createLocalCodingTools`)
- * exposes — the local-specific tools above plus the bash/code/PTC
- * pair that the local engine wraps around the existing factories.
- * Tests pin against this so any addition/removal in the bundle is
- * accompanied by a deliberate canonical-name update here.
- */
+* Every tool name the local coding bundle (`createLocalCodingTools`)
+* exposes — the local-specific tools above plus the bash/code/PTC
+* pair that the local engine wraps around the existing factories.
+* Tests pin against this so any addition/removal in the bundle is
+* accompanied by a deliberate canonical-name update here.
+*/
 const LOCAL_CODING_BUNDLE_NAMES = [
-    ...LOCAL_CODING_TOOL_NAMES,
-    exports.Constants.BASH_TOOL,
-    exports.Constants.EXECUTE_CODE,
-    exports.Constants.PROGRAMMATIC_TOOL_CALLING,
-    exports.Constants.BASH_PROGRAMMATIC_TOOL_CALLING,
+	...LOCAL_CODING_TOOL_NAMES,
+	"bash_tool",
+	"execute_code",
+	"run_tools_with_code",
+	"run_tools_with_bash"
 ];
-exports.TitleMethod = void 0;
-(function (TitleMethod) {
-    TitleMethod["STRUCTURED"] = "structured";
-    TitleMethod["FUNCTIONS"] = "functions";
-    TitleMethod["COMPLETION"] = "completion";
-})(exports.TitleMethod || (exports.TitleMethod = {}));
-exports.EnvVar = void 0;
-(function (EnvVar) {
-    EnvVar["CODE_BASEURL"] = "LIBRECHAT_CODE_BASEURL";
-    EnvVar["CODE_API_RUN_TIMEOUT_MS"] = "CODE_API_RUN_TIMEOUT_MS";
-})(exports.EnvVar || (exports.EnvVar = {}));
-
+let TitleMethod = /* @__PURE__ */ function(TitleMethod) {
+	TitleMethod["STRUCTURED"] = "structured";
+	TitleMethod["FUNCTIONS"] = "functions";
+	TitleMethod["COMPLETION"] = "completion";
+	return TitleMethod;
+}({});
+let EnvVar = /* @__PURE__ */ function(EnvVar) {
+	EnvVar["CODE_BASEURL"] = "LIBRECHAT_CODE_BASEURL";
+	EnvVar["CODE_API_RUN_TIMEOUT_MS"] = "CODE_API_RUN_TIMEOUT_MS";
+	return EnvVar;
+}({});
+//#endregion
 exports.CODE_EXECUTION_TOOLS = CODE_EXECUTION_TOOLS;
+exports.Callback = Callback;
+exports.CommonEvents = CommonEvents;
+exports.Constants = Constants;
+exports.ContentTypes = ContentTypes;
+exports.EnvVar = EnvVar;
+exports.GraphEvents = GraphEvents;
+exports.GraphNodeActions = GraphNodeActions;
+exports.GraphNodeKeys = GraphNodeKeys;
 exports.LOCAL_CODING_BUNDLE_NAMES = LOCAL_CODING_BUNDLE_NAMES;
 exports.LOCAL_CODING_TOOL_NAMES = LOCAL_CODING_TOOL_NAMES;
-//# sourceMappingURL=enum.cjs.map
+exports.Providers = Providers;
+exports.StepTypes = StepTypes;
+exports.TitleMethod = TitleMethod;
+exports.ToolCallTypes = ToolCallTypes;
+
+//# sourceMappingURL=enum.cjs.map

package/dist/cjs/common/enum.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"enum.cjs","sources":["../../../src/common/enum.ts"],"sourcesContent":["/**\n * Enum representing the various event types emitted during the execution of runnables.\n * These events provide real-time information about the progress and state of different components.\n *\n * @enum {string}\n */\nexport enum GraphEvents {\n  /* Custom Events */\n\n  /** [Custom] Agent update event in multi-agent graph/workflow */\n  ON_AGENT_UPDATE = 'on_agent_update',\n  /** [Custom] Delta event for run steps (message creation and tool calls) */\n  ON_RUN_STEP = 'on_run_step',\n  /** [Custom] Delta event for run steps (tool calls) */\n  ON_RUN_STEP_DELTA = 'on_run_step_delta',\n  /** [Custom] Completed event for run steps (tool calls) */\n  ON_RUN_STEP_COMPLETED = 'on_run_step_completed',\n  /** [Custom] Delta events for messages */\n  ON_MESSAGE_DELTA = 'on_message_delta',\n  /** [Custom] Reasoning Delta events for messages */\n  ON_REASONING_DELTA = 'on_reasoning_delta',\n  /** [Custom] Request to execute tools - dispatched by ToolNode, handled by host */\n  ON_TOOL_EXECUTE = 'on_tool_execute',\n  /** [Custom] Emitted when the summarize node begins generating a summary */\n  ON_SUMMARIZE_START = 'on_summarize_start',\n  /** [Custom] Delta event carrying the completed summary content */\n  ON_SUMMARIZE_DELTA = 'on_summarize_delta',\n  /** [Custom] Emitted when the summarize node completes with the final summary */\n  ON_SUMMARIZE_COMPLETE = 'on_summarize_complete',\n  /** [Custom] Progress update from a running subagent (wraps child-graph events so hosts can display activity separately from parent). */\n  ON_SUBAGENT_UPDATE = 'on_subagent_update',\n  /** [Custom] Diagnostic logging event for context management observability */\n  ON_AGENT_LOG = 'on_agent_log',\n\n  /* Official Events */\n\n  /** Custom event, emitted by system */\n  ON_CUSTOM_EVENT = 'on_custom_event',\n  /** Emitted when a chat model starts processing. */\n  CHAT_MODEL_START = 'on_chat_model_start',\n\n  /** Emitted when a chat model streams a chunk of its response. */\n  CHAT_MODEL_STREAM = 'on_chat_model_stream',\n\n  /** Emitted when a chat model completes its processing. */\n  CHAT_MODEL_END = 'on_chat_model_end',\n\n  /** Emitted when a language model starts processing. */\n  LLM_START = 'on_llm_start',\n\n  /** Emitted when a language model streams a chunk of its response. */\n  LLM_STREAM = 'on_llm_stream',\n\n  /** Emitted when a language model completes its processing. */\n  LLM_END = 'on_llm_end',\n\n  /** Emitted when a chain starts processing. */\n  CHAIN_START = 'on_chain_start',\n\n  /** Emitted when a chain streams a chunk of its output. */\n  CHAIN_STREAM = 'on_chain_stream',\n\n  /** Emitted when a chain completes its processing. */\n  CHAIN_END = 'on_chain_end',\n\n  /** Emitted when a tool starts its operation. */\n  TOOL_START = 'on_tool_start',\n\n  /** Emitted when a tool completes its operation. */\n  TOOL_END = 'on_tool_end',\n\n  /** Emitted when a retriever starts its operation. */\n  RETRIEVER_START = 'on_retriever_start',\n\n  /** Emitted when a retriever completes its operation. */\n  RETRIEVER_END = 'on_retriever_end',\n\n  /** Emitted when a prompt starts processing. */\n  PROMPT_START = 'on_prompt_start',\n\n  /** Emitted when a prompt completes its processing. */\n  PROMPT_END = 'on_prompt_end',\n}\n\nexport enum Providers {\n  OPENAI = 'openAI',\n  VERTEXAI = 'vertexai',\n  BEDROCK = 'bedrock',\n  ANTHROPIC = 'anthropic',\n  MISTRALAI = 'mistralai',\n  MISTRAL = 'mistral',\n  GOOGLE = 'google',\n  AZURE = 'azureOpenAI',\n  DEEPSEEK = 'deepseek',\n  OPENROUTER = 'openrouter',\n  XAI = 'xai',\n  MOONSHOT = 'moonshot',\n}\n\nexport enum GraphNodeKeys {\n  TOOLS = 'tools=',\n  AGENT = 'agent=',\n  SUMMARIZE = 'summarize=',\n  ROUTER = 'router',\n  PRE_TOOLS = 'pre_tools',\n  POST_TOOLS = 'post_tools',\n}\n\nexport enum GraphNodeActions {\n  TOOL_NODE = 'tool_node',\n  CALL_MODEL = 'call_model',\n  ROUTE_MESSAGE = 'route_message',\n}\n\nexport enum CommonEvents {\n  LANGGRAPH = 'LangGraph',\n}\n\nexport enum StepTypes {\n  TOOL_CALLS = 'tool_calls',\n  MESSAGE_CREATION = 'message_creation',\n}\n\nexport enum ContentTypes {\n  TEXT = 'text',\n  ERROR = 'error',\n  THINK = 'think',\n  TOOL_CALL = 'tool_call',\n  IMAGE_URL = 'image_url',\n  IMAGE_FILE = 'image_file',\n  /** Anthropic */\n  THINKING = 'thinking',\n  /** Vertex AI / Google Common */\n  REASONING = 'reasoning',\n  /** Multi-Agent Switch */\n  AGENT_UPDATE = 'agent_update',\n  /** Framework-level conversation summary block */\n  SUMMARY = 'summary',\n  /** Bedrock */\n  REASONING_CONTENT = 'reasoning_content',\n}\n\nexport enum ToolCallTypes {\n  FUNCTION = 'function',\n  RETRIEVAL = 'retrieval',\n  FILE_SEARCH = 'file_search',\n  CODE_INTERPRETER = 'code_interpreter',\n  /* Agents Tool Call */\n  TOOL_CALL = 'tool_call',\n}\n\nexport enum Callback {\n  TOOL_ERROR = 'handleToolError',\n  TOOL_START = 'handleToolStart',\n  TOOL_END = 'handleToolEnd',\n  CUSTOM_EVENT = 'handleCustomEvent',\n  /*\n  LLM_START = 'handleLLMStart',\n  LLM_NEW_TOKEN = 'handleLLMNewToken',\n  LLM_ERROR = 'handleLLMError',\n  LLM_END = 'handleLLMEnd',\n  CHAT_MODEL_START = 'handleChatModelStart',\n  CHAIN_START = 'handleChainStart',\n  CHAIN_ERROR = 'handleChainError',\n  CHAIN_END = 'handleChainEnd',\n  TEXT = 'handleText',\n  AGENT_ACTION = 'handleAgentAction',\n  AGENT_END = 'handleAgentEnd',\n  RETRIEVER_START = 'handleRetrieverStart',\n  RETRIEVER_END = 'handleRetrieverEnd',\n  RETRIEVER_ERROR = 'handleRetrieverError',\n  */\n}\n\nexport enum Constants {\n  OFFICIAL_CODE_BASEURL = 'https://api.librechat.ai/v1',\n  EXECUTE_CODE = 'execute_code',\n  TOOL_SEARCH = 'tool_search',\n  PROGRAMMATIC_TOOL_CALLING = 'run_tools_with_code',\n  WEB_SEARCH = 'web_search',\n  CONTENT_AND_ARTIFACT = 'content_and_artifact',\n  LC_TRANSFER_TO_ = 'lc_transfer_to_',\n  /** Delimiter for MCP tools: toolName_mcp_serverName */\n  MCP_DELIMITER = '_mcp_',\n  /** Anthropic server tool ID prefix (web_search, code_execution, etc.) */\n  ANTHROPIC_SERVER_TOOL_PREFIX = 'srvtoolu_',\n  SKILL_TOOL = 'skill',\n  READ_FILE = 'read_file',\n  BASH_TOOL = 'bash_tool',\n  BASH_PROGRAMMATIC_TOOL_CALLING = 'run_tools_with_bash',\n  SUBAGENT = 'subagent',\n  /**\n   * Local-engine coding tool names. Promoted to `Constants.*` (rather\n   * than left as per-file `*ToolName` consts) so consumer UIs — most\n   * importantly LibreChat's `getToolIconType` map — can match against\n   * canonical strings instead of guessing. Existing matched names:\n   * `bash_tool`, `read_file`, `execute_code`, `run_tools_with_code`.\n   * The rest below are new and currently fall through to the generic\n   * tool icon; once LibreChat adds icons keyed on the same names, the\n   * wiring will work without an SDK change.\n   */\n  WRITE_FILE = 'write_file',\n  EDIT_FILE = 'edit_file',\n  GREP_SEARCH = 'grep_search',\n  GLOB_SEARCH = 'glob_search',\n  LIST_DIRECTORY = 'list_directory',\n  COMPILE_CHECK = 'compile_check',\n}\n\n/** Tool names that use the code execution environment (shared session, file tracking). */\nexport const CODE_EXECUTION_TOOLS: ReadonlySet<string> = new Set([\n  Constants.EXECUTE_CODE,\n  Constants.BASH_TOOL,\n  Constants.PROGRAMMATIC_TOOL_CALLING,\n  Constants.BASH_PROGRAMMATIC_TOOL_CALLING,\n]);\n\n/**\n * Canonical names of the local-engine-specific coding tools — the\n * file/edit/search/typecheck surface that doesn't exist in the\n * remote (sandbox-API) engine. Single source of truth; the per-tool\n * factories, registry definitions, and `createWorkspacePolicyHook`\n * default extractors all key off these.\n *\n * `read_file` is on this list (the existing ReadFile tool is\n * remote-specific; the local engine's `read_file` is a parallel\n * implementation that shares the canonical name so consumer UIs\n * — most importantly LibreChat's `getToolIconType` — render both\n * with the same icon).\n */\nexport const LOCAL_CODING_TOOL_NAMES: readonly string[] = [\n  Constants.READ_FILE,\n  Constants.WRITE_FILE,\n  Constants.EDIT_FILE,\n  Constants.GREP_SEARCH,\n  Constants.GLOB_SEARCH,\n  Constants.LIST_DIRECTORY,\n  Constants.COMPILE_CHECK,\n];\n\n/**\n * Every tool name the local coding bundle (`createLocalCodingTools`)\n * exposes — the local-specific tools above plus the bash/code/PTC\n * pair that the local engine wraps around the existing factories.\n * Tests pin against this so any addition/removal in the bundle is\n * accompanied by a deliberate canonical-name update here.\n */\nexport const LOCAL_CODING_BUNDLE_NAMES: readonly string[] = [\n  ...LOCAL_CODING_TOOL_NAMES,\n  Constants.BASH_TOOL,\n  Constants.EXECUTE_CODE,\n  Constants.PROGRAMMATIC_TOOL_CALLING,\n  Constants.BASH_PROGRAMMATIC_TOOL_CALLING,\n];\n\nexport enum TitleMethod {\n  STRUCTURED = 'structured',\n  FUNCTIONS = 'functions',\n  COMPLETION = 'completion',\n}\n\nexport enum EnvVar {\n  CODE_BASEURL = 'LIBRECHAT_CODE_BASEURL',\n  CODE_API_RUN_TIMEOUT_MS = 'CODE_API_RUN_TIMEOUT_MS',\n}\n"],"names":["GraphEvents","Providers","GraphNodeKeys","GraphNodeActions","CommonEvents","StepTypes","ContentTypes","ToolCallTypes","Callback","Constants","TitleMethod","EnvVar"],"mappings":"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"}
+{"version":3,"file":"enum.cjs","names":[],"sources":["../../../src/common/enum.ts"],"sourcesContent":["/**\n * Enum representing the various event types emitted during the execution of runnables.\n * These events provide real-time information about the progress and state of different components.\n *\n * @enum {string}\n */\nexport enum GraphEvents {\n  /* Custom Events */\n\n  /** [Custom] Agent update event in multi-agent graph/workflow */\n  ON_AGENT_UPDATE = 'on_agent_update',\n  /** [Custom] Delta event for run steps (message creation and tool calls) */\n  ON_RUN_STEP = 'on_run_step',\n  /** [Custom] Delta event for run steps (tool calls) */\n  ON_RUN_STEP_DELTA = 'on_run_step_delta',\n  /** [Custom] Completed event for run steps (tool calls) */\n  ON_RUN_STEP_COMPLETED = 'on_run_step_completed',\n  /** [Custom] Delta events for messages */\n  ON_MESSAGE_DELTA = 'on_message_delta',\n  /** [Custom] Reasoning Delta events for messages */\n  ON_REASONING_DELTA = 'on_reasoning_delta',\n  /** [Custom] Request to execute tools - dispatched by ToolNode, handled by host */\n  ON_TOOL_EXECUTE = 'on_tool_execute',\n  /** [Custom] Emitted when the summarize node begins generating a summary */\n  ON_SUMMARIZE_START = 'on_summarize_start',\n  /** [Custom] Delta event carrying the completed summary content */\n  ON_SUMMARIZE_DELTA = 'on_summarize_delta',\n  /** [Custom] Emitted when the summarize node completes with the final summary */\n  ON_SUMMARIZE_COMPLETE = 'on_summarize_complete',\n  /** [Custom] Progress update from a running subagent (wraps child-graph events so hosts can display activity separately from parent). */\n  ON_SUBAGENT_UPDATE = 'on_subagent_update',\n  /** [Custom] Diagnostic logging event for context management observability */\n  ON_AGENT_LOG = 'on_agent_log',\n\n  /* Official Events */\n\n  /** Custom event, emitted by system */\n  ON_CUSTOM_EVENT = 'on_custom_event',\n  /** Emitted when a chat model starts processing. */\n  CHAT_MODEL_START = 'on_chat_model_start',\n\n  /** Emitted when a chat model streams a chunk of its response. */\n  CHAT_MODEL_STREAM = 'on_chat_model_stream',\n\n  /** Emitted when a chat model completes its processing. */\n  CHAT_MODEL_END = 'on_chat_model_end',\n\n  /** Emitted when a language model starts processing. */\n  LLM_START = 'on_llm_start',\n\n  /** Emitted when a language model streams a chunk of its response. */\n  LLM_STREAM = 'on_llm_stream',\n\n  /** Emitted when a language model completes its processing. */\n  LLM_END = 'on_llm_end',\n\n  /** Emitted when a chain starts processing. */\n  CHAIN_START = 'on_chain_start',\n\n  /** Emitted when a chain streams a chunk of its output. */\n  CHAIN_STREAM = 'on_chain_stream',\n\n  /** Emitted when a chain completes its processing. */\n  CHAIN_END = 'on_chain_end',\n\n  /** Emitted when a tool starts its operation. */\n  TOOL_START = 'on_tool_start',\n\n  /** Emitted when a tool completes its operation. */\n  TOOL_END = 'on_tool_end',\n\n  /** Emitted when a retriever starts its operation. */\n  RETRIEVER_START = 'on_retriever_start',\n\n  /** Emitted when a retriever completes its operation. */\n  RETRIEVER_END = 'on_retriever_end',\n\n  /** Emitted when a prompt starts processing. */\n  PROMPT_START = 'on_prompt_start',\n\n  /** Emitted when a prompt completes its processing. */\n  PROMPT_END = 'on_prompt_end',\n}\n\nexport enum Providers {\n  OPENAI = 'openAI',\n  VERTEXAI = 'vertexai',\n  BEDROCK = 'bedrock',\n  ANTHROPIC = 'anthropic',\n  MISTRALAI = 'mistralai',\n  MISTRAL = 'mistral',\n  GOOGLE = 'google',\n  AZURE = 'azureOpenAI',\n  DEEPSEEK = 'deepseek',\n  OPENROUTER = 'openrouter',\n  XAI = 'xai',\n  MOONSHOT = 'moonshot',\n}\n\nexport enum GraphNodeKeys {\n  TOOLS = 'tools=',\n  AGENT = 'agent=',\n  SUMMARIZE = 'summarize=',\n  ROUTER = 'router',\n  PRE_TOOLS = 'pre_tools',\n  POST_TOOLS = 'post_tools',\n}\n\nexport enum GraphNodeActions {\n  TOOL_NODE = 'tool_node',\n  CALL_MODEL = 'call_model',\n  ROUTE_MESSAGE = 'route_message',\n}\n\nexport enum CommonEvents {\n  LANGGRAPH = 'LangGraph',\n}\n\nexport enum StepTypes {\n  TOOL_CALLS = 'tool_calls',\n  MESSAGE_CREATION = 'message_creation',\n}\n\nexport enum ContentTypes {\n  TEXT = 'text',\n  ERROR = 'error',\n  THINK = 'think',\n  TOOL_CALL = 'tool_call',\n  IMAGE_URL = 'image_url',\n  IMAGE_FILE = 'image_file',\n  /** Anthropic */\n  THINKING = 'thinking',\n  /** Vertex AI / Google Common */\n  REASONING = 'reasoning',\n  /** Multi-Agent Switch */\n  AGENT_UPDATE = 'agent_update',\n  /** Framework-level conversation summary block */\n  SUMMARY = 'summary',\n  /** Bedrock */\n  REASONING_CONTENT = 'reasoning_content',\n}\n\nexport enum ToolCallTypes {\n  FUNCTION = 'function',\n  RETRIEVAL = 'retrieval',\n  FILE_SEARCH = 'file_search',\n  CODE_INTERPRETER = 'code_interpreter',\n  /* Agents Tool Call */\n  TOOL_CALL = 'tool_call',\n}\n\nexport enum Callback {\n  TOOL_ERROR = 'handleToolError',\n  TOOL_START = 'handleToolStart',\n  TOOL_END = 'handleToolEnd',\n  CUSTOM_EVENT = 'handleCustomEvent',\n  /*\n  LLM_START = 'handleLLMStart',\n  LLM_NEW_TOKEN = 'handleLLMNewToken',\n  LLM_ERROR = 'handleLLMError',\n  LLM_END = 'handleLLMEnd',\n  CHAT_MODEL_START = 'handleChatModelStart',\n  CHAIN_START = 'handleChainStart',\n  CHAIN_ERROR = 'handleChainError',\n  CHAIN_END = 'handleChainEnd',\n  TEXT = 'handleText',\n  AGENT_ACTION = 'handleAgentAction',\n  AGENT_END = 'handleAgentEnd',\n  RETRIEVER_START = 'handleRetrieverStart',\n  RETRIEVER_END = 'handleRetrieverEnd',\n  RETRIEVER_ERROR = 'handleRetrieverError',\n  */\n}\n\nexport enum Constants {\n  OFFICIAL_CODE_BASEURL = 'https://api.librechat.ai/v1',\n  EXECUTE_CODE = 'execute_code',\n  TOOL_SEARCH = 'tool_search',\n  PROGRAMMATIC_TOOL_CALLING = 'run_tools_with_code',\n  WEB_SEARCH = 'web_search',\n  CONTENT_AND_ARTIFACT = 'content_and_artifact',\n  LC_TRANSFER_TO_ = 'lc_transfer_to_',\n  /** Delimiter for MCP tools: toolName_mcp_serverName */\n  MCP_DELIMITER = '_mcp_',\n  /** Anthropic server tool ID prefix (web_search, code_execution, etc.) */\n  ANTHROPIC_SERVER_TOOL_PREFIX = 'srvtoolu_',\n  SKILL_TOOL = 'skill',\n  READ_FILE = 'read_file',\n  BASH_TOOL = 'bash_tool',\n  BASH_PROGRAMMATIC_TOOL_CALLING = 'run_tools_with_bash',\n  SUBAGENT = 'subagent',\n  /**\n   * Local-engine coding tool names. Promoted to `Constants.*` (rather\n   * than left as per-file `*ToolName` consts) so consumer UIs — most\n   * importantly LibreChat's `getToolIconType` map — can match against\n   * canonical strings instead of guessing. Existing matched names:\n   * `bash_tool`, `read_file`, `execute_code`, `run_tools_with_code`.\n   * The rest below are new and currently fall through to the generic\n   * tool icon; once LibreChat adds icons keyed on the same names, the\n   * wiring will work without an SDK change.\n   */\n  WRITE_FILE = 'write_file',\n  EDIT_FILE = 'edit_file',\n  GREP_SEARCH = 'grep_search',\n  GLOB_SEARCH = 'glob_search',\n  LIST_DIRECTORY = 'list_directory',\n  COMPILE_CHECK = 'compile_check',\n}\n\n/** Tool names that use the code execution environment (shared session, file tracking). */\nexport const CODE_EXECUTION_TOOLS: ReadonlySet<string> = new Set([\n  Constants.EXECUTE_CODE,\n  Constants.BASH_TOOL,\n  Constants.PROGRAMMATIC_TOOL_CALLING,\n  Constants.BASH_PROGRAMMATIC_TOOL_CALLING,\n]);\n\n/**\n * Canonical names of the local-engine-specific coding tools — the\n * file/edit/search/typecheck surface that doesn't exist in the\n * remote (sandbox-API) engine. Single source of truth; the per-tool\n * factories, registry definitions, and `createWorkspacePolicyHook`\n * default extractors all key off these.\n *\n * `read_file` is on this list (the existing ReadFile tool is\n * remote-specific; the local engine's `read_file` is a parallel\n * implementation that shares the canonical name so consumer UIs\n * — most importantly LibreChat's `getToolIconType` — render both\n * with the same icon).\n */\nexport const LOCAL_CODING_TOOL_NAMES: readonly string[] = [\n  Constants.READ_FILE,\n  Constants.WRITE_FILE,\n  Constants.EDIT_FILE,\n  Constants.GREP_SEARCH,\n  Constants.GLOB_SEARCH,\n  Constants.LIST_DIRECTORY,\n  Constants.COMPILE_CHECK,\n];\n\n/**\n * Every tool name the local coding bundle (`createLocalCodingTools`)\n * exposes — the local-specific tools above plus the bash/code/PTC\n * pair that the local engine wraps around the existing factories.\n * Tests pin against this so any addition/removal in the bundle is\n * accompanied by a deliberate canonical-name update here.\n */\nexport const LOCAL_CODING_BUNDLE_NAMES: readonly string[] = [\n  ...LOCAL_CODING_TOOL_NAMES,\n  Constants.BASH_TOOL,\n  Constants.EXECUTE_CODE,\n  Constants.PROGRAMMATIC_TOOL_CALLING,\n  Constants.BASH_PROGRAMMATIC_TOOL_CALLING,\n];\n\nexport enum TitleMethod {\n  STRUCTURED = 'structured',\n  FUNCTIONS = 'functions',\n  COMPLETION = 'completion',\n}\n\nexport enum EnvVar {\n  CODE_BASEURL = 'LIBRECHAT_CODE_BASEURL',\n  CODE_API_RUN_TIMEOUT_MS = 'CODE_API_RUN_TIMEOUT_MS',\n}\n"],"mappings":"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"}

package/dist/cjs/common/index.cjs

@@ -0,0 +1,2 @@
+require("./constants.cjs");
+require("./enum.cjs");