To review

Parts the Major Prototype needs that the system doesn't have, or has in another form. Each waits for a decision: keep the prototype's version, use the system's, or merge them.

Resizable panels

The split between the chat and the workspace panel (the web's components/ui/resizable.tsx, on react-resizable-panels): a group of panels in pixels with a draggable gap between them. Drag the gap, or focus it and step it with the arrow keys (Home and End for its bounds); a double-click resets it. A panel takes a ref that resizes it, which the editor uses to narrow the chat when a panel asks for room.

Used in
Agent editor: between the chat (360px, from 280px) and the workspace panel (from 250px)
Closest in the system
None
The difference
The Chat UI pattern says the chat is 360px and resizable from 280px, but the system has no resizable layout. The site can't add react-resizable-panels, so the port is a small one written for the prototype: one panel holds a width in pixels and the next takes the rest; no percentages, no collapsing, no saved layout.
Decision needed
Add Resizable to the system (on react-resizable-panels, as the web), or keep the chat at a fixed width.
Chat
Panel

Gap: Composer in the editor chat

What the web's chat input does that the system's Composer doesn't: @ mentions of connectors, apps and agents as chips in the text, attached images and files, Click & Ask selections from the preview, and a busy state while the first message creates a session.

Used in
Agent editor: the chat composer and the new chat composer
Closest in the system
Composer
The difference
Composer's text is a plain textarea, so a mention can't sit in it as a chip; it has attachment chips and an add menu, but the prototype has nowhere to upload to. So the editor chat sends plain text only: no @ menu, no attachments, no selections. Composer has no busy Send either: while a new chat is being created the composer is disabled instead. While Major works, Composer offers only Queue message, where the web keeps Send beside Stop. On a phone the web moves Approval into the box, hides the model and context row under it and squares the input's bottom edge; Composer keeps that row under the box and its rounded card, so the prototype insets the card from the screen's edges there.
Decision needed
Add mentions, attachments, a busy Send, Send while working and a phone layout to Composer, or keep the editor chat to plain text.
Queued · sends when Major finishes
Then post it in #random too

Gap: Reordering editor tabs

The workspace tabs above the panel can be dragged into another order, as the web's reorderable tab strip allows. The pinned agent tab moves too but can't be closed.

Used in
Agent editor: the workspace tabs
Closest in the system
EditorTabs
The difference
EditorTabs has no drag. The prototype wraps it in a pointer handler that moves the dragged tab past the middle of its neighbours; the tab doesn't follow the pointer as it does in the web, the order just changes under it.
Decision needed
Add drag to reorder to EditorTabs (an onReorder prop), or keep the tabs in the order they opened.
Daily Joke

Gap: Markdown in the chat

The assistant's replies are Markdown. The web typesets them with react-markdown and remark-gfm under its Prose component (ui/composite/prose, on Tailwind Typography) and highlights code with prism-react-renderer.

Used in
Agent editor: every assistant message and the agent's narration
Closest in the system
ChatMessage
The difference
The system has no prose or Markdown component, and the site installs none of the web's libraries, so the prototype parses Markdown itself: paragraphs, headings, flat lists, quotes, code and inline marks. Tables, nested lists and raw HTML read as plain text, and code has no syntax colours.
Decision needed
Add a Prose (Markdown) component to the system, with code highlighting, or accept plain text for tables and nested lists.

Here's what changes in Daily Joke:

| Setting | Before | After | | --- | --- | --- | | Topic | Any | Programming |

  • Tone
  • Dry, one line
  • Schedule: weekdays at 9:00

Editor header

The top row of an editor panel (mono-builder web ui/composite/editor-header): the ViewSwitcher on the left, the object's name and version centred ("v2 · draft", "v1 · live"), the panel's Small buttons on the right. Unsaved changes, or Major holding the editor, tint the row with warn-soft at 35% over panel and end the version line in a warn dot and "Unsaved changes" or "Major is editing".

Used in
Agent editor: the header of every view (/prototype/agents/…/edit)
Closest in the system
PageHeader
The difference
PageHeader is a page's title row (list or detail): a 24px title on the left, a status line, tools and one action. The editor header is a 45px bar with the switcher first and the name centred on the panel whatever the sides hold, and its tint has no token (a color-mix of warn-soft and panel).
Decision needed
Add an EditorHeader to the system (with a dirty and a locked state), or give PageHeader an editor variant.
Daily Jokev2 · draft
Daily Jokev2Unsaved changes
Daily Jokev2 · draftMajor is editing

Caret popover

A Popover anchored at the text caret (mono-builder web ui/composite/caret-popover), for the instructions' / and @ menus. It picks a side once as it opens (below when the whole sheet fits, else the roomier side), never takes focus from the editor, and ignores mousedown so the editor keeps the caret.

Used in
Agent editor: Config, instructions, the / and @ menus
Closest in the system
Popover
The difference
Popover anchors to an element through PopoverTrigger or PopoverAnchor. This one anchors to a rect the editor computes, sizes itself to the room on its side, and keeps focus in the text.
Decision needed
Add a caret anchor (a virtual rect) to Popover, or keep the part in the product.

Post the joke with @

Code block

Code on the code surface (mono-builder web ui/composite/code-block): an optional header with the file's name and a copy button that shows on hover, numbered or added/removed lines, wrapping or scrolling. The web's HighlightedCodeBlock (prism-react-renderer and --color-syntax-* tokens) isn't ported: the site has neither.

Used in
Agent editor: Code, agent.jsonc and prompt.md (numbered lines read-only, a plain-text field on a live sandbox where the web has its CodeMirror file editor), Agent editor chat: code in replies, and the tool cards (commands and their output, file contents, edit diffs)
Closest in the system
None
The difference
The system documents code-surface, text-code and text-code-small but ships no code block; the docs site's own CodeBlock is highlighted at build time and isn't a product part. There are no syntax colour tokens.
Decision needed
Add a CodeBlock (and syntax tokens) to the system, or keep it in the product.
agent.jsonc
{	// Posts one joke a day.	"name": "Daily Joke",	"model": "sonnet"}
"model": "haiku""model": "sonnet"

Page layout

The grid a dashboard page's content keeps to: the 1040px list grid, the 844px reading column, or the list grid widening to 1250px from 2xl. 28px side padding (16px on phones), 56px from the top. The web's components/ui/composite/page-layout.tsx.

Used in
Every dashboard page: Changelog, User settings, the placeholders, Agent editor: Settings
Closest in the system
Island
The difference
Island is the panel; the system has nothing for the column inside it, so every page would pick its own width. The web reads the widths from tokens the system lacks (page-list, page-reading, page-wide; MISSING_TOKENS).
Decision needed
Add PageLayout and its three width tokens to the system, or let pages set their own max width.
list
reading
wide

Gap: Model provider marks

The mark before a model in the Details panel and the model catalog. The web draws each provider's logo on a white chip, with a brand-coloured monogram where it has no asset.

Used in
Agent editor: Details → Model, the model catalog dropdown
Closest in the system
BrandTile
The difference
The site has no provider logos, so every mark is a BrandTile monogram. BrandTile's sizes are 14 and 28px; the web's badges are 16 and 22px, so the size is set on top of the 14px tile.
Decision needed
Add provider logos (and a 16/22px size) to BrandTile, or keep monograms.
AAnthropicOOpenAIGGoogleKKimiMMiniMaxQQwenZZ.aiDDeepSeekMMetaXxAI

Gap: Permission decision picker

Always allow, Needs approval or Blocked for one tool or endpoint: three icon buttons in a secondary track, the chosen one raised on surface, each named by a tooltip.

Used in
Agent editor: Config → a connector's or app's Permissions
Closest in the system
ToggleGroup
The difference
ToggleGroup is a wrapping set of choice chips, and a single one can be cleared by clicking it again; a decision always has a value. Tabs and ViewSwitcher choose views, not values. The web's hand-rolled control is kept.
Decision needed
Add an icon-only segmented control to the system, or give ToggleGroup a segmented, always-set variant.
Send MessagePost a message to a channel.

Gap: Model row card

Hovering a model in the catalog names the concrete model it runs today and what it's for. The web draws it on Radix's tooltip as a surface card with a panel-edge border and the pop shadow.

Used in
Agent editor: Details → Model, the catalog dropdown
Closest in the system
Tooltip
The difference
The system's Tooltip is the inverted one-line kind, so the prototype uses its HoverCard (an internal part, with no page of its own): the same surface card, narrowed to the web's 240px. Being a tooltip, the web's card describes its row to a screen reader; HoverCard's isn't announced, so the row repeats the card's text as its description. Each row's delay is its own, where the web's rows share one with a skip delay.
Decision needed
Give HoverCard a described-by option and a shared delay for a list, or accept the per-row card.

Gap: Connector tool in a mention

A mention of one connector tool (@[Slack](connector:…#send_message)) reads as the connector's chip with the tool after a hairline, in regular-weight mono.

Used in
Agent editor: Config, instructions
Closest in the system
ObjectChip
The difference
InlineObjectChip has no slot for a tool, so the tool is a span inside the chip's label with its own border and type, as in the web.
Decision needed
Add a tool (suffix) slot to InlineObjectChip, or keep the span.

Post it with , then react to your own message.

Sheet

A side panel over the dimmed page, from the left or the right, with a title, a description, a footer and a close button. The web's components/ui/sheet.tsx.

Used in
App shell: the phone's navigation drawer (the burger in every page header)
Closest in the system
Dialog
The difference
The system's overlays are centred (Dialog, AlertDialog) or anchored (Popover, DropdownMenu); none is pinned to an edge at full height. The port is the system's DialogContent with its centring, size and pop-in swapped for a panel sliding in from its side (keyframes in the prototype's styles/utilities.css).
Decision needed
Add a Sheet to the system (the web has it in components/ui), or open the phone's navigation in a Dialog.

Drawer

The bottom sheet a phone gets in place of a dialog, popover or menu: full width, a grab handle on top, a nested one for a submenu. The web's components/ui/drawer.tsx (vaul).

Used in
ResponsiveOverlay on phones: the account menu, Feedback, Search (⌘K), What's new, the chat's menu and dialogs
Closest in the system
Dialog
The difference
The system has no bottom sheet. The web's is vaul, which follows the finger and closes on a swipe down; the prototype can't add vaul, so its drawer is the system's DialogContent pinned to the bottom: it slides up and closes on the overlay, Escape or a pick, but doesn't drag, and a nested drawer stacks on top instead of stepping the first one back.
Decision needed
Add a Drawer to the system (on vaul, as the web), or keep dialogs and menus as they are on phones.

Responsive overlay

One overlay API for both sizes: a Dialog, Popover or DropdownMenu on desktop, the same content in a bottom Drawer on a phone, with rows, labels, radio rows and submenus that work in either. The web's components/ui/composite/responsive-overlay.tsx.

Used in
App shell: the account menu and its organization submenu, Feedback dialog, Search (⌘K), What's new modal, Agent editor chat: the chat's ⋯ menu (notification switches), Rename chat, Chat details, Agent editor: Publish / Update / Published in the header
Closest in the system
DropdownMenu
The difference
The system's overlays are desktop surfaces; a phone gets the same menu at the same size. The port swaps the host by the viewport (below 768px) and keeps the system's DropdownMenu, Dialog and Popover for desktop. A row given asChild outside the dropdown merges its props into its child itself, since the site can't import Radix's Slot.
Decision needed
Add ResponsiveOverlay to the system with the Drawer, or decide that phones use the desktop overlays.

Command

A searchable, keyboard-driven list on cmdk: a search line, grouped rows in the menu's row style, an empty line. The host (Dialog, Popover) gives it its surface. The web's components/ui/command.tsx.

Used in
Search (⌘K, Ctrl+K on Windows and Linux)
Closest in the system
DropdownMenu
The difference
DropdownMenu is a list of rows with typeahead, not a filtered search: it has no search field that narrows the rows, no ranking and no grouped results. The rows here reuse its look (32px, ink-2 icons, hover fill) on cmdk's data-selected.
Decision needed
Add Command to the system (the web has it in components/ui), or search with a SearchField over a list.

Progressive blur

A blur that fades from strong at one edge to none, from stacked backdrop-filter bands, with the background colour behind the strong edge. The web's components/ui/composite/progressive-blur.tsx.

Used in
Editor routes (/agents/…/edit): the sidebar that slides in over the page on hover, Agent editor chat: the header and the fade above the composer, over the scrolled transcript
Closest in the system
None
The difference
The system has no blur effect; its overlays dim (bg-dim) instead.
Decision needed
Add ProgressiveBlur to the system, or let the hover-reveal sidebar slide in over a dim.

Conversation row

A conversation in the sidebar: a status mark (three pulsing dots while working, a dot when it waits or is unread), the title, the agent on a second line, and the age, which gives way to Pin and a ⋯ menu on hover. Waiting rows show their open questions as a count. The web's ThreadRow.

Used in
App shell: Pinned conversations and Recent conversations, Agent editor: the sessions in its sidebar
Closest in the system
SidebarItem
The difference
SidebarItem is a 32px row with one label and trailing meta. It has no second line, no status mark, no trailing slot that swaps to actions on hover, and no drag to pin or reorder; the web hand-rolls the row, and the prototype ports it as the web has it.
Decision needed
Add a two-line SidebarItem with a status mark and a hover action slot, or keep ThreadRow in the product.
now
2
5h

Sticky sidebar section title

The section titles of the conversations list (Pinned conversations, Recent conversations) stick to the top of the sidebar's scroll area while their rows scroll under them.

Used in
App shell: the conversations list
Closest in the system
SidebarItem
The difference
SidebarSection draws the same 28px muted title, but as a plain block: it can't stick, and it needs its rows inside it, which the pinned list (a drag-to-reorder group) can't be. The web writes the titles as h2s with the sidebar's background.
Decision needed
Let SidebarSection's title stick (a prop), or keep the titles in the product.

Pinned conversations

Recent conversations

Organization tile

An organization's initial on a tile, in the account menu's organization row and the switcher's list.

Used in
App shell: account menu → Organization, Switch organization
Closest in the system
BrandTile
The difference
BrandTile draws a white letter on a brand colour (#555 by default). The web's tile is neutral: the ink letter on secondary, so organizations don't read as connectors. The prototype uses BrandTile, so the tiles are grey with a white letter.
Decision needed
Add a neutral form to BrandTile, or let organizations take a colour of their own.
MWebMPrototype (BrandTile)

Sidebar banner

The cards above the account row: Allow notifications (dismissable) and Upgrade to Team (with the free plan's daily usage and Claim your free $100 credit). A title, one line, an illustration bleeding off the corner, the whole card a link or a button.

Used in
App shell: the bottom of the sidebar
Closest in the system
Card
The difference
Card is a page surface with its own padding and type; the system has no compact sidebar card with an illustration and a dismiss. The web's shadow under it has no token (MISSING_TOKENS: sidebar-banner-shadow), nor do its illustrations.
Decision needed
Add a SidebarBanner to the system, or keep it in the product.

Allow notifications

Know when your agent's done

Upgrade to Team

34% of daily balance used

What's new modal

The release notes as the web shows them: one announcement at a time, its copy on the left (New, the title, a lead, three points, the CTAs and Close) and its illustration on the right, a pager on top, arrow keys and a swipe on phones. It opens by itself once for unseen notes, and from the changelog.

Used in
App shell: opens once for unseen notes, Changelog → See the announcement, Prototype settings → Show What's new
Closest in the system
Dialog
The difference
Dialog has three widths (420, 460, 540px); this one is 860px, split in two panes, and becomes a drawer on a phone. The fallback illustration's dark green and glow have no tokens (MISSING_TOKENS).
Decision needed
Add a fourth Dialog width (or a WhatsNew component), or fit the notes into the 540px dialog.

View switcher label

The account menu's Appearance (System, Light, Dark) and Scaling (Default, Bigger, Large) switches.

Used in
App shell: account menu → Appearance, Scaling
Closest in the system
ViewSwitcher
The difference
ViewSwitcher names its tab list "Views" and takes no label, so a screen reader announces both switches as "Views". The web uses the same ViewSwitcher and has the same problem. Its hidden measuring row is as wide as every view side by side and pokes out of the switcher (past the edge of the account menu on a phone); it has no height, so Chrome does not scroll for it, but it is a sideways scroll waiting to happen.
Decision needed
Let ViewSwitcher take an aria-label (or aria-labelledby), and keep its measuring row inside its own width.
Appearance

Missing tokens

Values the prototype uses that no token covers yet. Each is used in one place.

NameValueClosest tokenUsed in
settings-tab#0B0B0B (same in both themes)tooltipPrototype settings tab (right edge)
editor-header-statuscolor-mix(in srgb, var(--color-warn-soft) 35%, var(--color-panel)) (same in both themes)warn-softEditor header: the row while there are unsaved changes or Major is editing
page-list / page-reading / page-wide65rem / 52.75rem / 78.125rem (same in both themes)NonePage layout: the list grid, the reading column and the wide grid
sidebar-banner-shadow0 4px 12px -1px rgba(0, 0, 0, 0.1) (same in both themes)shadow-cardSidebar banners: Allow notifications, Upgrade to Team
whats-new-fallback#00130E (same in both themes)app-bgWhat's new modal: the illustration panel of an announcement without its own
whats-new-glowrgb(99, 217, 147) → rgba(0, 28, 22, 0) (same in both themes)island-glowWhat's new modal: the glow drifting behind the Major mark
brand-deep / brand-mint#103D26 / #4FFFB3 (same in both themes)successAgent editor: the Major mark of the thinking indicator (the prototype mixes success and ok instead)