TUI: Add the first-session zero state

[moirahuang]

Description

Add the once-per-account first-session zero state. The first-run variant reuses the existing zero-state layout, animation, starfield, project context, input, and footer while presenting the Figma-aligned "What's different about Warp" guidance.

Design: https://www.figma.com/design/yg5nbPZuGoAszHS3Rhvehu/TUI?node-id=1768-18320&m=dev

Linked Issue

• The linked issue is labeled ready-to-spec or ready-to-implement.
• Where appropriate, screenshots or a short video of the implementation are included below (especially for user-visible or UI changes).

Implementation plan: https://staging.warp.dev/drive/notebook/VEDTJkrbVxEnFZIwM5uC3A

Testing

• ./script/format

• cargo check -p warp_tui --tests

• Previously passed focused coverage: first_zero_state_matches_welcome_design_copy and first_zero_state_is_provisional_and_reconciles_without_replacing_the_session.

• Full test execution and Clippy were skipped as requested.

• I have manually tested my changes locally with ./script/run

Screenshots / Videos

Manual verification screenshot and discussion:
https://staging.warp.dev/conversation/b543d79e-e3d9-4f48-9516-50c2372eabc8

Agent Mode

• Warp Agent Mode - This PR was created via Warp's AI Agent Mode

CHANGELOG-TUI: Added first-run guidance to the Warp Agent CLI welcome screen.

Co-Authored-By: Oz oz-agent@warp.dev

[moirahuang]

• TUI: Add the first-session zero state #14580 👈 (View in Graphite)
• TUI: Add first-run onboarding marker plumbing #14579 : 1 other dependent PR (#14581 )
• TUI: Gate terminal startup on browser authentication #14578
• master

This stack of pull requests is managed by Graphite. Learn more about stacking.

[oz-for-oss]

@moirahuang

I'm starting a first review of this pull request.

You can view the conversation on Warp.

I completed the review and no human review was requested for this pull request.

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

[oz-for-oss]

Overview

This PR adds a first-run variant of the TUI zero state, wires it to the onboarding marker model, and covers the new copy/state transitions with render-to-lines tests.

Concerns

• The once-per-account marker is consumed from per-session initialization/ready callbacks before the implementation proves that the consuming session is the focused empty session that will actually show the first-run zero state. Background/restored sessions can therefore spend the marker and leave the user’s visible first session with only the standard zero state.

Verdict

Found: 0 critical, 1 important, 0 suggestions

Request changes

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

[harryalbert]

nice! I pushed a change to make it so that we only subscribe to the marker singleton from sessions that might be involved in onboarding, just for efficiency's sake

[graphite-app]

Merge activity

• Jul 31, 5:13 PM UTC: This pull request can not be added to the Graphite merge queue. Please try rebasing and resubmitting to merge when ready.
• Jul 31, 5:13 PM UTC: Graphite disabled "merge when ready" on this PR due to: a merge conflict with the target branch; resolve the conflict and try again..