Workspace chat header

Center-pane header for an active session: workspace glyph, session title and project, a runtime-panel toggle, and an overflow menu.

Included in the single kansho full pack. Components are not offered as separate installs.

Default

Runtime toggle is live; menu mutations are showcase-only preview callbacks

Compact the audit log writer

agent-platform · audit/compaction

Without runtime toggle

Draft the onboarding email

growth

Usage

Guidance

Wire only the menu actions this session supports — each item hides without a handler.
Pass onToggleRuntime and runtimeOpen to drive the panel toggle icon.

Don't

Show the options menu when no actions are wired — it hides entirely.

When to use: The header of a workspace chat, above the message stream.
When not to: A launcher list header — use the session overview header.

Accessibility

Keyboard & screen reader

Keyboard

Tab: Move focus to the runtime toggle and the session-options menu.
EnterSpace: Open the options menu or toggle the runtime panel.
Arrow keys: Move between items in the open menu.
Escape: Close the open menu.

Announces

The runtime toggle's label reflects Show / Hide runtime panel.
The options trigger carries aria-label "Session options".

Props

API reference

Prop	Type	Description
titlerequired	string	Session or thread title.
workspace	string	Workspace label beside the title.
icon	LucideIcon	Leading workspace glyph.
onToggleRuntime	() => void	Toggles the runtime panel; shows the panel icon when set.
runtimeOpen	boolean	Whether the runtime panel is open (drives the toggle icon).
onShare / onDuplicate / onArchive / onDelete	() => void	Session-options menu actions; each item renders only when wired.

Component documentation

Workspace Chat Header

components/workspace/workspace-chat-header.tsx

Purpose

Frames a workspace conversation with identity, runtime-panel toggle, and optional session actions.

Appropriate use

Use as the centre-pane header in a host application that owns panel and session mutations.

Example

components/workspace/workspace-chat-header.tsx has a representative live example in the "Default" section on /components/workspace-chat-header.

States

Runtime control can be open, closed, or absent; share, duplicate, archive, and delete items render only for supplied handlers.

API and props

WorkspaceChatHeader accepts title, workspace, icon, runtime state/callback, four session-action callbacks, and className.

Dependencies

Direct imports are React, Lucide icons, IconButton, Tooltip, DropdownMenu, and cn.

Accessibility

Runtime and menu controls have explicit names; Radix DropdownMenu supplies menu focus and keyboard behavior, with motion-safe transitions.

Limitations

It does not confirm destructive deletion, route, open a runtime panel, or report callback progress and failures.

Source

Source: components/workspace/workspace-chat-header.tsx.

Full pack

components/workspace/workspace-chat-header.tsx is documented at /components/workspace-chat-header and installs only through the single Kansho full pack; no individual component install is offered.