@librechat/agents 1.5.2 → 1.5.4

package/dist/cjs/main.cjs

@@ -5,6 +5,7 @@ var stream = require('./stream.cjs');
 var events = require('./events.cjs');
 var messages = require('./messages.cjs');
 var Graph = require('./graphs/Graph.cjs');
+var CodeExecutor = require('./tools/CodeExecutor.cjs');
 var _enum = require('./common/enum.cjs');
 var graph = require('./utils/graph.cjs');
 var run$1 = require('./utils/run.cjs');
@@ -27,6 +28,7 @@ exports.getConverseOverrideMessage = messages.getConverseOverrideMessage;
 exports.modifyDeltaProperties = messages.modifyDeltaProperties;
 exports.Graph = Graph.Graph;
 exports.StandardGraph = Graph.StandardGraph;
+exports.createCodeExecutionTool = CodeExecutor.createCodeExecutionTool;
 Object.defineProperty(exports, "Callback", {
 	enumerable: true,
 	get: function () { return _enum.Callback; }

package/dist/cjs/main.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"main.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"main.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/cjs/tools/CodeExecutor.cjs

@@ -0,0 +1,81 @@
+'use strict';
+
+var zod = require('zod');
+var dotenv = require('dotenv');
+var tools = require('@langchain/core/tools');
+
+dotenv.config();
+const EXEC_ENDPOINT = 'https://api.librechat.ai/exec';
+const CodeExecutionToolSchema = zod.z.object({
+    lang: zod.z.enum([
+        'py',
+        'js',
+        'ts',
+        'c',
+        'cpp',
+        'java',
+        'php',
+        'rs',
+        'go',
+        'bash',
+        'd',
+        'f90',
+    ])
+        .describe('The programming language or runtime to execute the code in.'),
+    code: zod.z.string()
+        .describe('The complete, self-contained code to execute, without any truncation or minimization.'),
+    args: zod.z.array(zod.z.string()).optional()
+        .describe('Additional arguments to execute the code with.'),
+});
+function createCodeExecutionTool(params = {}) {
+    return tools.tool(async ({ lang, code, ...rest }) => {
+        const postData = {
+            lang,
+            code,
+            ...rest,
+            ...params,
+        };
+        try {
+            const response = await fetch(EXEC_ENDPOINT, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'User-Agent': 'LibreChat/1.0',
+                },
+                body: JSON.stringify(postData),
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP error! status: ${response.status}`);
+            }
+            const result = await response.json();
+            let formattedOutput = '';
+            if (result.stdout)
+                formattedOutput += `stdout:\n${result.stdout}\n`;
+            if (result.stderr)
+                formattedOutput += `stderr:\n${result.stderr}\n`;
+            if (result.files && result.files.length > 0) {
+                formattedOutput += 'Generated files:\n';
+                result.files.forEach((file) => {
+                    formattedOutput += `${file.name}`;
+                });
+                return [formattedOutput.trim(), result.files];
+            }
+            return [formattedOutput.trim(), undefined];
+        }
+        catch (error) {
+            return `Calling tool with arguments:\n\n${JSON.stringify({
+                lang,
+                code,
+                ...rest,
+            })}\n\nraised the following error:\n\n${error?.message}`;
+        }
+    }, {
+        name: 'execute_code',
+        description: 'Executes code in various programming languages, returning stdout/stderr output.',
+        schema: CodeExecutionToolSchema,
+        responseFormat: 'content_and_artifact',
+    });
+}
+
+exports.createCodeExecutionTool = createCodeExecutionTool;
+//# sourceMappingURL=CodeExecutor.cjs.map

package/dist/cjs/tools/CodeExecutor.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeExecutor.cjs","sources":["../../../src/tools/CodeExecutor.ts"],"sourcesContent":["import { z } from 'zod';\nimport { config } from 'dotenv';\nimport { tool, DynamicStructuredTool } from '@langchain/core/tools';\n\nconfig();\n\nconst EXEC_ENDPOINT = 'https://api.librechat.ai/exec';\n\nexport type CodeExecutionToolParams = {\n  session_id?: string;\n  user_id?: string;\n}\n\nexport type FileRef = {\n  id: string;\n  name: string;\n  path?: string;\n};\n\nexport type FileRefs = FileRef[];\n\nexport type ExecuteResult = {\n  session_id: string;\n  stdout: string;\n  stderr: string;\n  files?: FileRefs;\n};\n\nconst CodeExecutionToolSchema = z.object({\n  lang: z.enum([\n    'py',\n    'js',\n    'ts',\n    'c',\n    'cpp',\n    'java',\n    'php',\n    'rs',\n    'go',\n    'bash',\n    'd',\n    'f90',\n  ])\n    .describe('The programming language or runtime to execute the code in.'),\n  code: z.string()\n    .describe('The complete, self-contained code to execute, without any truncation or minimization.'),\n  args: z.array(z.string()).optional()\n    .describe('Additional arguments to execute the code with.'),\n});\n\nfunction createCodeExecutionTool(params: CodeExecutionToolParams = {}): DynamicStructuredTool<typeof CodeExecutionToolSchema> {\n  return tool<typeof CodeExecutionToolSchema>(\n    async ({ lang, code, ...rest }) => {\n      const postData = {\n        lang,\n        code,\n        ...rest,\n        ...params,\n      };\n\n      try {\n        const response = await fetch(EXEC_ENDPOINT, {\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n            'User-Agent': 'LibreChat/1.0',\n          },\n          body: JSON.stringify(postData),\n        });\n\n        if (!response.ok) {\n          throw new Error(`HTTP error! status: ${response.status}`);\n        }\n\n        const result: ExecuteResult = await response.json();\n        let formattedOutput = '';\n        if (result.stdout) formattedOutput += `stdout:\\n${result.stdout}\\n`;\n        if (result.stderr) formattedOutput += `stderr:\\n${result.stderr}\\n`;\n        if (result.files && result.files.length > 0) {\n          formattedOutput += 'Generated files:\\n';\n          result.files.forEach((file: FileRef) => {\n            formattedOutput += `${file.name}`;\n          });\n          return [formattedOutput.trim(), result.files];\n        }\n\n        return [formattedOutput.trim(), undefined];\n      } catch (error) {\n        return `Calling tool with arguments:\\n\\n${JSON.stringify({\n          lang,\n          code,\n          ...rest,\n        })}\\n\\nraised the following error:\\n\\n${(error as Error | undefined)?.message}`;\n      }\n    },\n    {\n      name: 'execute_code',\n      description: 'Executes code in various programming languages, returning stdout/stderr output.',\n      schema: CodeExecutionToolSchema,\n      responseFormat: 'content_and_artifact',\n    }\n  );\n}\n\nexport { createCodeExecutionTool };"],"names":["config","z","tool"],"mappings":";;;;;;AAIAA,aAAM,EAAE,CAAC;AAET,MAAM,aAAa,GAAG,+BAA+B,CAAC;AAsBtD,MAAM,uBAAuB,GAAGC,KAAC,CAAC,MAAM,CAAC;AACvC,IAAA,IAAI,EAAEA,KAAC,CAAC,IAAI,CAAC;QACX,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,GAAG;QACH,KAAK;QACL,MAAM;QACN,KAAK;QACL,IAAI;QACJ,IAAI;QACJ,MAAM;QACN,GAAG;QACH,KAAK;KACN,CAAC;SACC,QAAQ,CAAC,6DAA6D,CAAC;AAC1E,IAAA,IAAI,EAAEA,KAAC,CAAC,MAAM,EAAE;SACb,QAAQ,CAAC,uFAAuF,CAAC;AACpG,IAAA,IAAI,EAAEA,KAAC,CAAC,KAAK,CAACA,KAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;SACjC,QAAQ,CAAC,gDAAgD,CAAC;AAC9D,CAAA,CAAC,CAAC;AAEH,SAAS,uBAAuB,CAAC,MAAA,GAAkC,EAAE,EAAA;AACnE,IAAA,OAAOC,UAAI,CACT,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,KAAI;AAChC,QAAA,MAAM,QAAQ,GAAG;YACf,IAAI;YACJ,IAAI;AACJ,YAAA,GAAG,IAAI;AACP,YAAA,GAAG,MAAM;SACV,CAAC;AAEF,QAAA,IAAI;AACF,YAAA,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,aAAa,EAAE;AAC1C,gBAAA,MAAM,EAAE,MAAM;AACd,gBAAA,OAAO,EAAE;AACP,oBAAA,cAAc,EAAE,kBAAkB;AAClC,oBAAA,YAAY,EAAE,eAAe;AAC9B,iBAAA;AACD,gBAAA,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;AAC/B,aAAA,CAAC,CAAC;AAEH,YAAA,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE;gBAChB,MAAM,IAAI,KAAK,CAAC,CAAA,oBAAA,EAAuB,QAAQ,CAAC,MAAM,CAAE,CAAA,CAAC,CAAC;aAC3D;AAED,YAAA,MAAM,MAAM,GAAkB,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACpD,IAAI,eAAe,GAAG,EAAE,CAAC;YACzB,IAAI,MAAM,CAAC,MAAM;AAAE,gBAAA,eAAe,IAAI,CAAY,SAAA,EAAA,MAAM,CAAC,MAAM,IAAI,CAAC;YACpE,IAAI,MAAM,CAAC,MAAM;AAAE,gBAAA,eAAe,IAAI,CAAY,SAAA,EAAA,MAAM,CAAC,MAAM,IAAI,CAAC;AACpE,YAAA,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE;gBAC3C,eAAe,IAAI,oBAAoB,CAAC;gBACxC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAa,KAAI;AACrC,oBAAA,eAAe,IAAI,CAAG,EAAA,IAAI,CAAC,IAAI,EAAE,CAAC;AACpC,iBAAC,CAAC,CAAC;gBACH,OAAO,CAAC,eAAe,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;aAC/C;YAED,OAAO,CAAC,eAAe,CAAC,IAAI,EAAE,EAAE,SAAS,CAAC,CAAC;SAC5C;QAAC,OAAO,KAAK,EAAE;AACd,YAAA,OAAO,CAAmC,gCAAA,EAAA,IAAI,CAAC,SAAS,CAAC;gBACvD,IAAI;gBACJ,IAAI;AACJ,gBAAA,GAAG,IAAI;AACR,aAAA,CAAC,CAAuC,mCAAA,EAAA,KAA2B,EAAE,OAAO,EAAE,CAAC;SACjF;AACH,KAAC,EACD;AACE,QAAA,IAAI,EAAE,cAAc;AACpB,QAAA,WAAW,EAAE,iFAAiF;AAC9F,QAAA,MAAM,EAAE,uBAAuB;AAC/B,QAAA,cAAc,EAAE,sBAAsB;AACvC,KAAA,CACF,CAAC;AACJ;;;;"}

package/dist/esm/main.mjs

@@ -3,6 +3,7 @@ export { ChatModelStreamHandler, createContentAggregator } from './stream.mjs';
 export { HandlerRegistry, LLMStreamHandler, ModelEndHandler, TestChatStreamHandler, TestLLMStreamHandler, ToolEndHandler, createMetadataAggregator } from './events.mjs';
 export { convertMessagesToContent, formatAnthropicMessage, getConverseOverrideMessage, modifyDeltaProperties } from './messages.mjs';
 export { Graph, StandardGraph } from './graphs/Graph.mjs';
+export { createCodeExecutionTool } from './tools/CodeExecutor.mjs';
 export { Callback, CommonEvents, ContentTypes, GraphEvents, GraphNodeActions, GraphNodeKeys, Providers, StepTypes, ToolCallTypes } from './common/enum.mjs';
 export { joinKeys, resetIfNotEmpty } from './utils/graph.mjs';
 export { RunnableCallable, sleep } from './utils/run.mjs';

package/dist/esm/main.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"main.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;"}
+{"version":3,"file":"main.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;"}

package/dist/esm/tools/CodeExecutor.mjs

@@ -0,0 +1,79 @@
+import { z } from 'zod';
+import { config } from 'dotenv';
+import { tool } from '@langchain/core/tools';
+
+config();
+const EXEC_ENDPOINT = 'https://api.librechat.ai/exec';
+const CodeExecutionToolSchema = z.object({
+    lang: z.enum([
+        'py',
+        'js',
+        'ts',
+        'c',
+        'cpp',
+        'java',
+        'php',
+        'rs',
+        'go',
+        'bash',
+        'd',
+        'f90',
+    ])
+        .describe('The programming language or runtime to execute the code in.'),
+    code: z.string()
+        .describe('The complete, self-contained code to execute, without any truncation or minimization.'),
+    args: z.array(z.string()).optional()
+        .describe('Additional arguments to execute the code with.'),
+});
+function createCodeExecutionTool(params = {}) {
+    return tool(async ({ lang, code, ...rest }) => {
+        const postData = {
+            lang,
+            code,
+            ...rest,
+            ...params,
+        };
+        try {
+            const response = await fetch(EXEC_ENDPOINT, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'User-Agent': 'LibreChat/1.0',
+                },
+                body: JSON.stringify(postData),
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP error! status: ${response.status}`);
+            }
+            const result = await response.json();
+            let formattedOutput = '';
+            if (result.stdout)
+                formattedOutput += `stdout:\n${result.stdout}\n`;
+            if (result.stderr)
+                formattedOutput += `stderr:\n${result.stderr}\n`;
+            if (result.files && result.files.length > 0) {
+                formattedOutput += 'Generated files:\n';
+                result.files.forEach((file) => {
+                    formattedOutput += `${file.name}`;
+                });
+                return [formattedOutput.trim(), result.files];
+            }
+            return [formattedOutput.trim(), undefined];
+        }
+        catch (error) {
+            return `Calling tool with arguments:\n\n${JSON.stringify({
+                lang,
+                code,
+                ...rest,
+            })}\n\nraised the following error:\n\n${error?.message}`;
+        }
+    }, {
+        name: 'execute_code',
+        description: 'Executes code in various programming languages, returning stdout/stderr output.',
+        schema: CodeExecutionToolSchema,
+        responseFormat: 'content_and_artifact',
+    });
+}
+
+export { createCodeExecutionTool };
+//# sourceMappingURL=CodeExecutor.mjs.map

