Widgets & Registry

Source-backed inventory of Apps SDK and ChatKit widget families, plus the installable KnearMe surface contracts derived from them.

Reference Inventory Matrix

This matrix is the source-backed answer to which widget families exist in the reference repos, how they behave, and where KnearMe should document or install them.

What it is for

Compare reference widget families against KnearMe coverage before building a new surface.

Use when

You need to decide whether a pattern is already implemented, only referenced, or currently described incorrectly.

Do not use when

You only need one component API. Use the focused installable pages for that.

Related patterns

App Surfaces · Generative UI · MCP Client Interface

Escalation path

Inventory -> focused widget page -> installable registry item -> runtime adoption.

Widget family	Source	Interaction	Modes	Behaviors	KnearMe status	Target
Kitchen Sink Lite	Apps SDK	Host bridge lab	inlinefullscreenmodal	setWidgetState · requestDisplayMode · callTool · sendFollowUpMessage · requestModal	Reference only	mcp-client-interface
Mixed Auth Search	Apps SDK	Inline search slices	inline	state sync · selection	Reference only	widgets-registry/inline-cards
Mixed Auth Past Orders	Apps SDK	Authenticated history panels	inlinepanel	auth-gated rendering · state sync	Reference only	widgets-registry/chatkit-shells
Pizzaz List	Apps SDK	Ranked card list	inline	selection · cta restraint	Implemented	widgets-registry/inline-cards @knearme/result-preview-card
Pizzaz Carousel	Apps SDK	Media-heavy comparison rail	inline	horizontal comparison · selection	Reference only	app-surfaces/inline-carousel
Pizzaz Map	Apps SDK	Map with inspector	inlinefullscreen	requestDisplayMode · host state sync · inspector offset	Misframed	widgets-registry/inspector-rail @knearme/inspector-detail-rail · @knearme/list-detail-shell
Pizzaz Album	Apps SDK	Deep-dive gallery	inlinefullscreen	requestDisplayMode · selection	Reference only	widgets-registry/fullscreen
Pizzaz Shop	Apps SDK	Inline commerce flow	inlinefullscreenmodal	setWidgetState · requestDisplayMode · requestModal · state sync	Reference only	mcp-client-interface
Shopping Cart	Apps SDK	Stateful inline cart	inline	setWidgetState · state sync	Reference only	generative-ui/runtime-flow
Solar System	Apps SDK	Interactive visual canvas	inlinefullscreen	requestDisplayMode	Reference only	widgets-registry/fullscreen
Todo	Apps SDK	Editable structured list	inline	persistent edits · state sync	Reference only	widgets-registry/inline-cards
Customer Support shell + context panel	ChatKit Advanced	Conversation + context shell	split shellpanel	context sync · shell layout · dictation	Implemented	widgets-registry/chatkit-shells @knearme/conversation-side-shell · @knearme/context-detail-panel
Metro Map split canvas/chat shell	ChatKit Advanced	Canvas + chat split shell	split shellpanel	selection sync · client effects · tool-driven canvas updates	Reference only	widgets-registry/chatkit-shells
News Guide newsroom shell	ChatKit Advanced	Chat + newsroom context shell	split shellpanel	retrieval widgets · page-aware context · tool routing	Reference only	widgets-registry/chatkit-shells
Cat Lounge dual-panel shell	ChatKit Advanced	Dual-panel chat + status shell	split shellpanel	quick actions · client effects · status sync	Reference only	widgets-registry/chatkit-shells
Self-hosted ChatKitPanel shell	ChatKit Starter	Minimal embedded chat shell	panel	session startup	Implemented	widgets-registry/chatkit-shells @knearme/conversation-side-shell
Managed ChatKitPanel shell	ChatKit Starter	Managed session shell	panel	session token fetch	Reference only	widgets-registry/chatkit-shells

Installable Surface Family

These are the KnearMe-owned components that turn the inventory into installable contracts.

Developer details

Start from these files when you need to trace the live implementation.

src/shared/ui/chat/*.tsx · registry/new-york/*.tsx · registry.json