Files
kandev/docs/specs/ui/requirements/bounded-user-message-rendering.md
T
2026-09-18 16:30:51 +01:00

47 lines
2.6 KiB
Markdown

---
status: active
system: ui
created: 2026-09-18
owners:
- kandev
---
# Bounded user-message rendering
## Overview
Large user messages need bounded previews so users can navigate the conversation.
UI owns this presentation contract. Tasks and agents retain message storage and delivery ownership.
## Requirements
### REQ-UI-BOUNDED-USER-MESSAGE-001: Bounded user-message previews
**Intent:** Keep large messages accessible without rendering their complete contents during conversation navigation.
#### Acceptance criteria
- **AC-UI-BOUNDED-USER-MESSAGE-001.1:** When a user message exceeds 200 logical lines or 16,000 UTF-16 code units, its preview shall contain no more than either limit. This applies to transcript bubbles, queued previews, and pinned prompts. A logical line ends at LF, CRLF, or CR.
- **AC-UI-BOUNDED-USER-MESSAGE-001.2:** A shortened preview shall identify omitted content and offer a full-text download. The download shall preserve the selected message representation exactly, including its final character.
- **AC-UI-BOUNDED-USER-MESSAGE-001.3:** Raw mode, queued-row expansion, pinned-prompt expansion, and workflow-instruction disclosure shall retain the rendering limit. No preview action shall mount the complete oversized message.
- **AC-UI-BOUNDED-USER-MESSAGE-001.4:** Preview shortening shall not alter stored messages, agent input, existing copy behavior, queue editing, or attachment data. Ordinary messages shall retain Markdown, mentions, file links, and instruction disclosure.
- **AC-UI-BOUNDED-USER-MESSAGE-001.5:** Desktop and phone users shall have a visible, keyboard-accessible download action. Phone targets shall measure at least 44 CSS pixels. Previews shall not cause document-level horizontal overflow.
- **AC-UI-BOUNDED-USER-MESSAGE-001.6:** With a 3,921-line generated log selected, users shall switch sessions and send a subsequent small message successfully. The regression scenario shall produce no WebSocket request-timeout errors.
## Compatibility
Pinned previews retain Markdown and the existing desktop-only navigation contract in
[last-prompt pinning](last-prompt-pinning-regressions.md).
The size limit governs source content passed to rendering, including expanded previews.
The phone retains its existing scroll-to-last-prompt control.
## Out of scope
- Message admission limits, persisted truncation, and automatic attachment conversion.
- Provider context limits, agent-stream recovery, and RPC timeout changes.
- Assistant output, repository Markdown, share snapshots, and prompt-history plugin views.
## Implementation plans
- [Oversized user-message rendering](../../../plans/oversized-user-message-rendering/plan.md)