From d60ff2db02bf2b6c6ac4fd39c179c9854409d2a4 Mon Sep 17 00:00:00 2001
From: Brennan Benson <79079362+brennanb2025@users.noreply.github.com>
Date: Wed, 16 Sep 2026 17:50:25 -0700
Subject: [PATCH] docs(agent-launch): clarify failed replay guidance

---
 src/main/runtime/rpc/methods/agent-launch-replay.ts | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/main/runtime/rpc/methods/agent-launch-replay.ts b/src/main/runtime/rpc/methods/agent-launch-replay.ts
index 11619b47f3d..223d4a56c9e 100644
--- a/src/main/runtime/rpc/methods/agent-launch-replay.ts
+++ b/src/main/runtime/rpc/methods/agent-launch-replay.ts
@@ -87,9 +87,9 @@ function answerFromRecordedRow(
     // Replayed verbatim rather than narrowed to the `agentSession.*` vocabulary. A launch fails
     // with its own codes — `worktree_not_found` and the reuse-terminal guards — none of which is on
     // that closed list, so narrowing would answer every one of them with
-    // `agent_session_operation_invalid`: the ledger's "your id is malformed" signal, which invites
-    // a client to mint a fresh id when what actually happened is a launch that definitively did not
-    // run and is worth retrying under the same one.
+    // `agent_session_operation_invalid`: the ledger's "your id is malformed" signal. The original
+    // code says this launch definitively failed; the same id replays that answer, while a deliberate
+    // new attempt must use a fresh id.
     return {
       decision: 'refuse',
       refusal: {