Files
pipelines/app/notes/chat-response-pending.md
T

47 lines
2.7 KiB
Markdown

# Assistant bubble before response tokens
## Behavior
- Send inserts the optimistic user turn and starts a display-only assistant
response shell immediately, before draft persistence or the server reply.
- The normal assistant bubble contains three animated dots while no answer body
exists, including reasoning-only and tool-only responses. Tool/reasoning chips
stay below the bubble. First answer content replaces the dots.
- No fabricated assistant message enters stored history or the transcript cache.
Rejection, a terminal step, or reconnect clears local waiting state. A queued
follow-up does not add a second response shell. Pending operator decisions
suppress the generating indicator.
- Animation rebuilds only the dots, not the transcript. Reduced-motion users
receive a static ellipsis; accessibility announces “Assistant is responding”.
## Verification
- Full `flutter test`: **1,900 passed**. Ten targeted new tests also passed on
the final checkout; `flutter analyze` is clean.
- Tests cover immediate appearance despite a blocked draft write, acceptance and
user echoes, reasoning/tools before text, animation changes, first text,
rejection, queued prompts, terminal steps, and reduced motion.
- Isolated release web build: `build/chat-response-pending-web`.
Real Material and Cupertino browser probes sent only fixture prompts and
checked the pre-frame bubble, changing dot pixels, tool-only state, and text
replacement. Inspected captures:
`build/chat-response-pending-{material,cupertino}/`.
- No pre-change screenshot was captured. The source diff shows the prior missing
assistant row before frames and the omission of the bubble for tool-only rows.
## Pixel 9 Pro XL
- Exercised the actual thread on `47241FDAS00DLK` using the isolated native entry
`tool/chat_response_pending_fixture.dart`, which has no server connection and
an in-memory draft store. No test prompts were sent to real operator chats.
- Native captures verify the bubble before any response frame, above a tool-only
footer, and then replaced by answer text. A four-second recording sampled the
dots' exact semantics bounds: **19 sampled frames, 19 distinct pixel hashes**.
Evidence: `build/chat-response-pending-pixel9/`.
- Restored the normal app release **0.1.29882493** after the fixture test with
`adb install -r`; normal Pipelines UI and installed version verified. App data
and sign-in preserved. Original display/density/power/timeout settings verified
restored; device capture files removed; all recorders completed.
- Normal APK: `build/chat-response-pending-apk/pipelines.apk`. No website or
public update-feed publication, shared-service restart, or Fold use.