Enhanced ChatGPT Clone: Features Agents, MCP, Skills, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenAPI Actions, Functions, Secure Multi-User Auth, Presets, open-source for self-hosting. Active
TypeScript aianthropicartifactsawsazurechatgptchatgpt-cloneclaudeclonedeepseekgeminigooglegpt-5librechatmcpo1openairesponses-apivisionwebui
🚦 ci: Reduce GitHub Actions Runner Pressure (#14716)
Marco Beretta82de3bc42229
diff --git a/.github/workflows/a11y.yml b/.github/workflows/a11y.ymlindex e217c03769..4de5212aa5 100644--- a/.github/workflows/a11y.yml+++ b/.github/workflows/a11y.yml@@ -16,6 +16,10 @@ permissions:contents: readpull-requests: write+concurrency:+ group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}+ cancel-in-progress: true+jobs:axe-linter:runs-on: ubuntu-latestdiff --git a/.github/workflows/agents-integration-tests.yml b/.github/workflows/agents-integration-tests.ymlindex 9454e8883b..4353e622b0 100644--- a/.github/workflows/agents-integration-tests.yml+++ b/.github/workflows/agents-integration-tests.yml@@ -20,6 +20,10 @@ on:permissions:contents: read+concurrency:+ group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}+ cancel-in-progress: true+jobs:agents_integration_tests:name: Integration Tests that use in-process MongoDBdiff --git a/.github/workflows/backend-review.yml b/.github/workflows/backend-review.ymlindex 67541f5b06..47e08d03fc 100644--- a/.github/workflows/backend-review.yml+++ b/.github/workflows/backend-review.yml@@ -11,6 +11,10 @@ on:permissions:contents: read+concurrency:+ group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}+ cancel-in-progress: true+env:NODE_ENV: CINODE_OPTIONS: '--max-old-space-size=${{ secrets.NODE_MAX_OLD_SPACE_SIZE || 6144 }}'diff --git a/.github/workflows/cache-integration-tests.yml b/.github/workflows/cache-integration-tests.ymlindex 3f6908921f..f98cff0c2f 100644--- a/.github/workflows/cache-integration-tests.yml+++ b/.github/workflows/cache-integration-tests.yml@@ -19,6 +19,10 @@ on:permissions:contents: read+concurrency:+ group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}+ cancel-in-progress: true+jobs:cache_integration_tests:name: Integration Tests that use actual Redis Cachediff --git a/.github/workflows/config-review.yml b/.github/workflows/config-review.ymldeleted file mode 100644index b89c4e4c9f..0000000000--- a/.github/workflows/config-review.yml+++ /dev/null@@ -1,89 +0,0 @@-name: Config Migration Tests-on:- pull_request:- paths:- - 'config/**'- - 'api/models/**'- - 'api/db/**'- - 'packages/data-schemas/src/**'- - 'packages/data-provider/src/**'- - 'packages/api/src/acl/**'- - 'packages/api/src/shared-links/**'- - '!**.md'--env:- NODE_ENV: CI- NODE_OPTIONS: '--max-old-space-size=${{ secrets.NODE_MAX_OLD_SPACE_SIZE || 6144 }}'--jobs:- test-config:- name: 'Tests: config migrations'- runs-on: ubuntu-latest- timeout-minutes: 15- steps:- - uses: actions/checkout@v5-- - name: Use Node.js 24.16.0- uses: actions/setup-node@v5- with:- node-version: '24.16.0'-- - name: Restore node_modules cache- id: cache-node-modules- uses: actions/cache@v5- with:- path: |- node_modules- api/node_modules- packages/api/node_modules- packages/data-provider/node_modules- packages/data-schemas/node_modules- key: node-modules-backend-${{ runner.os }}-20.19-${{ hashFiles('package-lock.json') }}-- - name: Install dependencies- if: steps.cache-node-modules.outputs.cache-hit != 'true'- run: npm ci-- - name: Restore data-provider build cache- id: cache-data-provider- uses: actions/cache@v5- with:- path: packages/data-provider/dist- key: build-data-provider-${{ runner.os }}-${{ hashFiles('packages/data-provider/src/**', 'packages/data-provider/tsconfig*.json', 'packages/data-provider/tsdown.config.mjs', 'packages/data-provider/package.json') }}-- - name: Build data-provider- if: steps.cache-data-provider.outputs.cache-hit != 'true'- run: npm run build:data-provider-- - name: Restore data-schemas build cache- id: cache-data-schemas- uses: actions/cache@v5- with:- path: packages/data-schemas/dist- key: build-data-schemas-${{ runner.os }}-${{ hashFiles('packages/data-schemas/src/**', 'packages/data-schemas/tsconfig*.json', 'packages/data-schemas/tsdown.config.mjs', 'packages/data-schemas/package.json', 'packages/data-provider/src/**', 'packages/data-provider/tsconfig*.json', 'packages/data-provider/tsdown.config.mjs', 'packages/data-provider/package.json') }}-- - name: Build data-schemas- if: steps.cache-data-schemas.outputs.cache-hit != 'true'- run: npm run build:data-schemas-- - name: Restore api build cache- id: cache-api- uses: actions/cache@v5- with:- path: packages/api/dist- key: build-api-${{ runner.os }}-${{ hashFiles('packages/api/src/**', 'packages/api/tsconfig*.json', 'packages/api/tsdown.config.mjs', 'packages/api/package.json', 'packages/data-provider/src/**', 'packages/data-provider/tsconfig*.json', 'packages/data-provider/tsdown.config.mjs', 'packages/data-provider/package.json', 'packages/data-schemas/src/**', 'packages/data-schemas/tsconfig*.json', 'packages/data-schemas/tsdown.config.mjs', 'packages/data-schemas/package.json') }}-- - name: Build api- if: steps.cache-api.outputs.cache-hit != 'true'- run: npm run build:api-- - name: Create empty auth.json file- run: |- mkdir -p api/data- echo '{}' > api/data/auth.json-- - name: Prepare .env.test file- run: cp api/test/.env.test.example api/test/.env.test-- - name: Run config migration tests- run: npm run test:configdiff --git a/.github/workflows/eslint-ci.yml b/.github/workflows/eslint-ci.ymldeleted file mode 100644index 47e8fbb970..0000000000--- a/.github/workflows/eslint-ci.yml+++ /dev/null@@ -1,132 +0,0 @@-name: ESLint Code Quality Checks--on:- pull_request:- branches:- - main- - dev- - dev-staging- - release/*- paths:- - 'api/**'- - 'client/**'- - 'packages/**'- - '.github/workflows/eslint-ci.yml'- - '!**.md'--jobs:- eslint_checks:- name: Run ESLint Linting- runs-on: ubuntu-latest- permissions:- contents: read- security-events: write- actions: read- steps:- - name: Checkout repository- uses: actions/checkout@v5- with:- fetch-depth: 0-- - name: Set up Node.js 24.16.0- uses: actions/setup-node@v5- with:- node-version: '24.16.0'- cache: npm-- - name: Install dependencies- run: npm ci-- # Run ESLint on changed files within the api/, client/, and packages/ directories.- - name: Run ESLint on changed files- run: |- # Extract the base commit SHA from the pull_request event payload.- BASE_SHA=$(jq --raw-output .pull_request.base.sha "$GITHUB_EVENT_PATH")- echo "Base commit SHA: $BASE_SHA"-- # Get changed files (only JS/TS files in api/, client/, or packages/)- mapfile -d '' -t CHANGED_FILES < <(- git diff -z --name-only --diff-filter=ACMRTUXB "$BASE_SHA" HEAD |- grep -zE '^(api|client|packages)/.*\.(js|jsx|ts|tsx)$' || true- )-- # Debug output- echo "Changed files:"- printf '%s\n' "${CHANGED_FILES[@]}"-- # Ensure there are files to lint before running ESLint- if [[ ${#CHANGED_FILES[@]} -eq 0 ]]; then- echo "No matching files changed. Skipping ESLint."- exit 0- fi-- # Run ESLint- # --no-warn-ignored: changed files under config-ignored paths- # (e.g. packages/data-schemas/misc/**) must not fail --max-warnings=0- npx eslint --no-error-on-unmatched-pattern \- --config eslint.config.mjs \- --no-warn-ignored \- --max-warnings=0 \- -- "${CHANGED_FILES[@]}"-- # Run Prettier --check on the same set of changed files to catch- # formatting drift in PRs that bypassed the local pre-commit hook- # (e.g. GitHub UI edit-and-merge, `git commit --no-verify`).- - name: Run Prettier --check on changed files- run: |- BASE_SHA=$(jq --raw-output .pull_request.base.sha "$GITHUB_EVENT_PATH")- mapfile -d '' -t CHANGED_FILES < <(- git diff -z --name-only --diff-filter=ACMRTUXB "$BASE_SHA" HEAD |- grep -zE '^(api|client|packages)/.*\.(js|jsx|ts|tsx)$' || true- )-- if [[ ${#CHANGED_FILES[@]} -eq 0 ]]; then- echo "No matching files changed. Skipping Prettier."- exit 0- fi-- echo "Files to check:"- printf '%s\n' "${CHANGED_FILES[@]}"-- # `prettier --check` exits non-zero if any file would be reformatted.- # Suggest the local fix in the failure message so contributors aren't- # left guessing how to resolve.- if ! npx prettier --check --no-error-on-unmatched-pattern -- "${CHANGED_FILES[@]}"; then- echo ""- echo "::error::Prettier formatting drift detected. Fix locally with:"- echo "::error:: npx prettier --write <files>"- echo "::error::Or rely on the lint-staged pre-commit hook (do not bypass with --no-verify)."- exit 1- fi-- # Verify import ordering on the same set of changed files. The script- # only sorts files under known source roots, so unrelated changed files- # (configs, etc.) are ignored. Matches the lint-staged pre-commit hook.- - name: Check import sorting on changed files- run: |- BASE_SHA=$(jq --raw-output .pull_request.base.sha "$GITHUB_EVENT_PATH")- mapfile -d '' -t CHANGED_FILES < <(- git diff -z --name-only --diff-filter=ACMRTUXB "$BASE_SHA" HEAD |- grep -zE '^(api|client|packages)/.*\.(js|jsx|ts|tsx)$' || true- )-- if [[ ${#CHANGED_FILES[@]} -eq 0 ]]; then- echo "No matching files changed. Skipping import-sort check."- exit 0- fi-- echo "Files to check:"- printf '%s\n' "${CHANGED_FILES[@]}"-- # `--check` lists offending files and exits non-zero without writing.- if ! node scripts/sort-imports.mts --check "${CHANGED_FILES[@]}"; then- echo ""- echo "::error::Import order drift detected. Fix locally with:"- echo "::error:: npm run sort-imports"- echo "::error::For specific files:"- echo "::error:: npm run sort-imports -- packages/api/src/app/metrics.ts packages/api/src/rum/proxy.ts"- echo "::error::To check without writing files:"- echo "::error:: npm run sort-imports:check"- echo "::error::Or rely on the lint-staged pre-commit hook (do not bypass with --no-verify)."- exit 1- fidiff --git a/.github/workflows/frontend-review.yml b/.github/workflows/frontend-review.ymlindex 1a2e505e7d..d3bd40ae47 100644--- a/.github/workflows/frontend-review.yml+++ b/.github/workflows/frontend-review.yml@@ -12,6 +12,10 @@ on:permissions:contents: read+concurrency:+ group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}+ cancel-in-progress: true+env:NODE_OPTIONS: '--max-old-space-size=${{ secrets.NODE_MAX_OLD_SPACE_SIZE || 6144 }}'@@ -162,62 +166,14 @@ jobs:working-directory: packages/clienttest-ubuntu:- name: 'Tests: Ubuntu (shard ${{ matrix.shard }}/4)'+ name: 'Tests: Ubuntu (shard ${{ matrix.shard }}/2)'needs: buildruns-on: ubuntu-latesttimeout-minutes: 15strategy:fail-fast: falsematrix:- shard: [1, 2, 3, 4]- steps:- - uses: actions/checkout@v5-- - name: Use Node.js 24.16.0- uses: actions/setup-node@v5- with:- node-version: '24.16.0'-- - name: Restore node_modules cache- id: cache-node-modules- uses: actions/cache@v5- with:- path: |- node_modules- client/node_modules- packages/client/node_modules- packages/data-provider/node_modules- key: node-modules-frontend-${{ runner.os }}-24.16.0-${{ hashFiles('package-lock.json') }}-- - name: Install dependencies- if: steps.cache-node-modules.outputs.cache-hit != 'true'- run: npm ci-- - name: Download data-provider build- uses: actions/download-artifact@v7- with:- name: build-data-provider- path: packages/data-provider/dist-- - name: Download client-package build- uses: actions/download-artifact@v7- with:- name: build-client-package- path: packages/client/dist-- - name: Run unit tests (shard ${{ matrix.shard }}/4)- run: npm run test:ci -- --shard=${{ matrix.shard }}/4- working-directory: client-- test-windows:- name: 'Tests: Windows (shard ${{ matrix.shard }}/4)'- needs: build- runs-on: windows-latest- timeout-minutes: 20- strategy:- fail-fast: false- matrix:- shard: [1, 2, 3, 4]+ shard: [1, 2]steps:- uses: actions/checkout@v5@@ -253,8 +209,8 @@ jobs:name: build-client-packagepath: packages/client/dist- - name: Run unit tests (shard ${{ matrix.shard }}/4)- run: npm run test:ci -- --shard=${{ matrix.shard }}/4+ - name: Run unit tests (shard ${{ matrix.shard }}/2)+ run: npm run test:ci -- --shard=${{ matrix.shard }}/2working-directory: clientbuild-verify:diff --git a/.github/workflows/frontend-windows-nightly.yml b/.github/workflows/frontend-windows-nightly.ymlnew file mode 100644index 0000000000..d8da19e7cd--- /dev/null+++ b/.github/workflows/frontend-windows-nightly.yml@@ -0,0 +1,139 @@+name: Frontend Windows Tests++on:+ schedule:+ - cron: '17 3 * * *'+ workflow_dispatch:++permissions:+ contents: read++concurrency:+ group: ${{ github.workflow }}-${{ github.ref }}+ cancel-in-progress: true++env:+ NODE_OPTIONS: '--max-old-space-size=${{ secrets.NODE_MAX_OLD_SPACE_SIZE || 6144 }}'++jobs:+ build:+ name: Build packages+ runs-on: ubuntu-latest+ timeout-minutes: 15+ outputs:+ source-sha: ${{ steps.source.outputs.sha }}+ steps:+ - uses: actions/checkout@v5+ with:+ ref: ${{ github.event_name == 'schedule' && 'dev' || github.sha }}++ - name: Capture source SHA+ id: source+ shell: bash+ run: echo "sha=$(git rev-parse HEAD)" >> "$GITHUB_OUTPUT"++ - name: Use Node.js 24.16.0+ uses: actions/setup-node@v5+ with:+ node-version: '24.16.0'++ - name: Restore node_modules cache+ id: cache-node-modules+ uses: actions/cache@v5+ with:+ path: |+ node_modules+ client/node_modules+ packages/client/node_modules+ packages/data-provider/node_modules+ key: node-modules-frontend-${{ runner.os }}-24.16.0-${{ hashFiles('package-lock.json') }}++ - name: Install dependencies+ if: steps.cache-node-modules.outputs.cache-hit != 'true'+ run: npm ci++ - name: Restore data-provider build cache+ id: cache-data-provider+ uses: actions/cache@v5+ with:+ path: packages/data-provider/dist+ key: build-data-provider-${{ runner.os }}-${{ hashFiles('packages/data-provider/src/**', 'packages/data-provider/tsconfig*.json', 'packages/data-provider/tsdown.config.mjs', 'packages/data-provider/package.json') }}++ - name: Build data-provider+ if: steps.cache-data-provider.outputs.cache-hit != 'true'+ run: npm run build:data-provider++ - name: Restore client-package build cache+ id: cache-client-package+ uses: actions/cache@v5+ with:+ path: packages/client/dist+ key: build-client-package-${{ runner.os }}-${{ hashFiles('packages/client/src/**', 'packages/client/tsconfig*.json', 'packages/client/tsdown.config.mjs', 'packages/client/package.json', 'packages/data-provider/src/**', 'packages/data-provider/tsconfig*.json', 'packages/data-provider/tsdown.config.mjs', 'packages/data-provider/package.json') }}++ - name: Build client-package+ if: steps.cache-client-package.outputs.cache-hit != 'true'+ run: npm run build:client-package++ - name: Upload data-provider build+ uses: actions/upload-artifact@v6+ with:+ name: build-data-provider+ path: packages/data-provider/dist+ retention-days: 2++ - name: Upload client-package build+ uses: actions/upload-artifact@v6+ with:+ name: build-client-package+ path: packages/client/dist+ retention-days: 2++ test-windows:+ name: 'Tests: Windows (shard ${{ matrix.shard }}/4)'+ needs: build+ runs-on: windows-latest+ timeout-minutes: 20+ strategy:+ fail-fast: false+ matrix:+ shard: [1, 2, 3, 4]+ steps:+ - uses: actions/checkout@v5+ with:+ ref: ${{ needs.build.outputs.source-sha }}++ - name: Use Node.js 24.16.0+ uses: actions/setup-node@v5+ with:+ node-version: '24.16.0'++ - name: Restore node_modules cache+ id: cache-node-modules+ uses: actions/cache@v5+ with:+ path: |+ node_modules+ client/node_modules+ packages/client/node_modules+ packages/data-provider/node_modules+ key: node-modules-frontend-${{ runner.os }}-24.16.0-${{ hashFiles('package-lock.json') }}++ - name: Install dependencies+ if: steps.cache-node-modules.outputs.cache-hit != 'true'+ run: npm ci++ - name: Download data-provider build+ uses: actions/download-artifact@v7+ with:+ name: build-data-provider+ path: packages/data-provider/dist++ - name: Download client-package build+ uses: actions/download-artifact@v7+ with:+ name: build-client-package+ path: packages/client/dist++ - name: Run unit tests (shard ${{ matrix.shard }}/4)+ run: npm run test:ci -- --shard=${{ matrix.shard }}/4+ working-directory: clientdiff --git a/.github/workflows/i18n-unused-keys.yml b/.github/workflows/i18n-unused-keys.ymldeleted file mode 100644index 33e47d58a7..0000000000--- a/.github/workflows/i18n-unused-keys.yml+++ /dev/null@@ -1,151 +0,0 @@-name: Detect Unused i18next Strings--# This workflow checks for unused i18n keys in translation files.-# It has special handling for:-# - com_ui_special_var_* keys that are dynamically constructed-# - com_agents_category_* keys that are stored in the database and used dynamically--on:- pull_request:- paths:- - "client/src/**"- - "api/**"- - "packages/data-provider/src/**"- - "packages/client/**"- - "packages/data-schemas/src/**"- - "!**.md"--jobs:- detect-unused-i18n-keys:- runs-on: ubuntu-latest- permissions:- contents: read- pull-requests: write- steps:- - name: Checkout repository- uses: actions/checkout@v5-- - name: Find unused i18next keys- id: find-unused- run: |- echo "🔍 Scanning for unused i18next keys..."-- # Define paths- I18N_FILE="client/src/locales/en/translation.json"- SOURCE_DIRS=("client/src" "api" "packages/data-provider/src" "packages/client" "packages/data-schemas/src")-- # Check if translation file exists- if [[ ! -f "$I18N_FILE" ]]; then- echo "::error title=Missing i18n File::Translation file not found: $I18N_FILE"- exit 1- fi-- # Extract all keys from the JSON file- KEYS=$(jq -r 'keys[]' "$I18N_FILE")-- # Track unused keys- UNUSED_KEYS=()-- # Check if each key is used in the source code- for KEY in $KEYS; do- FOUND=false-- # Special case for dynamically constructed special variable keys- if [[ "$KEY" == com_ui_special_var_* ]]; then- # Check if TSpecialVarLabel is used in the codebase- for DIR in "${SOURCE_DIRS[@]}"; do- if grep -r --include=\*.{js,jsx,ts,tsx} -q "TSpecialVarLabel" "$DIR"; then- FOUND=true- break- fi- done-- # Also check if the key is directly used somewhere- if [[ "$FOUND" == false ]]; then- for DIR in "${SOURCE_DIRS[@]}"; do- if grep -r --include=\*.{js,jsx,ts,tsx} -q "$KEY" "$DIR"; then- FOUND=true- break- fi- done- fi- # Special case for agent category keys that are dynamically used from database- elif [[ "$KEY" == com_agents_category_* ]]; then- # Check if agent category localization is being used- for DIR in "${SOURCE_DIRS[@]}"; do- # Check for dynamic category label/description usage- if grep -r --include=\*.{js,jsx,ts,tsx} -E "category\.(label|description).*startsWith.*['\"]com_" "$DIR" > /dev/null 2>&1 || \- # Check for the method that defines these keys- grep -r --include=\*.{js,jsx,ts,tsx} "ensureDefaultCategories" "$DIR" > /dev/null 2>&1 || \- # Check for direct usage in agentCategory.ts- grep -r --include=\*.ts -E "label:.*['\"]$KEY['\"]" "$DIR" > /dev/null 2>&1 || \- grep -r --include=\*.ts -E "description:.*['\"]$KEY['\"]" "$DIR" > /dev/null 2>&1; then- FOUND=true- break- fi- done-- # Also check if the key is directly used somewhere- if [[ "$FOUND" == false ]]; then- for DIR in "${SOURCE_DIRS[@]}"; do- if grep -r --include=\*.{js,jsx,ts,tsx} -q "$KEY" "$DIR"; then- FOUND=true- break- fi- done- fi- else- # Regular check for other keys- for DIR in "${SOURCE_DIRS[@]}"; do- if grep -r --include=\*.{js,jsx,ts,tsx} -q "$KEY" "$DIR"; then- FOUND=true- break- fi- done- fi-- if [[ "$FOUND" == false ]]; then- UNUSED_KEYS+=("$KEY")- fi- done-- # Output results- if [[ ${#UNUSED_KEYS[@]} -gt 0 ]]; then- echo "🛑 Found ${#UNUSED_KEYS[@]} unused i18n keys:"- echo "unused_keys=$(echo "${UNUSED_KEYS[@]}" | jq -R -s -c 'split(" ")')" >> $GITHUB_ENV- for KEY in "${UNUSED_KEYS[@]}"; do- echo "::warning title=Unused i18n Key::'$KEY' is defined but not used in the codebase."- done- else- echo "✅ No unused i18n keys detected!"- echo "unused_keys=[]" >> $GITHUB_ENV- fi-- - name: Post verified comment on PR- if: env.unused_keys != '[]'- run: |- PR_NUMBER=$(jq --raw-output .pull_request.number "$GITHUB_EVENT_PATH")-- # Format the unused keys list as checkboxes for easy manual checking.- FILTERED_KEYS=$(echo "$unused_keys" | jq -r '.[]' | grep -v '^\s*$' | sed 's/^/- [ ] `/;s/$/`/' )-- COMMENT_BODY=$(cat <<EOF- ### 🚨 Unused i18next Keys Detected-- The following translation keys are defined in \`translation.json\` but are **not used** in the codebase:-- $FILTERED_KEYS-- ⚠️ **Please remove these unused keys to keep the translation files clean.**- EOF- )-- gh api "repos/${{ github.repository }}/issues/${PR_NUMBER}/comments" \- -f body="$COMMENT_BODY" \- -H "Authorization: token $GITHUB_TOKEN"- env:- GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}-- - name: Fail workflow if unused keys found- if: env.unused_keys != '[]'- run: exit 1diff --git a/.github/workflows/playwright-mock.yml b/.github/workflows/playwright-mock.ymlindex 16779dff04..bfe6653766 100644--- a/.github/workflows/playwright-mock.yml+++ b/.github/workflows/playwright-mock.yml@@ -27,7 +27,7 @@ env:jobs:e2e_shards:- name: e2e (${{ matrix.stream_store }}, shard ${{ matrix.shard }}/4)+ name: e2e (${{ matrix.stream_store }}, shard ${{ matrix.shard }}/2)if: >-github.event_name == 'workflow_dispatch' ||(github.event_name == 'pull_request' &&@@ -39,7 +39,7 @@ jobs:fail-fast: falsematrix:stream_store: [memory, redis]- shard: [1, 2, 3, 4]+ shard: [1, 2]services:redis:image: redis:7-alpine@@ -142,7 +142,7 @@ jobs:npx playwright install-deps chrome- name: Run mock-LLM Tier-1 e2e- run: npx playwright test --config=e2e/playwright.config.mock.ts --shard=${{ matrix.shard }}/4+ run: npx playwright test --config=e2e/playwright.config.mock.ts --shard=${{ matrix.shard }}/2env:CI: 'true'diff --git a/.github/workflows/static-checks.yml b/.github/workflows/static-checks.ymlnew file mode 100644index 0000000000..fff4b8d0f3--- /dev/null+++ b/.github/workflows/static-checks.yml@@ -0,0 +1,691 @@+name: Static Checks++on:+ pull_request:+ paths:+ - 'api/**'+ - 'client/**'+ - 'config/**'+ - 'packages/**'+ - 'package.json'+ - 'package-lock.json'+ - '.github/workflows/static-checks.yml'+ - '!**.md'++permissions:+ contents: read+ pull-requests: read++concurrency:+ group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}+ cancel-in-progress: true++env:+ NODE_ENV: CI+ NODE_OPTIONS: '--max-old-space-size=${{ secrets.NODE_MAX_OLD_SPACE_SIZE || 6144 }}'++jobs:+ static-checks:+ name: Static checks+ runs-on: ubuntu-latest+ timeout-minutes: 30++ steps:+ - name: Checkout repository+ uses: actions/checkout@v5+ with:+ fetch-depth: 0++ - name: Detect affected checks+ id: paths+ uses: dorny/paths-filter@v4+ with:+ predicate-quantifier: 'some-with-excludes'+ filters: |+ eslint:+ - 'api/**'+ - 'client/**'+ - 'packages/**'+ - '.github/workflows/static-checks.yml'+ - '!**.md'+ config:+ - 'api/**'+ - 'config/**'+ - 'packages/**'+ - '.github/workflows/static-checks.yml'+ - '!**.md'+ i18n:+ - 'api/**'+ - 'client/src/**'+ - 'packages/client/**'+ - 'packages/data-provider/src/**'+ - 'packages/data-schemas/src/**'+ - '.github/workflows/static-checks.yml'+ - '!**.md'+ unused_packages:+ - 'api/**'+ - 'client/**'+ - 'packages/api/**'+ - 'packages/client/**'+ - 'package.json'+ - 'package-lock.json'+ - '.github/workflows/static-checks.yml'+ - '!**.md'++ - name: Set up Node.js 24.16.0+ uses: actions/setup-node@v5+ with:+ node-version: '24.16.0'+ cache: npm++ - name: Install dependencies+ id: install_dependencies+ continue-on-error: true+ run: npm ci++ # Run ESLint on changed files within the api/, client/, and packages/ directories.+ - name: Run ESLint on changed files+ id: eslint+ if: always() && steps.paths.outputs.eslint == 'true'+ continue-on-error: true+ run: |+ # Extract the base commit SHA from the pull_request event payload.+ BASE_SHA=$(jq --raw-output .pull_request.base.sha "$GITHUB_EVENT_PATH")+ echo "Base commit SHA: $BASE_SHA"++ # Get changed files (only JS/TS files in api/, client/, or packages/)+ mapfile -d '' -t CHANGED_FILES < <(+ git diff -z --name-only --diff-filter=ACMRTUXB "$BASE_SHA" HEAD |+ grep -zE '^(api|client|packages)/.*\.(js|jsx|ts|tsx)$' || true+ )++ # Debug output+ echo "Changed files:"+ printf '%s\n' "${CHANGED_FILES[@]}"++ # Ensure there are files to lint before running ESLint+ if [[ ${#CHANGED_FILES[@]} -eq 0 ]]; then+ echo "No matching files changed. Skipping ESLint."+ exit 0+ fi++ # Run ESLint+ # --no-warn-ignored: changed files under config-ignored paths+ # (e.g. packages/data-schemas/misc/**) must not fail --max-warnings=0+ npx eslint --no-error-on-unmatched-pattern \+ --config eslint.config.mjs \+ --no-warn-ignored \+ --max-warnings=0 \+ -- "${CHANGED_FILES[@]}"++ # Run Prettier --check on the same set of changed files to catch+ # formatting drift in PRs that bypassed the local pre-commit hook+ # (e.g. GitHub UI edit-and-merge, `git commit --no-verify`).+ - name: Run Prettier --check on changed files+ id: prettier+ if: always() && steps.paths.outputs.eslint == 'true'+ continue-on-error: true+ run: |+ BASE_SHA=$(jq --raw-output .pull_request.base.sha "$GITHUB_EVENT_PATH")+ mapfile -d '' -t CHANGED_FILES < <(+ git diff -z --name-only --diff-filter=ACMRTUXB "$BASE_SHA" HEAD |+ grep -zE '^(api|client|packages)/.*\.(js|jsx|ts|tsx)$' || true+ )++ if [[ ${#CHANGED_FILES[@]} -eq 0 ]]; then+ echo "No matching files changed. Skipping Prettier."+ exit 0+ fi++ echo "Files to check:"+ printf '%s\n' "${CHANGED_FILES[@]}"++ # `prettier --check` exits non-zero if any file would be reformatted.+ # Suggest the local fix in the failure message so contributors aren't+ # left guessing how to resolve.+ if ! npx prettier --check --no-error-on-unmatched-pattern -- "${CHANGED_FILES[@]}"; then+ echo ""+ echo "::error::Prettier formatting drift detected. Fix locally with:"+ echo "::error:: npx prettier --write <files>"+ echo "::error::Or rely on the lint-staged pre-commit hook (do not bypass with --no-verify)."+ exit 1+ fi++ # Verify import ordering on the same set of changed files. The script+ # only sorts files under known source roots, so unrelated changed files+ # (configs, etc.) are ignored. Matches the lint-staged pre-commit hook.+ - name: Check import sorting on changed files+ id: import_sort+ if: always() && steps.paths.outputs.eslint == 'true'+ continue-on-error: true+ run: |+ BASE_SHA=$(jq --raw-output .pull_request.base.sha "$GITHUB_EVENT_PATH")+ mapfile -d '' -t CHANGED_FILES < <(+ git diff -z --name-only --diff-filter=ACMRTUXB "$BASE_SHA" HEAD |+ grep -zE '^(api|client|packages)/.*\.(js|jsx|ts|tsx)$' || true+ )++ if [[ ${#CHANGED_FILES[@]} -eq 0 ]]; then+ echo "No matching files changed. Skipping import-sort check."+ exit 0+ fi++ echo "Files to check:"+ printf '%s\n' "${CHANGED_FILES[@]}"++ # `--check` lists offending files and exits non-zero without writing.+ if ! node scripts/sort-imports.mts --check "${CHANGED_FILES[@]}"; then+ echo ""+ echo "::error::Import order drift detected. Fix locally with:"+ echo "::error:: npm run sort-imports"+ echo "::error::For specific files:"+ echo "::error:: npm run sort-imports -- packages/api/src/app/metrics.ts packages/api/src/rum/proxy.ts"+ echo "::error::To check without writing files:"+ echo "::error:: npm run sort-imports:check"+ echo "::error::Or rely on the lint-staged pre-commit hook (do not bypass with --no-verify)."+ exit 1+ fi++ - name: Restore data-provider build cache+ if: always() && steps.paths.outputs.config == 'true'+ id: cache-data-provider+ continue-on-error: true+ uses: actions/cache@v5+ with:+ path: packages/data-provider/dist+ key: build-data-provider-${{ runner.os }}-${{ hashFiles('packages/data-provider/src/**', 'packages/data-provider/tsconfig*.json', 'packages/data-provider/tsdown.config.mjs', 'packages/data-provider/package.json') }}++ - name: Build data-provider+ id: config_data_provider+ if: always() && steps.paths.outputs.config == 'true' && steps.cache-data-provider.outputs.cache-hit != 'true'+ continue-on-error: true+ run: npm run build:data-provider++ - name: Restore data-schemas build cache+ if: always() && steps.paths.outputs.config == 'true'+ id: cache-data-schemas+ continue-on-error: true+ uses: actions/cache@v5+ with:+ path: packages/data-schemas/dist+ key: build-data-schemas-${{ runner.os }}-${{ hashFiles('packages/data-schemas/src/**', 'packages/data-schemas/tsconfig*.json', 'packages/data-schemas/tsdown.config.mjs', 'packages/data-schemas/package.json', 'packages/data-provider/src/**', 'packages/data-provider/tsconfig*.json', 'packages/data-provider/tsdown.config.mjs', 'packages/data-provider/package.json') }}++ - name: Build data-schemas+ id: config_data_schemas+ if: always() && steps.paths.outputs.config == 'true' && steps.cache-data-schemas.outputs.cache-hit != 'true'+ continue-on-error: true+ run: npm run build:data-schemas++ - name: Restore api build cache+ if: always() && steps.paths.outputs.config == 'true'+ id: cache-api+ continue-on-error: true+ uses: actions/cache@v5+ with:+ path: packages/api/dist+ key: build-api-${{ runner.os }}-${{ hashFiles('packages/api/src/**', 'packages/api/tsconfig*.json', 'packages/api/tsdown.config.mjs', 'packages/api/package.json', 'packages/data-provider/src/**', 'packages/data-provider/tsconfig*.json', 'packages/data-provider/tsdown.config.mjs', 'packages/data-provider/package.json', 'packages/data-schemas/src/**', 'packages/data-schemas/tsconfig*.json', 'packages/data-schemas/tsdown.config.mjs', 'packages/data-schemas/package.json') }}++ - name: Build api+ id: config_api+ if: always() && steps.paths.outputs.config == 'true' && steps.cache-api.outputs.cache-hit != 'true'+ continue-on-error: true+ run: npm run build:api++ - name: Create empty auth.json file+ id: config_auth+ if: always() && steps.paths.outputs.config == 'true'+ continue-on-error: true+ run: |+ mkdir -p api/data+ echo '{}' > api/data/auth.json++ - name: Prepare .env.test file+ id: config_env+ if: always() && steps.paths.outputs.config == 'true'+ continue-on-error: true+ run: cp api/test/.env.test.example api/test/.env.test++ - name: Run config migration tests+ id: config_tests+ if: always() && steps.paths.outputs.config == 'true'+ continue-on-error: true+ run: npm run test:config++ - name: Find unused i18next keys+ id: find_unused_i18n+ if: always() && steps.paths.outputs.i18n == 'true'+ continue-on-error: true+ run: |+ echo "🔍 Scanning for unused i18next keys..."++ # Define paths+ I18N_FILE="client/src/locales/en/translation.json"+ SOURCE_DIRS=("client/src" "api" "packages/data-provider/src" "packages/client" "packages/data-schemas/src")++ # Check if translation file exists+ if [[ ! -f "$I18N_FILE" ]]; then+ echo "::error title=Missing i18n File::Translation file not found: $I18N_FILE"+ exit 1+ fi++ # Extract all keys from the JSON file+ KEYS=$(jq -r 'keys[]' "$I18N_FILE")++ # Track unused keys+ UNUSED_KEYS=()++ # Check if each key is used in the source code+ for KEY in $KEYS; do+ FOUND=false++ # Special case for dynamically constructed special variable keys+ if [[ "$KEY" == com_ui_special_var_* ]]; then+ # Check if TSpecialVarLabel is used in the codebase+ for DIR in "${SOURCE_DIRS[@]}"; do+ if grep -r --include=\*.{js,jsx,ts,tsx} -q "TSpecialVarLabel" "$DIR"; then+ FOUND=true+ break+ fi+ done++ # Also check if the key is directly used somewhere+ if [[ "$FOUND" == false ]]; then+ for DIR in "${SOURCE_DIRS[@]}"; do+ if grep -r --include=\*.{js,jsx,ts,tsx} -q "$KEY" "$DIR"; then+ FOUND=true+ break+ fi+ done+ fi+ # Special case for agent category keys that are dynamically used from database+ elif [[ "$KEY" == com_agents_category_* ]]; then+ # Check if agent category localization is being used+ for DIR in "${SOURCE_DIRS[@]}"; do+ # Check for dynamic category label/description usage+ if grep -r --include=\*.{js,jsx,ts,tsx} -E "category\.(label|description).*startsWith.*['\"]com_" "$DIR" > /dev/null 2>&1 || \+ # Check for the method that defines these keys+ grep -r --include=\*.{js,jsx,ts,tsx} "ensureDefaultCategories" "$DIR" > /dev/null 2>&1 || \+ # Check for direct usage in agentCategory.ts+ grep -r --include=\*.ts -E "label:.*['\"]$KEY['\"]" "$DIR" > /dev/null 2>&1 || \+ grep -r --include=\*.ts -E "description:.*['\"]$KEY['\"]" "$DIR" > /dev/null 2>&1; then+ FOUND=true+ break+ fi+ done++ # Also check if the key is directly used somewhere+ if [[ "$FOUND" == false ]]; then+ for DIR in "${SOURCE_DIRS[@]}"; do+ if grep -r --include=\*.{js,jsx,ts,tsx} -q "$KEY" "$DIR"; then+ FOUND=true+ break+ fi+ done+ fi+ else+ # Regular check for other keys+ for DIR in "${SOURCE_DIRS[@]}"; do+ if grep -r --include=\*.{js,jsx,ts,tsx} -q "$KEY" "$DIR"; then+ FOUND=true+ break+ fi+ done+ fi++ if [[ "$FOUND" == false ]]; then+ UNUSED_KEYS+=("$KEY")+ fi+ done++ # Output results+ if [[ ${#UNUSED_KEYS[@]} -gt 0 ]]; then+ echo "🛑 Found ${#UNUSED_KEYS[@]} unused i18n keys:"+ echo "unused_keys=$(echo "${UNUSED_KEYS[@]}" | jq -R -s -c 'split(" ")')" >> $GITHUB_ENV+ for KEY in "${UNUSED_KEYS[@]}"; do+ echo "::warning title=Unused i18n Key::'$KEY' is defined but not used in the codebase."+ done+ else+ echo "✅ No unused i18n keys detected!"+ echo "unused_keys=[]" >> $GITHUB_ENV+ fi++ - name: Fail workflow if unused keys found+ id: i18n+ if: >+ always() &&+ steps.paths.outputs.i18n == 'true' &&+ (steps.find_unused_i18n.outcome == 'failure' || env.unused_keys != '[]')+ continue-on-error: true+ run: exit 1++ - name: Install depcheck+ id: install_depcheck+ if: always() && steps.paths.outputs.unused_packages == 'true'+ continue-on-error: true+ run: npm install -g depcheck++ - name: Validate JSON files+ id: validate_package_json+ if: always() && steps.paths.outputs.unused_packages == 'true'+ continue-on-error: true+ run: |+ for FILE in package.json client/package.json api/package.json packages/client/package.json; do+ if [[ -f "$FILE" ]]; then+ jq empty "$FILE" || (echo "::error title=Invalid JSON::$FILE is invalid" && exit 1)+ fi+ done++ - name: Extract Dependencies Used in Scripts+ if: always() && steps.paths.outputs.unused_packages == 'true'+ id: extract-used-scripts+ continue-on-error: true+ run: |+ extract_deps_from_scripts() {+ local package_file=$1+ if [[ -f "$package_file" ]]; then+ jq -r '.scripts | to_entries[].value' "$package_file" | \+ grep -oE '([a-zA-Z0-9_-]+)' | sort -u > used_scripts.txt+ else+ touch used_scripts.txt+ fi+ }++ extract_deps_from_scripts "package.json"+ mv used_scripts.txt root_used_deps.txt++ extract_deps_from_scripts "client/package.json"+ mv used_scripts.txt client_used_deps.txt++ extract_deps_from_scripts "api/package.json"+ mv used_scripts.txt api_used_deps.txt++ - name: Extract Dependencies Used in Source Code+ if: always() && steps.paths.outputs.unused_packages == 'true'+ id: extract-used-code+ continue-on-error: true+ run: |+ extract_deps_from_code() {+ local folder=$1+ local output_file=$2++ # Initialize empty output file+ > "$output_file"++ if [[ -d "$folder" ]]; then+ # Extract require() statements (use explicit includes for portability)+ grep -rEho "require\\(['\"]([a-zA-Z0-9@/._-]+)['\"]\\)" "$folder" \+ --include='*.js' --include='*.ts' --include='*.tsx' --include='*.jsx' --include='*.mjs' --include='*.cjs' 2>/dev/null | \+ sed -E "s/require\\(['\"]([a-zA-Z0-9@/._-]+)['\"]\\)/\1/" >> "$output_file" || true++ # Extract ES6 imports - import x from 'module'+ grep -rEho "import .* from ['\"]([a-zA-Z0-9@/._-]+)['\"]" "$folder" \+ --include='*.js' --include='*.ts' --include='*.tsx' --include='*.jsx' --include='*.mjs' --include='*.cjs' 2>/dev/null | \+ sed -E "s/import .* from ['\"]([a-zA-Z0-9@/._-]+)['\"]/\1/" >> "$output_file" || true++ # import 'module' (side-effect imports)+ grep -rEho "import ['\"]([a-zA-Z0-9@/._-]+)['\"]" "$folder" \+ --include='*.js' --include='*.ts' --include='*.tsx' --include='*.jsx' --include='*.mjs' --include='*.cjs' 2>/dev/null | \+ sed -E "s/import ['\"]([a-zA-Z0-9@/._-]+)['\"]/\1/" >> "$output_file" || true++ # export { x } from 'module' or export * from 'module'+ grep -rEho "export .* from ['\"]([a-zA-Z0-9@/._-]+)['\"]" "$folder" \+ --include='*.js' --include='*.ts' --include='*.tsx' --include='*.jsx' --include='*.mjs' --include='*.cjs' 2>/dev/null | \+ sed -E "s/export .* from ['\"]([a-zA-Z0-9@/._-]+)['\"]/\1/" >> "$output_file" || true++ # import type { x } from 'module' (TypeScript)+ grep -rEho "import type .* from ['\"]([a-zA-Z0-9@/._-]+)['\"]" "$folder" \+ --include='*.ts' --include='*.tsx' 2>/dev/null | \+ sed -E "s/import type .* from ['\"]([a-zA-Z0-9@/._-]+)['\"]/\1/" >> "$output_file" || true++ # Remove subpath imports but keep the base package+ # For scoped packages: '@scope/pkg/subpath' -> '@scope/pkg'+ # For regular packages: 'pkg/subpath' -> 'pkg'+ # Scoped packages (must keep @scope/package, strip anything after)+ sed -i -E 's|^(@[a-zA-Z0-9_-]+/[a-zA-Z0-9_-]+)/.*|\1|' "$output_file" 2>/dev/null || true+ # Non-scoped packages (keep package name, strip subpath)+ sed -i -E 's|^([a-zA-Z0-9_-]+)/.*|\1|' "$output_file" 2>/dev/null || true++ sort -u "$output_file" -o "$output_file"+ fi+ }++ extract_deps_from_code "." root_used_code.txt+ extract_deps_from_code "client" client_used_code.txt+ extract_deps_from_code "api" api_used_code.txt++ # Extract dependencies used by workspace packages+ # These packages are used in the workspace but dependencies are provided by parent package.json+ extract_deps_from_code "packages/client" packages_client_used_code.txt+ extract_deps_from_code "packages/api" packages_api_used_code.txt++ - name: Get @librechat/client dependencies+ if: always() && steps.paths.outputs.unused_packages == 'true'+ id: get-librechat-client-deps+ continue-on-error: true+ run: |+ if [[ -f "packages/client/package.json" ]]; then+ # Get all dependencies from @librechat/client (dependencies, devDependencies, and peerDependencies)+ DEPS=$(jq -r '.dependencies // {} | keys[]' packages/client/package.json 2>/dev/null || echo "")+ DEV_DEPS=$(jq -r '.devDependencies // {} | keys[]' packages/client/package.json 2>/dev/null || echo "")+ PEER_DEPS=$(jq -r '.peerDependencies // {} | keys[]' packages/client/package.json 2>/dev/null || echo "")++ # Combine all dependencies+ echo "$DEPS" > librechat_client_deps.txt+ echo "$DEV_DEPS" >> librechat_client_deps.txt+ echo "$PEER_DEPS" >> librechat_client_deps.txt++ # Also include dependencies that are imported in packages/client+ cat packages_client_used_code.txt >> librechat_client_deps.txt++ # Remove empty lines and sort+ grep -v '^$' librechat_client_deps.txt | sort -u > temp_deps.txt+ mv temp_deps.txt librechat_client_deps.txt+ else+ touch librechat_client_deps.txt+ fi++ - name: Get @librechat/api dependencies+ if: always() && steps.paths.outputs.unused_packages == 'true'+ id: get-librechat-api-deps+ continue-on-error: true+ run: |+ if [[ -f "packages/api/package.json" ]]; then+ # Get all dependencies from @librechat/api (dependencies, devDependencies, and peerDependencies)+ DEPS=$(jq -r '.dependencies // {} | keys[]' packages/api/package.json 2>/dev/null || echo "")+ DEV_DEPS=$(jq -r '.devDependencies // {} | keys[]' packages/api/package.json 2>/dev/null || echo "")+ PEER_DEPS=$(jq -r '.peerDependencies // {} | keys[]' packages/api/package.json 2>/dev/null || echo "")++ # Combine all dependencies+ echo "$DEPS" > librechat_api_deps.txt+ echo "$DEV_DEPS" >> librechat_api_deps.txt+ echo "$PEER_DEPS" >> librechat_api_deps.txt++ # Also include dependencies that are imported in packages/api+ cat packages_api_used_code.txt >> librechat_api_deps.txt++ # Remove empty lines and sort+ grep -v '^$' librechat_api_deps.txt | sort -u > temp_deps.txt+ mv temp_deps.txt librechat_api_deps.txt+ else+ touch librechat_api_deps.txt+ fi++ - name: Extract Workspace Dependencies+ if: always() && steps.paths.outputs.unused_packages == 'true'+ id: extract-workspace-deps+ continue-on-error: true+ run: |+ # Function to get dependencies from a workspace package that are used by another package+ get_workspace_package_deps() {+ local package_json=$1+ local output_file=$2++ # Get all workspace dependencies (starting with @librechat/)+ if [[ -f "$package_json" ]]; then+ local workspace_deps=$(jq -r '.dependencies // {} | to_entries[] | select(.key | startswith("@librechat/")) | .key' "$package_json" 2>/dev/null || echo "")++ # For each workspace dependency, get its dependencies+ for dep in $workspace_deps; do+ # Convert @librechat/api to packages/api+ local workspace_path=$(echo "$dep" | sed 's/@librechat\//packages\//')+ local workspace_package_json="${workspace_path}/package.json"++ if [[ -f "$workspace_package_json" ]]; then+ # Extract all dependencies from the workspace package+ jq -r '.dependencies // {} | keys[]' "$workspace_package_json" 2>/dev/null >> "$output_file"+ # Also extract peerDependencies+ jq -r '.peerDependencies // {} | keys[]' "$workspace_package_json" 2>/dev/null >> "$output_file"+ fi+ done+ fi++ if [[ -f "$output_file" ]]; then+ sort -u "$output_file" -o "$output_file"+ else+ touch "$output_file"+ fi+ }++ # Get workspace dependencies for each package+ get_workspace_package_deps "package.json" root_workspace_deps.txt+ get_workspace_package_deps "client/package.json" client_workspace_deps.txt+ get_workspace_package_deps "api/package.json" api_workspace_deps.txt++ - name: Run depcheck for root package.json+ if: always() && steps.paths.outputs.unused_packages == 'true'+ id: check-root+ continue-on-error: true+ run: |+ if [[ -f "package.json" ]]; then+ UNUSED=$(depcheck --json | jq -r '.dependencies | join("\n")' || echo "")+ # Exclude dependencies used in scripts, code, and workspace packages+ UNUSED=$(comm -23 <(echo "$UNUSED" | sort) <(cat root_used_deps.txt root_used_code.txt root_workspace_deps.txt | sort) || echo "")+ echo "ROOT_UNUSED<<EOF" >> $GITHUB_ENV+ echo "$UNUSED" >> $GITHUB_ENV+ echo "EOF" >> $GITHUB_ENV+ fi++ - name: Run depcheck for client/package.json+ if: always() && steps.paths.outputs.unused_packages == 'true'+ id: check-client+ continue-on-error: true+ run: |+ if [[ -f "client/package.json" ]]; then+ chmod -R 755 client+ cd client+ UNUSED=$(depcheck --json | jq -r '.dependencies | join("\n")' || echo "")+ # Exclude dependencies used in scripts, code, workspace packages, and @librechat/client imports+ UNUSED=$(comm -23 <(echo "$UNUSED" | sort) <(cat ../client_used_deps.txt ../client_used_code.txt ../client_workspace_deps.txt ../packages_client_used_code.txt ../librechat_client_deps.txt 2>/dev/null | sort -u) || echo "")+ # Filter out false positives+ UNUSED=$(echo "$UNUSED" | grep -v "^micromark-extension-llm-math$" || echo "")+ echo "CLIENT_UNUSED<<EOF" >> $GITHUB_ENV+ echo "$UNUSED" >> $GITHUB_ENV+ echo "EOF" >> $GITHUB_ENV+ cd ..+ fi++ - name: Run depcheck for api/package.json+ if: always() && steps.paths.outputs.unused_packages == 'true'+ id: check-api+ continue-on-error: true+ run: |+ if [[ -f "api/package.json" ]]; then+ chmod -R 755 api+ cd api+ UNUSED=$(depcheck --json | jq -r '.dependencies | join("\n")' || echo "")+ # Exclude dependencies used in scripts, code, workspace packages, and @librechat/api imports+ UNUSED=$(comm -23 <(echo "$UNUSED" | sort) <(cat ../api_used_deps.txt ../api_used_code.txt ../api_workspace_deps.txt ../packages_api_used_code.txt ../librechat_api_deps.txt 2>/dev/null | sort -u) || echo "")+ echo "API_UNUSED<<EOF" >> $GITHUB_ENV+ echo "$UNUSED" >> $GITHUB_ENV+ echo "EOF" >> $GITHUB_ENV+ cd ..+ fi++ - name: Fail workflow if unused dependencies found+ id: unused_packages+ if: >+ always() &&+ steps.paths.outputs.unused_packages == 'true' &&+ (env.ROOT_UNUSED != '' || env.CLIENT_UNUSED != '' || env.API_UNUSED != '')+ continue-on-error: true+ run: exit 1++ - name: Summarize static check failures+ if: always()+ env:+ INSTALL_DEPENDENCIES_OUTCOME: ${{ steps.install_dependencies.outcome }}+ ESLINT_OUTCOME: ${{ steps.eslint.outcome }}+ PRETTIER_OUTCOME: ${{ steps.prettier.outcome }}+ IMPORT_SORT_OUTCOME: ${{ steps.import_sort.outcome }}+ CACHE_DATA_PROVIDER_OUTCOME: ${{ steps.cache-data-provider.outcome }}+ CONFIG_DATA_PROVIDER_OUTCOME: ${{ steps.config_data_provider.outcome }}+ CACHE_DATA_SCHEMAS_OUTCOME: ${{ steps.cache-data-schemas.outcome }}+ CONFIG_DATA_SCHEMAS_OUTCOME: ${{ steps.config_data_schemas.outcome }}+ CACHE_API_OUTCOME: ${{ steps.cache-api.outcome }}+ CONFIG_API_OUTCOME: ${{ steps.config_api.outcome }}+ CONFIG_AUTH_OUTCOME: ${{ steps.config_auth.outcome }}+ CONFIG_ENV_OUTCOME: ${{ steps.config_env.outcome }}+ CONFIG_TESTS_OUTCOME: ${{ steps.config_tests.outcome }}+ FIND_I18N_OUTCOME: ${{ steps.find_unused_i18n.outcome }}+ I18N_OUTCOME: ${{ steps.i18n.outcome }}+ INSTALL_DEPCHECK_OUTCOME: ${{ steps.install_depcheck.outcome }}+ VALIDATE_PACKAGE_JSON_OUTCOME: ${{ steps.validate_package_json.outcome }}+ EXTRACT_USED_SCRIPTS_OUTCOME: ${{ steps.extract-used-scripts.outcome }}+ EXTRACT_USED_CODE_OUTCOME: ${{ steps.extract-used-code.outcome }}+ GET_CLIENT_DEPS_OUTCOME: ${{ steps.get-librechat-client-deps.outcome }}+ GET_API_DEPS_OUTCOME: ${{ steps.get-librechat-api-deps.outcome }}+ EXTRACT_WORKSPACE_DEPS_OUTCOME: ${{ steps.extract-workspace-deps.outcome }}+ CHECK_ROOT_OUTCOME: ${{ steps.check-root.outcome }}+ CHECK_CLIENT_OUTCOME: ${{ steps.check-client.outcome }}+ CHECK_API_OUTCOME: ${{ steps.check-api.outcome }}+ UNUSED_PACKAGES_OUTCOME: ${{ steps.unused_packages.outcome }}+ run: |+ failures=()++ record_failure() {+ if [[ "$2" == "failure" ]]; then+ failures+=("$1")+ fi+ }++ record_failure "Dependency installation" "$INSTALL_DEPENDENCIES_OUTCOME"+ record_failure "ESLint" "$ESLINT_OUTCOME"+ record_failure "Prettier" "$PRETTIER_OUTCOME"+ record_failure "Import sorting" "$IMPORT_SORT_OUTCOME"+ record_failure "Config data-provider cache" "$CACHE_DATA_PROVIDER_OUTCOME"+ record_failure "Config data-provider build" "$CONFIG_DATA_PROVIDER_OUTCOME"+ record_failure "Config data-schemas cache" "$CACHE_DATA_SCHEMAS_OUTCOME"+ record_failure "Config data-schemas build" "$CONFIG_DATA_SCHEMAS_OUTCOME"+ record_failure "Config API cache" "$CACHE_API_OUTCOME"+ record_failure "Config API build" "$CONFIG_API_OUTCOME"+ record_failure "Config auth preparation" "$CONFIG_AUTH_OUTCOME"+ record_failure "Config environment preparation" "$CONFIG_ENV_OUTCOME"+ record_failure "Config migration tests" "$CONFIG_TESTS_OUTCOME"+ record_failure "Unused i18n scan" "$FIND_I18N_OUTCOME"+ record_failure "Unused i18n keys" "$I18N_OUTCOME"+ record_failure "depcheck installation" "$INSTALL_DEPCHECK_OUTCOME"+ record_failure "Package JSON validation" "$VALIDATE_PACKAGE_JSON_OUTCOME"+ record_failure "Package script dependency extraction" "$EXTRACT_USED_SCRIPTS_OUTCOME"+ record_failure "Source dependency extraction" "$EXTRACT_USED_CODE_OUTCOME"+ record_failure "Client dependency collection" "$GET_CLIENT_DEPS_OUTCOME"+ record_failure "API dependency collection" "$GET_API_DEPS_OUTCOME"+ record_failure "Workspace dependency extraction" "$EXTRACT_WORKSPACE_DEPS_OUTCOME"+ record_failure "Root depcheck" "$CHECK_ROOT_OUTCOME"+ record_failure "Client depcheck" "$CHECK_CLIENT_OUTCOME"+ record_failure "API depcheck" "$CHECK_API_OUTCOME"+ record_failure "Unused NPM packages" "$UNUSED_PACKAGES_OUTCOME"++ if [[ "$UNUSED_PACKAGES_OUTCOME" == "failure" ]]; then+ [[ -n "$ROOT_UNUSED" ]] && printf 'Root unused dependencies:\n%s\n' "$ROOT_UNUSED"+ [[ -n "$CLIENT_UNUSED" ]] && printf 'Client unused dependencies:\n%s\n' "$CLIENT_UNUSED"+ [[ -n "$API_UNUSED" ]] && printf 'API unused dependencies:\n%s\n' "$API_UNUSED"+ fi++ if [[ ${#failures[@]} -eq 0 ]]; then+ echo "All affected static checks passed."+ exit 0+ fi++ echo "::error::Static checks failed:"+ printf ' - %s\n' "${failures[@]}"+ exit 1diff --git a/.github/workflows/unused-packages.yml b/.github/workflows/unused-packages.ymldeleted file mode 100644index 8836f32246..0000000000--- a/.github/workflows/unused-packages.yml+++ /dev/null@@ -1,283 +0,0 @@-name: Detect Unused NPM Packages--on:- pull_request:- paths:- - 'package.json'- - 'package-lock.json'- - 'client/**'- - 'api/**'- - 'packages/client/**'- - 'packages/api/**'- - '!**.md'--jobs:- detect-unused-packages:- runs-on: ubuntu-latest- permissions:- contents: read- pull-requests: write-- steps:- - uses: actions/checkout@v5-- - name: Use Node.js 24.16.0- uses: actions/setup-node@v5- with:- node-version: '24.16.0'- cache: 'npm'-- - name: Install depcheck- run: npm install -g depcheck-- - name: Validate JSON files- run: |- for FILE in package.json client/package.json api/package.json packages/client/package.json; do- if [[ -f "$FILE" ]]; then- jq empty "$FILE" || (echo "::error title=Invalid JSON::$FILE is invalid" && exit 1)- fi- done-- - name: Extract Dependencies Used in Scripts- id: extract-used-scripts- run: |- extract_deps_from_scripts() {- local package_file=$1- if [[ -f "$package_file" ]]; then- jq -r '.scripts | to_entries[].value' "$package_file" | \- grep -oE '([a-zA-Z0-9_-]+)' | sort -u > used_scripts.txt- else- touch used_scripts.txt- fi- }-- extract_deps_from_scripts "package.json"- mv used_scripts.txt root_used_deps.txt-- extract_deps_from_scripts "client/package.json"- mv used_scripts.txt client_used_deps.txt-- extract_deps_from_scripts "api/package.json"- mv used_scripts.txt api_used_deps.txt-- - name: Extract Dependencies Used in Source Code- id: extract-used-code- run: |- extract_deps_from_code() {- local folder=$1- local output_file=$2-- # Initialize empty output file- > "$output_file"-- if [[ -d "$folder" ]]; then- # Extract require() statements (use explicit includes for portability)- grep -rEho "require\\(['\"]([a-zA-Z0-9@/._-]+)['\"]\\)" "$folder" \- --include='*.js' --include='*.ts' --include='*.tsx' --include='*.jsx' --include='*.mjs' --include='*.cjs' 2>/dev/null | \- sed -E "s/require\\(['\"]([a-zA-Z0-9@/._-]+)['\"]\\)/\1/" >> "$output_file" || true-- # Extract ES6 imports - import x from 'module'- grep -rEho "import .* from ['\"]([a-zA-Z0-9@/._-]+)['\"]" "$folder" \- --include='*.js' --include='*.ts' --include='*.tsx' --include='*.jsx' --include='*.mjs' --include='*.cjs' 2>/dev/null | \- sed -E "s/import .* from ['\"]([a-zA-Z0-9@/._-]+)['\"]/\1/" >> "$output_file" || true-- # import 'module' (side-effect imports)- grep -rEho "import ['\"]([a-zA-Z0-9@/._-]+)['\"]" "$folder" \- --include='*.js' --include='*.ts' --include='*.tsx' --include='*.jsx' --include='*.mjs' --include='*.cjs' 2>/dev/null | \- sed -E "s/import ['\"]([a-zA-Z0-9@/._-]+)['\"]/\1/" >> "$output_file" || true-- # export { x } from 'module' or export * from 'module'- grep -rEho "export .* from ['\"]([a-zA-Z0-9@/._-]+)['\"]" "$folder" \- --include='*.js' --include='*.ts' --include='*.tsx' --include='*.jsx' --include='*.mjs' --include='*.cjs' 2>/dev/null | \- sed -E "s/export .* from ['\"]([a-zA-Z0-9@/._-]+)['\"]/\1/" >> "$output_file" || true-- # import type { x } from 'module' (TypeScript)- grep -rEho "import type .* from ['\"]([a-zA-Z0-9@/._-]+)['\"]" "$folder" \- --include='*.ts' --include='*.tsx' 2>/dev/null | \- sed -E "s/import type .* from ['\"]([a-zA-Z0-9@/._-]+)['\"]/\1/" >> "$output_file" || true-- # Remove subpath imports but keep the base package- # For scoped packages: '@scope/pkg/subpath' -> '@scope/pkg'- # For regular packages: 'pkg/subpath' -> 'pkg'- # Scoped packages (must keep @scope/package, strip anything after)- sed -i -E 's|^(@[a-zA-Z0-9_-]+/[a-zA-Z0-9_-]+)/.*|\1|' "$output_file" 2>/dev/null || true- # Non-scoped packages (keep package name, strip subpath)- sed -i -E 's|^([a-zA-Z0-9_-]+)/.*|\1|' "$output_file" 2>/dev/null || true-- sort -u "$output_file" -o "$output_file"- fi- }-- extract_deps_from_code "." root_used_code.txt- extract_deps_from_code "client" client_used_code.txt- extract_deps_from_code "api" api_used_code.txt-- # Extract dependencies used by workspace packages- # These packages are used in the workspace but dependencies are provided by parent package.json- extract_deps_from_code "packages/client" packages_client_used_code.txt- extract_deps_from_code "packages/api" packages_api_used_code.txt-- - name: Get @librechat/client dependencies- id: get-librechat-client-deps- run: |- if [[ -f "packages/client/package.json" ]]; then- # Get all dependencies from @librechat/client (dependencies, devDependencies, and peerDependencies)- DEPS=$(jq -r '.dependencies // {} | keys[]' packages/client/package.json 2>/dev/null || echo "")- DEV_DEPS=$(jq -r '.devDependencies // {} | keys[]' packages/client/package.json 2>/dev/null || echo "")- PEER_DEPS=$(jq -r '.peerDependencies // {} | keys[]' packages/client/package.json 2>/dev/null || echo "")-- # Combine all dependencies- echo "$DEPS" > librechat_client_deps.txt- echo "$DEV_DEPS" >> librechat_client_deps.txt- echo "$PEER_DEPS" >> librechat_client_deps.txt-- # Also include dependencies that are imported in packages/client- cat packages_client_used_code.txt >> librechat_client_deps.txt-- # Remove empty lines and sort- grep -v '^$' librechat_client_deps.txt | sort -u > temp_deps.txt- mv temp_deps.txt librechat_client_deps.txt- else- touch librechat_client_deps.txt- fi-- - name: Get @librechat/api dependencies- id: get-librechat-api-deps- run: |- if [[ -f "packages/api/package.json" ]]; then- # Get all dependencies from @librechat/api (dependencies, devDependencies, and peerDependencies)- DEPS=$(jq -r '.dependencies // {} | keys[]' packages/api/package.json 2>/dev/null || echo "")- DEV_DEPS=$(jq -r '.devDependencies // {} | keys[]' packages/api/package.json 2>/dev/null || echo "")- PEER_DEPS=$(jq -r '.peerDependencies // {} | keys[]' packages/api/package.json 2>/dev/null || echo "")-- # Combine all dependencies- echo "$DEPS" > librechat_api_deps.txt- echo "$DEV_DEPS" >> librechat_api_deps.txt- echo "$PEER_DEPS" >> librechat_api_deps.txt-- # Also include dependencies that are imported in packages/api- cat packages_api_used_code.txt >> librechat_api_deps.txt-- # Remove empty lines and sort- grep -v '^$' librechat_api_deps.txt | sort -u > temp_deps.txt- mv temp_deps.txt librechat_api_deps.txt- else- touch librechat_api_deps.txt- fi-- - name: Extract Workspace Dependencies- id: extract-workspace-deps- run: |- # Function to get dependencies from a workspace package that are used by another package- get_workspace_package_deps() {- local package_json=$1- local output_file=$2-- # Get all workspace dependencies (starting with @librechat/)- if [[ -f "$package_json" ]]; then- local workspace_deps=$(jq -r '.dependencies // {} | to_entries[] | select(.key | startswith("@librechat/")) | .key' "$package_json" 2>/dev/null || echo "")-- # For each workspace dependency, get its dependencies- for dep in $workspace_deps; do- # Convert @librechat/api to packages/api- local workspace_path=$(echo "$dep" | sed 's/@librechat\//packages\//')- local workspace_package_json="${workspace_path}/package.json"-- if [[ -f "$workspace_package_json" ]]; then- # Extract all dependencies from the workspace package- jq -r '.dependencies // {} | keys[]' "$workspace_package_json" 2>/dev/null >> "$output_file"- # Also extract peerDependencies- jq -r '.peerDependencies // {} | keys[]' "$workspace_package_json" 2>/dev/null >> "$output_file"- fi- done- fi-- if [[ -f "$output_file" ]]; then- sort -u "$output_file" -o "$output_file"- else- touch "$output_file"- fi- }-- # Get workspace dependencies for each package- get_workspace_package_deps "package.json" root_workspace_deps.txt- get_workspace_package_deps "client/package.json" client_workspace_deps.txt- get_workspace_package_deps "api/package.json" api_workspace_deps.txt-- - name: Run depcheck for root package.json- id: check-root- run: |- if [[ -f "package.json" ]]; then- UNUSED=$(depcheck --json | jq -r '.dependencies | join("\n")' || echo "")- # Exclude dependencies used in scripts, code, and workspace packages- UNUSED=$(comm -23 <(echo "$UNUSED" | sort) <(cat root_used_deps.txt root_used_code.txt root_workspace_deps.txt | sort) || echo "")- echo "ROOT_UNUSED<<EOF" >> $GITHUB_ENV- echo "$UNUSED" >> $GITHUB_ENV- echo "EOF" >> $GITHUB_ENV- fi-- - name: Run depcheck for client/package.json- id: check-client- run: |- if [[ -f "client/package.json" ]]; then- chmod -R 755 client- cd client- UNUSED=$(depcheck --json | jq -r '.dependencies | join("\n")' || echo "")- # Exclude dependencies used in scripts, code, workspace packages, and @librechat/client imports- UNUSED=$(comm -23 <(echo "$UNUSED" | sort) <(cat ../client_used_deps.txt ../client_used_code.txt ../client_workspace_deps.txt ../packages_client_used_code.txt ../librechat_client_deps.txt 2>/dev/null | sort -u) || echo "")- # Filter out false positives- UNUSED=$(echo "$UNUSED" | grep -v "^micromark-extension-llm-math$" || echo "")- echo "CLIENT_UNUSED<<EOF" >> $GITHUB_ENV- echo "$UNUSED" >> $GITHUB_ENV- echo "EOF" >> $GITHUB_ENV- cd ..- fi-- - name: Run depcheck for api/package.json- id: check-api- run: |- if [[ -f "api/package.json" ]]; then- chmod -R 755 api- cd api- UNUSED=$(depcheck --json | jq -r '.dependencies | join("\n")' || echo "")- # Exclude dependencies used in scripts, code, workspace packages, and @librechat/api imports- UNUSED=$(comm -23 <(echo "$UNUSED" | sort) <(cat ../api_used_deps.txt ../api_used_code.txt ../api_workspace_deps.txt ../packages_api_used_code.txt ../librechat_api_deps.txt 2>/dev/null | sort -u) || echo "")- echo "API_UNUSED<<EOF" >> $GITHUB_ENV- echo "$UNUSED" >> $GITHUB_ENV- echo "EOF" >> $GITHUB_ENV- cd ..- fi-- - name: Post comment on PR if unused dependencies are found- if: env.ROOT_UNUSED != '' || env.CLIENT_UNUSED != '' || env.API_UNUSED != ''- run: |- PR_NUMBER=$(jq --raw-output .pull_request.number "$GITHUB_EVENT_PATH")-- ROOT_LIST=$(echo "$ROOT_UNUSED" | awk '{print "- `" $0 "`"}')- CLIENT_LIST=$(echo "$CLIENT_UNUSED" | awk '{print "- `" $0 "`"}')- API_LIST=$(echo "$API_UNUSED" | awk '{print "- `" $0 "`"}')-- COMMENT_BODY=$(cat <<EOF- ### 🚨 Unused NPM Packages Detected-- The following **unused dependencies** were found:-- $(if [[ ! -z "$ROOT_UNUSED" ]]; then echo "#### 📂 Root \`package.json\`"; echo ""; echo "$ROOT_LIST"; echo ""; fi)-- $(if [[ ! -z "$CLIENT_UNUSED" ]]; then echo "#### 📂 Client \`client/package.json\`"; echo ""; echo "$CLIENT_LIST"; echo ""; fi)-- $(if [[ ! -z "$API_UNUSED" ]]; then echo "#### 📂 API \`api/package.json\`"; echo ""; echo "$API_LIST"; echo ""; fi)-- ⚠️ **Please remove these unused dependencies to keep your project clean.**- EOF- )-- gh api "repos/${{ github.repository }}/issues/${PR_NUMBER}/comments" \- -f body="$COMMENT_BODY" \- -H "Authorization: token $GITHUB_TOKEN"- env:- GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}-- - name: Fail workflow if unused dependencies found- if: env.ROOT_UNUSED != '' || env.CLIENT_UNUSED != '' || env.API_UNUSED != ''- run: exit 1