Kanshō/Agent identity chip

Agent identity chip

The smallest unit of agent identity: who acted, in what role. Used inline in activity feeds, as a card byline, and anywhere an agent needs naming without a full fleet row. The dot variant carries status colour; the avatar variant suits cards and headers.

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

Dot variant

Status-coloured dot — for dense feeds and inline use
Plan & dispatchorchestratorAudit writerwriterSlack notifiercommsEmbedderindexer

Avatar variant

For card bylines and headers
Plan & dispatchorchestratorSource searchsearchVault rotatorsecops

Bordered

A self-contained chip for toolbars and filters
Plan & dispatchorchestratorAudit writerwriterEmbedder

Usage

Guidance
Do
  • Use the dot variant inline in dense feeds where status colour matters.
  • Use the avatar variant for card bylines and headers.
  • Add bordered when the chip stands alone in a toolbar or filter.
Don't
  • Rely on the status dot colour alone — it carries an aria-label twin.
  • Use it as a full fleet row — reach for the agent registry row.
When to use
Naming who acted, and in what role, at the smallest scale.
When not to
Rich agent detail with metrics — use a fleet or registry row.

Accessibility

Screen reader

Announces

  • The dot variant's status dot is a role=img with a text label, so status is never colour-only.

Not supported

  • The chip is presentational — wrap it in a button or link when it needs to be interactive.

Props

API reference
PropTypeDefaultDescription
namerequiredstring—Agent or actor name.
rolestring—Short role or tool type, e.g. orchestrator.
variant'dot' | 'avatar''dot'Lead with a status dot or an initials avatar.
statusStatusType—Colours the leading dot (dot variant only).
borderedbooleanfalseRender as a bordered chip rather than bare inline text.

Component documentation

Agent Identity Chip

components/monitor/agent-identity-chip.tsx

Purpose

Shows an agent name and optional role with either a status dot or avatar.

Appropriate use

Use in dense feeds, cards, or headers where the visible name remains the primary identity.

Example

components/monitor/agent-identity-chip.tsx has a representative live example in the "Dot variant" section on /components/agent-identity-chip.

States

Variants are dot or avatar; the chip can be bare or bordered, and status affects only the dot variant.

API and props

AgentIdentityChip accepts name, role, variant, status, bordered, and className.

Dependencies

Direct imports are React, StatusDot, shared status types, and cn.

Accessibility

Name and role are visible text; the leading glyph is supplementary, so identity does not depend on colour alone.

Limitations

It is presentational and does not provide selection, presence updates, a tooltip, or avatar imagery.

Source

Source: components/monitor/agent-identity-chip.tsx.

Full pack

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