Skip to content

v0.12.0 — Generative UI Protocol

Choose a tag to compare

@gustavoignis gustavoignis released this 24 Aug 03:07
· 94 commits to main since this release

What's new in 0.12.0

Public release of @ggui-ai/*@0.12.0 — install via npm install @ggui-ai/cli@0.12.0.

The server tells the truth about itself

  • MCP serverInfo.version, the MCP Apps appInfo.version, and /ggui/health all report the real shipped release now — previously hand-typed placeholders (0.0.1, 1.0.0) told every connected agent the wrong thing. A new runtime constant, GGUI_WAVE_VERSION (exported from @ggui-ai/protocol), carries the shipped wave and is parity-pinned to the published packages so the wire identity cannot drift again.

Registered themes travel with the render

  • The server now delivers a registered theme's full light/dark token ladders alongside the per-app overlay, and the runtime installs the delivered ladder as the base token set. A registered theme renders identically on every surface — there is no compiled-in copy to drift out of date.
  • Theme registration gained guardrails: a coverage validator proves a theme defines every token the design system actually consumes (both modes, with explicit inherit declarations — nothing passes quietly); unknown theme ids are refused at the point they were typed; and a brand-shaped variable overlay gets a pointed suggestion to register as a full theme instead of silently painting over defaults.

Readability, guaranteed

  • Solid-accent components — buttons, active tabs, checkbox marks, tooltips — read their foreground from the theme's on-accent tokens (onPrimary, onError) instead of hardcoded white, so a bright accent color gets dark text automatically.
  • A WCAG AA contrast sweep over every producible foreground/background pairing now stands in the design test suite, in both color modes.

Generation quality

  • Generated UIs are checked for prop sensitivity before they ship: a displayed required scalar that does not track its prop value is caught by the render check instead of reaching users.

Install

npm install @ggui-ai/cli@0.12.0

Verify provenance: every tarball is signed via npm Trusted Publishing (OIDC); see https://www.npmjs.com/package/@ggui-ai/cli for the public attestation.