From 88f644b53b3e5d85bc58b36b33a37876a7fcf4e4 Mon Sep 17 00:00:00 2001 From: Mohamed Boudra Date: Fri, 30 Oct 2026 12:28:32 +0100 Subject: [PATCH] docs(terminal): state the minimum ANSI replay app version Document the intentional JSON-era app compatibility cut and its missing restored screen/history behavior, verified against the v0.1.80 and v0.1.81 decoder and request paths. --- docs/protocol-compatibility.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/protocol-compatibility.md b/docs/protocol-compatibility.md index da73c2ebe1..797cc1674b 100644 --- a/docs/protocol-compatibility.md +++ b/docs/protocol-compatibility.md @@ -54,6 +54,10 @@ without requesting streams. Application caches and which agents are visible rema ## Terminal ANSI replay +Terminal replay intentionally drops JSON-era apps, an exception to the general cross-version policy: +use app v0.1.81 or newer. Earlier apps omit `restore` and reject ANSI Restore (`0x05`), so they show +only subsequent live output, without the existing screen or history. + `terminal_chunked_replay` is SDK-owned delivery behavior. The daemon sends new binary opcodes only to a source advertising the capability. The SDK keeps the established subscribe request against older ANSI hosts and normalizes their single Restore frame into begin/data/end. `observeTerminal` defaults