Skip to main content
Documents saga a2ui 0.11.0-rc.1 (prerelease). This is the SDK guide docs/public-install.md at source revision fb4126c. It is published as a snapshot: later source changes do not alter it. Licensed under Apache-2.0.
The public release set contains seven packages: Use Node 22.12.0 or newer and a TypeScript-aware bundler. The packages export TypeScript source. An application normally installs one stack and its framework peers, and imports from that stack only.

​
Choose an exact published version

Check the registry before selecting a version:
The current RC is 0.9.0-rc.1 for all seven packages, verified on 29 October 2026. The recipes below pin those versions. The release receipt records the source revision, registry integrity and anonymous installation checks. next selects these versions; latest was not changed by this release. A stack pins its SDK siblings, so its patch version can differ from theirs. For another release, confirm the stack version and its framework peers in npm before replacing the pins. Source manifests and candidate builds can be ahead of the registry.

​
Install one stack plus framework peers

At your application’s root, preserve existing overrides and add:
For Lit:
For React:
Commit the application lockfile. Each stack declares its SAGA siblings as regular dependencies with exact pins, so the application does not declare those packages separately. Use the stack root for an application-owned catalog and /faithful-card for a card application; /server is composed separately and stays out of browser bundles. A stack’s server entry requires the full application’s framework peers. For pnpm, put the equivalent Markdown override in the consumer workspace root. See React consumer dependencies for the separate A2UI Zod 3 and MCP Zod 4 contexts. Do not add direct upstream A2UI packages to a stack application.

​
Lower-level integrations

Applications that intentionally compose lower-level SDK APIs may install the packages they import, using the versions recorded in the release receipt. The original four-package 0.1.0-rc.1 release remains historical; it predates the stacks. See package layout for ownership and entry points.

​
Run a demo or use a starter

Getting started creates a Lit starter or the React starter on Hono, or attaches SAGA to an existing backend, and its two tracks build an application (React, Lit, which also runs the synthetic demo). The React tutorial installs published npm packages in the reader’s own app directory. The source CLI and contributor workflows build matched candidate tarballs from a checkout to test unpublished changes. Candidates have versions such as 0.0.0-candidate.g<12 hex> and are distinct from public npm releases; see candidate installation, updates and rollback. The source CLI, root workspace and example applications are not npm packages. Continue with the Lit track or the React track to connect a view, then the action guide to trace a complete interaction. Host compatibility records the flows observed in ChatGPT, Claude and Alexa+. Installing a package does not deploy an application or establish acceptance in an assistant host.

​
Maintainer publication

Release preparation describes the seven-package set, exact tarball qualification and publication verification. Source metadata and passing CI prepare a release; successful publication followed by an anonymous exact-version install establishes registry availability. Keep current release receipts here instead of copying mutable registry status into agent instructions and development guides. For repeat releases, npm trusted publishing needs a matching package repository URL, a supported Node/npm combination and id-token: write confined to its publishing job. The existing validation workflow does not publish. Verify scope ownership and approved versions and tags before publishing with public npm access.