Kanshō/Agent session row

Agent session row

A single row in the workspace session list: icon, title, workspace/project, time, and a running or unread indicator. Selected rows bind the accent-soft selection tint.

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

States

running · unread · selected · idle

Unread badge pop

the badge zooms in quietly only when the count crosses 0 → n
Review the retry queue
agent-platform

Run rows

done (no dot) · failed (red) · running (pulse) · explicit label · selected

Supporting sources

These installed helpers belong to components documented on this page. They do not increase the public component count.

components/workspace/workspace-types.ts

Shared workspace session and run contracts.

Component documentation

Agent Session Row

components/workspace/agent-session-row.tsx

Purpose

Displays a session row and its quieter child-run row with lifecycle, time, workspace, and unread context.

Appropriate use

Use in a session rail where parent sessions may expand into multiple runs.

Example

components/workspace/agent-session-row.tsx has a representative live example in the "States" section on /components/agent-session-row.

States

Session rows support selected, static or clickable, running and unread treatments; run rows support selected, optional ordinal, and every session-run status.

API and props

Exports AgentSessionRow and AgentSessionRunRow; props accept shared AgentSession or SessionRun data, selection, onClick, className, ordinal, and run-row style.

Dependencies

Direct imports are React, Lucide icons, Badge, BrailleLoader, InteractiveContainer, StatusDot, Time, shared status types, workspace types, and cn.

Accessibility

Clickable rows use native button behavior through InteractiveContainer; running and run status have accessible names and parseable times use Time.

Limitations

Rows do not expand runs, navigate, update unread state, or permit nested interactive controls inside the clickable surface.

Source

Source: components/workspace/agent-session-row.tsx.

Full pack

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