From 72ddee7b69c228aa70320e3bd5a18abd14f47d80 Mon Sep 17 00:00:00 2001 From: Yegor Jbanov Date: Wed, 10 Jun 2026 16:59:48 -0700 Subject: [PATCH] docs: standardize A2UI acronym expansions across specifications and docs Remove incorrect and inconsistent expansions of the A2UI acronym (such as "Agent to UI", "Agent-to-Agent UI") from protocol titles, JSON schema titles/descriptions, and documentation, aligning on "Agent to User Interface". --- .../google/a2ui/adk/a2a_extension/SendA2uiToClientToolset.kt | 2 +- docs/index.md | 2 +- docs/introduction/what-is-a2ui.md | 2 +- renderers/web_core/src/v0_8/schema/server-to-client.ts | 2 +- specification/v0_8/docs/a2ui_extension_specification.md | 4 ++-- specification/v0_8/docs/a2ui_protocol.md | 4 ++-- specification/v0_8/json/client_to_server.json | 2 +- specification/v0_8/json/server_to_client.json | 2 +- .../v0_8/json/server_to_client_with_standard_catalog.json | 2 +- specification/v0_9/docs/a2ui_extension_specification.md | 4 ++-- specification/v0_9/docs/a2ui_protocol.md | 2 +- specification/v0_9/json/client_to_server.json | 2 +- specification/v0_9/json/server_to_client.json | 2 +- specification/v0_9_1/docs/a2ui_extension_specification.md | 4 ++-- specification/v0_9_1/docs/a2ui_protocol.md | 2 +- specification/v0_9_1/json/client_to_server.json | 2 +- specification/v0_9_1/json/server_to_client.json | 2 +- specification/v1_0/docs/a2ui_extension_specification.md | 4 ++-- specification/v1_0/docs/a2ui_protocol.md | 2 +- specification/v1_0/json/client_to_server.json | 2 +- specification/v1_0/json/server_to_client.json | 2 +- 21 files changed, 26 insertions(+), 26 deletions(-) diff --git a/agent_sdks/kotlin/src/main/kotlin/com/google/a2ui/adk/a2a_extension/SendA2uiToClientToolset.kt b/agent_sdks/kotlin/src/main/kotlin/com/google/a2ui/adk/a2a_extension/SendA2uiToClientToolset.kt index 99a2a6a2fc..0a7c356ac7 100644 --- a/agent_sdks/kotlin/src/main/kotlin/com/google/a2ui/adk/a2a_extension/SendA2uiToClientToolset.kt +++ b/agent_sdks/kotlin/src/main/kotlin/com/google/a2ui/adk/a2a_extension/SendA2uiToClientToolset.kt @@ -38,7 +38,7 @@ typealias A2uiCatalogProvider = (ReadonlyContext) -> A2uiCatalog typealias A2uiExamplesProvider = (ReadonlyContext) -> String /** - * A toolset that furnishes ADK agents with A2UI (Agent-to-UI) functional tools. + * A toolset that furnishes ADK agents with A2UI functional tools. * * This allows an agent to explicitly decide to render UI components based on the configured schemas * and current catalog capabilities. Features dynamic enablement, pulling localized components on diff --git a/docs/index.md b/docs/index.md index 049230ad58..d1addb92b0 100644 --- a/docs/index.md +++ b/docs/index.md @@ -15,7 +15,7 @@ hide: # A Protocol for Agent-Driven Interfaces

-A2UI enables AI agents to generate rich, interactive user interfaces that render natively across web, mobile, and desktop—without executing arbitrary code. +A2UI (Agent to User Interface) enables AI agents to generate rich, interactive user interfaces that render natively across web, mobile, and desktop—without executing arbitrary code.

diff --git a/docs/introduction/what-is-a2ui.md b/docs/introduction/what-is-a2ui.md index 0081aae21b..da29624142 100644 --- a/docs/introduction/what-is-a2ui.md +++ b/docs/introduction/what-is-a2ui.md @@ -1,6 +1,6 @@ # What is A2UI? -**A2UI (Agent to UI) is a declarative UI protocol for agent-driven interfaces.** AI agents generate rich, interactive UIs that render natively across platforms (web, mobile, desktop) without executing arbitrary code. +**A2UI (Agent to User Interface) is a declarative UI protocol for agent-driven interfaces.** AI agents generate rich, interactive UIs that render natively across platforms (web, mobile, desktop) without executing arbitrary code. ## The Problem diff --git a/renderers/web_core/src/v0_8/schema/server-to-client.ts b/renderers/web_core/src/v0_8/schema/server-to-client.ts index 3707b46d13..7abb5f2f98 100644 --- a/renderers/web_core/src/v0_8/schema/server-to-client.ts +++ b/renderers/web_core/src/v0_8/schema/server-to-client.ts @@ -260,7 +260,7 @@ export const A2uiMessageSchema = z } }) .describe( - "Describes a JSON payload for an A2UI (Agent to UI) message, which is used to dynamically construct and update user interfaces. A message MUST contain exactly ONE of the action properties: 'beginRendering', 'surfaceUpdate', 'dataModelUpdate', or 'deleteSurface'.", + "Describes a JSON payload for an A2UI message, which is used to dynamically construct and update user interfaces. A message MUST contain exactly ONE of the action properties: 'beginRendering', 'surfaceUpdate', 'dataModelUpdate', or 'deleteSurface'.", ); export type A2uiMessage = z.infer; diff --git a/specification/v0_8/docs/a2ui_extension_specification.md b/specification/v0_8/docs/a2ui_extension_specification.md index f4d35febcc..c603930d06 100644 --- a/specification/v0_8/docs/a2ui_extension_specification.md +++ b/specification/v0_8/docs/a2ui_extension_specification.md @@ -1,8 +1,8 @@ -# A2UI (Agent-to-Agent UI) Extension spec +# A2UI Extension spec ## Overview -This extension implements the A2UI (Agent-to-Agent UI) spec, a format for agents to send streaming, interactive user interfaces to clients. +This extension implements the A2UI spec, a format for agents to send streaming, interactive user interfaces to clients. ## Extension URI diff --git a/specification/v0_8/docs/a2ui_protocol.md b/specification/v0_8/docs/a2ui_protocol.md index 4d64569ccc..2606157876 100644 --- a/specification/v0_8/docs/a2ui_protocol.md +++ b/specification/v0_8/docs/a2ui_protocol.md @@ -3,7 +3,7 @@
A2UI Protocol Logo -

A2UI (Agent to UI) Protocol

+

A2UI Protocol

@@ -14,7 +14,7 @@ Updated: Nov 12, 2025 ## Design requirements -The A2UI (Agent to UI) protocol should be a system where an LLM can stream a platform-agnostic, abstract UI definition to a client, which then renders it progressively using a native widget set. Every major design choice is traced back to the core challenges of LLM generation, perceived performance, and platform independence. +The A2UI protocol should be a system where an LLM can stream a platform-agnostic, abstract UI definition to a client, which then renders it progressively using a native widget set. Every major design choice is traced back to the core challenges of LLM generation, perceived performance, and platform independence. ### Requirement: The protocol must be easily generated by a Transformer Large Language Model (LLM) diff --git a/specification/v0_8/json/client_to_server.json b/specification/v0_8/json/client_to_server.json index 510518267e..afc218a70f 100644 --- a/specification/v0_8/json/client_to_server.json +++ b/specification/v0_8/json/client_to_server.json @@ -1,5 +1,5 @@ { - "title": "A2UI (Agent to UI) Client-to-Server Event Schema", + "title": "A2UI Client-to-Server Event Schema", "description": "Describes a JSON payload for a client-to-server event message.", "type": "object", "minProperties": 1, diff --git a/specification/v0_8/json/server_to_client.json b/specification/v0_8/json/server_to_client.json index 908f54669d..fa3f9923a8 100644 --- a/specification/v0_8/json/server_to_client.json +++ b/specification/v0_8/json/server_to_client.json @@ -1,6 +1,6 @@ { "title": "A2UI Message Schema", - "description": "Describes a JSON payload for an A2UI (Agent to UI) message, which is used to dynamically construct and update user interfaces. A message MUST contain exactly ONE of the action properties: 'beginRendering', 'surfaceUpdate', 'dataModelUpdate', or 'deleteSurface'.", + "description": "Describes a JSON payload for an A2UI message, which is used to dynamically construct and update user interfaces. A message MUST contain exactly ONE of the action properties: 'beginRendering', 'surfaceUpdate', 'dataModelUpdate', or 'deleteSurface'.", "type": "object", "additionalProperties": false, "properties": { diff --git a/specification/v0_8/json/server_to_client_with_standard_catalog.json b/specification/v0_8/json/server_to_client_with_standard_catalog.json index 74536b9d61..0090c1824b 100644 --- a/specification/v0_8/json/server_to_client_with_standard_catalog.json +++ b/specification/v0_8/json/server_to_client_with_standard_catalog.json @@ -1,6 +1,6 @@ { "title": "A2UI Message Schema", - "description": "Describes a JSON payload for an A2UI (Agent to UI) message, which is used to dynamically construct and update user interfaces. A message MUST contain exactly ONE of the action properties: 'beginRendering', 'surfaceUpdate', 'dataModelUpdate', or 'deleteSurface'.", + "description": "Describes a JSON payload for an A2UI message, which is used to dynamically construct and update user interfaces. A message MUST contain exactly ONE of the action properties: 'beginRendering', 'surfaceUpdate', 'dataModelUpdate', or 'deleteSurface'.", "type": "object", "additionalProperties": false, "properties": { diff --git a/specification/v0_9/docs/a2ui_extension_specification.md b/specification/v0_9/docs/a2ui_extension_specification.md index af3ec1ba71..79c1b60b0f 100644 --- a/specification/v0_9/docs/a2ui_extension_specification.md +++ b/specification/v0_9/docs/a2ui_extension_specification.md @@ -1,8 +1,8 @@ -# A2UI (Agent-to-Agent UI) Extension spec v0.9 +# A2UI Extension spec v0.9 ## Overview -This extension implements the A2UI (Agent-to-Agent UI) spec v0.9, a format for agents to send streaming, interactive user interfaces to clients. +This extension implements the A2UI spec v0.9, a format for agents to send streaming, interactive user interfaces to clients. ## Extension URI diff --git a/specification/v0_9/docs/a2ui_protocol.md b/specification/v0_9/docs/a2ui_protocol.md index d214530f80..0fd96dd5b8 100644 --- a/specification/v0_9/docs/a2ui_protocol.md +++ b/specification/v0_9/docs/a2ui_protocol.md @@ -4,7 +4,7 @@
A2UI Protocol Logo -

A2UI (Agent to UI) Protocol v0.9

+

A2UI Protocol v0.9

diff --git a/specification/v0_9/json/client_to_server.json b/specification/v0_9/json/client_to_server.json index f2b1b5887b..3ad6d5fb71 100644 --- a/specification/v0_9/json/client_to_server.json +++ b/specification/v0_9/json/client_to_server.json @@ -1,5 +1,5 @@ { - "title": "A2UI (Agent to UI) Client-to-Server Event Schema", + "title": "A2UI Client-to-Server Event Schema", "description": "Describes a JSON payload for a client-to-server event message.", "type": "object", "minProperties": 2, diff --git a/specification/v0_9/json/server_to_client.json b/specification/v0_9/json/server_to_client.json index 005980642d..6649c0cf54 100644 --- a/specification/v0_9/json/server_to_client.json +++ b/specification/v0_9/json/server_to_client.json @@ -2,7 +2,7 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://a2ui.org/specification/v0_9/server_to_client.json", "title": "A2UI Message Schema", - "description": "Describes a JSON payload for an A2UI (Agent to UI) message, which is used to dynamically construct and update user interfaces.", + "description": "Describes a JSON payload for an A2UI message, which is used to dynamically construct and update user interfaces.", "type": "object", "oneOf": [ {"$ref": "#/$defs/CreateSurfaceMessage"}, diff --git a/specification/v0_9_1/docs/a2ui_extension_specification.md b/specification/v0_9_1/docs/a2ui_extension_specification.md index 89b33bab86..795ce74f43 100644 --- a/specification/v0_9_1/docs/a2ui_extension_specification.md +++ b/specification/v0_9_1/docs/a2ui_extension_specification.md @@ -1,8 +1,8 @@ -# A2UI (Agent-to-Agent UI) Extension spec v0.9.1 +# A2UI Extension spec v0.9.1 ## Overview -This extension implements the A2UI (Agent-to-Agent UI) spec v0.9.1, a format for agents to send streaming, interactive user interfaces to clients. +This extension implements the A2UI spec v0.9.1, a format for agents to send streaming, interactive user interfaces to clients. ## Extension URI diff --git a/specification/v0_9_1/docs/a2ui_protocol.md b/specification/v0_9_1/docs/a2ui_protocol.md index 82f45846ee..f239144738 100644 --- a/specification/v0_9_1/docs/a2ui_protocol.md +++ b/specification/v0_9_1/docs/a2ui_protocol.md @@ -4,7 +4,7 @@
A2UI Protocol Logo -

A2UI (Agent to UI) Protocol v0.9

+

A2UI Protocol v0.9.1

diff --git a/specification/v0_9_1/json/client_to_server.json b/specification/v0_9_1/json/client_to_server.json index 37261d7d1b..90da605eec 100644 --- a/specification/v0_9_1/json/client_to_server.json +++ b/specification/v0_9_1/json/client_to_server.json @@ -1,5 +1,5 @@ { - "title": "A2UI (Agent to UI) Client-to-Server Event Schema", + "title": "A2UI Client-to-Server Event Schema", "description": "Describes a JSON payload for a client-to-server event message.", "type": "object", "minProperties": 2, diff --git a/specification/v0_9_1/json/server_to_client.json b/specification/v0_9_1/json/server_to_client.json index dcf138a177..dd16584a7f 100644 --- a/specification/v0_9_1/json/server_to_client.json +++ b/specification/v0_9_1/json/server_to_client.json @@ -2,7 +2,7 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://a2ui.org/specification/v0_9/server_to_client.json", "title": "A2UI Message Schema", - "description": "Describes a JSON payload for an A2UI (Agent to UI) message, which is used to dynamically construct and update user interfaces.", + "description": "Describes a JSON payload for an A2UI message, which is used to dynamically construct and update user interfaces.", "type": "object", "oneOf": [ {"$ref": "#/$defs/CreateSurfaceMessage"}, diff --git a/specification/v1_0/docs/a2ui_extension_specification.md b/specification/v1_0/docs/a2ui_extension_specification.md index 713f08a018..1cd5d44b78 100644 --- a/specification/v1_0/docs/a2ui_extension_specification.md +++ b/specification/v1_0/docs/a2ui_extension_specification.md @@ -1,8 +1,8 @@ -# A2UI (Agent-to-Agent UI) Extension spec v1.0 +# A2UI Extension spec v1.0 ## Overview -This extension implements the A2UI (Agent-to-Agent UI) spec v1.0, a format for agents to send streaming, interactive user interfaces to clients. +This extension implements the A2UI spec v1.0, a format for agents to send streaming, interactive user interfaces to clients. ## Extension URI diff --git a/specification/v1_0/docs/a2ui_protocol.md b/specification/v1_0/docs/a2ui_protocol.md index 930fd065ef..86a9e214ac 100644 --- a/specification/v1_0/docs/a2ui_protocol.md +++ b/specification/v1_0/docs/a2ui_protocol.md @@ -4,7 +4,7 @@
A2UI Protocol Logo -

A2UI (Agent to UI) Protocol v1.0

+

A2UI Protocol v1.0

diff --git a/specification/v1_0/json/client_to_server.json b/specification/v1_0/json/client_to_server.json index 1d03edfef1..1213d303f1 100644 --- a/specification/v1_0/json/client_to_server.json +++ b/specification/v1_0/json/client_to_server.json @@ -1,7 +1,7 @@ { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://a2ui.org/specification/v1_0/client_to_server.json", - "title": "A2UI (Agent to UI) Client-to-Server Event Schema", + "title": "A2UI Client-to-Server Event Schema", "description": "Describes a JSON payload for a client-to-server event message.", "type": "object", "minProperties": 2, diff --git a/specification/v1_0/json/server_to_client.json b/specification/v1_0/json/server_to_client.json index 7ecc8cdca2..530c235c7e 100644 --- a/specification/v1_0/json/server_to_client.json +++ b/specification/v1_0/json/server_to_client.json @@ -2,7 +2,7 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://a2ui.org/specification/v1_0/server_to_client.json", "title": "A2UI Message Schema", - "description": "Describes a JSON payload for an A2UI (Agent to UI) message, which is used to dynamically construct and update user interfaces.", + "description": "Describes a JSON payload for an A2UI message, which is used to dynamically construct and update user interfaces.", "type": "object", "oneOf": [ {"$ref": "#/$defs/CreateSurfaceMessage"},