Session overview
The assembled launcher: a large search at the top with a new-session button aligned right, and a recent-sessions list below covering pinned, running, recent, failed, and archived. Typing a query with no match falls back to the no-results empty state.
Included in the single kansho full pack. Components are not offered as separate installs.
Demo event: No action yet
Launcher
search · recent list · new sessionNo results
search the demo for an unknown term to see this stateNo sessions found
No sessions to show yet. Start a new session to get going.
Usage
Guidance- Pass a selectedId and onSelect to drive a master-detail launcher.
- Wire onNewSession to the header create action.
- Use it as a full session table with sorting — reach for DataTable.
- When to use
- A launcher's recent-sessions panel with search and a create action.
- When not to
- Dense tabular session data with columns and sorting.
Props
API reference| Prop | Type | Description |
|---|---|---|
| sessionsrequired | AgentSession[] | Sessions to list; empty renders the no-results state. |
| listLabel | string | Heading above the list. |
| selectedId | string | Currently selected session id. |
| onSelect | (session) => void | Fires when a session row is chosen. |
| onNewSession | () => void | Fires from the header create action. |
Component documentation
Session Overview
components/workspace/session-overview.tsxPurpose
Provides a large session launcher with search, new-session action, recent rows, and a no-results state.
Appropriate use
Use as the primary session landing view when the host owns selected session and creation.
Example
components/workspace/session-overview.tsx has a representative live example in the "Launcher" section on /components/session-overview.
States
Supports populated or filtered-empty lists, optional selected id, configurable list label, and optional new-session action.
API and props
SessionOverview accepts sessions, listLabel, selectedId, onSelect, onNewSession, and className.
Dependencies
Direct imports are React, Lucide icons, EmptyState, SessionSearch, NewSessionButton, RecentSessionRow, workspace types, and cn.
Accessibility
Search and buttons retain native semantics, recent rows become buttons when selectable, and the empty state has visible explanatory text.
Limitations
Filtering is client-local and the view does not navigate, create sessions, virtualise long lists, or announce new results counts.
Source
Source: components/workspace/session-overview.tsx.
Full pack
components/workspace/session-overview.tsx is documented at /components/session-overview and installs only through the single Kansho full pack; no individual component install is offered.