From f7af6a87dcf06397bb66b91fd851572e31385815 Mon Sep 17 00:00:00 2001
From: Tianyi Cui <53024+tianyicui@users.noreply.github.com>
Date: Thu, 16 Jul 2026 03:25:21 +0800
Subject: [PATCH] docs(acp): describe terminal capability lifetime

---
 packages/ui/acp/src/index.ts | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/ui/acp/src/index.ts b/packages/ui/acp/src/index.ts
index 7b5cb11324..a12249d0b5 100644
--- a/packages/ui/acp/src/index.ts
+++ b/packages/ui/acp/src/index.ts
@@ -359,10 +359,10 @@ export function apply(ctx: Context, config: AcpConfig): void {
   // await and NOT install a record (which would resurrect a live agent/listeners
   // after the bridge closed). Checked after every load await.
   let closed = false
-  // Whether the client advertised the Zed `_meta.terminal_output` capability in
-  // `initialize`. When true, a tool's terminal presentation is rendered as a
-  // terminal card (content + `_meta.terminal_*`); when false, the bridge uses
-  // the tool's text fallback. Set once in `initialize`, read on every tool event.
+  // Connection-level terminal capability from the latest `initialize`; false
+  // before initialization. Each `session/new` or `session/load` snapshots it in
+  // `SessionRecord.terminalEnabled`, so later initialization affects only future
+  // sessions.
   let terminalOutputCap = false
 
   // Assigned at the bottom, before any agent event can fire (a session only