LibreChat/packages/api/src/agents/config.ts
Danny Avila cb41ba14b2
🔁 fix: Pass recursionLimit to OpenAI-Compatible Agents API Endpoint (#12510)
* fix: pass recursionLimit to processStream in OpenAI-compatible agents API

The OpenAI-compatible endpoint never passed recursionLimit to LangGraph's
processStream(), silently capping all API-based agent calls at the default
25 steps. Mirror the 3-step cascade already used by the UI path (client.js):
yaml config default → per-agent DB override → max cap.

* refactor: extract resolveRecursionLimit into shared utility

Extract the 3-step recursion limit cascade into a shared
resolveRecursionLimit() function in @librechat/api. Both openai.js and
client.js now call this single source of truth.

Also fixes falsy-guard edge cases where recursion_limit=0 or
maxRecursionLimit=0 would silently misbehave, by using explicit
typeof + positive checks.

Includes unit tests covering all cascade branches and edge cases.

* refactor: use resolveRecursionLimit in openai.js and client.js

Replace duplicated cascade logic in both controllers with the shared
resolveRecursionLimit() utility from @librechat/api.

In openai.js: hoist agentsEConfig to avoid double property walk,
remove displaced comment, add integration test assertions.

In client.js: remove inline cascade that was overriding config
after initial assignment.

* fix: hoist processStream mock for test accessibility

The processStream mock was created inline inside mockResolvedValue,
making it inaccessible via createRun.mock.results (which returns
the Promise, not the resolved value). Hoist it to a module-level
variable so tests can assert on it directly.

* test: improve test isolation and boundary coverage

Use mockReturnValueOnce instead of mockReturnValue to prevent mock
leaking across test boundaries. Add boundary tests for downward
agent override and exact-match maxRecursionLimit.
2026-04-01 21:13:07 -04:00

30 lines
918 B
TypeScript

import type { TAgentsEndpoint } from 'librechat-data-provider';
const DEFAULT_RECURSION_LIMIT = 50;
/**
* Resolves the effective recursion limit for an agent run via a 3-step cascade:
* 1. YAML endpoint config default (falls back to 50)
* 2. Per-agent DB override (if set and positive)
* 3. Global max cap from YAML (if set and positive)
*/
export function resolveRecursionLimit(
agentsEConfig: TAgentsEndpoint | undefined,
agent: { recursion_limit?: number } | undefined,
): number {
let limit = agentsEConfig?.recursionLimit ?? DEFAULT_RECURSION_LIMIT;
if (typeof agent?.recursion_limit === 'number' && agent.recursion_limit > 0) {
limit = agent.recursion_limit;
}
if (
typeof agentsEConfig?.maxRecursionLimit === 'number' &&
agentsEConfig.maxRecursionLimit > 0 &&
limit > agentsEConfig.maxRecursionLimit
) {
limit = agentsEConfig.maxRecursionLimit;
}
return limit;
}