package/dist/esm/tools/CodeExecutor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeExecutor.mjs","sources":["../../../src/tools/CodeExecutor.ts"],"sourcesContent":["import { z } from 'zod';\nimport { config } from 'dotenv';\nimport { tool, DynamicStructuredTool } from '@langchain/core/tools';\n\nconfig();\n\nconst EXEC_ENDPOINT = 'https://api.librechat.ai/exec';\n\nexport type CodeExecutionToolParams = {\n  session_id?: string;\n  user_id?: string;\n}\n\nexport type FileRef = {\n  id: string;\n  name: string;\n  path?: string;\n};\n\nexport type FileRefs = FileRef[];\n\nexport type ExecuteResult = {\n  session_id: string;\n  stdout: string;\n  stderr: string;\n  files?: FileRefs;\n};\n\nconst CodeExecutionToolSchema = z.object({\n  lang: z.enum([\n    'py',\n    'js',\n    'ts',\n    'c',\n    'cpp',\n    'java',\n    'php',\n    'rs',\n    'go',\n    'bash',\n    'd',\n    'f90',\n  ])\n    .describe('The programming language or runtime to execute the code in.'),\n  code: z.string()\n    .describe('The complete, self-contained code to execute, without any truncation or minimization.'),\n  args: z.array(z.string()).optional()\n    .describe('Additional arguments to execute the code with.'),\n});\n\nfunction createCodeExecutionTool(params: CodeExecutionToolParams = {}): DynamicStructuredTool<typeof CodeExecutionToolSchema> {\n  return tool<typeof CodeExecutionToolSchema>(\n    async ({ lang, code, ...rest }) => {\n      const postData = {\n        lang,\n        code,\n        ...rest,\n        ...params,\n      };\n\n      try {\n        const response = await fetch(EXEC_ENDPOINT, {\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n            'User-Agent': 'LibreChat/1.0',\n          },\n          body: JSON.stringify(postData),\n        });\n\n        if (!response.ok) {\n          throw new Error(`HTTP error! status: ${response.status}`);\n        }\n\n        const result: ExecuteResult = await response.json();\n        let formattedOutput = '';\n        if (result.stdout) formattedOutput += `stdout:\\n${result.stdout}\\n`;\n        if (result.stderr) formattedOutput += `stderr:\\n${result.stderr}\\n`;\n        if (result.files && result.files.length > 0) {\n          formattedOutput += 'Generated files:\\n';\n          result.files.forEach((file: FileRef) => {\n            formattedOutput += `${file.name}`;\n          });\n          return [formattedOutput.trim(), result.files];\n        }\n\n        return [formattedOutput.trim(), undefined];\n      } catch (error) {\n        return `Calling tool with arguments:\\n\\n${JSON.stringify({\n          lang,\n          code,\n          ...rest,\n        })}\\n\\nraised the following error:\\n\\n${(error as Error | undefined)?.message}`;\n      }\n    },\n    {\n      name: 'execute_code',\n      description: 'Executes code in various programming languages, returning stdout/stderr output.',\n      schema: CodeExecutionToolSchema,\n      responseFormat: 'content_and_artifact',\n    }\n  );\n}\n\nexport { createCodeExecutionTool };"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -3,6 +3,7 @@ export * from './stream';
 export * from './events';
 export * from './messages';
 export * from './graphs';
