Agent UI
What changed in each release of @kind-ui/agent-ui.
Agent UI's releases, newest first, from its changelog at the release this site serves. A version's Breaking notes say what to change when you upgrade.
0.4.0
Minor Changes
-
2ec5574: Wave 4: Sources, Inline Citation, Document, Generated Image, File Tree, Terminal, Stack Trace, Test Results, Transcript, Selection and Action, in React and Web Components, with their
@kind-uiregistry items.- New dependencies:
ansi-sequence-parser(Terminal's colors) andstacktrace-parser(Stack Trace's frames). ./coreexports the new primitives and their helpers (createAnsiLines,parseStack,isLibraryFrame,pathItems,treeValues,documentSize,testCounts,testItems,testValue,emptyTestsText,currentAtandsearchSegments), and the package root adds theFileTreeEntry,StackFrame,TranscriptSegment,TranscriptWordandSelectionActionItemtypes.Sourcegains an optionalfavicon.- Model Selector takes an
iconper model, shown before its name in the list and in the field: an image URL, or on React an element and on Web Components an element it clones.ModelOptiontakes the icon's type as a parameter (ModelOption<Icon = string>), and the list now opens against the whole field. - Breaking: Model Selector's
contentStatetakes the content's instance id, and the render files use a new Combobox item icon. Update copied files along with the package withnpx shadcn@latest add @kind-ui/model-selector --overwrite(or@kind-ui/model-selector-web): until then the React file doesn't compile and the web element throws when it renders. - Breaking (types):
ModelSelectorOptions,ModelSelectorState,getModels()andModelSelectorItemin./coreuseModelOption<unknown>, since core passes icons through untouched, so code that typed them asModelOption[]takesModelOption<unknown>[].ModelSelectorContentStategainsanchor. - Status marks keep their glyph centered at any size and device pixel ratio. Resize a mark with the new
--kind-status-mark-size(default16px, even pixels), set on the mark or any ancestor, rather thanwidthandheight. - New
--kind-ansi-*tokens for the 16 named terminal colors. - Queue asks
onRemoveonce per item: a host that keeps an item after a failed removal passes a new object for it to allow another try. - A Task, Plan or Queue item that's removed and added again plays its entrance again.
- Step-based components and Guardrail Notice return focus to their own trigger when their content closes with focus inside.
- Icon buttons and file icons show in forced colors, in Message, Tool, Queue, Checkpoint, Code Block, Markdown Table, Conversation, Composer, Attachments, Uploader and Context Meter.
- New dependencies:
0.3.1
Patch Changes
- 34c8f20: The docs link between pages and import their examples with relative paths, so kindui.dev can render them from the release tag, and the release's namespace check treats a kindui.dev registry that isn't served yet as empty.
0.3.0
Minor Changes
-
803ea14: Wave 3: Confirmation, Question, Checkpoint, Model Selector, Reasoning Effort, Suggestion, Context Meter, Feedback, Notice and Guardrail Notice, in React and Web Components, with their
@kind-uiregistry items.-
Tool asks for approval through Confirmation: pass
onApproveandonDeny(on Web Components, thecan-approveandcan-denyattributes and theapproveanddenyevents) to offer Approve and Deny, andapprovalReasonfor a reason box. Once the host records the decision, the tool keeps the outcome, like "Approved", not the buttons. Its approval part now sits after the content, so it shows while the tool is closed.Breaking:
ToolState.approvalis now the wholeApproval, not its state, andToolState.approvalLabelis gone (useapprovalLabel(state.approval)).ToolApprovalrenders a Confirmation, and a render function passed to it gets the Confirmation's props, whoselabelreads "Run <name>?". -
Confirmation, Question, Checkpoint and Feedback lock on
createPendingAction(exported since 0.2.1, and shared with Plan's Accept and Subagent's Stop): a press disables the choices at once, a rejection makes them available again with an error, and a late result for a replaced request changes nothing. -
Wave 3 callbacks get a
detailswhosesourcesays who acted, like"mouse","keyboard"or"agent", after the value when they have one:onApprove(decision, details),onRestore(details). Notice'sonDismisstakes no arguments. -
New
--kind-color-on-warningtoken for marks on the warning fill, andinfoandwarningstatus marks. -
Step, Task, Plan and Chain of Thought rows no longer play their transitions when the page loads on Web Components.
-
The size check also budgets single exports of
./core, so a component that stops tree-shaking fails it.
-
0.2.1
Patch Changes
- 74b5748: - Every React render file starts with
"use client", so Next.js App Router server components can import them.- The composer's attachments area expands and collapses instead of jumping open and shut.
- Removing the last attachment returns focus to the editor. Attachments takes a
focusFallbackoption for where focus goes when no chip is left. - Motion helper springs start at rest, so a reversed
expandno longer overshoots.
0.2.0
Minor Changes
-
c1e394a: Wave 2: Status, Reasoning, Tool, Chain of Thought, Task, Plan, Subagent and Queue, in React and Web Components, with their
@kind-uiregistry items.- Reasoning, Tool, Chain of Thought, Task, Plan and Subagent share the Step base, so they open, close, announce and animate the way Step does.
- Queue reorders items with the pointer or the keyboard. The host owns the order:
onReorder(id, details)gets the new position asdetails.index(on Web Components, thereorderevent'sdetail.valueanddetail.index). - Subagent's avatar shows
avatarInitials(name)when it has no image. - Attachments and Uploader animate removed items out, and focus moves to a neighbor while they leave.
Breaking: Step's
titleoption is nowlabel(thelabelattribute on Web Components), becausetitleshows the browser's tooltip on a custom element. It still names the step in announcements.
0.1.0
Minor Changes
- 22e23d2: Wave 1: Step and Step List, Conversation, Message, Markdown with Code Block and Markdown Table, Composer with Attachments, Uploader, Loader, Thinking Indicator, Typing Indicator and Streaming Text, in React and Web Components, plus the AI SDK adapter, theme tokens and the
@kind-uiregistry items.