LibreChat/packages/api/src/agents
Danny Avila c52ba4efdb
fix: restore provider typing against the Agents SDK declarations (#15161)
@librechat/agents publishes its declaration files with its internal @/*
path aliases unrewritten, across 112 files. types/llm.d.ts imports
Providers that way, so a consumer cannot resolve it, ProviderOptionsMap's
computed keys go unresolved, and keyof ProviderOptionsMap collapses to
number.

Through v3.6.15 that only degraded LLMConfig silently: provider was typed
as the unresolved Providers, so everything assigned. v3.6.16 made
SharedLLMConfig generic over that key union, turning provider into
number | RuntimeProviderName, which nothing real is assignable to. That is
the whole of the "Type check @librechat/api" failure on dev.

Declaring the one alias llm.d.ts needs restores the enum and the provider
key union, taking the package from 20 errors to 4. The remaining 4 were
genuine: custom-endpoint specs pass provider: 'custom', which widens to
string, and the SDK models a provider outside ProviderOptionsMap as
RuntimeProviderName.

Mapping every @/* alias instead was tried and rejected here: it unmasks a
backlog of roughly 114 latent errors elsewhere in the package, which is a
separate cleanup. The real fix belongs upstream, in what the SDK ships.
2026-08-24 03:28:59 -04:00
..
__tests__ 🧫 test: Lock Subagent File Context Propagation (#15126) 2026-08-23 02:06:57 -04:00
activityLabels 🧠 feat: Add Live Reasoning Labels (#14893) 2026-08-16 18:11:55 -04:00
activityPhases 🩹 fix: Restore the @librechat/api Build and Remove Legacy Code (#14808) 2026-08-13 19:57:32 -04:00
hitl 🛂 feat: Filter Model-Bound Content by Source (#14425) 2026-08-21 22:43:32 -04:00
hooks 🪝 feat: Execute Agent Plugin Command Hooks (#14755) 2026-08-12 13:21:15 -04:00
openai 🧾 fix: Report Complete Agents API Usage (#15127) 2026-08-23 02:37:09 -04:00
reasoningLabels 🧠 feat: Add Live Reasoning Labels (#14893) 2026-08-16 18:11:55 -04:00
responses 🧾 fix: Report Complete Agents API Usage (#15127) 2026-08-23 02:37:09 -04:00
steering 🛂 feat: Filter Model-Bound Content by Source (#14425) 2026-08-21 22:43:32 -04:00
triggers ⚡ perf: Plain-JSON Memory Cache and an Idle Backoff for the Trigger Poll (#15144) 2026-08-23 23:15:26 -04:00
activity.spec.ts 🪟 feat: Unify Subagent Activity Panel (#15106) 2026-08-21 19:51:11 -04:00
activity.ts 🪟 feat: Unify Subagent Activity Panel (#15106) 2026-08-21 19:51:11 -04:00
added.ts 🏷️ fix: Persist the Ephemeral Agent's Display Label as Sender (#14899) 2026-08-16 19:50:30 -04:00
attachments.test.ts 🕸️ feat: Run Saved Agent Teams as Subagents (#14944) 2026-08-17 18:02:52 -04:00
attachments.ts 🕸️ feat: Run Saved Agent Teams as Subagents (#14944) 2026-08-17 18:02:52 -04:00
auth.ts
avatars.spec.ts
avatars.ts
background.spec.ts 🛂 feat: Filter Model-Bound Content by Source (#14425) 2026-08-21 22:43:32 -04:00
background.ts 🛂 feat: Filter Model-Bound Content by Source (#14425) 2026-08-21 22:43:32 -04:00
callerCapabilities.spec.ts 🚦 fix: Restrict Programmatic Tool Execution Maps (#15105) 2026-08-22 11:02:09 -04:00
callerCapabilities.ts 🚦 fix: Restrict Programmatic Tool Execution Maps (#15105) 2026-08-22 11:02:09 -04:00
chain.ts
checkpointer.integration.spec.ts
checkpointer.spec.ts
checkpointer.ts
cleanup.spec.ts
cleanup.ts
client.spec.ts 🧮 perf: Enable Agent Context Count Reuse (#15130) 2026-08-23 03:05:02 -04:00
client.ts 🧮 perf: Enable Agent Context Count Reuse (#15130) 2026-08-23 03:05:02 -04:00
codeFilesSession.spec.ts 🕸️ feat: Run Saved Agent Teams as Subagents (#14944) 2026-08-17 18:02:52 -04:00
codeFilesSession.ts 🕸️ feat: Run Saved Agent Teams as Subagents (#14944) 2026-08-17 18:02:52 -04:00
config.spec.ts 🚦 feat: Configurable Circuit Breakers for Runaway Streamed Tool Args (#14613) 2026-08-04 23:05:05 -04:00
config.ts 🚦 feat: Configurable Circuit Breakers for Runaway Streamed Tool Args (#14613) 2026-08-04 23:05:05 -04:00
contact.spec.ts
contact.ts
context.spec.ts 🛂 feat: Filter Model-Bound Content by Source (#14425) 2026-08-21 22:43:32 -04:00
context.ts 🛂 feat: Filter Model-Bound Content by Source (#14425) 2026-08-21 22:43:32 -04:00
conversation.spec.ts
conversation.ts
discovery.spec.ts 🪡 fix: Thread Parent Message ID Through MCP Request-Scoped Bodies (#15095) 2026-08-21 16:33:01 -04:00
discovery.ts 🪡 fix: Thread Parent Message ID Through MCP Request-Scoped Bodies (#15095) 2026-08-21 16:33:01 -04:00
edges.spec.ts
edges.ts
envelope.spec.ts 🪢 refactor: Move Agent Execution Seam Before Initialization (#14581) 2026-08-01 18:25:34 -04:00
envelope.ts 🛰️ feat: Execute Generic Agent Trigger Deliveries (#14921) 2026-08-17 08:45:49 -04:00
errors.spec.ts 🛡️ feat: Let Admins Restrict Stateful Workspace Scopes (#14910) 2026-08-17 01:29:19 -04:00
errors.ts 🛡️ feat: Let Admins Restrict Stateful Workspace Scopes (#14910) 2026-08-17 01:29:19 -04:00
eventRetention.ts 📨 feat: Continue Bound Child Agents from Events (#15112) 2026-08-23 01:15:57 -04:00
execution.spec.ts 🛤️ feat: Per-Agent Code Execution Routing With Stateful Session Scopes (#14848) 2026-08-16 09:42:15 -04:00
execution.ts 🛤️ feat: Per-Agent Code Execution Routing With Stateful Session Scopes (#14848) 2026-08-16 09:42:15 -04:00
guard.spec.ts ⚡ perf: Cut Serial Round Trips and a 100ms Admission Stall from Chat Turns (#15138) 2026-08-23 15:17:35 -04:00
guard.ts ⚡ perf: Append Saved Message Ids Instead of Rebuilding the Conversation Array (#15141) 2026-08-23 16:52:44 -04:00
handlers.background.spec.ts 🛂 feat: Filter Model-Bound Content by Source (#14425) 2026-08-21 22:43:32 -04:00
handlers.spec.ts 🖥️ feat: Stream PTC Inner Tool Calls as a CLI-Style Trace (#15115) 2026-08-23 01:18:14 -04:00
handlers.ts 🖥️ feat: Stream PTC Inner Tool Calls as a CLI-Style Trace (#15115) 2026-08-23 01:18:14 -04:00
handoffPromptKeyCompatibility.spec.ts
handoffPromptKeyCompatibility.ts
harvest.spec.ts 🛂 feat: Filter Model-Bound Content by Source (#14425) 2026-08-21 22:43:32 -04:00
harvest.ts 🛂 feat: Filter Model-Bound Content by Source (#14425) 2026-08-21 22:43:32 -04:00
index.ts 🖥️ feat: Stream PTC Inner Tool Calls as a CLI-Style Trace (#15115) 2026-08-23 01:18:14 -04:00
initialize.files.spec.ts ⚡ perf: Append Saved Message Ids Instead of Rebuilding the Conversation Array (#15141) 2026-08-23 16:52:44 -04:00
initialize.ts ⚡ perf: Append Saved Message Ids Instead of Rebuilding the Conversation Array (#15141) 2026-08-23 16:52:44 -04:00
intent.spec.ts
intent.ts
json.ts 🛰️ feat: Execute Generic Agent Trigger Deliveries (#14921) 2026-08-17 08:45:49 -04:00
lazySubagents.spec.ts 🪶 feat: Resolve Explicit Subagents Lazily (#14714) 2026-08-09 19:23:45 -04:00
lazySubagents.ts 🛤️ feat: Per-Agent Code Execution Routing With Stateful Session Scopes (#14848) 2026-08-16 09:42:15 -04:00
legacy.test.ts
legacy.ts
load.spec.ts 🏷️ fix: Persist the Ephemeral Agent's Display Label as Sender (#14899) 2026-08-16 19:50:30 -04:00
load.ts 🏷️ fix: Persist the Ephemeral Agent's Display Label as Sender (#14899) 2026-08-16 19:50:30 -04:00
memory.spec.ts fix: restore provider typing against the Agents SDK declarations (#15161) 2026-08-24 03:28:59 -04:00
memory.ts 🛂 feat: Filter Model-Bound Content by Source (#14425) 2026-08-21 22:43:32 -04:00
migration.ts
orphans.spec.ts 🛂 feat: Filter Model-Bound Content by Source (#14425) 2026-08-21 22:43:32 -04:00
orphans.ts 🛂 feat: Filter Model-Bound Content by Source (#14425) 2026-08-21 22:43:32 -04:00
parameters.spec.ts
parameters.ts
phases.ts
prewarm.spec.ts 🛤️ feat: Per-Agent Code Execution Routing With Stateful Session Scopes (#14848) 2026-08-16 09:42:15 -04:00
prewarm.ts 🛤️ feat: Per-Agent Code Execution Routing With Stateful Session Scopes (#14848) 2026-08-16 09:42:15 -04:00
ptc.spec.ts 🖥️ feat: Stream PTC Inner Tool Calls as a CLI-Style Trace (#15115) 2026-08-23 01:18:14 -04:00
ptc.ts 🖥️ feat: Stream PTC Inner Tool Calls as a CLI-Style Trace (#15115) 2026-08-23 01:18:14 -04:00
resources.test.ts 🧱 fix: Enforce Agent Runtime File Trust Boundaries (#14577) 2026-08-02 14:18:28 -04:00
resources.ts 🛤️ feat: Per-Agent Code Execution Routing With Stateful Session Scopes (#14848) 2026-08-16 09:42:15 -04:00
run.spec.ts 🪶 feat: Resolve Explicit Subagents Lazily (#14714) 2026-08-09 19:23:45 -04:00
run.ts 🛂 feat: Filter Model-Bound Content by Source (#14425) 2026-08-21 22:43:32 -04:00
selection.ts
sender.spec.ts 🏷️ fix: Persist the Ephemeral Agent's Display Label as Sender (#14899) 2026-08-16 19:50:30 -04:00
sender.ts 🏷️ fix: Persist the Ephemeral Agent's Display Label as Sender (#14899) 2026-08-16 19:50:30 -04:00
skillConfigurable.spec.ts
skillConfigurable.ts
skillFiles.spec.ts 🛂 feat: Filter Model-Bound Content by Source (#14425) 2026-08-21 22:43:32 -04:00
skillFiles.ts 🛂 feat: Filter Model-Bound Content by Source (#14425) 2026-08-21 22:43:32 -04:00
skills.ts 🛂 feat: Filter Model-Bound Content by Source (#14425) 2026-08-21 22:43:32 -04:00
startup.spec.ts
startup.ts
subagentActivity.spec.ts 📇 feat: Surface Event Child Activity Through a Bounded Parent Index (#15142) 2026-08-23 18:50:00 -04:00
subagentActivity.ts 📇 feat: Surface Event Child Activity Through a Bounded Parent Index (#15142) 2026-08-23 18:50:00 -04:00
subagentCompletionWakeup.spec.ts 🧾 feat: Sibling Task Manifest for Resumed Parent Runs (#15063) 2026-08-21 03:35:46 -04:00
subagentCompletionWakeup.ts 🧾 feat: Sibling Task Manifest for Resumed Parent Runs (#15063) 2026-08-21 03:35:46 -04:00
subagentCrossReplica.integration.spec.ts 📡 feat: Stream Detached Subagent Activity (#15111) 2026-08-22 09:45:27 -04:00
subagentDelivery.spec.ts 🕊️ feat: Yield to Subagent Completion Wakeups (#15066) 2026-08-21 01:45:42 -04:00
subagentDelivery.ts 🕊️ feat: Yield to Subagent Completion Wakeups (#15066) 2026-08-21 01:45:42 -04:00
subagentTaskContext.ts 🧵 feat: Persist View-Only Subagent Threads (#14957) 2026-08-18 07:41:42 -04:00
subagentTaskRouting.spec.ts 🛰️ feat: Route Live Subagent Controls Across Replicas (#14971) 2026-08-19 02:16:35 -04:00
subagentTaskRouting.ts 🪃 feat: Wake Parent Agents on Child Completion (#14975) 2026-08-19 12:18:31 -04:00
subagentThreadIds.ts 🧵 feat: Persist View-Only Subagent Threads (#14957) 2026-08-18 07:41:42 -04:00
subagentThreads.spec.ts 📨 feat: Continue Bound Child Agents from Events (#15112) 2026-08-23 01:15:57 -04:00
subagentThreads.ts 📇 feat: Surface Event Child Activity Through a Bounded Parent Index (#15142) 2026-08-23 18:50:00 -04:00
testHook.ts 🛂 feat: Filter Model-Bound Content by Source (#14425) 2026-08-21 22:43:32 -04:00
tools.spec.ts
tools.ts 🛤️ feat: Per-Agent Code Execution Routing With Stateful Session Scopes (#14848) 2026-08-16 09:42:15 -04:00
toolValidation.spec.ts 🍡 feat: Batched User Questions With A Single Bounded Answer Form (#14737) 2026-08-11 01:06:16 -04:00
toolValidation.ts 🍡 feat: Batched User Questions With A Single Bounded Answer Form (#14737) 2026-08-11 01:06:16 -04:00
transactions.bulk-parity.spec.ts
transactions.spec.ts
transactions.ts
traversal.spec.ts 🛂 feat: Filter Model-Bound Content by Source (#14425) 2026-08-21 22:43:32 -04:00
traversal.ts 🛂 feat: Filter Model-Bound Content by Source (#14425) 2026-08-21 22:43:32 -04:00
usage.bulk-parity.spec.ts
usage.spec.ts 🧾 fix: Report Complete Agents API Usage (#15127) 2026-08-23 02:37:09 -04:00
usage.ts 🧾 fix: Report Complete Agents API Usage (#15127) 2026-08-23 02:37:09 -04:00
validation.spec.ts 🎛️ feat: Make Max Subagents Configurable via librechat.yaml (#15023) 2026-08-20 11:16:08 -04:00
validation.ts 🎛️ feat: Make Max Subagents Configurable via librechat.yaml (#15023) 2026-08-20 11:16:08 -04:00
view.spec.ts 📇 feat: Surface Event Child Activity Through a Bounded Parent Index (#15142) 2026-08-23 18:50:00 -04:00
view.ts 📇 feat: Surface Event Child Activity Through a Bounded Parent Index (#15142) 2026-08-23 18:50:00 -04:00