+export { createCodeExecutionTool } from './tools/CodeExecutor';
 export * from './common';
 export * from './utils';
 export type * from './types';

package/dist/types/scripts/code_exec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tools/CodeExecutor.d.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import { DynamicStructuredTool } from '@langchain/core/tools';
+export type CodeExecutionToolParams = {
+    session_id?: string;
+    user_id?: string;
+};
+export type FileRef = {
+    id: string;
+    name: string;
+    path?: string;
+};
+export type FileRefs = FileRef[];
+export type ExecuteResult = {
+    session_id: string;
+    stdout: string;
+    stderr: string;
+    files?: FileRefs;
+};
+declare const CodeExecutionToolSchema: z.ZodObject<{
+    lang: z.ZodEnum<["py", "js", "ts", "c", "cpp", "java", "php", "rs", "go", "bash", "d", "f90"]>;
+    code: z.ZodString;
+    args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    lang: "py" | "js" | "ts" | "c" | "cpp" | "java" | "php" | "rs" | "go" | "bash" | "d" | "f90";
+    args?: string[] | undefined;
+}, {
+    code: string;
+    lang: "py" | "js" | "ts" | "c" | "cpp" | "java" | "php" | "rs" | "go" | "bash" | "d" | "f90";
+    args?: string[] | undefined;
+}>;
+declare function createCodeExecutionTool(params?: CodeExecutionToolParams): DynamicStructuredTool<typeof CodeExecutionToolSchema>;
+export { createCodeExecutionTool };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@librechat/agents",
-  "version": "1.5.2",
+  "version": "1.5.4",
   "main": "./dist/cjs/main.cjs",
   "module": "./dist/esm/main.mjs",
   "types": "./dist/types/index.d.ts",
