Skip to content

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

🦿 chore: Bump Agents SDK to 4.2.1 (#17664)

lia-by-librechat[bot]f4154b649efa
diff --git a/api/jest.config.js b/api/jest.config.js
index 716ca04798..9d48595279 100644
--- a/api/jest.config.js
+++ b/api/jest.config.js
@@ -1,6 +1,7 @@
const { maxWorkers, workerIdleMemoryLimit } = require('../config/jest.workers.cjs');
const esModules = [
+ '@librechat/agents',
'openid-client',
'oauth4webapi',
'jose',
@@ -35,7 +36,7 @@ module.exports = {
'^openid-client$': '<rootDir>/test/__mocks__/openid-client.js',
},
transform: {
- '\\.[jt]sx?$': [
+ '\\.[cm]?[jt]sx?$': [
'babel-jest',
{
presets: [
diff --git a/api/package.json b/api/package.json
index fc0ca4ebda..6caeffffdc 100644
--- a/api/package.json
+++ b/api/package.json
@@ -40,7 +40,7 @@
"@azure/storage-blob": "^12.30.0",
"@google/genai": "^2.8.0",
"@keyv/redis": "5.1.6",
- "@librechat/agents": "^4.1.1",
+ "@librechat/agents": "^4.2.1",
"@librechat/api": "*",
"@librechat/data-schemas": "*",
"@microsoft/microsoft-graph-client": "^3.0.7",
diff --git a/api/server/controllers/agents/__tests__/usageEvents.integration.spec.js b/api/server/controllers/agents/__tests__/usageEvents.integration.spec.js
index cd61f4e167..27150b7fcb 100644
--- a/api/server/controllers/agents/__tests__/usageEvents.integration.spec.js
+++ b/api/server/controllers/agents/__tests__/usageEvents.integration.spec.js
@@ -392,8 +392,7 @@ describe('usage events through the real agents pipeline', () => {
}
});
- /** Drives a real summarization (tight context + padded history); self-summarize
- * reuses the overridden fake model so no API key is needed. */
+ /** Leave recent turns small and reserve room for the summary request. */
async function runSummarizationLoop({ res, collectedUsage, contextUsageSink, usageEmitSink }) {
const { aggregateContent } = createContentAggregator();
const handlers = getDefaultHandlers({
@@ -412,7 +411,9 @@ describe('usage events through the real agents pipeline', () => {
new AIMessage(`Turn 1 answer. ${pad}`),
new HumanMessage(`Turn 2 question. ${pad}`),
new AIMessage(`Turn 2 answer. ${pad}`),
- new HumanMessage(`Final question after a lot of prior history. ${pad}`),
+ new HumanMessage('Turn 3 question.'),
+ new AIMessage('3.'),
+ new HumanMessage('Final question?'),
];
const indexTokenCountMap = {};
history.forEach((message, i) => {
@@ -430,9 +431,32 @@ describe('usage events through the real agents pipeline', () => {
streamUsage: false,
},
instructions: 'You are a helpful assistant.',
- maxContextTokens: 700,
+ maxContextTokens: 6000,
summarizationEnabled: true,
- summarizationConfig: { provider: Providers.OPENAI, model: 'gpt-4o-mini' },
+ summarizationConfig: {
+ provider: Providers.OPENAI,
+ model: 'gpt-4o-mini',
+ reserveRatio: 0.5,
+ parameters: {
+ streaming: false,
+ apiKey: 'test-summary-key',
+ configuration: {
+ fetch: async () =>
+ Response.json({
+ id: 'summary-response',
+ model: 'gpt-4o-mini',
+ choices: [
+ {
+ index: 0,
+ message: { role: 'assistant', content: '## Summary\nPrior turns compacted.' },
+ finish_reason: 'stop',
+ },
+ ],
+ usage: { prompt_tokens: 40, completion_tokens: 8, total_tokens: 48 },
+ }),
+ },
+ },
+ },
},
returnContent: true,
customHandlers: handlers,
@@ -440,10 +464,9 @@ describe('usage events through the real agents pipeline', () => {
indexTokenCountMap,
});
- run.Graph.overrideModel = new UsageFakeModel(
- { responses: ['## Summary\nPrior turns compacted.', 'Here is the final answer.'] },
- [{ input_tokens: 40, output_tokens: 8, total_tokens: 48 }],
- );
+ run.Graph.overrideModel = new UsageFakeModel({ responses: ['Here is the final answer.'] }, [
+ { input_tokens: 40, output_tokens: 8, total_tokens: 48 },
+ ]);
await run.processStream(
{ messages: history },
diff --git a/bun.lock b/bun.lock
index 5f34879fe3..ed26a7444f 100644
--- a/bun.lock
+++ b/bun.lock
@@ -55,7 +55,7 @@
"@azure/storage-blob": "^12.30.0",
"@google/genai": "^2.8.0",
"@keyv/redis": "5.1.6",
- "@librechat/agents": "^4.1.1",
+ "@librechat/agents": "^4.2.1",
"@librechat/api": "*",
"@librechat/data-schemas": "*",
"@microsoft/microsoft-graph-client": "^3.0.7",
@@ -378,7 +378,7 @@
"@azure/identity": "^4.14.0",
"@azure/storage-blob": "^12.30.0",
"@keyv/redis": "5.1.6",
- "@librechat/agents": "^4.1.1",
+ "@librechat/agents": "^4.2.1",
"@librechat/data-schemas": "*",
"@modelcontextprotocol/sdk": "^1.32.1",
"@opentelemetry/api": "^1.9.0",
@@ -1597,7 +1597,7 @@
"@lezer/lr": ["@lezer/[email protected]", "", { "dependencies": { "@lezer/common": "^1.0.0" } }, "sha512-pu0K1jCIdnQ12aWNaAVU5bzi7Bd1w54J3ECgANPmYLtQKP0HBj2cE/5coBD66MT10xbtIuUr7tg0Shbsvk0mDA=="],
- "@librechat/agents": ["@librechat/[email protected]", "", { "dependencies": { "@anthropic-ai/sdk": "^0.115.0", "@aws-sdk/client-bedrock-runtime": "^3.1075.0", "@langchain/anthropic": "1.5.2", "@langchain/aws": "^1.4.2", "@langchain/core": "1.2.8", "@langchain/deepseek": "^1.1.3", "@langchain/google-common": "2.2.0", "@langchain/google-gauth": "2.2.0", "@langchain/google-genai": "2.2.0", "@langchain/google-vertexai": "2.2.0", "@langchain/langgraph": "1.4.8", "@langchain/mistralai": "^1.2.0", "@langchain/openai": "1.5.8", "@langchain/textsplitters": "^1.0.1", "@langchain/xai": "^1.4.3", "@langfuse/core": "^5.10.1", "@langfuse/langchain": "^5.10.1", "@langfuse/otel": "^5.10.1", "@langfuse/tracing": "^5.10.1", "@opentelemetry/context-async-hooks": "^2.9.0", "@opentelemetry/sdk-node": "^0.220.0", "@types/diff": "^7.0.2", "ai-tokenizer": "^1.0.6", "axios": "^1.20.0", "cheerio": "^1.2.0", "diff": "^9.0.0", "dotenv": "^16.4.7", "https-proxy-agent": "^7.0.6", "mathjs": "^15.2.0", "nanoid": "^3.3.18", "okapibm25": "^1.4.1", "openai": "^6.46.0", "reova": "^0.4.1", "socks-proxy-agent": "^8.0.5", "uuid": "^11.1.1", "zod": "3.25.67", "zod-to-json-schema": "3.25.2", "zod-v4": "npm:[email protected]" }, "peerDependencies": { "@anthropic-ai/sandbox-runtime": "^0.0.78" }, "optionalPeers": ["@anthropic-ai/sandbox-runtime"] }, "sha512-vbZcHgFPFox+crvvDwt2lBg6tJzl5ADOkzw6HgyOJlkOigScYjS51EGWS3sDoaemBtv4EndRNSlJSGQvJvW/iw=="],
+ "@librechat/agents": ["@librechat/[email protected]", "", { "dependencies": { "@anthropic-ai/sdk": "^0.115.0", "@aws-sdk/client-bedrock-runtime": "^3.1075.0", "@langchain/anthropic": "1.5.2", "@langchain/aws": "^1.4.2", "@langchain/core": "1.2.8", "@langchain/deepseek": "^1.1.3", "@langchain/google-common": "2.2.0", "@langchain/google-gauth": "2.2.0", "@langchain/google-genai": "2.2.0", "@langchain/google-vertexai": "2.2.0", "@langchain/langgraph": "1.4.8", "@langchain/mistralai": "^1.2.0", "@langchain/openai": "1.5.8", "@langchain/textsplitters": "^1.0.1", "@langchain/xai": "^1.4.3", "@langfuse/core": "^5.10.1", "@langfuse/langchain": "^5.10.1", "@langfuse/otel": "^5.10.1", "@langfuse/tracing": "^5.10.1", "@opentelemetry/context-async-hooks": "^2.9.0", "@opentelemetry/sdk-node": "^0.220.0", "@types/diff": "^7.0.2", "ai-tokenizer": "^1.0.6", "axios": "^1.20.0", "cheerio": "^1.2.0", "diff": "^9.0.0", "dotenv": "^16.4.7", "https-proxy-agent": "^7.0.6", "mathjs": "^15.2.0", "nanoid": "^3.3.18", "okapibm25": "^1.4.1", "openai": "^6.46.0", "reova": "^0.4.1", "socks-proxy-agent": "^8.0.5", "uuid": "^11.1.1", "zod": "4.6.7", "zod-to-json-schema": "3.25.2" }, "peerDependencies": { "@anthropic-ai/sandbox-runtime": "^0.0.78" }, "optionalPeers": ["@anthropic-ai/sandbox-runtime"] }, "sha512-HDgD95i7Vx9cx/SqgV1LlQG4fS9ZixJANxFP6wfS8dBXJCeqY27j/lYwtmyswTo45Q7dDRTR6XnN/qYsMToAHg=="],
"@librechat/api": ["@librechat/api@workspace:packages/api"],
@@ -5249,8 +5249,6 @@
"zod-to-json-schema": ["[email protected]", "", { "peerDependencies": { "zod": "^3.25.28 || ^4" } }, "sha512-O/PgfnpT1xKSDeQYSCfRI5Gy3hPf91mKVDuYLUHZJMiDFptvP41MSnWofm8dnCm0256ZNfZIM7DSzuSMAFnjHA=="],
- "zod-v4": ["[email protected]", "", {}, "sha512-g8W2D2kU6a8untc053fX1uVBKzM7yqAxW/3zwk83+6RyF2+SKOuV+c0wBDhUwzV1PaGapmZH+rmcUzPf+3CGwg=="],
-
"zone.js": ["[email protected]", "", {}, "sha512-Eky7p2Z1Ig3NnbfodSPoARCjKBSTFMnE/ACsP1L/XJEfY4SdOFce19BsUCWVwL6K5ABZFy5J3bjcMWffX+YM3Q=="],
"zwitch": ["[email protected]", "", {}, "sha512-bXE4cR/kVZhKZX/RjPEflHaKVhUVl85noU3v6b8apfQEc1x4A+zBxjZ4lN8LqGd6WZ3dl98pY4o717VFmoPp+A=="],
@@ -5371,8 +5369,6 @@
"@librechat/agents/diff": ["[email protected]", "", {}, "sha512-svtcdpS8CgJyqAjEQIXdb3OjhFVVYjzGAPO8WGCmRbrml64SPw/jJD4GoE98aR7r25A0XcgrK3F02yw9R/vhQw=="],
- "@librechat/agents/zod": ["[email protected]", "", {}, "sha512-idA2YXwpCdqUSKRCACDE6ItZD9TZzy3OZMtpfLoh6oPR47lipysRrJfjzMqFxQ3uJuUPyUeWe1r9vLH33xO/Qw=="],
-
"@librechat/api/@librechat/code": ["@librechat/code@file:vendor/code", {}],
"@librechat/backend/@opentelemetry/resources": ["@opentelemetry/[email protected]", "", { "dependencies": { "@opentelemetry/core": "2.10.0", "@opentelemetry/semantic-conventions": "^1.29.0" }, "peerDependencies": { "@opentelemetry/api": ">=1.3.0 <1.10.0" } }, "sha512-q6MMm2zhggzsHVNbabYwut+a6nbuQQe3URUoxaojM/8K1IBfwwPzvxIjNi2/lI1TFe+fMHMW9MWhrtDLEXEnkA=="],
diff --git a/e2e/specs/mock/compaction.helpers.ts b/e2e/specs/mock/compaction.helpers.ts
new file mode 100644
index 0000000000..4cfec6a7f7
--- /dev/null
+++ b/e2e/specs/mock/compaction.helpers.ts
@@ -0,0 +1,22 @@
+import { expect } from '@playwright/test';
+import type { Page } from '@playwright/test';
+import { messagesView, replyPrompt, replyText, sendMessageAndWaitForCompletion } from './helpers';
+
+/** Prepend older exchanges: compaction preserves the last two user-led turns. */
+export async function sendCompactionHistory(
+ page: Page,
+ label: string,
+ turns = 2,
+): Promise<string[]> {
+ const transcript: string[] = [];
+ for (let index = 0; index < turns; index++) {
+ const turnLabel = `history-${index + 1}-${label}`;
+ const prompt = replyPrompt(turnLabel);
+ const reply = replyText(turnLabel);
+ await sendMessageAndWaitForCompletion(page, prompt);
+ await expect(messagesView(page).getByText(reply, { exact: true })).toBeVisible();
+ await expect(page.getByRole('button', { name: 'Stop generating' })).toBeHidden();
+ transcript.push(prompt, reply);
+ }
+ return transcript;
+}
diff --git a/e2e/specs/mock/scenarios/compaction-abort-finalize.spec.ts b/e2e/specs/mock/scenarios/compaction-abort-finalize.spec.ts
index b7ed81d7a2..86c898ba82 100644
--- a/e2e/specs/mock/scenarios/compaction-abort-finalize.spec.ts
+++ b/e2e/specs/mock/scenarios/compaction-abort-finalize.spec.ts
@@ -1,8 +1,6 @@
+import { randomUUID } from 'node:crypto';
import { expect, test } from '@playwright/test';
import type { APIRequestContext, Page } from '@playwright/test';
-import { randomUUID } from 'node:crypto';
-import { getE2EUser } from '../../../setup/user';
-import { deleteConversations, deleteMessagesByConversation, seedMessages, withMongo } from '../db';
import {
MOCK_ENDPOINTS,
NEW_CHAT_PATH,
@@ -11,6 +9,9 @@ import {
selectMockEndpoint,
sendMessageAndWaitForCompletion,
} from '../helpers';
+import { deleteConversations, deleteMessagesByConversation, seedMessages, withMongo } from '../db';
+import { sendCompactionHistory } from '../compaction.helpers';
+import { getE2EUser } from '../../../setup/user';
const userEmail = getE2EUser().email;
const LABEL_SERVER = `http://127.0.0.1:${process.env.E2E_LABEL_PORT || '8889'}`;
@@ -26,10 +27,11 @@ function findRow(filter: Row): Promise<Row | null> {
return withMongo((db) => db.collection('messages').findOne(filter));
}
-/** A finished exchange plus a user leaf seeded under its answer, then a manual
+/** Finished exchanges plus a user leaf seeded under the latest answer, then a manual
* compaction held open on that leaf until the caller presses Stop. */
async function startCompactionOnUserLeaf(page: Page, request: APIRequestContext, label: string) {
await page.goto('/c/new');
+ await sendCompactionHistory(page, label, 1);
await sendMessageAndWaitForCompletion(page, `tell me about ${label}`);
const conversationId = new URL(page.url()).pathname.replace('/c/', '');
expect(conversationId).not.toBe('new');
diff --git a/e2e/specs/mock/scenarios/compaction-collision-settlement.spec.ts b/e2e/specs/mock/scenarios/compaction-collision-settlement.spec.ts
index b976a8177b..5f46ca228a 100644
--- a/e2e/specs/mock/scenarios/compaction-collision-settlement.spec.ts
+++ b/e2e/specs/mock/scenarios/compaction-collision-settlement.spec.ts
@@ -1,7 +1,5 @@
-import { expect, test } from '@playwright/test';
import { randomUUID } from 'node:crypto';
-import { getE2EUser } from '../../../setup/user';
-import { deleteConversations, deleteMessagesByConversation, seedMessages, withMongo } from '../db';
+import { expect, test } from '@playwright/test';
import {
MOCK_ENDPOINTS,
NEW_CHAT_PATH,
@@ -10,6 +8,9 @@ import {
selectMockEndpoint,
sendMessageAndWaitForCompletion,
} from '../helpers';
+import { deleteConversations, deleteMessagesByConversation, seedMessages, withMongo } from '../db';
+import { sendCompactionHistory } from '../compaction.helpers';
+import { getE2EUser } from '../../../setup/user';
const userEmail = getE2EUser().email;
const LABEL_SERVER = `http://127.0.0.1:${process.env.E2E_LABEL_PORT || '8889'}`;
@@ -41,6 +42,7 @@ test.describe('compaction collision settlement', () => {
}) => {
test.setTimeout(120_000);
await page.goto('/c/new');
+ await sendCompactionHistory(page, 'compaction-collision', 1);
await sendMessageAndWaitForCompletion(page, 'tell me about collisions');
const conversationId = new URL(page.url()).pathname.replace('/c/', '');
expect(conversationId).not.toBe('new');
diff --git a/e2e/specs/mock/scenarios/compaction-rerun-controls.spec.ts b/e2e/specs/mock/scenarios/compaction-rerun-controls.spec.ts
index d66c18b697..f17a678bec 100644
--- a/e2e/specs/mock/scenarios/compaction-rerun-controls.spec.ts
+++ b/e2e/specs/mock/scenarios/compaction-rerun-controls.spec.ts
@@ -1,7 +1,7 @@
+import { randomUUID } from 'node:crypto';
import { expect, test } from '@playwright/test';
import type { APIRequestContext, Page } from '@playwright/test';
-import { randomUUID } from 'node:crypto';
-import { getE2EUser } from '../../../setup/user';
+import type { SeedMessage } from '../db';
import {
deleteConversations,
deleteMessagesByConversation,
@@ -9,8 +9,9 @@ import {
seedMessages,
withMongo,
} from '../db';
-import type { SeedMessage } from '../db';
import { messagesView, sendMessageAndWaitForCompletion } from '../helpers';
+import { sendCompactionHistory } from '../compaction.helpers';
+import { getE2EUser } from '../../../setup/user';
const userEmail = getE2EUser().email;
const ROOT_PARENT = '00000000-0000-0000-0000-000000000000';
@@ -92,6 +93,7 @@ const LABEL_SERVER = `http://127.0.0.1:${process.env.E2E_LABEL_PORT || '8889'}`;
*/
async function compactWithEmptySummarizer(page: Page, request: APIRequestContext, label: string) {
await page.goto('/c/new');
+ await sendCompactionHistory(page, label);
await sendMessageAndWaitForCompletion(page, `tell me about ${label}`);
const conversationId = new URL(page.url()).pathname.replace('/c/', '');
expect(conversationId).not.toBe('new');
@@ -130,6 +132,7 @@ async function compactWithEmptySummarizer(page: Page, request: APIRequestContext
*/
async function cancelCompactionOnUserLeaf(page: Page, request: APIRequestContext, label: string) {
await page.goto('/c/new');
+ await sendCompactionHistory(page, label, 1);
await sendMessageAndWaitForCompletion(page, `tell me about ${label}`);
const conversationId = new URL(page.url()).pathname.replace('/c/', '');
expect(conversationId).not.toBe('new');
diff --git a/e2e/specs/mock/scenarios/compaction-snapshot-modes.spec.ts b/e2e/specs/mock/scenarios/compaction-snapshot-modes.spec.ts
index 2ae0745ef2..e3099e6c1b 100644
--- a/e2e/specs/mock/scenarios/compaction-snapshot-modes.spec.ts
+++ b/e2e/specs/mock/scenarios/compaction-snapshot-modes.spec.ts
@@ -1,8 +1,9 @@
-import { expect, test } from '@playwright/test';
import { randomUUID } from 'node:crypto';
-import { getE2EUser } from '../../../setup/user';
+import { expect, test } from '@playwright/test';
import { deleteConversations, deleteMessagesByConversation, seedMessages, withMongo } from '../db';
import { messagesView, sendMessageAndWaitForCompletion } from '../helpers';
+import { sendCompactionHistory } from '../compaction.helpers';
+import { getE2EUser } from '../../../setup/user';
const userEmail = getE2EUser().email;
const LABEL_SERVER = `http://127.0.0.1:${process.env.E2E_LABEL_PORT || '8889'}`;
@@ -33,6 +34,7 @@ test.describe('compaction snapshot modes', () => {
}) => {
test.setTimeout(150_000);
await page.goto('/c/new');
+ await sendCompactionHistory(page, 'abandoned-compaction', 1);
await sendMessageAndWaitForCompletion(page, 'tell me about abandoned compactions');
const conversationId = new URL(page.url()).pathname.replace('/c/', '');
expect(conversationId).not.toBe('new');
diff --git a/e2e/specs/mock/scenarios/step-reducer.spec.ts b/e2e/specs/mock/scenarios/step-reducer.spec.ts
index 118aca7dce..5a9e637c4f 100644
--- a/e2e/specs/mock/scenarios/step-reducer.spec.ts
+++ b/e2e/specs/mock/scenarios/step-reducer.spec.ts
@@ -9,6 +9,7 @@ import {
thinkPrompt,
replyText,
} from '../helpers';
+import { sendCompactionHistory } from '../compaction.helpers';
/**
* Streamed content parts are folded into the response by the step reducers in
@@ -64,6 +65,7 @@ test.describe('step reducer', () => {
test.setTimeout(120_000);
const label = uniqueLabel('compact');
await page.goto(NEW_CHAT_PATH, { timeout: 10_000 });
+ await sendCompactionHistory(page, label);
await sendMessageAndWaitForCompletion(page, `tell me about ${label}`);
await page.getByTestId('token-usage').click();
diff --git a/e2e/specs/mock/thread-fold.spec.ts b/e2e/specs/mock/thread-fold.spec.ts
index 49cbf8d248..7ccd5d8de4 100644
--- a/e2e/specs/mock/thread-fold.spec.ts
+++ b/e2e/specs/mock/thread-fold.spec.ts
@@ -9,6 +9,7 @@ import {
selectMockEndpoint,
sendMessage,
} from './helpers';
+import { sendCompactionHistory } from './compaction.helpers';
/**
* Regression suite for the "folded thread" incident (PR: order-robust message
@@ -205,6 +206,7 @@ test.describe('thread fold regressions', () => {
const latestReply = replyText(`${label}-latest`);
await openMockChat(page);
+ const olderHistory = await sendCompactionHistory(page, label, 1);
await sendAndExpectReply(page, setupPrompt, setupReply);
await sendAndExpectReply(page, latestPrompt, latestReply);
await expect(page).toHaveURL(/\/c\/[0-9a-fA-F-]{36}$/, { timeout: 15000 });
@@ -218,13 +220,16 @@ test.describe('thread fold regressions', () => {
await page.getByRole('button', { name: 'Compact context' }).click();
await expect(messagesView(page).getByText('Summarizing...')).toBeVisible({ timeout: 30000 });
+ for (const text of olderHistory) {
+ await expect(messagesView(page).getByText(text, { exact: true })).toBeVisible();
+ }
await expect(messagesView(page).getByText(setupPrompt)).toBeVisible();
await expect(messagesView(page).getByText(setupReply)).toBeVisible();
await expect(messagesView(page).getByText(latestPrompt)).toBeVisible();
await expect(messagesView(page).getByText(latestReply)).toBeVisible();
- await expect(messageTurns(page)).toHaveCount(5);
- await expect(messageTurns(page).nth(3)).toContainText(latestReply);
- await expect(messageTurns(page).nth(4)).toContainText('Summarizing...');
+ await expect(messageTurns(page)).toHaveCount(7);
+ await expect(messageTurns(page).nth(5)).toContainText(latestReply);
+ await expect(messageTurns(page).nth(6)).toContainText('Summarizing...');
await expect(page.getByRole('navigation', { name: 'Sibling message navigation' })).toHaveCount(
0,
);
@@ -232,13 +237,16 @@ test.describe('thread fold regressions', () => {
await expect(messagesView(page).getByText('You compacted the context')).toBeVisible({
timeout: 60000,
});
+ for (const text of olderHistory) {
+ await expect(messagesView(page).getByText(text, { exact: true })).toBeVisible();
+ }
await expect(messagesView(page).getByText(setupPrompt)).toBeVisible();
await expect(messagesView(page).getByText(setupReply)).toBeVisible();
await expect(messagesView(page).getByText(latestPrompt)).toBeVisible();
await expect(messagesView(page).getByText(latestReply)).toBeVisible();
- await expect(messageTurns(page)).toHaveCount(5);
- await expect(messageTurns(page).nth(3)).toContainText(latestReply);
- await expect(messageTurns(page).nth(4)).toContainText('You compacted the context');
+ await expect(messageTurns(page)).toHaveCount(7);
+ await expect(messageTurns(page).nth(5)).toContainText(latestReply);
+ await expect(messageTurns(page).nth(6)).toContainText('You compacted the context');
await expect(page.getByRole('navigation', { name: 'Sibling message navigation' })).toHaveCount(
0,
);
@@ -263,6 +271,7 @@ test.describe('thread fold regressions', () => {
const setupReply = replyText(label);
await openMockChat(page);
+ const olderHistory = await sendCompactionHistory(page, label);
await sendAndExpectReply(page, setupPrompt, setupReply);
await expect(page).toHaveURL(/\/c\/[0-9a-fA-F-]{36}$/, { timeout: 15000 });
@@ -284,6 +293,11 @@ test.describe('thread fold regressions', () => {
/** The turn under compaction is still the answer it always was, on the one
* branch the conversation has — a rewritten anchor would strand both rows
* behind a phantom root and offer a sibling switcher to page back to them. */
+ for (const text of olderHistory) {
+ await expect(messagesView(page).getByText(text, { exact: true })).toBeVisible({
+ timeout: 30000,
+ });
+ }
await expect(messagesView(page).getByText(setupPrompt)).toBeVisible({ timeout: 30000 });
await expect(messagesView(page).getByText(setupReply)).toBeVisible();
await expect(page.getByRole('navigation', { name: 'Sibling message navigation' })).toHaveCount(
@@ -294,9 +308,14 @@ test.describe('thread fold regressions', () => {
await expect(messagesView(page).getByText('You compacted the context')).toBeVisible({
timeout: 60000,
});
+ for (const text of olderHistory) {
+ await expect(messagesView(page).getByText(text, { exact: true })).toBeVisible();
+ }
await expect(messagesView(page).getByText(setupPrompt)).toBeVisible();
await expect(messagesView(page).getByText(setupReply)).toBeVisible();
- await expect(messageTurns(page)).toHaveCount(3);
+ await expect(messageTurns(page)).toHaveCount(7);
+ await expect(messageTurns(page).nth(5)).toContainText(setupReply);
+ await expect(messageTurns(page).nth(6)).toContainText('You compacted the context');
await expect(page.getByRole('navigation', { name: 'Sibling message navigation' })).toHaveCount(
0,
);
diff --git a/package-lock.json b/package-lock.json
index f8c1f4ce3b..0ed9dfa3ca 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -65,7 +65,7 @@
"@azure/storage-blob": "^12.30.0",
"@google/genai": "^2.8.0",
"@keyv/redis": "5.1.6",
- "@librechat/agents": "^4.1.1",
+ "@librechat/agents": "^4.2.1",
"@librechat/api": "*",
"@librechat/data-schemas": "*",
"@microsoft/microsoft-graph-client": "^3.0.7",
@@ -9166,9 +9166,9 @@
}
},
"node_modules/@librechat/agents": {
- "version": "4.1.1",
- "resolved": "https://registry.npmjs.org/@librechat/agents/-/agents-4.1.1.tgz",
- "integrity": "sha512-vbZcHgFPFox+crvvDwt2lBg6tJzl5ADOkzw6HgyOJlkOigScYjS51EGWS3sDoaemBtv4EndRNSlJSGQvJvW/iw==",
+ "version": "4.2.1",
+ "resolved": "https://registry.npmjs.org/@librechat/agents/-/agents-4.2.1.tgz",
+ "integrity": "sha512-HDgD95i7Vx9cx/SqgV1LlQG4fS9ZixJANxFP6wfS8dBXJCeqY27j/lYwtmyswTo45Q7dDRTR6XnN/qYsMToAHg==",
"license": "MIT",
"dependencies": {
"@anthropic-ai/sdk": "^0.115.0",
@@ -9206,9 +9206,8 @@
"reova": "^0.4.1",
"socks-proxy-agent": "^8.0.5",
"uuid": "^11.1.1",
- "zod": "3.25.67",
- "zod-to-json-schema": "3.25.2",
- "zod-v4": "npm:[email protected]"
+ "zod": "4.6.7",
+ "zod-to-json-schema": "3.25.2"
},
"engines": {
"node": ">=24.0.0"
@@ -9239,15 +9238,6 @@
"@langchain/core": "^1.2.8"
}
},
- "node_modules/@librechat/agents/node_modules/@langchain/openai/node_modules/zod": {
- "version": "4.6.7",
- "resolved": "https://registry.npmjs.org/zod/-/zod-4.6.7.tgz",
- "integrity": "sha512-g8W2D2kU6a8untc053fX1uVBKzM7yqAxW/3zwk83+6RyF2+SKOuV+c0wBDhUwzV1PaGapmZH+rmcUzPf+3CGwg==",
- "license": "MIT",
- "funding": {
- "url": "https://github.com/sponsors/colinhacks"
- }
- },
"node_modules/@librechat/agents/node_modules/@opentelemetry/api-logs": {
"version": "0.220.0",
"resolved": "https://registry.npmjs.org/@opentelemetry/api-logs/-/api-logs-0.220.0.tgz",
@@ -9757,15 +9747,6 @@
"node": ">=18"
}
},
- "node_modules/@librechat/agents/node_modules/zod": {
- "version": "3.25.67",
- "resolved": "https://registry.npmjs.org/zod/-/zod-3.25.67.tgz",
- "integrity": "sha512-idA2YXwpCdqUSKRCACDE6ItZD9TZzy3OZMtpfLoh6oPR47lipysRrJfjzMqFxQ3uJuUPyUeWe1r9vLH33xO/Qw==",
- "license": "MIT",
- "funding": {
- "url": "https://github.com/sponsors/colinhacks"
- }
- },
"node_modules/@librechat/api": {
"resolved": "packages/api",
"link": true
@@ -40718,16 +40699,6 @@
"zod": "^3.25.28 || ^4"
}
},
- "node_modules/zod-v4": {
- "name": "zod",
- "version": "4.6.7",
- "resolved": "https://registry.npmjs.org/zod/-/zod-4.6.7.tgz",
- "integrity": "sha512-g8W2D2kU6a8untc053fX1uVBKzM7yqAxW/3zwk83+6RyF2+SKOuV+c0wBDhUwzV1PaGapmZH+rmcUzPf+3CGwg==",
- "license": "MIT",
- "funding": {
- "url": "https://github.com/sponsors/colinhacks"
- }
- },
"node_modules/zone.js": {
"version": "0.16.2",
"resolved": "https://registry.npmjs.org/zone.js/-/zone.js-0.16.2.tgz",
@@ -40810,7 +40781,7 @@
"@azure/identity": "^4.14.0",
"@azure/storage-blob": "^12.30.0",
"@keyv/redis": "5.1.6",
- "@librechat/agents": "^4.1.1",
+ "@librechat/agents": "^4.2.1",
"@librechat/data-schemas": "*",
"@modelcontextprotocol/sdk": "^1.32.1",
"@opentelemetry/api": "^1.9.0",
diff --git a/packages/api/jest.config.mjs b/packages/api/jest.config.mjs
index 232ac74a82..c31ff8b7d7 100644
--- a/packages/api/jest.config.mjs
+++ b/packages/api/jest.config.mjs
@@ -1,6 +1,7 @@
import { maxWorkers, workerIdleMemoryLimit } from '../../config/jest.workers.cjs';
const esModules = [
+ '@librechat/agents',
'@librechat/code',
'@langchain/langgraph',
'@langchain/langgraph-checkpoint',
@@ -32,7 +33,7 @@ export default {
coverageReporters: ['text', 'cobertura'],
testResultsProcessor: 'jest-junit',
transform: {
- '\\.[jt]sx?$': [
+ '\\.[cm]?[jt]sx?$': [
'babel-jest',
{
presets: [
diff --git a/packages/api/package.json b/packages/api/package.json
index eb937f262b..a2c6fd20a5 100644
--- a/packages/api/package.json
+++ b/packages/api/package.json
@@ -113,7 +113,7 @@
"@azure/identity": "^4.14.0",
"@azure/storage-blob": "^12.30.0",
"@keyv/redis": "5.1.6",
- "@librechat/agents": "^4.1.1",
+ "@librechat/agents": "^4.2.1",
"@librechat/data-schemas": "*",
"@modelcontextprotocol/sdk": "^1.32.1",
"@opentelemetry/api": "^1.9.0",
diff --git a/packages/api/src/agents/__tests__/run-summarization.test.ts b/packages/api/src/agents/__tests__/run-summarization.test.ts
index af1d8d6b2f..33b1922a34 100644
--- a/packages/api/src/agents/__tests__/run-summarization.test.ts
+++ b/packages/api/src/agents/__tests__/run-summarization.test.ts
@@ -1014,6 +1014,14 @@ type CapturedRequest = {
async function compactSummary(
agents: Array<Record<string, unknown>>,
requests: CapturedRequest[] = [],
+ messages: BaseMessage[] = [
+ new HumanMessage('Compute 1 + 1.'),
+ new AIMessage('2'),
+ new HumanMessage('Compute 2 + 2.'),
+ new AIMessage('4'),
+ new HumanMessage('Compute 3 + 3.'),
+ new AIMessage('6'),
+ ],
) {
const summaryConfig = agents[0].summarizationConfig as NonNullable<
AgentInputs['summarizationConfig']
@@ -1063,13 +1071,35 @@ async function compactSummary(
tokenCounter: (message) => String(message.content).length,
});
await run.processStream(
- { messages: [new HumanMessage('Compute 2 + 2.'), new AIMessage('4')] },
+ { messages },
{ version: 'v2', configurable: { thread_id: 'azure-summary-test' } },
);
return { requests };
}
+describe('manual compaction recency', () => {
+ it('skips a fully retained conversation without calling the summarizer', async () => {
+ const agents = await callAndCapture({
+ summarizeOnly: true,
+ summarizationConfig: { model: 'gpt-4o', parameters: { streaming: false } },
+ });
+ const requests: CapturedRequest[] = [];
+ await expect(
+ compactSummary(agents, requests, [
+ new HumanMessage('Compute 1 + 1.'),
+ new AIMessage('2'),
+ new HumanMessage('Compute 2 + 2.'),
+ new AIMessage('4'),
+ ]),
+ ).rejects.toMatchObject({
+ name: 'ManualSummarizationSkippedError',
+ reason: 'nothing_to_summarize',
+ });
+ expect(requests).toHaveLength(0);
+ });
+});
+
describe('Azure deployment alias', () => {
/** `initializeAgent` maps an Azure Responses agent to the OpenAI provider. */
const azureAstraAgent = () => {