feat: add selected option to commands for pre-selection

[Br1an67]

What

Add a selected boolean option to commands that enables pre-selecting a command when the page loads.

Closes #2141

Why

Command selection resets on page refresh. Developers need a way to persist the selected command state by setting it from the backend (e.g. from a cached value).

Changes

• backend/chainlit/types.py: Add selected: Optional[bool] to CommandDict
• libs/react-client/src/types/command.ts: Add selected?: boolean to ICommand
• frontend/src/components/chat/MessageComposer/index.tsx: Add useEffect that auto-selects the command marked selected: True when commands are received (only if no command is already selected)

Usage

commands = [
    {"id": "Search", "icon": "globe", "description": "Web search", "button": True, "persistent": True, "selected": True}
]

Testing

Backward compatible — commands without selected work exactly as before. The selected flag is only honored when no command is already user-selected.

---

Summary by cubic

Adds a selected option to commands to pre-select a command on load. This lets the backend persist command state across refreshes, addressing #2141.

• New Features
  • Backend: CommandDict now supports selected: Optional[bool].
  • React client: ICommand now supports selected?: boolean.
  • UI: MessageComposer auto-selects the command with selected=true when commands load, only if no command is already selected.

^{Written for commit 0bccfa2. Summary will update on new commits.}

[cubic-dev-ai]

No issues found across 3 files