@@ -42,6 +42,7 @@
     "start:cli": "node -r dotenv/config --loader ./tsconfig-paths-bootstrap.mjs --experimental-specifier-resolution=node ./src/scripts/cli.ts --provider 'anthropic' --name 'Jo' --location 'New York, NY'",
     "content": "node -r dotenv/config --loader ./tsconfig-paths-bootstrap.mjs --experimental-specifier-resolution=node ./src/scripts/content.ts --provider 'anthropic' --name 'Jo' --location 'New York, NY'",
     "stream": "node -r dotenv/config --loader ./tsconfig-paths-bootstrap.mjs --experimental-specifier-resolution=node ./src/scripts/stream.ts --provider 'anthropic' --name 'Jo' --location 'New York, NY'",
+    "code_exec": "node -r dotenv/config --loader ./tsconfig-paths-bootstrap.mjs --experimental-specifier-resolution=node ./src/scripts/code_exec.ts --provider 'openAI' --name 'Jo' --location 'New York, NY'",
     "simple": "node -r dotenv/config --loader ./tsconfig-paths-bootstrap.mjs --experimental-specifier-resolution=node ./src/scripts/simple.ts --provider 'bedrock' --name 'Jo' --location 'New York, NY'",
     "tool-test": "node -r dotenv/config --loader ./tsconfig-paths-bootstrap.mjs --experimental-specifier-resolution=node ./src/scripts/tools.ts --provider 'anthropic' --name 'Jo' --location 'New York, NY'",
     "abort": "node -r dotenv/config --loader ./tsconfig-paths-bootstrap.mjs --experimental-specifier-resolution=node ./src/scripts/abort.ts --provider 'anthropic' --name 'Jo' --location 'New York, NY'",

