diff --git a/docs/config-catalog.md b/docs/config-catalog.md
index b28634ccae..fa4aaecc31 100644
--- a/docs/config-catalog.md
+++ b/docs/config-catalog.md
@@ -688,7 +688,7 @@ export interface ReplayModelConfig {
 }
 ```
 
-Source: [`packages/support/llm-replay/src/index.ts:496`](../packages/support/llm-replay/src/index.ts)
+Source: [`packages/support/llm-replay/src/index.ts:497`](../packages/support/llm-replay/src/index.ts)
 
 ## `@deepseek-ai/dsh-llm-retry`
 
diff --git a/packages/support/llm-replay/src/index.ts b/packages/support/llm-replay/src/index.ts
index e54eabc4b6..4eb042d4f5 100644
--- a/packages/support/llm-replay/src/index.ts
+++ b/packages/support/llm-replay/src/index.ts
@@ -59,10 +59,11 @@ export interface ReplayConfig {
    */
   file: string
   /**
-   * Optional `ReplayEntry[]` sidecar that REPLACES the derived script for the
-   * PRIMARY session. Used by the two single-session scenarios not expressible as
-   * `assistant/chunk` (pure throw-before-chunk, cancel/hang). Absent for normal
-   * and nested scenarios.
+   * Optional sidecar for the PRIMARY session: a bare `ReplayEntry[]` REPLACES
+   * the derived script; `{ patches }` keeps it and swaps the named call
+   * indexes ({@link ReplayOverrideDoc}). Used by single-session scenarios not
+   * expressible as `assistant/chunk` (throw-before-chunk, cancel/hang,
+   * injected transient failures). Absent for normal and nested scenarios.
    */
   overrideFile?: string
   /**