Skip to content

The Open Standard for Generative UI

Update GitHub demo components and add token comparison feature. (#438)

Aditya-thesys003f39fa26e1
diff --git a/docs/app/(home)/sections/HeroSection/HeroSection.module.css b/docs/app/(home)/sections/HeroSection/HeroSection.module.css
index 84cb169f2..9aef3122b 100644
--- a/docs/app/(home)/sections/HeroSection/HeroSection.module.css
+++ b/docs/app/(home)/sections/HeroSection/HeroSection.module.css
@@ -112,7 +112,9 @@
background: var(--openui-foreground);
box-shadow: var(--openui-shadow-l);
cursor: pointer;
- transition: transform 0.2s ease, box-shadow 0.2s ease;
+ transition:
+ transform 0.2s ease,
+ box-shadow 0.2s ease;
}
.npmButton:hover {
@@ -440,8 +442,12 @@
/* ── Animation ── */
@keyframes npmTickerScroll {
- 0% { transform: translateX(0); }
- 100% { transform: translateX(-50%); }
+ 0% {
+ transform: translateX(0);
+ }
+ 100% {
+ transform: translateX(-50%);
+ }
}
/* ── Responsive: subtitle no-wrap on wider phones ── */
diff --git a/docs/app/(home)/sections/HeroSection/HeroSection.tsx b/docs/app/(home)/sections/HeroSection/HeroSection.tsx
index 8103b4990..4acac1b62 100644
--- a/docs/app/(home)/sections/HeroSection/HeroSection.tsx
+++ b/docs/app/(home)/sections/HeroSection/HeroSection.tsx
@@ -88,7 +88,11 @@ function AnnouncementBanner({ className = "" }: { className?: string }) {
<span>We&apos;re introducing OpenUI Lang v0.5</span>
</span>
<div className={styles.heroBannerActions}>
- <Link href="/demo/github" target="_blank" className={`${styles.heroBannerButton} ${styles.heroBannerButtonPrimary}`}>
+ <Link
+ href="/demo/github"
+ target="_blank"
+ className={`${styles.heroBannerButton} ${styles.heroBannerButtonPrimary}`}
+ >
<span>Try</span>
</Link>
<Link href={architectureHref} className={styles.heroBannerButton}>
@@ -96,7 +100,10 @@ function AnnouncementBanner({ className = "" }: { className?: string }) {
</Link>
</div>
</div>
- <Link href={architectureHref} className={`${styles.heroBanner} ${styles.heroBannerMobile} ${className}`.trim()}>
+ <Link
+ href={architectureHref}
+ className={`${styles.heroBanner} ${styles.heroBannerMobile} ${className}`.trim()}
+ >
<span className={styles.heroBannerLabel}>
<span className={styles.heroBannerBadge}>New</span>
<span>Introducing OpenUI Lang v0.5</span>
@@ -136,9 +143,7 @@ function DesktopHero() {
<div className={styles.desktopHeroLockup}>
<AnnouncementBanner />
<h1 className={styles.desktopTitle}>OpenUI</h1>
- <p className={styles.desktopSubtitle}>
- The Open Standard for Generative UI
- </p>
+ <p className={styles.desktopSubtitle}>The Open Standard for Generative UI</p>
</div>
<div className={styles.desktopCtaStack}>
@@ -168,9 +173,7 @@ function MobileHero({ theme }: { theme: HeroTheme }) {
</div>
{/* Subtitle */}
- <p className={styles.mobileSubtitle}>
- The Open Standard for Generative UI
- </p>
+ <p className={styles.mobileSubtitle}>The Open Standard for Generative UI</p>
</div>
</div>
diff --git a/docs/app/(home)/sections/PossibilitiesSection/PossibilitiesSection.tsx b/docs/app/(home)/sections/PossibilitiesSection/PossibilitiesSection.tsx
index 0c9f20b1e..53b7e2254 100644
--- a/docs/app/(home)/sections/PossibilitiesSection/PossibilitiesSection.tsx
+++ b/docs/app/(home)/sections/PossibilitiesSection/PossibilitiesSection.tsx
@@ -156,24 +156,14 @@ export function PossibilitiesSection() {
<div className={styles.mobileCarouselViewport}>
<div ref={mobileTrackRef} className={styles.mobileCarouselTrack}>
{MOBILE_CAROUSEL_CARDS.map((card) => (
- <Card
- key={card.key}
- title={card.title}
- image={card.lightImage}
- href={card.href}
- />
+ <Card key={card.key} title={card.title} image={card.lightImage} href={card.href} />
))}
</div>
</div>
<div className={styles.cardsGrid}>
{CARDS.map((card) => (
- <Card
- key={card.title}
- title={card.title}
- image={card.lightImage}
- href={card.href}
- />
+ <Card key={card.title} title={card.title} image={card.lightImage} href={card.href} />
))}
</div>
</div>
diff --git a/docs/app/api/demo/github/stream/route.ts b/docs/app/api/demo/github/stream/route.ts
index ac4ca6092..fd3648177 100644
--- a/docs/app/api/demo/github/stream/route.ts
+++ b/docs/app/api/demo/github/stream/route.ts
@@ -3,6 +3,7 @@ import { generatePrompt, type PromptSpec } from "@openuidev/lang-core";
import { readFileSync } from "fs";
import { type NextRequest } from "next/server";
import { join } from "path";
+import { GITHUB_DEMO_MODEL } from "../../../../demo/github/constants";
import {
GITHUB_ADDITIONAL_RULES,
GITHUB_PREAMBLE,
@@ -10,8 +11,6 @@ import {
} from "../../../../demo/github/github/prompt-config";
import { GITHUB_TOOL_SPECS } from "../../../../demo/github/github/types";
-const MODEL = "openai/gpt-5.4-mini";
-
// ── Component spec from generated JSON ────────────────────────────────────
const componentSpec = JSON.parse(
@@ -74,7 +73,7 @@ export async function POST(req: NextRequest) {
"X-Title": "OpenUI GitHub Demo",
},
body: JSON.stringify({
- model: MODEL,
+ model: GITHUB_DEMO_MODEL,
stream: true,
messages: chatMessages,
}),
diff --git a/docs/app/components/blocks/charts/line/page.tsx b/docs/app/components/blocks/charts/line/page.tsx
index 165424a20..3c56d8c08 100644
--- a/docs/app/components/blocks/charts/line/page.tsx
+++ b/docs/app/components/blocks/charts/line/page.tsx
@@ -2,7 +2,7 @@
import ClientOnly from "@components/blocks/_components/ClientOnly";
import { BlockVariantPreview, PreviewPage, PreviewSection } from "@components/components/preview";
-import { LineChartCondensed, LineChart } from "@openuidev/react-ui";
+import { LineChart, LineChartCondensed } from "@openuidev/react-ui";
const lineData = [
{ month: "Jan", desktop: 150, mobile: 90 },
diff --git a/docs/app/demo/github/components/ConversationPanel/ConversationPanel.css b/docs/app/demo/github/components/ConversationPanel/ConversationPanel.css
index ec411e06f..a44b19d14 100644
--- a/docs/app/demo/github/components/ConversationPanel/ConversationPanel.css
+++ b/docs/app/demo/github/components/ConversationPanel/ConversationPanel.css
@@ -125,71 +125,6 @@
font-family: var(--openui-font-body);
}
-/* Tool call badges */
-.conv-tools-badge {
- padding: var(--openui-space-xs) var(--openui-space-s-m);
- border-radius: var(--openui-radius-m);
- margin-bottom: var(--openui-space-xs);
- font-size: 11px;
- font-family: var(--openui-font-body);
-}
-
-.conv-tools-runtime {
- background: var(--openui-success-background);
- border: 1px solid var(--openui-border-success);
-}
-
-.conv-tools-live {
- background: var(--openui-highlight-subtle);
- border: 1px solid var(--openui-border-default);
-}
-
-.conv-tools-label {
- color: var(--openui-text-success-primary);
- font-weight: 600;
- margin-bottom: 3px;
- display: flex;
- align-items: center;
- gap: var(--openui-space-2xs);
-}
-
-.conv-tools-label-text {
- color: var(--openui-text-neutral-secondary);
- font-weight: 600;
- text-transform: uppercase;
- letter-spacing: 0.5px;
- font-size: 10px;
-}
-
-.conv-tools-list {
- display: flex;
- flex-wrap: wrap;
- gap: 3px;
- align-items: center;
-}
-
-.conv-tool-chip {
- padding: 1px var(--openui-space-xs);
- border-radius: var(--openui-radius-xs);
- font-size: 10px;
- font-family: var(--openui-font-code);
-}
-
-.conv-tool-done {
- background: var(--openui-success-background);
- color: var(--openui-text-success-primary);
-}
-
-.conv-tool-pending {
- background: var(--openui-alert-background);
- color: var(--openui-text-alert-primary);
-}
-
-.conv-tool-error {
- background: var(--openui-danger-background);
- color: var(--openui-text-danger-primary);
-}
-
/* Code badge */
.conv-code-badge {
display: inline-flex;
diff --git a/docs/app/demo/github/components/ConversationPanel/ConversationPanel.tsx b/docs/app/demo/github/components/ConversationPanel/ConversationPanel.tsx
index bc9578b40..75bba0f88 100644
--- a/docs/app/demo/github/components/ConversationPanel/ConversationPanel.tsx
+++ b/docs/app/demo/github/components/ConversationPanel/ConversationPanel.tsx
@@ -3,7 +3,7 @@
import { IconButton } from "@openuidev/react-ui";
import { ChevronRight, MessageSquare, Send, Square } from "lucide-react";
import { useEffect, useRef, useState } from "react";
-import type { ChatMessage, ToolCallEntry } from "../../constants";
+import type { ChatMessage } from "../../constants";
import "./ConversationPanel.css";
type ConversationPanelProps = {
@@ -11,7 +11,6 @@ type ConversationPanelProps = {
streamingText: string;
isStreaming: boolean;
elapsed: number | null;
- toolCalls: ToolCallEntry[];
onSend: (text: string) => void;
onStop: () => void;
hasDashboard: boolean;
@@ -23,7 +22,6 @@ export function ConversationPanel({
streamingText,
isStreaming,
elapsed,
- toolCalls,
onSend,
onStop,
hasDashboard,
@@ -50,8 +48,6 @@ export function ConversationPanel({
setInput("");
};
- const pendingTools = toolCalls.filter((t) => t.status === "pending");
-
if (collapsed) {
return (
<div className="conv-collapsed">
@@ -83,23 +79,6 @@ export function ConversationPanel({
<div className="conv-user-bubble">{msg.content}</div>
) : (
<div className="conv-assistant">
- {/* Runtime tool call badges */}
- {msg.runtimeTools && msg.runtimeTools.length > 0 && (
- <div className="conv-tools-badge conv-tools-runtime">
- <div className="conv-tools-label">
- <span>⚡</span> Live data fetched
- </div>
- <div className="conv-tools-list">
- {msg.runtimeTools.map((tc, j) => (
- <span key={j} className={`conv-tool-chip conv-tool-${tc.status}`}>
- {tc.status === "done" ? "✓" : tc.status === "error" ? "✗" : "⏳"}{" "}
- {tc.tool}
- </span>
- ))}
- </div>
- </div>
- )}
-
{/* Text response */}
{msg.text && <div className="conv-assistant-bubble">{msg.text}</div>}
@@ -107,9 +86,7 @@ export function ConversationPanel({
{msg.hasCode && <span className="conv-code-badge">✓ dashboard updated</span>}
{/* Empty response */}
- {!msg.text && !msg.hasCode && !msg.runtimeTools?.length && (
- <div className="conv-empty">(empty response)</div>
- )}
+ {!msg.text && !msg.hasCode && <div className="conv-empty">(empty response)</div>}
</div>
)}
</div>
@@ -119,29 +96,13 @@ export function ConversationPanel({
{isStreaming && (
<div className="conv-msg">
<div className="conv-assistant">
- {/* Live runtime tool calls */}
- {toolCalls.length > 0 && (
- <div className="conv-tools-badge conv-tools-live">
- <div className="conv-tools-list">
- <span className="conv-tools-label-text">
- {pendingTools.length > 0 ? "Fetching" : "Loaded"}
- </span>
- {toolCalls.map((tc, j) => (
- <span key={j} className={`conv-tool-chip conv-tool-${tc.status}`}>
- {tc.status === "pending" ? "⏳" : "✓"} {tc.tool}
- </span>
- ))}
- </div>
- </div>
- )}
-
{/* Streaming text or thinking indicator */}
{streamingText ? (
<div className="conv-assistant-bubble">{streamingText}</div>
) : (
<div className="conv-thinking">
{elapsed
- ? `${(elapsed / 1000).toFixed(1)}s — ${responseHasCode ? "writing code..." : "thinking..."}`
+ ? `${(elapsed / 1000).toFixed(1)}s — ${responseHasCode ? "writing openui-lang..." : "thinking..."}`
: "thinking..."}
</div>
)}
diff --git a/docs/app/demo/github/components/GitHubConnect/GitHubConnect.css b/docs/app/demo/github/components/GitHubConnect/GitHubConnect.css
index a768658dc..635378e7b 100644
--- a/docs/app/demo/github/components/GitHubConnect/GitHubConnect.css
+++ b/docs/app/demo/github/components/GitHubConnect/GitHubConnect.css
@@ -128,7 +128,9 @@
color: var(--openui-text-neutral-secondary);
cursor: pointer;
opacity: 0;
- transition: opacity 0.15s ease, color 0.15s ease;
+ transition:
+ opacity 0.15s ease,
+ color 0.15s ease;
}
.gh-inputWrap:hover .gh-inputClear,
@@ -267,13 +269,20 @@
box-shadow: var(--openui-shadow-s);
cursor: pointer;
text-align: left;
- transition: transform 0.2s ease, border-color 0.2s ease, background-color 0.2s ease;
+ transition:
+ transform 0.2s ease,
+ border-color 0.2s ease,
+ background-color 0.2s ease;
}
.gh-choiceOption:hover,
.gh-choiceOption-selected {
transform: translateY(-1px);
- border-color: color-mix(in srgb, var(--gh-tone-fill) 36%, var(--openui-border-interactive-emphasis));
+ border-color: color-mix(
+ in srgb,
+ var(--gh-tone-fill) 36%,
+ var(--openui-border-interactive-emphasis)
+ );
background: color-mix(in srgb, var(--gh-tone-bg) 54%, var(--openui-foreground));
}
@@ -408,19 +417,22 @@
/* ── Tone tokens ── */
-.gh-tone-green, .gh-tone-mint {
+.gh-tone-green,
+.gh-tone-mint {
--gh-tone-fill: var(--openui-text-success-primary);
--gh-tone-bg: var(--openui-success-background);
--gh-tone-border: var(--openui-border-success);
}
-.gh-tone-purple, .gh-tone-violet {
+.gh-tone-purple,
+.gh-tone-violet {
--gh-tone-fill: var(--openui-text-purple-primary);
--gh-tone-bg: var(--openui-purple-background);
--gh-tone-border: var(--openui-border-accent);
}
-.gh-tone-red, .gh-tone-rose {
+.gh-tone-red,
+.gh-tone-rose {
--gh-tone-fill: var(--openui-text-danger-primary);
--gh-tone-bg: var(--openui-danger-background);
--gh-tone-border: var(--openui-border-danger);
@@ -432,7 +444,8 @@
--gh-tone-border: var(--openui-border-info);
}
-.gh-tone-amber, .gh-tone-peach {
+.gh-tone-amber,
+.gh-tone-peach {
--gh-tone-fill: var(--openui-text-alert-primary);
--gh-tone-bg: var(--openui-alert-background);
--gh-tone-border: var(--openui-border-alert);
@@ -441,7 +454,11 @@
.gh-tone-pink {
--gh-tone-fill: var(--openui-text-pink-primary);
--gh-tone-bg: var(--openui-pink-background);
- --gh-tone-border: color-mix(in srgb, var(--openui-text-pink-primary) 24%, var(--openui-border-default));
+ --gh-tone-border: color-mix(
+ in srgb,
+ var(--openui-text-pink-primary) 24%,
+ var(--openui-border-default)
+ );
}
/* ── Visually hidden ── */
@@ -461,8 +478,14 @@
/* ── Animation ── */
@keyframes gh-step-fade-in {
- from { opacity: 0; transform: translateY(8px); }
- to { opacity: 1; transform: translateY(0); }
+ from {
+ opacity: 0;
+ transform: translateY(8px);
+ }
+ to {
+ opacity: 1;
+ transform: translateY(0);
+ }
}
.gh-step-appear {
@@ -503,7 +526,7 @@
}
.gh-actions {
- margin-top:32px;
+ margin-top: 32px;
flex-wrap: wrap;
align-items: flex-start;
gap: var(--openui-space-l);
diff --git a/docs/app/demo/github/components/GitHubConnect/GitHubConnect.tsx b/docs/app/demo/github/components/GitHubConnect/GitHubConnect.tsx
index b85b11ecd..6e891fa05 100644
--- a/docs/app/demo/github/components/GitHubConnect/GitHubConnect.tsx
+++ b/docs/app/demo/github/components/GitHubConnect/GitHubConnect.tsx
@@ -48,8 +48,9 @@ const STARTER_ICON_MAP: Record<GitHubStarterIconKey, LucideIcon> = {
const DEMO_USERS = [
{ username: "torvalds", tone: "peach" },
{ username: "yyx990803", tone: "mint" },
- { username: "sindresorhus", tone: "violet" },
+ { username: "rauchg", tone: "violet" },
{ username: "gaearon", tone: "rose" },
+ { username: "ctate", tone: "mint" },
] as const satisfies ReadonlyArray<{ username: string; tone: DeveloperTone }>;
const DEVELOPER_OPTIONS: PickerOption[] = DEMO_USERS.map((user) => ({
@@ -184,9 +185,18 @@ export function GitHubConnect({ onConnectAndPrompt }: GitHubConnectProps) {
const validate = useCallback((name: string): boolean => {
const trimmed = name.trim();
- if (!trimmed) { setError("Enter a GitHub username"); return false; }
- if (!/^[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$/.test(trimmed)) { setError("Invalid username format"); return false; }
- if (trimmed.length > 39) { setError("Username too long"); return false; }
+ if (!trimmed) {
+ setError("Enter a GitHub username");
+ return false;
+ }
+ if (!/^[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$/.test(trimmed)) {
+ setError("Invalid username format");
+ return false;
+ }
+ if (trimmed.length > 39) {
+ setError("Username too long");
+ return false;
+ }
setError("");
return true;
}, []);
@@ -199,21 +209,42 @@ export function GitHubConnect({ onConnectAndPrompt }: GitHubConnectProps) {
}, []);
const handleClearIdentity = useCallback(() => handleReset(), [handleReset]);
- const handleClearSelectedFocus = useCallback(() => { setSelectedGithubPrompt(null); setError(""); }, []);
- const handleClearTypedUsername = useCallback(() => { setUsername(""); setAvatarUrl(null); setError(""); focusInput(); }, [focusInput]);
+ const handleClearSelectedFocus = useCallback(() => {
+ setSelectedGithubPrompt(null);
+ setError("");
+ }, []);
+ const handleClearTypedUsername = useCallback(() => {
+ setUsername("");
+ setAvatarUrl(null);
+ setError("");
+ focusInput();
+ }, [focusInput]);
const trimmedUsername = username.trim();
const effectiveUsername = trimmedUsername || selectedDeveloperUsername || "";
- const selectedDeveloperOption = DEVELOPER_OPTIONS.find((o) => o.value === selectedDeveloperUsername) ?? null;
- const selectedFocusOption = FOCUS_AREA_OPTIONS.find((o) => o.value === selectedGithubPrompt) ?? null;
- const selectedDeveloperLeading = selectedDeveloperOption ? renderOptionLeading(selectedDeveloperOption) : null;
- const selectedFocusLeading = selectedFocusOption ? renderOptionLeading(selectedFocusOption) : null;
- const hasValidUsername = effectiveUsername.length > 0 && effectiveUsername.length <= 39 && /^[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$/.test(effectiveUsername);
+ const selectedDeveloperOption =
+ DEVELOPER_OPTIONS.find((o) => o.value === selectedDeveloperUsername) ?? null;
+ const selectedFocusOption =
+ FOCUS_AREA_OPTIONS.find((o) => o.value === selectedGithubPrompt) ?? null;
+ const selectedDeveloperLeading = selectedDeveloperOption
+ ? renderOptionLeading(selectedDeveloperOption)
+ : null;
+ const selectedFocusLeading = selectedFocusOption
+ ? renderOptionLeading(selectedFocusOption)
+ : null;
+ const hasValidUsername =
+ effectiveUsername.length > 0 &&
+ effectiveUsername.length <= 39 &&
+ /^[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$/.test(effectiveUsername);
const hasIdentitySelection = Boolean(effectiveUsername);
- const isTypedIdentityLocked = Boolean(trimmedUsername && selectedGithubPrompt && hasValidUsername);
+ const isTypedIdentityLocked = Boolean(
+ trimmedUsername && selectedGithubPrompt && hasValidUsername,
+ );
const showDeveloperPicker = !selectedDeveloperOption && !trimmedUsername;
const canStart = Boolean(selectedGithubPrompt) && hasValidUsername;
- const canReset = Boolean(trimmedUsername || selectedDeveloperUsername || error || selectedGithubPrompt);
+ const canReset = Boolean(
+ trimmedUsername || selectedDeveloperUsername || error || selectedGithubPrompt,
+ );
const handleStartGenerating = async () => {
if (!selectedGithubPrompt) return;
@@ -221,9 +252,15 @@ export function GitHubConnect({ onConnectAndPrompt }: GitHubConnectProps) {
setValidating(true);
try {
const res = await fetch(`https://api.github.com/users/${effectiveUsername}`);
- if (!res.ok) { setError("GitHub user not found"); setValidating(false); return; }
+ if (!res.ok) {
+ setError("GitHub user not found");
+ setValidating(false);
+ return;
+ }
} catch {
- setError("Could not verify username"); setValidating(false); return;
+ setError("Could not verify username");
+ setValidating(false);
+ return;
}
setValidating(false);
onConnectAndPrompt(effectiveUsername, selectedGithubPrompt);
@@ -238,9 +275,16 @@ export function GitHubConnect({ onConnectAndPrompt }: GitHubConnectProps) {
if (selectedDeveloperOption) {
return (
<span className={`gh-chip gh-tone-${selectedDeveloperOption.tone}`}>
- {selectedDeveloperLeading && <span className="gh-chipLeading">{selectedDeveloperLeading}</span>}
+ {selectedDeveloperLeading && (
+ <span className="gh-chipLeading">{selectedDeveloperLeading}</span>
+ )}
<span className="gh-chipLabel">{selectedDeveloperOption.label}</span>
- <button type="button" className="gh-chipClear" aria-label="Clear selected developer" onClick={handleClearIdentity}>
+ <button
+ type="button"
+ className="gh-chipClear"
+ aria-label="Clear selected developer"
+ onClick={handleClearIdentity}
+ >
<X size={14} />
</button>
</span>
@@ -250,10 +294,19 @@ export function GitHubConnect({ onConnectAndPrompt }: GitHubConnectProps) {
return (
<span className="gh-chip gh-chip-neutral">
<span className="gh-chipLeading">
- {avatarUrl ? <img src={avatarUrl} alt="" className="gh-chipAvatar" /> : <span className="gh-chipMonogram">@</span>}
+ {avatarUrl ? (
+ <img src={avatarUrl} alt="" className="gh-chipAvatar" />
+ ) : (
+ <span className="gh-chipMonogram">@</span>
+ )}
</span>
<span className="gh-chipLabel">@{effectiveUsername}</span>
- <button type="button" className="gh-chipClear" aria-label="Clear username" onClick={handleClearIdentity}>
+ <button
+ type="button"
+ className="gh-chipClear"
+ aria-label="Clear username"
+ onClick={handleClearIdentity}
+ >
<X size={14} />
</button>
</span>
@@ -270,14 +323,24 @@ export function GitHubConnect({ onConnectAndPrompt }: GitHubConnectProps) {
ref={inputRef}
className="gh-inputField"
value={username}
- onChange={(e) => { setSelectedDeveloperUsername(null); setUsername(e.target.value); setAvatarUrl(null); setError(""); }}
+ onChange={(e) => {
+ setSelectedDeveloperUsername(null);
+ setUsername(e.target.value);
+ setAvatarUrl(null);
+ setError("");
+ }}
placeholder="username"
autoComplete="off"
spellCheck={false}
/>
</span>
{trimmedUsername && (
- <button type="button" className="gh-inputClear" aria-label="Clear" onClick={handleClearTypedUsername}>
+ <button
+ type="button"
+ className="gh-inputClear"
+ aria-label="Clear"
+ onClick={handleClearTypedUsername}
+ >
<X size={14} />
</button>
)}
@@ -289,7 +352,9 @@ export function GitHubConnect({ onConnectAndPrompt }: GitHubConnectProps) {
<div className="gh-connect">
<form className="gh-builder" onSubmit={handleSubmit}>
<div className="gh-brand">
- <span className="gh-brandIcon"><GitHubIcon /></span>
+ <span className="gh-brandIcon">
+ <GitHubIcon />
+ </span>
<span className="gh-brandLabel">GitPulse</span>
</div>
@@ -302,9 +367,16 @@ export function GitHubConnect({ onConnectAndPrompt }: GitHubConnectProps) {
that focuses on{" "}
{selectedFocusOption ? (
<span className={`gh-chip gh-chip-focus gh-tone-${selectedFocusOption.tone}`}>
- {selectedFocusLeading && <span className="gh-chipLeading">{selectedFocusLeading}</span>}
+ {selectedFocusLeading && (
+ <span className="gh-chipLeading">{selectedFocusLeading}</span>
+ )}
<span className="gh-chipLabel">{selectedFocusOption.label}</span>
- <button type="button" className="gh-chipClear" aria-label="Clear topic" onClick={handleClearSelectedFocus}>
+ <button
+ type="button"
+ className="gh-chipClear"
+ aria-label="Clear topic"
+ onClick={handleClearSelectedFocus}
+ >
<X size={14} />
</button>
</span>
@@ -335,7 +407,10 @@ export function GitHubConnect({ onConnectAndPrompt }: GitHubConnectProps) {
ariaLabel="Select a focus area"
options={FOCUS_AREA_OPTIONS}
value={selectedGithubPrompt}
- onChange={(v) => { setSelectedGithubPrompt(v); setError(""); }}
+ onChange={(v) => {
+ setSelectedGithubPrompt(v);
+ setError("");
+ }}
className="gh-choiceList-focus"
/>
</div>
@@ -345,10 +420,20 @@ export function GitHubConnect({ onConnectAndPrompt }: GitHubConnectProps) {
{hasIdentitySelection && selectedGithubPrompt && (
<div className="gh-actions gh-step-appear">
- <Button className="gh-cta" size="large" type="submit" disabled={!canStart || validating}>
+ <Button
+ className="gh-cta"
+ size="large"
+ type="submit"
+ disabled={!canStart || validating}
+ >
{validating ? "Verifying..." : "Let's go"}
</Button>
- <button type="button" className="gh-startOver" onClick={handleReset} disabled={!canReset}>
+ <button
+ type="button"
+ className="gh-startOver"
+ onClick={handleReset}
+ disabled={!canReset}
+ >
Start over
</button>
</div>
diff --git a/docs/app/demo/github/constants.ts b/docs/app/demo/github/constants.ts
index 12a992833..be314962b 100644
--- a/docs/app/demo/github/constants.ts
+++ b/docs/app/demo/github/constants.ts
@@ -1,6 +1,9 @@
export type Theme = "system" | "light" | "dark";
export type Status = "idle" | "streaming" | "done" | "error";
+export const GITHUB_DEMO_MODEL = "openai/gpt-5.4-mini";
+export const GITHUB_DEMO_MODEL_LABEL = "GPT-5.4 Mini";
+
export type GitHubStarterIconKey =
| "commit-activity"
| "pull-requests"
@@ -75,5 +78,4 @@ export interface ChatMessage {
content: string;
text?: string;
hasCode: boolean;
- runtimeTools?: ToolCallEntry[];
}
diff --git a/docs/app/demo/github/github/prompt-config.ts b/docs/app/demo/github/github/prompt-config.ts
index d30f3b988..d943323be 100644
--- a/docs/app/demo/github/github/prompt-config.ts
+++ b/docs/app/demo/github/github/prompt-config.ts
@@ -82,4 +82,5 @@ export const GITHUB_ADDITIONAL_RULES: string[] = [
"Use PieChart for language breakdowns (donut variant), BarChart for comparisons, LineChart for trends over time",
"Rate limit: 60 req/hr per visitor. Prefer get_repos (1 API call) over per-repo endpoints (get_commit_activity, get_star_history, get_contributors)",
"Per-repo tools (get_commit_activity, get_star_history, get_contributors) are expensive — only use when the user specifically asks about a specific repo",
+ "NEVER use Image() or ImageBlock() components — no external image URLs are available. Use TextContent, Tag, or emoji for visual accents instead.",
];
diff --git a/docs/app/demo/github/github/tools.ts b/docs/app/demo/github/github/tools.ts
index 009859a62..e22485261 100644
--- a/docs/app/demo/github/github/tools.ts
+++ b/docs/app/demo/github/github/tools.ts
@@ -37,6 +37,46 @@ export function clearCache() {
cache.clear();
}
+/**
+ * Prefetch core GitHub data and return a compact summary for LLM context.
+ * Also warms the cache so Query() nodes resolve instantly on first render.
+ */
+export async function prefetchAndSummarize(
+ tools: Record<string, (args: Record<string, unknown>) => Promise<unknown>>,
+): Promise<string> {
+ const [profile, repos, languages, events] = await Promise.all([
+ tools.get_profile({}),
+ tools.get_repos({ sort: "stars" }),
+ tools.get_languages({}),
+ tools.get_events({}),
+ ]);
+
+ const p = profile as Record<string, unknown>;
+ const repoRows = ((repos as Record<string, unknown>).rows ?? []) as Array<
+ Record<string, unknown>
+ >;
+ const langRows = ((languages as Record<string, unknown>).rows ?? []) as Array<
+ Record<string, unknown>
+ >;
+ const ev = ((events as Record<string, unknown>).summary ?? {}) as Record<string, number>;
+
+ const topRepos = repoRows
+ .slice(0, 8)
+ .map((r) => `${r.name} (${r.stars}★, ${r.language || "unknown"})`)
+ .join(", ");
+ const topLangs = langRows
+ .slice(0, 6)
+ .map((l) => l.language)
+ .join(", ");
+
+ return `<github-data>
+Profile: ${p.name || p.login}, ${p.public_repos} public repos, ${p.followers} followers, joined ${p.created_at}
+Top repos by stars: ${topRepos || "none found"}
+Languages: ${topLangs || "none detected"}
+Recent activity (last 90 days): ${ev.total || 0} events (${ev.push || 0} pushes, ${ev.pr || 0} PRs, ${ev.issues || 0} issues, ${ev.reviews || 0} reviews)
+</github-data>`;
+}
+
// ── Rate limit tracking ────────────────────────────────────────────────────
let rateLimitRemaining = 60;
diff --git a/docs/app/demo/github/layout.css b/docs/app/demo/github/layout.css
index f6e452c03..07362f805 100644
--- a/docs/app/demo/github/layout.css
+++ b/docs/app/demo/github/layout.css
@@ -431,6 +431,17 @@
align-items: center;
}
+.dashboard-model-label {
+ padding: 2px var(--openui-space-s);
+ border-radius: var(--openui-radius-full);
+ background: var(--openui-highlight-subtle);
+ border: 1px solid var(--openui-border-default);
+ font-size: 11px;
+ font-weight: 500;
+ font-family: var(--openui-font-code);
+ color: var(--openui-text-neutral-secondary);
+}
+
.dashboard-elapsed {
font-family: var(--openui-font-code);
}
@@ -459,21 +470,179 @@
color: var(--openui-text-neutral-primary);
}
-.dashboard-source {
- background: var(--playground-code-background);
- color: var(--playground-code-foreground);
- padding: var(--openui-space-m);
+/* Token saving badge */
+.dashboard-token-saving {
+ display: inline-flex;
+ align-items: center;
+ gap: 3px;
+ padding: 2px var(--openui-space-s);
+ border-radius: var(--openui-radius-full);
+ background: var(--openui-success-background);
+ color: var(--openui-text-success-primary);
+ font-size: 11px;
+ font-weight: 600;
+ font-family: var(--openui-font-body);
+}
+
+/* Source panel with tabs */
+.dashboard-source-panel {
+ margin-bottom: var(--openui-space-m);
border: 1px solid var(--openui-border-default);
border-radius: var(--openui-radius-m);
+ overflow: hidden;
+}
+
+.dashboard-source-header {
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ background: var(--openui-highlight-subtle);
+ border-bottom: 1px solid var(--openui-border-default);
+ padding-right: var(--openui-space-s);
+}
+
+.dashboard-source-tabs {
+ display: flex;
+ gap: 0;
+}
+
+.dashboard-source-tab {
+ display: flex;
+ align-items: center;
+ gap: var(--openui-space-xs);
+ padding: var(--openui-space-s) var(--openui-space-m);
+ background: transparent;
+ border: none;
+ border-bottom: 2px solid transparent;
+ color: var(--openui-text-neutral-tertiary);
+ font-size: 11px;
+ font-weight: 600;
+ font-family: var(--openui-font-body);
+ cursor: pointer;
+ transition:
+ color 0.15s,
+ border-color 0.15s;
+}
+
+.dashboard-source-tab:hover {
+ color: var(--openui-text-neutral-secondary);
+}
+
+.dashboard-source-tab-active {
+ color: var(--openui-text-neutral-primary);
+ border-bottom-color: var(--openui-border-accent-emphasis);
+}
+
+.dashboard-source-token-count {
+ padding: 1px 6px;
+ border-radius: var(--openui-radius-full);
+ background: var(--openui-highlight);
+ color: var(--openui-text-neutral-secondary);
+ font-size: 10px;
+ font-weight: 600;
+ font-family: var(--openui-font-code);
+}
+
+.dashboard-source-copy {
+ display: flex;
+ align-items: center;
+ justify-content: center;
+ width: 28px;
+ height: 28px;
+ background: transparent;
+ border: none;
+ border-radius: var(--openui-radius-s);
+ color: var(--openui-text-neutral-tertiary);
+ cursor: pointer;
+ transition:
+ background-color 0.15s,
+ color 0.15s;
+ flex-shrink: 0;
+}
+
+.dashboard-source-copy:hover {
+ background: var(--openui-highlight);
+ color: var(--openui-text-neutral-primary);
+}
+
+.dashboard-source-panel .dashboard-source {
+ border: none;
+ border-radius: 0;
+ margin-bottom: 0;
+}
+
+.dashboard-source {
+ background: var(--openui-sunk);
+ padding: var(--openui-space-m);
font-size: 11px;
font-family: var(--openui-font-code);
overflow: auto;
white-space: pre-wrap;
max-height: 250px;
- line-height: 1.4;
+ line-height: 1.6;
margin-bottom: var(--openui-space-m);
}
+/* Live data indicator strip */
+.dashboard-data-strip {
+ display: flex;
+ align-items: center;
+ gap: var(--openui-space-s);
+ padding: var(--openui-space-xs) var(--openui-space-m);
+ margin-bottom: var(--openui-space-s);
+ border: 1px solid var(--openui-border-success);
+ border-radius: var(--openui-radius-m);
+ background: var(--openui-success-background);
+ font-size: 11px;
+ font-family: var(--openui-font-body);
+ transition:
+ border-color 0.2s,
+ background-color 0.2s;
+}
+
+.dashboard-data-strip-loading {
+ border-color: var(--openui-border-alert);
+ background: var(--openui-alert-background);
+}
+
+.dashboard-data-label {
+ color: var(--openui-text-success-primary);
+ font-weight: 600;
+ white-space: nowrap;
+}
+
+.dashboard-data-strip-loading .dashboard-data-label {
+ color: var(--openui-text-alert-primary);
+}
+
+.dashboard-data-chips {
+ display: flex;
+ flex-wrap: wrap;
+ gap: 3px;
+}
+
+.dashboard-data-chip {
+ padding: 1px var(--openui-space-xs);
+ border-radius: var(--openui-radius-xs);
+ font-size: 10px;
+ font-family: var(--openui-font-code);
+}
+
+.dashboard-data-chip-done {
+ background: var(--openui-success-background);
+ color: var(--openui-text-success-primary);
+}
+
+.dashboard-data-chip-pending {
+ background: var(--openui-alert-background);
+ color: var(--openui-text-alert-primary);
+}
+
+.dashboard-data-chip-error {
+ background: var(--openui-danger-background);
+ color: var(--openui-text-danger-primary);
+}
+
.dashboard-loading {
display: flex;
flex-direction: column;
diff --git a/docs/app/demo/github/page.tsx b/docs/app/demo/github/page.tsx
index a6ed51f82..58268affa 100644
--- a/docs/app/demo/github/page.tsx
+++ b/docs/app/demo/github/page.tsx
@@ -2,22 +2,28 @@
import { mergeStatements } from "@openuidev/react-lang";
import { Button } from "@openuidev/react-ui";
+import { encode } from "gpt-tokenizer";
import {
Activity,
+ Check,
CircleDot,
Code2,
+ Copy,
GitPullRequest,
Hexagon,
Search,
+ Zap,
type LucideIcon,
} from "lucide-react";
import { useTheme } from "next-themes";
+import { Highlight, themes } from "prism-react-renderer";
import { useCallback, useEffect, useMemo, useRef, useState } from "react";
import { ConversationPanel } from "./components/ConversationPanel/ConversationPanel";
import { GitHubConnect } from "./components/GitHubConnect/GitHubConnect";
import { Header } from "./components/Header/Header";
import { PreviewPanel } from "./components/PreviewPanel/PreviewPanel";
import {
+ GITHUB_DEMO_MODEL_LABEL,
GITHUB_STARTERS,
type ChatMessage,
type GitHubStarterIconKey,
@@ -25,7 +31,7 @@ import {
type Theme,
type ToolCallEntry,
} from "./constants";
-import { clearCache, createGitHubToolProvider } from "./github/tools";
+import { clearCache, createGitHubToolProvider, prefetchAndSummarize } from "./github/tools";
// ── Helpers ─────────────────────────────────────────────────────────────────
@@ -90,8 +96,11 @@ type ToolCallListener = (calls: ToolCallEntry[]) => void;
function wrapToolProvider(
inner: Record<string, (args: Record<string, unknown>) => Promise<unknown>>,
listener: ToolCallListener,
-): Record<string, (args: Record<string, unknown>) => Promise<unknown>> {
- const activeCalls: ToolCallEntry[] = [];
+): {
+ tools: Record<string, (args: Record<string, unknown>) => Promise<unknown>>;
+ resetCalls: () => void;
+} {
+ let activeCalls: ToolCallEntry[] = [];
const wrapped: Record<string, (args: Record<string, unknown>) => Promise<unknown>> = {};
for (const [name, fn] of Object.entries(inner)) {
@@ -112,7 +121,12 @@ function wrapToolProvider(
};
}
- return wrapped;
+ return {
+ tools: wrapped,
+ resetCalls: () => {
+ activeCalls = [];
+ },
+ };
}
// ── SSE streaming ────────────────────────────────────────────────────────
@@ -193,7 +207,9 @@ export default function GitHubDemoPage() {
// Dashboard state
const [dashboardCode, setDashboardCode] = useState<string | null>(null);
const [showSource, setShowSource] = useState(false);
+ const [sourceTab, setSourceTab] = useState<"raw" | "json">("raw");
const [parsedJson, setParsedJson] = useState<string | null>(null);
+ const [codeCopied, setCodeCopied] = useState(false);
// Conversation
const [conversation, setConversation] = useState<ChatMessage[]>([]);
@@ -216,6 +232,17 @@ export default function GitHubDemoPage() {
const isGitHub = githubUsername !== null;
const isHomeState = !isGitHub && !hasDashboard && conversation.length === 0;
+ // Token comparison
+ const rawTokens = useMemo(
+ () => (dashboardCode ? encode(dashboardCode).length : 0),
+ [dashboardCode],
+ );
+ const jsonTokens = useMemo(() => (parsedJson ? encode(parsedJson).length : 0), [parsedJson]);
+ const tokenSavingPct =
+ status === "done" && rawTokens > 0 && jsonTokens > 0 && rawTokens < jsonTokens
+ ? Math.round(((jsonTokens - rawTokens) / jsonTokens) * 100)
+ : null;
+
// Theme
const currentTheme = useMemo<Theme>(() => {
if (theme === "light" || theme === "dark" || theme === "system") {
@@ -238,17 +265,19 @@ export default function GitHubDemoPage() {
// ── GitHub connect ───────────────────────────────────────────────────
+ const rawToolsRef = useRef<Record<
+ string,
+ (args: Record<string, unknown>) => Promise<unknown>
+ > | null>(null);
+ const resetToolCallsRef = useRef<(() => void) | null>(null);
+
const handleConnect = useCallback((username: string) => {
const rawTools = createGitHubToolProvider(username);
- const wrapped = wrapToolProvider(rawTools, (calls) => {
+ rawToolsRef.current = rawTools;
+ const { tools: wrapped, resetCalls } = wrapToolProvider(rawTools, (calls) => {
setToolCalls([...calls]);
- setConversation((prev) => {
- if (prev.length === 0) return prev;
- const last = prev[prev.length - 1];
- if (last.role !== "assistant") return prev;
- return [...prev.slice(0, -1), { ...last, runtimeTools: [...calls] }];
- });
});
+ resetToolCallsRef.current = resetCalls;
setGithubUsername(username);
setToolProvider(wrapped);
}, []);
@@ -285,6 +314,7 @@ export default function GitHubDemoPage() {
responseRef.current = "";
setStreamingText("");
setToolCalls([]);
+ resetToolCallsRef.current?.();
setStreamResponseHasCode(false);
let streamStartTime: number | null = null;
@@ -308,13 +338,24 @@ export default function GitHubDemoPage() {
return { role: m.role, content: m.content };
});
+ // Prefetch GitHub data on first message to warm cache + give LLM context
+ // Use raw (unwrapped) tools to avoid triggering tool-call tracking side effects
+ let githubContext = "";
+ if (conversation.length === 0 && rawToolsRef.current) {
+ try {
+ githubContext = await prefetchAndSummarize(rawToolsRef.current);
+ } catch {
+ // Non-critical — LLM just won't have data context
+ }
+ }
+
const controller = new AbortController();
abortRef.current = controller;
try {
await streamChat(
{
- prompt: trimmed,
+ prompt: githubContext ? `${githubContext}\n\n${trimmed}` : trimmed,
messages: apiMessages.slice(0, -1),
},
(chunk) => {
@@ -345,7 +386,6 @@ export default function GitHubDemoPage() {
content: raw,
text,
hasCode,
- runtimeTools: toolCalls.length > 0 ? [...toolCalls] : undefined,
};
setConversation((prev) => [...prev, assistantMsg]);
@@ -374,7 +414,7 @@ export default function GitHubDemoPage() {
setStatus("error");
}
},
- [isStreaming, conversation, dashboardCode, toolCalls],
+ [isStreaming, conversation, dashboardCode],
);
// Process pending prompt after GitHub connect
@@ -425,26 +465,6 @@ export default function GitHubDemoPage() {
<div className="artifact-layout">
{/* Left: Dashboard */}
<div className="dashboard-area">
- {/* Connected user bar */}
- {isGitHub && (hasDashboard || conversation.length > 0) && (
- <div className="gh-connected-bar">
- <img
- src={`https://github.com/${githubUsername}.png?size=32`}
- alt=""
- className="gh-connected-avatar"
- />
- <span>@{githubUsername}</span>
- <Button
- className="gh-connected-change"
- variant="tertiary"
- size="extra-small"
- onClick={handleDisconnect}
- >
- Change
- </Button>
- </div>
- )}
-
{/* GitHub starters (before first generation) */}
{isGitHub && !hasDashboard && conversation.length === 0 && (
<div className="gh-starters-welcome">
@@ -468,7 +488,9 @@ export default function GitHubDemoPage() {
onClick={() => send(s.prompt)}
disabled={isStreaming}
>
- <span className={`gh-starter-icon gh-tone-${s.tone}`}>{renderStarterIcon(s.icon)}</span>
+ <span className={`gh-starter-icon gh-tone-${s.tone}`}>
+ {renderStarterIcon(s.icon)}
+ </span>
<div className="gh-starter-label">{s.label}</div>
<div className="gh-starter-desc">
{s.prompt.length > 60 ? s.prompt.slice(0, 60) + "..." : s.prompt}
@@ -479,12 +501,19 @@ export default function GitHubDemoPage() {
</div>
)}
- {/* Meta + source toggle */}
+ {/* Meta + source toggle + token comparison */}
{hasDashboard && !isStreaming && (
<div className="dashboard-meta">
+ <span className="dashboard-model-label">{GITHUB_DEMO_MODEL_LABEL}</span>
{elapsed && (
<span className="dashboard-elapsed">{(elapsed / 1000).toFixed(1)}s</span>
)}
+ {tokenSavingPct !== null && (
+ <span className="dashboard-token-saving">
+ <Zap size={10} />
+ {tokenSavingPct}% fewer tokens
+ </span>
+ )}
<Button
className="dashboard-source-toggle"
variant="tertiary"
@@ -497,9 +526,130 @@ export default function GitHubDemoPage() {
</div>
)}
- {/* Source code view */}
- {hasDashboard && showSource && (
- <pre className="dashboard-source">{dashboardCode}</pre>
+ {/* Source code view with tabs */}
+ {hasDashboard &&
+ showSource &&
+ (() => {
+ const activeSource =
+ sourceTab === "raw"
+ ? (dashboardCode ?? "")
+ : (parsedJson ?? "Waiting for parse...");
+ const handleCopy = async () => {
+ await navigator.clipboard.writeText(activeSource);
+ setCodeCopied(true);
+ setTimeout(() => setCodeCopied(false), 2000);
+ };
+ return (
+ <div className="dashboard-source-panel">
+ <div className="dashboard-source-header">
+ <div className="dashboard-source-tabs">
+ <button
+ className={`dashboard-source-tab ${sourceTab === "raw" ? "dashboard-source-tab-active" : ""}`}
+ onClick={() => {
+ setSourceTab("raw");
+ setCodeCopied(false);
+ }}
+ >
+ openui-lang
+ {rawTokens > 0 && (
+ <span className="dashboard-source-token-count">
+ {rawTokens.toLocaleString()}
+ </span>
+ )}
+ </button>
+ <button
+ className={`dashboard-source-tab ${sourceTab === "json" ? "dashboard-source-tab-active" : ""}`}
+ onClick={() => {
+ setSourceTab("json");
+ setCodeCopied(false);
+ }}
+ >
+ Parsed JSON
+ {jsonTokens > 0 && (
+ <span className="dashboard-source-token-count">
+ {jsonTokens.toLocaleString()}
+ </span>
+ )}
+ </button>
+ </div>
+ <button
+ className="dashboard-source-copy"
+ onClick={handleCopy}
+ title="Copy code"
+ >
+ {codeCopied ? <Check size={14} /> : <Copy size={14} />}
+ </button>
+ </div>
+ <div className="dashboard-source">
+ <Highlight
+ theme={resolvedMode === "dark" ? themes.oneDark : themes.oneLight}
+ code={activeSource.trim()}
+ language={sourceTab === "json" ? "json" : "javascript"}
+ >
+ {({ className, style, tokens, getLineProps, getTokenProps }) => (
+ <pre
+ className={className}
+ style={{ ...style, margin: 0, background: "transparent" }}
+ >
+ <code>
+ {tokens.map((line, i) => (
+ <div key={i} {...getLineProps({ line })}>
+ {line.map((token, j) => (
+ <span key={j} {...getTokenProps({ token })} />
+ ))}
+ </div>
+ ))}
+ </code>
+ </pre>
+ )}
+ </Highlight>
+ </div>
+ </div>
+ );
+ })()}
+
+ {/* Connected user bar */}
+ {isGitHub && (hasDashboard || conversation.length > 0) && (
+ <div className="gh-connected-bar">
+ <img
+ src={`https://github.com/${githubUsername}.png?size=32`}
+ alt=""
+ className="gh-connected-avatar"
+ />
+ <span>@{githubUsername}</span>
+ <Button
+ className="gh-connected-change"
+ variant="tertiary"
+ size="extra-small"
+ onClick={handleDisconnect}
+ >
+ Change
+ </Button>
+ </div>
+ )}
+
+ {/* Live data indicator */}
+ {hasDashboard && toolCalls.length > 0 && (
+ <div
+ className={`dashboard-data-strip ${toolCalls.some((t) => t.status === "pending") ? "dashboard-data-strip-loading" : ""}`}
+ >
+ <span className="dashboard-data-label">
+ {toolCalls.some((t) => t.status === "pending")
+ ? "Fetching live data..."
+ : "Live data from GitHub"}
+ </span>
+ <div className="dashboard-data-chips">
+ {toolCalls.map((tc, i) => (
+ <span
+ key={i}
+ className={`dashboard-data-chip dashboard-data-chip-${tc.status}`}
+ >
+ {tc.status === "done" ? "✓" : tc.status === "error" ? "✗" : "⏳"}{" "}
+ {tc.tool.replace("get_", "")}
+ </span>
+ ))}
+ </div>
+ </div>
)}
{/* Dashboard renderer */}
@@ -542,7 +692,6 @@ export default function GitHubDemoPage() {
streamingText={streamingText}
isStreaming={isStreaming}
elapsed={elapsed}
- toolCalls={toolCalls}
onSend={send}
onStop={handleStop}
hasDashboard={hasDashboard}
diff --git a/docs/app/playground/layout.css b/docs/app/playground/layout.css
index f4e298d8b..21927ee20 100644
--- a/docs/app/playground/layout.css
+++ b/docs/app/playground/layout.css
@@ -58,7 +58,11 @@
--scrollbar-thumb: var(--openui-text-neutral-tertiary);
--font-sans: var(--openui-font-body);
--font-mono: var(--openui-font-code);
- --playground-focus-ring: color-mix(in srgb, var(--openui-border-accent-emphasis) 24%, transparent);
+ --playground-focus-ring: color-mix(
+ in srgb,
+ var(--openui-border-accent-emphasis) 24%,
+ transparent
+ );
--playground-success-tint: color-mix(in srgb, var(--openui-success-background) 16%, transparent);
--playground-success-border: color-mix(
in srgb,
diff --git a/docs/components/site-marketing-header.tsx b/docs/components/site-marketing-header.tsx
index 665ad2a51..e873b338a 100644
--- a/docs/components/site-marketing-header.tsx
+++ b/docs/components/site-marketing-header.tsx
@@ -3,9 +3,9 @@
import {
GitHubIcon,
GitHubStarButton,
- type LogoVariant,
StarCountBadge,
useGitHubStarCount,
+ type LogoVariant,
} from "@/components/brand-logo";
import { SiteHeaderFrame } from "@/components/site-header";
import { PRIMARY_SITE_NAV_ITEMS, SitePrimaryNav } from "@/components/site-primary-nav";
diff --git a/docs/content/docs/openui-lang/renderer.mdx b/docs/content/docs/openui-lang/renderer.mdx
index 28fa0b439..2942b8cfe 100644
--- a/docs/content/docs/openui-lang/renderer.mdx
+++ b/docs/content/docs/openui-lang/renderer.mdx
@@ -89,18 +89,18 @@ These examples are simplified for demonstration. In production, you'll need to h
Error codes:
-| Code | Source | Description |
-| :------------------ | :------------- | :----------------------------------------------------------------------- |
-| `unknown-component` | parser | Component name not in the library |
-| `missing-required` | parser | Required prop not provided |
-| `null-required` | parser | Required prop explicitly null |
-| `excess-args` | parser | More positional args than schema params (extras dropped, still renders) |
-| `inline-reserved` | parser | Query/Mutation used inline instead of top-level |
-| `parse-failed` | parser | Response produced no renderable root |
-| `parse-exception` | parser | Parser crashed on malformed input |
-| `tool-not-found` | query/mutation | Tool name not found in toolProvider |
-| `runtime-error` | runtime | Expression evaluation failed on a prop |
-| `render-error` | runtime | React component threw during render |
+| Code | Source | Description |
+| :------------------ | :------------- | :---------------------------------------------------------------------- |
+| `unknown-component` | parser | Component name not in the library |
+| `missing-required` | parser | Required prop not provided |
+| `null-required` | parser | Required prop explicitly null |
+| `excess-args` | parser | More positional args than schema params (extras dropped, still renders) |
+| `inline-reserved` | parser | Query/Mutation used inline instead of top-level |
+| `parse-failed` | parser | Response produced no renderable root |
+| `parse-exception` | parser | Parser crashed on malformed input |
+| `tool-not-found` | query/mutation | Tool name not found in toolProvider |
+| `runtime-error` | runtime | Expression evaluation failed on a prop |
+| `render-error` | runtime | React component threw during render |
If no `onError` callback is provided, errors are logged to `console.warn` instead of being silently swallowed.
diff --git a/docs/content/docs/openui-lang/system-prompts.mdx b/docs/content/docs/openui-lang/system-prompts.mdx
index 757612738..e2253eb3b 100644
--- a/docs/content/docs/openui-lang/system-prompts.mdx
+++ b/docs/content/docs/openui-lang/system-prompts.mdx
@@ -66,8 +66,8 @@ const systemPrompt = generatePrompt({
| Flag | What it enables | Default |
| ------------ | ----------------------------------------------------------------------------- | ----------------------------- |
-| `toolCalls` | `Query()`, `Mutation()`, `@Run`, built-in functions, tool workflow rules | `true` if `tools` provided |
-| `bindings` | `$variables`, `@Set`, `@Reset`, built-in functions, reactive filters | `true` if `toolCalls` is true |
+| `toolCalls` | `Query()`, `Mutation()`, `@Run`, built-in functions, tool workflow rules | `true` if `tools` provided |
+| `bindings` | `$variables`, `@Set`, `@Reset`, built-in functions, reactive filters | `true` if `toolCalls` is true |
| `editMode` | Incremental editing - LLM outputs only changed statements | `false` |
| `inlineMode` | Text + fenced code responses - LLM can answer questions without generating UI | `false` |
diff --git a/docs/generated/chat-system-prompt.txt b/docs/generated/chat-system-prompt.txt
index 1cff93aac..af8c67770 100644
--- a/docs/generated/chat-system-prompt.txt
+++ b/docs/generated/chat-system-prompt.txt
@@ -117,34 +117,6 @@ Tag(text: string, icon?: string, size?: "sm" | "md" | "lg", variant?: "neutral"
### Other
Card(children: (TextContent | MarkDownRenderer | CardHeader | Callout | TextCallout | CodeBlock | Image | ImageBlock | ImageGallery | Separator | HorizontalBarChart | RadarChart | PieChart | RadialChart | SingleStackedBarChart | ScatterChart | AreaChart | BarChart | LineChart | Table | TagBlock | Form | Buttons | Steps | ListBlock | FollowUpBlock | SectionBlock | Tabs | Carousel)[]) — Vertical container for all content in a chat response. Children stack top to bottom automatically.
-## Built-in Functions
-
-Data functions prefixed with `@` to distinguish from components. These are the ONLY functions available — do NOT invent new ones.
-Use @-prefixed built-in functions (@Count, @Sum, @Avg, @Min, @Max, @Round) on Query results — do NOT hardcode computed values.
-
-@Count(array) → number — Returns array length
-@First(array) → element — Returns first element of array
-@Last(array) → element — Returns last element of array
-@Sum(numbers[]) → number — Sum of numeric array
-@Avg(numbers[]) → number — Average of numeric array
-@Min(numbers[]) → number — Minimum value in array
-@Max(numbers[]) → number — Maximum value in array
-@Sort(array, field, direction?) → sorted array — Sort array by field. Direction: "asc" (default) or "desc"
-@Filter(array, field, operator: "==" | "!=" | ">" | "<" | ">=" | "<=" | "contains", value) → filtered array — Filter array by field value
-@Round(number, decimals?) → number — Round to N decimal places (default 0)
-@Abs(number) → number — Absolute value
-@Floor(number) → number — Round down to nearest integer
-@Ceil(number) → number — Round up to nearest integer
-@Each(array, varName, template) — Evaluate template for each element. varName is the loop variable — use it ONLY inside the template expression (inline). Do NOT create a separate statement for the template.
-
-Builtins compose — output of one is input to the next:
-`@Count(@Filter(data.rows, "field", "==", "val"))` for KPIs/chart values, `@Round(@Avg(data.rows.score), 1)`, `@Each(data.rows, "item", Comp(item.field))` for per-item rendering.
-Array pluck: `data.rows.field` extracts a field from every row → use with @Sum, @Avg, charts, tables.
-
-IMPORTANT @Each rule: The loop variable (e.g. "item") is ONLY available inside the @Each template expression. Always inline the template — do NOT extract it to a separate statement.
-CORRECT: `Col("Actions", @Each(rows, "t", Button("Edit", Action([@Set($id, t.id)]))))`
-WRONG: `myBtn = Button("Edit", Action([@Set($id, t.id)]))` then `Col("Actions", @Each(rows, "t", myBtn))` — t is undefined in myBtn.
-
## Action — Button Behavior
Action([@steps...]) wires button clicks to operations. Steps are @-prefixed built-in actions. Steps execute in order.
@@ -169,10 +141,8 @@ During streaming, the output is re-parsed on every chunk. Undefined references a
**Recommended statement order for optimal streaming:**
1. `root = Card(...)` — UI shell appears immediately
-2. $variable declarations — state ready for bindings
-3. Query statements — defaults resolve immediately so components render with data
-4. Component definitions — fill in with data already available
-5. Data values — leaf content last
+2. Component definitions — fill in as they stream
+3. Data values — leaf content last
Always write the root = Card(...) statement first so the UI shell appears immediately, even before child data has streamed in.
diff --git a/docs/generated/playground-component-spec.json b/docs/generated/playground-component-spec.json
index c10423427..d36586a0b 100644
--- a/docs/generated/playground-component-spec.json
+++ b/docs/generated/playground-component-spec.json
@@ -265,10 +265,7 @@
},
{
"name": "Tables",
- "components": [
- "Table",
- "Col"
- ],
+ "components": ["Table", "Col"],
"notes": [
"- Table is COLUMN-oriented: Table([Col(\"Label\", dataArray), Col(\"Count\", countArray, \"number\")]). Use array pluck for data: data.rows.fieldName",
"- Col data can be component arrays for styled cells: Col(\"Status\", @Each(data.rows, \"item\", Tag(item.status, null, \"sm\", item.status == \"open\" ? \"success\" : \"danger\")))",
@@ -298,12 +295,7 @@
},
{
"name": "Charts (1D)",
- "components": [
- "PieChart",
- "RadialChart",
- "SingleStackedBarChart",
- "Slice"
- ],
+ "components": ["PieChart", "RadialChart", "SingleStackedBarChart", "Slice"],
"notes": [
"- PieChart and BarChart need NUMBERS, not objects. For list data, use @Count(@Filter(...)) to aggregate:",
"- PieChart from list: `PieChart([\"Low\", \"Med\", \"High\"], [@Count(@Filter(data.rows, \"priority\", \"==\", \"low\")), @Count(@Filter(data.rows, \"priority\", \"==\", \"medium\")), @Count(@Filter(data.rows, \"priority\", \"==\", \"high\"))], \"donut\")`",
@@ -312,11 +304,7 @@
},
{
"name": "Charts (Scatter)",
- "components": [
- "ScatterChart",
- "ScatterSeries",
- "Point"
- ]
+ "components": ["ScatterChart", "ScatterSeries", "Point"]
},
{
"name": "Forms",
@@ -350,20 +338,14 @@
},
{
"name": "Buttons",
- "components": [
- "Button",
- "Buttons"
- ],
+ "components": ["Button", "Buttons"],
"notes": [
"- Toggle in @Each: @Each(rows, \"t\", Button(t.status == \"open\" ? \"Close\" : \"Reopen\", Action([...])))"
]
},
{
"name": "Data Display",
- "components": [
- "TagBlock",
- "Tag"
- ],
+ "components": ["TagBlock", "Tag"],
"notes": [
"- Color-mapped Tag: Tag(value, null, \"sm\", value == \"high\" ? \"danger\" : value == \"medium\" ? \"warning\" : \"neutral\")"
]
diff --git a/docs/generated/playground-system-prompt.txt b/docs/generated/playground-system-prompt.txt
index 2e87a5674..ba91045c0 100644
--- a/docs/generated/playground-system-prompt.txt
+++ b/docs/generated/playground-system-prompt.txt
@@ -123,34 +123,6 @@ TagBlock(tags: string[]) — tags is an array of strings
Tag(text: string, icon?: string, size?: "sm" | "md" | "lg", variant?: "neutral" | "info" | "success" | "warning" | "danger") — Styled tag/badge with optional icon and variant
- Color-mapped Tag: Tag(value, null, "sm", value == "high" ? "danger" : value == "medium" ? "warning" : "neutral")
-## Built-in Functions
-
-Data functions prefixed with `@` to distinguish from components. These are the ONLY functions available — do NOT invent new ones.
-Use @-prefixed built-in functions (@Count, @Sum, @Avg, @Min, @Max, @Round) on Query results — do NOT hardcode computed values.
-
-@Count(array) → number — Returns array length
-@First(array) → element — Returns first element of array
-@Last(array) → element — Returns last element of array
-@Sum(numbers[]) → number — Sum of numeric array
-@Avg(numbers[]) → number — Average of numeric array
-@Min(numbers[]) → number — Minimum value in array
-@Max(numbers[]) → number — Maximum value in array
-@Sort(array, field, direction?) → sorted array — Sort array by field. Direction: "asc" (default) or "desc"
-@Filter(array, field, operator: "==" | "!=" | ">" | "<" | ">=" | "<=" | "contains", value) → filtered array — Filter array by field value
-@Round(number, decimals?) → number — Round to N decimal places (default 0)
-@Abs(number) → number — Absolute value
-@Floor(number) → number — Round down to nearest integer
-@Ceil(number) → number — Round up to nearest integer
-@Each(array, varName, template) — Evaluate template for each element. varName is the loop variable — use it ONLY inside the template expression (inline). Do NOT create a separate statement for the template.
-
-Builtins compose — output of one is input to the next:
-`@Count(@Filter(data.rows, "field", "==", "val"))` for KPIs/chart values, `@Round(@Avg(data.rows.score), 1)`, `@Each(data.rows, "item", Comp(item.field))` for per-item rendering.
-Array pluck: `data.rows.field` extracts a field from every row → use with @Sum, @Avg, charts, tables.
-
-IMPORTANT @Each rule: The loop variable (e.g. "item") is ONLY available inside the @Each template expression. Always inline the template — do NOT extract it to a separate statement.
-CORRECT: `Col("Actions", @Each(rows, "t", Button("Edit", Action([@Set($id, t.id)]))))`
-WRONG: `myBtn = Button("Edit", Action([@Set($id, t.id)]))` then `Col("Actions", @Each(rows, "t", myBtn))` — t is undefined in myBtn.
-
## Action — Button Behavior
Action([@steps...]) wires button clicks to operations. Steps are @-prefixed built-in actions. Steps execute in order.
@@ -175,10 +147,8 @@ During streaming, the output is re-parsed on every chunk. Undefined references a
**Recommended statement order for optimal streaming:**
1. `root = Stack(...)` — UI shell appears immediately
-2. $variable declarations — state ready for bindings
-3. Query statements — defaults resolve immediately so components render with data
-4. Component definitions — fill in with data already available
-5. Data values — leaf content last
+2. Component definitions — fill in as they stream
+3. Data values — leaf content last
Always write the root = Stack(...) statement first so the UI shell appears immediately, even before child data has streamed in.