Skip to content

Session Chat controls and actions

Action names in native action popovers may wrap to two lines. Popup width accounts for label text, icons, state values, and pin controls; rendered row height drives popup height, with scrolling for long menus. The OpenAI message-compaction action is displayed as OpenAI compaction up to here; its plugin/action IDs and inclusive message boundary remain unchanged.

This page describes desktop-specific placement and native presentation of rich session controls and actions in ChatPane, including request-action eligibility. Shared normalized control and action-menu behavior remains owned by the frontend SDK and shared React Native package.

ChatPane renders normalized config-rich dropdowns and rich session actions at their declared session_header or composer placement. Config changes use the ordinary session-settings controller. Rich action controls use the ordinary action runner.

Compact dropdowns and rich lists open through the native popover coordinator. The full Session Settings window renders fixed-option dropdowns with MacSelect. Custom-capable dropdowns use the native MacComboBox, while portable filtering, regex validation, and synthetic custom options remain in the frontend SDK. The composer enables the shared two-row pinned-action layout with its second row below.

The Send button shows an activity indicator during request submission and while an active request remains. Active request state gates duplicate Send/Resend starts and enables Cancel, but does not disable rich settings, plugin actions, attachment drafting, or Append. Append and attachment work use their own local in-flight guards, while the server remains authoritative for accepting concurrent mutations.

Request submission, generation, message modification, and application actions also appear in a compact status row above the transcript. Concurrent actions retain independent activity entries; one finishing does not remove another's progress. Running an application action leaves unrelated session actions available.

Panes shorter than 650 points use one-line title/subtitle text, a single-row composer action bar, and a composer input capped at 48 points. Extra pinned actions remain available in the overflow menu. The transcript reserves at least 30% of the pane height, and notification content scrolls within its bounded rail. Edit context shares the toolbar in short panes so long edits leave room for the transcript and primary button.

Modify loads the selected user, assistant, or system message into the main composer. Warning-colored context shows its canonical zero-based index, and the primary button becomes Save edit. Saving modifies that message through the existing PATCH operation and confirms the updated transcript before leaving edit mode. It does not start a model response. Append, Append as, Resend, and attachment changes are disabled during editing. Request cancellation and unrelated settings/actions retain their ordinary eligibility.

Edit text is separate from the ordinary draft and attachments. Saving or Cancel edit restores ordinary composition; a failed save retains the edit. The connection/session-scoped transient workspace keeps the edit and attachment drafts across warm-pane eviction without changing disk-cache schemas.

See the shared React Native actions menu components and frontend SDK rich session UI implementation for portable behavior.

Maintainer entry points:

  • src/chat/ChatPane.tsx
  • src/windows/SessionSettingsWindow.tsx
  • src/native/MacSelect.tsx
  • src/native/MacComboBox.tsx
  • src/windows/desktopPopoverCoordinator.ts