💾 feat: Add Memory Configuration Options for CI unit tests

[chrisdoyle]

Summary

TL;DR

• Updated GitHub Actions workflows with configurable Node.js heap allocation, defaults to 6144 MiB (i.e., --max-old-space-size=6144)
• Added heap usage logging for memory monitoring and debugging (i.e., --logHeapUsage)
• Increased Docker frontend build memory allocation to ensure consistent memory limits
• Optimized Jest timeout for the tokenSplit.spec.js test

---

Background

We manage a forked version of LibreChat in our Enterprise Cloud GitHub Organization. While working on our upgrade to v0.8.x we noted CI test failures due to a JavaScript heap out of memory error during Pull Requests, notably:

• During the "Build Client" step of Frontend Unit Tests (Ubuntu + Windows)
• During the "Run unit tests" step of Backend Unit Tests

HOWEVER, as @danny-avila noted, this is not a bug. After exhaustive research on our side, we discovered that these tests were failing because the Standard GitHub-hosted runners within our Enterprise-hosted pool use smaller VMs than those provided by the Public GitHub Actions pool in order to manage isolation and costs more tightly. The same tests pass when executed from accounts within the Public GitHub Actions environment (upstream and personal), which instead use large, multi-tenant Azure VMs with larger out-of-the-box capacity.

In summary:

    ubuntu-latest (Enterprise Cloud) != ubuntu-latest (Public)

As such, I have prepared a configurable override for the Node.js heap allocation via this PR, and per his request:

Since test setup works well as is within the GitHub CI/CD environment, making the new hardcoded options configurable would be preferred.

Change Type

Please delete any irrelevant options.

• New feature (non-breaking change which adds functionality)

Testing

We tested the successful execution of the unit tests using our GitHub Enterprise runners AND from my personal GitHub account.

Test Configuration:

1. Mirrored the LibreChat repository into our GitHub organization.
2. Created a feature branch off of main to isolate testing.
3. Added push event trigger for feat/* branches for Backend Unit Tests and Frontend Unit Tests to enable iterative testing without a PR.

    branches:
      - feat/*

4. Observed test failures before fix and success after fix in GitHub Actions.
5. Repeated exercise in forked repository under my Personal GitHub account, and validated output.

Checklist

Please delete any irrelevant options.

• My code adheres to this project's style guidelines
• I have performed a self-review of my own code
• My changes do not introduce new warnings
• Local unit tests pass with my changes

[Copilot]

Pull request overview

This PR adds configurable memory allocation settings to improve CI test reliability, particularly for environments with smaller VM resources than standard GitHub-hosted runners. The changes set a default Node.js heap size of 6144 MiB and add heap usage logging for debugging purposes.

• Added NODE_OPTIONS environment variable configuration with --max-old-space-size=6144 across CI workflows
• Implemented --logHeapUsage flag in Jest test scripts for memory monitoring
• Updated Docker build configurations to use configurable memory limits via build arguments

Reviewed changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
.github/workflows/frontend-review.yml	Adds NODE_OPTIONS environment variable for Ubuntu and Windows frontend test jobs
.github/workflows/backend-review.yml	Adds NODE_OPTIONS environment variable for backend test job
.github/workflows/build.yml	Adds NODE_MAX_OLD_SPACE_SIZE build argument for Docker container build
Dockerfile	Introduces ARG for configurable memory and applies it to frontend build step
Dockerfile.multi	Introduces ARG for configurable memory in multi-stage build
api/package.json	Adds --logHeapUsage flag to CI test script
client/package.json	Adds --logHeapUsage flag to CI test script
packages/data-provider/package.json	Adds --logHeapUsage flag to CI test script
api/test/jestSetup.js	Attempts to set NODE_MAX_OLD_SPACE_SIZE environment variable
api/test/.env.test.example	Documents NODE_MAX_OLD_SPACE_SIZE configuration
api/app/clients/document/tokenSplit.spec.js	Increases Jest timeout to 120 seconds for slow-running tests
.env.example	Documents NODE_MAX_OLD_SPACE_SIZE environment variable

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

You can also share your feedback on Copilot code review for a chance to win a $100 gift card. Take the survey.

[danny-avila]

there is a merge conflict in the code, changed base branch to dev-staging