package/src/index.ts

@@ -7,6 +7,9 @@ export * from './messages';
 /* Graphs */
 export * from './graphs';
 
+/* Tools */
+export { createCodeExecutionTool } from './tools/CodeExecutor';
+
 /* Misc. */
 export * from './common';
 export * from './utils';

package/src/scripts/code_exec.ts

@@ -0,0 +1,176 @@
+// src/scripts/cli.ts
+import { config } from 'dotenv';
+config();
+import { HumanMessage, AIMessage, BaseMessage } from '@langchain/core/messages';
+import { TavilySearchResults } from '@langchain/community/tools/tavily_search';
+import type * as t from '@/types';
+import { ChatModelStreamHandler, createContentAggregator } from '@/stream';
+import { ToolEndHandler, ModelEndHandler, createMetadataAggregator } from '@/events';
+import { getLLMConfig } from '@/utils/llmConfig';
+import { getArgs } from '@/scripts/args';
+import { GraphEvents } from '@/common';
+import { Run } from '@/run';
+import { createCodeExecutionTool } from '@/tools/CodeExecutor';
+
+const conversationHistory: BaseMessage[] = [];
+
+async function testCodeExecution(): Promise<void> {
+  const { userName, location, provider, currentDate } = await getArgs();
+  const { contentParts, aggregateContent } = createContentAggregator();
+  const customHandlers = {
+    [GraphEvents.TOOL_END]: new ToolEndHandler(),
+    [GraphEvents.CHAT_MODEL_END]: new ModelEndHandler(),
+    [GraphEvents.CHAT_MODEL_STREAM]: new ChatModelStreamHandler(),
+    [GraphEvents.ON_RUN_STEP_COMPLETED]: {
+      handle: (event: GraphEvents.ON_RUN_STEP_COMPLETED, data: t.StreamEventData): void => {
+        console.log('====== ON_RUN_STEP_COMPLETED ======');
+        console.dir(data, { depth: null });
+        aggregateContent({ event, data: data as unknown as { result: t.ToolEndEvent } });
+      }
+    },
+    [GraphEvents.ON_RUN_STEP]: {
+      handle: (event: GraphEvents.ON_RUN_STEP, data: t.StreamEventData): void => {
+        console.log('====== ON_RUN_STEP ======');
+        console.dir(data, { depth: null });
+        aggregateContent({ event, data: data as t.RunStep });
+      }
+    },
+    [GraphEvents.ON_RUN_STEP_DELTA]: {
+      handle: (event: GraphEvents.ON_RUN_STEP_DELTA, data: t.StreamEventData): void => {
+        console.log('====== ON_RUN_STEP_DELTA ======');
+        console.dir(data, { depth: null });
+        aggregateContent({ event, data: data as t.RunStepDeltaEvent });
+      }
+    },
+    [GraphEvents.ON_MESSAGE_DELTA]: {
+      handle: (event: GraphEvents.ON_MESSAGE_DELTA, data: t.StreamEventData): void => {
+        console.log('====== ON_MESSAGE_DELTA ======');
+        console.dir(data, { depth: null });
+        aggregateContent({ event, data: data as t.MessageDeltaEvent });
+      }
+    },
+    [GraphEvents.TOOL_START]: {
+      handle: (_event: string, data: t.StreamEventData, metadata?: Record<string, unknown>): void => {
+        console.log('====== TOOL_START ======');
+        console.dir(data, { depth: null });
+      }
+    },
+  };
+
+  const llmConfig = getLLMConfig(provider);
+
+  const run = await Run.create<t.IState>({
+    graphConfig: {
+      type: 'standard',
+      llmConfig,
+      tools: [new TavilySearchResults(), createCodeExecutionTool()],
+      instructions: 'You are a friendly AI assistant with coding capabilities. Always address the user by their name.',
+      additional_instructions: `The user's name is ${userName} and they are located in ${location}.`,
+    },
+    returnContent: true,
+    customHandlers,
+  });
+
+  const config = {
+    configurable: {
+      provider,
+      thread_id: 'conversation-num-1',
+    },
+    streamMode: 'values',
+    version: 'v2' as const,
+  };
+
+  console.log('Test 1: Sorting Algorithm Comparison');
+
+  const userMessage1 = `
+  Hi ${userName} here. I need a Python script that compares different sorting algorithms. Can you write a script that:
+  1. Implements three sorting algorithms: Bubble Sort, Insertion Sort, and Merge Sort
+  2. Generates three random lists of integers:
+     - A small list (20 elements)
+     - A medium list (100 elements)
+     - A large list (1000 elements)
+  3. Applies each sorting algorithm to each list and measures the execution time
+  4. Prints a comparison table showing the time taken by each algorithm for each list size
+  5. Determines and announces the fastest algorithm for each list size
+  Please write the script and then execute it to show the results.
+  `;
+
+  conversationHistory.push(new HumanMessage(userMessage1));
+
+  let inputs = {
+    messages: conversationHistory,
+  };
+  const finalContentParts1 = await run.processStream(inputs, config);
+  const finalMessages1 = run.getRunMessages();
+  if (finalMessages1) {
+    conversationHistory.push(...finalMessages1);
+  }
+  console.log('\n\n====================\n\n');
+  console.dir(contentParts, { depth: null });
+
+  console.log('Test 2: Text File Analysis and Processing');
+
+  const userMessage2 = `
+  Great job on the sorting algorithms! Now, let's solve a popular LeetCode problem using the Merge Sort algorithm we implemented. The problem is "Merge Intervals". Here's what I need:
+
+  1. Implement a solution to the Merge Intervals problem:
+     - Given an array of intervals where intervals[i] = [starti, endi], merge all overlapping intervals.
+     - Return an array of the non-overlapping intervals that cover all the intervals in the input.
+
+  2. Use the Merge Sort algorithm as part of the solution to sort the intervals based on their start times.
+
+  3. Implement a function to generate a random list of intervals for testing.
+
+  4. Create test cases:
+     - A small case with 5 intervals
+     - A medium case with 20 intervals
+     - A large case with 100 intervals
+
+  5. Apply your solution to each test case and print:
+     - The original intervals
+     - The merged intervals
+     - The time taken to solve each case
+
+  Please write the script and execute it to demonstrate the results for all three test cases.
+  `;
+
+  conversationHistory.push(new HumanMessage(userMessage2));
+
+  inputs = {
+    messages: conversationHistory,
+  };
+  const finalContentParts2 = await run.processStream(inputs, config);
+  const finalMessages2 = run.getRunMessages();
+  if (finalMessages2) {
+    conversationHistory.push(...finalMessages2);
+  }
+  console.log('\n\n====================\n\n');
+  console.dir(contentParts, { depth: null });
+
+  const { handleLLMEnd, collected } = createMetadataAggregator();
+  const titleResult = await run.generateTitle({
+    inputText: userMessage2,
+    contentParts,
+    chainOptions: {
+      callbacks: [{
+        handleLLMEnd,
+      }],
+    },
+  });
+  console.log('Generated Title:', titleResult);
+  console.log('Collected metadata:', collected);
+}
+
+process.on('unhandledRejection', (reason, promise) => {
+  console.error('Unhandled Rejection at:', promise, 'reason:', reason);
+  console.log('Conversation history:');
+  console.dir(conversationHistory, { depth: null });
+  process.exit(1);
+});
+
+testCodeExecution().catch((err) => {
+  console.error(err);
+  console.log('Conversation history:');
+  console.dir(conversationHistory, { depth: null });
+  process.exit(1);
+});

