From 0c449a63c629ae95c6a1bb7e10d5bd2db4daf436 Mon Sep 17 00:00:00 2001 From: Intern Dev Date: Mon, 13 Apr 2026 01:42:50 -0400 Subject: [PATCH] docs(active-memory): document cacheTtlMs bounds (#65708) The Active Memory docs listed cacheTtlMs without noting its bounds. The zod schema and the plugin manifest cap it at 1000-120000 ms with a 15000 ms default. A user following older "paste this in" snippets with cacheTtlMs=300000 crashed the gateway on startup with an opaque schema error before figuring out the real limit. Document the range and default inline in the tuning-fields table so the limit is discoverable before boot. Closes #65708 --- docs/concepts/active-memory.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/concepts/active-memory.md b/docs/concepts/active-memory.md index 72a733647b9..13eb3924471 100644 --- a/docs/concepts/active-memory.md +++ b/docs/concepts/active-memory.md @@ -547,14 +547,14 @@ The most important fields are: Useful tuning fields: -| Key | Type | Meaning | -| ----------------------------- | -------- | ------------------------------------------------------------- | -| `config.maxSummaryChars` | `number` | Maximum total characters allowed in the active-memory summary | -| `config.recentUserTurns` | `number` | Prior user turns to include when `queryMode` is `recent` | -| `config.recentAssistantTurns` | `number` | Prior assistant turns to include when `queryMode` is `recent` | -| `config.recentUserChars` | `number` | Max chars per recent user turn | -| `config.recentAssistantChars` | `number` | Max chars per recent assistant turn | -| `config.cacheTtlMs` | `number` | Cache reuse for repeated identical queries | +| Key | Type | Meaning | +| ----------------------------- | -------- | ---------------------------------------------------------------------------------- | +| `config.maxSummaryChars` | `number` | Maximum total characters allowed in the active-memory summary | +| `config.recentUserTurns` | `number` | Prior user turns to include when `queryMode` is `recent` | +| `config.recentAssistantTurns` | `number` | Prior assistant turns to include when `queryMode` is `recent` | +| `config.recentUserChars` | `number` | Max chars per recent user turn | +| `config.recentAssistantChars` | `number` | Max chars per recent assistant turn | +| `config.cacheTtlMs` | `number` | Cache reuse for repeated identical queries (range: 1000-120000 ms; default: 15000) | ## Recommended setup