ai loading.md
AI State Loading
Agent progress as a list of steps with a live log, elapsed time and a summary when done.
Installation
npx shadcn@latest add @kokonutui/ai-loading
Props
| Prop | Type | Default | Description |
|---|---|---|---|
steps? |
AgentStep[] |
The agent's steps, in order. Update them as work progresses. When omitted, a demo run plays on a loop. | |
collapseWhenDone? |
boolean |
true |
Collapse the list once every step is done. Defaults to true. |
className? |
string |
Extra classes for the root element. |
AgentStep
| Field | Type | Description |
|---|---|---|
id |
string |
|
label |
string |
|
status |
AgentStepStatus |
|
detail? |
string[] |
Log lines for the step. The running step shows the latest ones. |
AgentStepStatus
type AgentStepStatus = "pending" | "running" | "done" | "error";
Demo Steps
const DEMO_STEPS: Omit<AgentStep, "status">[] = [
{
id: "search",
label: "Searching the web",
detail: [
"query: loading states in agent UIs",
"visiting 5 websites",
"reading emilkowal.ski/ui/great-animations",
"reading developer.apple.com/design",
],
},
{
id: "read",
label: "Reading 4 sources",
detail: [
"extracting key passages",
"dropping 1 duplicate source",
"ranking by relevance",
],
},
{
id: "compare",
label: "Comparing approaches",
detail: [
"spinners vs. step lists",
"progress you can verify",
"checking motion preferences",
],
},
{
id: "write",
label: "Writing the summary",
detail: ["drafting 3 sections"],
},
];
API Usage
The AILoadingState component expects a list of AgentSteps as a prop as follows:
<AILoadingState steps={DEMO_STEPS} />
Example
An example of how to use the AILoadingState in your React application:
import AILoadingState from './AILoadingState';
function MyComponent() {
return (
<div>
<AILoadingState steps={DEMO_STEPS} />
</div>
);
}
Conclusion
The AILoadingState component provides a robust solution for managing agent loading states with a visual progression display.