From 78b8cc731e05bb7102b7730aaacc18505cd79c99 Mon Sep 17 00:00:00 2001
From: imccyu <276526105+imccyu@users.noreply.github.com>
Date: Mon, 24 Aug 2026 00:54:24 +0800
Subject: [PATCH] docs(client): preserve opaque context fallback

---
 .../src/client/contract/context-provenance.ts               | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/client/ui-conversation/src/client/contract/context-provenance.ts b/packages/client/ui-conversation/src/client/contract/context-provenance.ts
index ef5827eaab..db732bf59c 100644
--- a/packages/client/ui-conversation/src/client/contract/context-provenance.ts
+++ b/packages/client/ui-conversation/src/client/contract/context-provenance.ts
@@ -23,5 +23,9 @@ export interface ContextProvenanceView {
   label: string | null
 }
 
-/** One durable context form this UI version knows how to present. */
+/**
+ * One durable context form this UI version knows how to present. Target
+ * projections map absent or unknown forms to their opaque presentation so
+ * logs written by older, newer, or foreign producers remain visible.
+ */
 export type KnownContextForm = 'instructions' | 'catalog' | 'snapshot' | 'notice' | 'relay' | 'recall'