Tianyi Cui
3.0 KiB
Agent Note: New Session clears onto the empty-state launch
Status: implemented Archived: 2026-07-26
English | 中文
Problem
Sidebar "New Session" created and opened a blank session immediately, so the center column showed ConversationRoot with an empty transcript and the resident composer. The Figma NEW SESSION screen (EmptyState + shared InputBar hero) only rendered when sessions.current was already undefined, so the launch page was unreachable from the primary creation control.
Decision
SessionsService.clear() wipes the persisted selection and list.current. Top-level sidebar creation entries (onCreate() with no cwd — New Session and New Workspace) call clear() so AppFrame renders conversation.empty. The empty state's first send still runs conversation.startSession (create → open → send) and reuses the same InputBar component as the resident composer (variant="hero"). Per-project "+" (onCreate(cwd)) keeps create-then-open until the empty-state picker can accept a seeded cwd.
Alternatives considered
Keep create-then-open for New Session and add a second empty chrome inside ConversationRoot when the transcript is empty. Rejected: that duplicates the launch InputBar and breaks the empty→content ruling that one InputBar moves position rather than swapping components.
Route New Session through a dedicated route or slot outside selection. Rejected for this pass: conversation.empty already owns the launch UI; clearing current is the existing empty branch.
Consequences
New Session no longer mints a host session until the first send. Reloading after clear stays on the empty state. Project-scoped "+" still creates immediately. EmptyState stacks the Figma hero (Input_Bottom 75:8208) as fish + title, a Menu-backed workspace chip above the card, then shared InputBar (variant="hero", max-width 800, r20 card matching the composer — not a taller r24 hero), with a soft ellipse glow (figma 313:14109) centered behind the picker + card and width-locked to the card (1051/776 asset ratio) so it scales with it. The chip uses the soft interactive hover fill + 12px radius from 75:8208 and opens MenuDropdown (figma 122:9481; --dsw-specific-menu + --dsw-shadow-lv3): basename rows with folder icons and a trailing check, then a separator and "New Workspace" whose submenu (figma 419:16920) offers "Use a existing folder" and "Create new". Use a existing folder opens the path Dialog (figma 451:18655 copy — "Enter an existing folder path" / Open Folder) over a full-viewport mask (--dsw-alias-bg-mask-1 + --dsw-mask-blur) and sets the chip cwd. Create new opens the same Dialog chrome to name a folder under host.describe().cwd; success runs sessions.createWorkspace → host session.create (mkdir recursive) → sessions.open, so a default session lands in the new workspace. InputBar paints the bottom chrome (attach / Plan / Read-only / model) with local native <select> state only — host plan, access, and model seams remain unwired.