From ab1d9b489769fff911a4f604c5c4c742f1f339a4 Mon Sep 17 00:00:00 2001 From: Brian Love Date: Sun, 7 Jun 2026 18:08:30 -0700 Subject: [PATCH] docs(a2ui): voice pass on guides --- apps/website/content/docs/a2ui/guides/message-protocol.mdx | 2 +- apps/website/content/docs/a2ui/reference/schema.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/apps/website/content/docs/a2ui/guides/message-protocol.mdx b/apps/website/content/docs/a2ui/guides/message-protocol.mdx index 919b3348..f3cfe40b 100644 --- a/apps/website/content/docs/a2ui/guides/message-protocol.mdx +++ b/apps/website/content/docs/a2ui/guides/message-protocol.mdx @@ -106,7 +106,7 @@ A user interacts — clicks the Button — and the client sends an `A2uiActionMe {"version":"v1","action":{"name":"bookingSubmit","surfaceId":"booking","sourceComponentId":"submit","timestamp":"2026-06-05T12:34:56.789Z","context":{"origin":{"literalString":"LAX"},"dest":{"literalString":"JFK"}},"label":"Search flights"}} ``` -Two details worth pinning down, because the inbound and outbound shapes differ: +Two details are worth pinning down, because the inbound and outbound shapes differ: - **Context flips from list to map.** The inbound Button's `action.context` is a *list* of `{ key, value }` entries, where each `value` is still a dynamic value (often a `{ path }`). The outbound message's `action.context` is a *map* keyed by those keys, with each value already a wrapped literal — the path references resolved against the current model and re-wrapped (here `{ path: '/origin' }` became `{ literalString: 'LAX' }`). - **`label` is derived.** It comes from the source component's authored text — for a Button-with-Text-child, the child Text's literal string ("Search flights"). It's optional; the transcript renderer uses it to label the user bubble, and backends may ignore it. diff --git a/apps/website/content/docs/a2ui/reference/schema.mdx b/apps/website/content/docs/a2ui/reference/schema.mdx index 9ddf6ebd..43956460 100644 --- a/apps/website/content/docs/a2ui/reference/schema.mdx +++ b/apps/website/content/docs/a2ui/reference/schema.mdx @@ -1,6 +1,6 @@ # A2UI Schema -The `@threadplane/a2ui` schema is a TypeScript model of the protocol shapes used by the framework. It is useful as a contract for agent output and custom integrations, but it is not a runtime validator. +The `@threadplane/a2ui` schema is a TypeScript model of the protocol shapes the framework uses. It's a contract for agent output and custom integrations, but it's not a runtime validator. ## Dynamic values