Skip to content

docs: Fix discrepancies between v0.8 spec/docs and schemas #556

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jacobsimionato merged 3 commits into from
Jan 27, 2026
+5 −5
Merged

docs: Fix discrepancies between v0.8 spec/docs and schemas #556

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
504f83f
docs: Fix discrepancies between v0.8 spec/docs and schemas
jacobsimionato Jan 27, 2026
17fc822
Fix catalog ids for v0.8
jacobsimionato Jan 27, 2026
7b63c02
Merge branch 'main' into fix-schema-discrepancies
jacobsimionato Jan 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/reference/components.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -91,7 +91,7 @@ Display icons using Material Icons or custom icon sets.
"id": "check-icon",
"component": {
"Icon": {
"name": {"literalString": "check_circle"}
"name": {"literalString": "check"}
}
}
}
Expand Down Expand Up @@ -169,7 +169,7 @@ Boolean toggle.
{
"id": "terms-checkbox",
"component": {
"Checkbox": {
"CheckBox": {
Copy link
Contributor

@gemini-code-assist gemini-code-assist bot Jan 27, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

For consistency with other components in this document, it would be great to add markdown headings for components where they are missing. For example:

  • A ### CheckBox heading before the description on line 166.
  • A ### List heading before the description on line 232.

"label": {"literalString": "I agree to the terms"},
"value": {"path": "/form/agreedToTerms"}
}
Expand Down
2 changes: 1 addition & 1 deletion specification/v0_8/docs/custom_catalog_changes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ Your responsibilities are to accurately declare your capabilities and render sur

1. **Declare capabilities on every request**: For every A2A message your application sends, your library must inject the `a2uiClientCapabilities` object into the top-level `metadata` field.

2. **Populate `supportedCatalogIds`**: In the capabilities object, populate this array with the string identifiers of all pre-compiled catalogs your renderer supports. If your renderer supports the standard catalog for v0.8, you **should** include its ID: `a2ui.org:standard_catalog_0_8_0`.
2. **Populate `supportedCatalogIds`**: In the capabilities object, populate this array with the string identifiers of all pre-compiled catalogs your renderer supports. If your renderer supports the standard catalog for v0.8, you **should** include its ID: `https://github.com/google/A2UI/blob/main/specification/v0_8/json/standard_catalog_definition.json`.

3. **Provide `inlineCatalogs` (optional)**: If your renderer supports dynamically generating or defining catalogs at runtime, include their full, valid Catalog Definition Documents in the `inlineCatalogs` array.

Expand Down
2 changes: 1 addition & 1 deletion specification/v0_8/json/a2ui_client_capabilities_schema.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"properties": {
"supportedCatalogIds": {
"type": "array",
"description": "The URI of each of the catalogs that is supported by the client. The standard catalog for v0.8 is 'a2ui.org:standard_catalog_0_8_0'.",
"description": "The URI of each of the catalogs that is supported by the client. The standard catalog for v0.8 is 'https://github.com/google/A2UI/blob/main/specification/v0_8/json/standard_catalog_definition.json'.",
"items": {
"type": "string"
}
Expand Down
2 changes: 1 addition & 1 deletion specification/v0_8/json/server_to_client.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@
},
"catalogId": {
"type": "string",
"description": "The identifier of the component catalog to use for this surface. If omitted, the client MUST default to the standard catalog for this A2UI version (a2ui.org:standard_catalog_0_8_0)."
"description": "The identifier of the component catalog to use for this surface. If omitted, the client MUST default to the standard catalog for this A2UI version (https://github.com/google/A2UI/blob/main/specification/v0_8/json/standard_catalog_definition.json)."
},
"root": {
"type": "string",
Expand Down
Loading