package/src/tools/CodeExecutor.ts

@@ -0,0 +1,105 @@
+import { z } from 'zod';
+import { config } from 'dotenv';
+import { tool, DynamicStructuredTool } from '@langchain/core/tools';
+
+config();
+
+const EXEC_ENDPOINT = 'https://api.librechat.ai/exec';
+
+export type CodeExecutionToolParams = {
+  session_id?: string;
+  user_id?: string;
+}
+
+export type FileRef = {
+  id: string;
+  name: string;
+  path?: string;
+};
+
+export type FileRefs = FileRef[];
+
+export type ExecuteResult = {
+  session_id: string;
+  stdout: string;
+  stderr: string;
+  files?: FileRefs;
+};
+
+const CodeExecutionToolSchema = z.object({
+  lang: z.enum([
+    'py',
+    'js',
+    'ts',
+    'c',
+    'cpp',
+    'java',
+    'php',
+    'rs',
+    'go',
+    'bash',
+    'd',
+    'f90',
+  ])
+    .describe('The programming language or runtime to execute the code in.'),
+  code: z.string()
+    .describe('The complete, self-contained code to execute, without any truncation or minimization.'),
+  args: z.array(z.string()).optional()
+    .describe('Additional arguments to execute the code with.'),
+});
+
+function createCodeExecutionTool(params: CodeExecutionToolParams = {}): DynamicStructuredTool<typeof CodeExecutionToolSchema> {
+  return tool<typeof CodeExecutionToolSchema>(
+    async ({ lang, code, ...rest }) => {
+      const postData = {
+        lang,
+        code,
+        ...rest,
+        ...params,
+      };
+
+      try {
+        const response = await fetch(EXEC_ENDPOINT, {
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+            'User-Agent': 'LibreChat/1.0',
+          },
+          body: JSON.stringify(postData),
+        });
+
+        if (!response.ok) {
+          throw new Error(`HTTP error! status: ${response.status}`);
+        }
+
+        const result: ExecuteResult = await response.json();
+        let formattedOutput = '';
+        if (result.stdout) formattedOutput += `stdout:\n${result.stdout}\n`;
+        if (result.stderr) formattedOutput += `stderr:\n${result.stderr}\n`;
+        if (result.files && result.files.length > 0) {
+          formattedOutput += 'Generated files:\n';
+          result.files.forEach((file: FileRef) => {
+            formattedOutput += `${file.name}`;
+          });
+          return [formattedOutput.trim(), result.files];
+        }
+
+        return [formattedOutput.trim(), undefined];
+      } catch (error) {
+        return `Calling tool with arguments:\n\n${JSON.stringify({
+          lang,
+          code,
+          ...rest,
+        })}\n\nraised the following error:\n\n${(error as Error | undefined)?.message}`;
+      }
+    },
+    {
+      name: 'execute_code',
+      description: 'Executes code in various programming languages, returning stdout/stderr output.',
+      schema: CodeExecutionToolSchema,
+      responseFormat: 'content_and_artifact',
+    }
+  );
+}
+
+export { createCodeExecutionTool };