From 90d91c3cf9dbb41739443d83edac682f62d1d806 Mon Sep 17 00:00:00 2001
From: Tianyi Cui <53024+tianyicui@users.noreply.github.com>
Date: Sun, 26 Jul 2026 03:31:21 +0800
Subject: [PATCH] docs(llm-replay): cover the patches form in the overrideFile
 contract

The ReplayConfig.overrideFile JSDoc still described only whole-script
replacement; it now names both sidecar forms and links ReplayOverrideDoc
(config catalog regenerated: source line shifted).
---
 docs/config-catalog.md                   | 2 +-
 packages/support/llm-replay/src/index.ts | 9 +++++----
 2 files changed, 6 insertions(+), 5 deletions(-)

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
   /**