Skip to content

docs: update Agent Surfaces doc #2608

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

Open
kapunahelewong wants to merge 3 commits into
base: main
Choose a base branch
from
Open

docs: update Agent Surfaces doc #2608

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
91f63be
docs: update Agent Surfaces doc
kapunahelewong Aug 3, 2026
fca0f3c
update to pass checks
kapunahelewong Aug 3, 2026
0d5cf1a
add translations
kapunahelewong Aug 4, 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
5 changes: 5 additions & 0 deletions .changeset/agent-surfaces.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"@agent-native/core": patch
---

Restructure agent-surfaces doc to match table order, add Native inline UI and Generated inline UI sections
603 changes: 313 additions & 290 deletions packages/core/docs/content/agent-surfaces.mdx
View file
Open in desktop

Large diffs are not rendered by default.

647 changes: 343 additions & 304 deletions packages/core/docs/content/locales/ar-SA/agent-surfaces.mdx
View file
Open in desktop

Large diffs are not rendered by default.

661 changes: 354 additions & 307 deletions packages/core/docs/content/locales/de-DE/agent-surfaces.mdx
View file
Open in desktop

Large diffs are not rendered by default.

653 changes: 350 additions & 303 deletions packages/core/docs/content/locales/es-ES/agent-surfaces.mdx
View file
Open in desktop

Large diffs are not rendered by default.

651 changes: 349 additions & 302 deletions packages/core/docs/content/locales/fr-FR/agent-surfaces.mdx
View file
Open in desktop

Large diffs are not rendered by default.

600 changes: 298 additions & 302 deletions packages/core/docs/content/locales/hi-IN/agent-surfaces.mdx
View file
Open in desktop

Large diffs are not rendered by default.

595 changes: 295 additions & 300 deletions packages/core/docs/content/locales/ja-JP/agent-surfaces.mdx
View file
Open in desktop

Large diffs are not rendered by default.

655 changes: 360 additions & 295 deletions packages/core/docs/content/locales/ko-KR/agent-surfaces.mdx
View file
Open in desktop

Large diffs are not rendered by default.

602 changes: 298 additions & 304 deletions packages/core/docs/content/locales/pt-BR/agent-surfaces.mdx
View file
Open in desktop

Large diffs are not rendered by default.

589 changes: 294 additions & 295 deletions packages/core/docs/content/locales/zh-CN/agent-surfaces.mdx
View file
Open in desktop

Large diffs are not rendered by default.

664 changes: 333 additions & 331 deletions packages/core/docs/content/locales/zh-TW/agent-surfaces.mdx
View file
Open in desktop

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion packages/docs/app/components/docsNavItems.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -43,12 +43,12 @@ const NAV_SECTION_CONFIG: NavSectionConfig[] = [
labelKey: "whatIsAgentNative",
slug: "what-is-agent-native",
},
{ id: "key-concepts", labelKey: "keyConcepts", slug: "key-concepts" },
{
id: "agent-surfaces",
labelKey: "agentSurfaces",
slug: "agent-surfaces",
},
{ id: "key-concepts", labelKey: "keyConcepts", slug: "key-concepts" },
{
id: "cloneable-saas",
labelKey: "templatesOverview",
Expand Down
48 changes: 48 additions & 0 deletions scripts/i18n-localized-docs-baseline.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,11 @@ packages/core/docs/content/locales/ar-SA/template-slides.mdx|"10-slide pitch dec
packages/core/docs/content/locales/ar-SA/toolkit-capability-packages.mdx|Creative Context
packages/core/docs/content/locales/ar-SA/toolkit-context-knowledge.mdx|Context X-Ray
packages/core/docs/content/locales/ar-SA/using-your-agent.mdx|**Shared awareness is two-way.** You and the agent both read and write `application_state`, so "reply to this" or "summarize the selection" just works — and when the agent navigates, the real UI moves with it.
packages/core/docs/content/locales/de-DE/agent-surfaces.mdx|Agent-Native routes
packages/core/docs/content/locales/de-DE/agent-surfaces.mdx|Generative UI
packages/core/docs/content/locales/de-DE/agent-surfaces.mdx|Native Chat UI
packages/core/docs/content/locales/de-DE/agent-surfaces.mdx|route · selection
packages/core/docs/content/locales/de-DE/agent-surfaces.mdx|same actions · same SQL · same agent loop
packages/core/docs/content/locales/de-DE/dispatch.mdx|"summarize last week's signups"
packages/core/docs/content/locales/de-DE/frames.mdx|type: \"code\"
packages/core/docs/content/locales/de-DE/getting-started.mdx|Agent-callable and UI-callable operations
Expand All @@ -52,6 +57,8 @@ packages/core/docs/content/locales/de-DE/template-forms.mdx|"add an NPS question
packages/core/docs/content/locales/de-DE/template-slides.mdx|"10-slide pitch deck"
packages/core/docs/content/locales/de-DE/toolkit-capability-packages.mdx|Creative Context
packages/core/docs/content/locales/de-DE/using-your-agent.mdx|**Shared awareness is two-way.** You and the agent both read and write `application_state`, so "reply to this" or "summarize the selection" just works — and when the agent navigates, the real UI moves with it.
packages/core/docs/content/locales/es-ES/agent-surfaces.mdx|Generative UI
packages/core/docs/content/locales/es-ES/agent-surfaces.mdx|Native Chat UI
packages/core/docs/content/locales/es-ES/dispatch.mdx|"summarize last week's signups"
packages/core/docs/content/locales/es-ES/frames.mdx|type: \"code\"
packages/core/docs/content/locales/es-ES/getting-started.mdx|Hello world
Expand All @@ -72,6 +79,8 @@ packages/core/docs/content/locales/es-ES/template-slides.mdx|"10-slide pitch dec
packages/core/docs/content/locales/es-ES/toolkit-capability-packages.mdx|Creative Context
packages/core/docs/content/locales/es-ES/toolkit-context-knowledge.mdx|Context X-Ray
packages/core/docs/content/locales/es-ES/using-your-agent.mdx|**Shared awareness is two-way.** You and the agent both read and write `application_state`, so "reply to this" or "summarize the selection" just works — and when the agent navigates, the real UI moves with it.
packages/core/docs/content/locales/fr-FR/agent-surfaces.mdx|Generative UI
packages/core/docs/content/locales/fr-FR/agent-surfaces.mdx|Native Chat UI
packages/core/docs/content/locales/fr-FR/dispatch.mdx|"summarize last week's signups"
packages/core/docs/content/locales/fr-FR/frames.mdx|type: \"code\"
packages/core/docs/content/locales/fr-FR/getting-started.mdx|Agent-callable and UI-callable operations
Expand All @@ -98,6 +107,25 @@ packages/core/docs/content/locales/fr-FR/template-slides.mdx|"10-slide pitch dec
packages/core/docs/content/locales/fr-FR/toolkit-capability-packages.mdx|Creative Context
packages/core/docs/content/locales/fr-FR/toolkit-context-knowledge.mdx|Context X-Ray
packages/core/docs/content/locales/fr-FR/using-your-agent.mdx|**Shared awareness is two-way.** You and the agent both read and write `application_state`, so "reply to this" or "summarize the selection" just works — and when the agent navigates, the real UI moves with it.
packages/core/docs/content/locales/hi-IN/agent-surfaces.mdx|A2A Protocol
packages/core/docs/content/locales/hi-IN/agent-surfaces.mdx|Agent-Native routes
packages/core/docs/content/locales/hi-IN/agent-surfaces.mdx|Automation-First Apps
packages/core/docs/content/locales/hi-IN/agent-surfaces.mdx|Calling an action over HTTP
packages/core/docs/content/locales/hi-IN/agent-surfaces.mdx|Context awareness
packages/core/docs/content/locales/hi-IN/agent-surfaces.mdx|Deep links
packages/core/docs/content/locales/hi-IN/agent-surfaces.mdx|External Agents
packages/core/docs/content/locales/hi-IN/agent-surfaces.mdx|Generative UI
packages/core/docs/content/locales/hi-IN/agent-surfaces.mdx|Generative UI and extensions
packages/core/docs/content/locales/hi-IN/agent-surfaces.mdx|How the sidecar bridges to a host app
packages/core/docs/content/locales/hi-IN/agent-surfaces.mdx|Invoke any action by name over HTTP
packages/core/docs/content/locales/hi-IN/agent-surfaces.mdx|Live sync
packages/core/docs/content/locales/hi-IN/agent-surfaces.mdx|Native Chat UI
packages/core/docs/content/locales/hi-IN/agent-surfaces.mdx|Native chat widgets
packages/core/docs/content/locales/hi-IN/agent-surfaces.mdx|One action surface, four product shapes, each adding UI without changing the operation underneath.
packages/core/docs/content/locales/hi-IN/agent-surfaces.mdx|SQL state
packages/core/docs/content/locales/hi-IN/agent-surfaces.mdx|The surface spectrum
packages/core/docs/content/locales/hi-IN/agent-surfaces.mdx|route · selection
packages/core/docs/content/locales/hi-IN/agent-surfaces.mdx|same actions · same SQL · same agent loop
packages/core/docs/content/locales/hi-IN/dispatch.mdx|"summarize last week's signups"
packages/core/docs/content/locales/hi-IN/frames.mdx|type: \"code\"
packages/core/docs/content/locales/hi-IN/getting-started.mdx|Agent-callable and UI-callable operations
Expand All @@ -124,6 +152,8 @@ packages/core/docs/content/locales/hi-IN/template-slides.mdx|"10-slide pitch dec
packages/core/docs/content/locales/hi-IN/toolkit-capability-packages.mdx|Creative Context
packages/core/docs/content/locales/hi-IN/toolkit-context-knowledge.mdx|Context X-Ray
packages/core/docs/content/locales/hi-IN/using-your-agent.mdx|**Shared awareness is two-way.** You and the agent both read and write `application_state`, so "reply to this" or "summarize the selection" just works — and when the agent navigates, the real UI moves with it.
packages/core/docs/content/locales/ja-JP/agent-surfaces.mdx|Generative UI
packages/core/docs/content/locales/ja-JP/agent-surfaces.mdx|Native Chat UI
packages/core/docs/content/locales/ja-JP/dispatch.mdx|"summarize last week's signups"
packages/core/docs/content/locales/ja-JP/frames.mdx|type: \"code\"
packages/core/docs/content/locales/ja-JP/getting-started.mdx|Agent-callable and UI-callable operations
Expand All @@ -150,6 +180,8 @@ packages/core/docs/content/locales/ja-JP/template-slides.mdx|"10-slide pitch dec
packages/core/docs/content/locales/ja-JP/toolkit-capability-packages.mdx|Creative Context
packages/core/docs/content/locales/ja-JP/toolkit-context-knowledge.mdx|Context X-Ray
packages/core/docs/content/locales/ja-JP/using-your-agent.mdx|**Shared awareness is two-way.** You and the agent both read and write `application_state`, so "reply to this" or "summarize the selection" just works — and when the agent navigates, the real UI moves with it.
packages/core/docs/content/locales/ko-KR/agent-surfaces.mdx|Generative UI
packages/core/docs/content/locales/ko-KR/agent-surfaces.mdx|Native Chat UI
packages/core/docs/content/locales/ko-KR/dispatch.mdx|"summarize last week's signups"
packages/core/docs/content/locales/ko-KR/frames.mdx|type: \"code\"
packages/core/docs/content/locales/ko-KR/getting-started.mdx|Agent-callable and UI-callable operations
Expand Down Expand Up @@ -177,6 +209,10 @@ packages/core/docs/content/locales/ko-KR/template-slides.mdx|"10-slide pitch dec
packages/core/docs/content/locales/ko-KR/toolkit-capability-packages.mdx|Creative Context
packages/core/docs/content/locales/ko-KR/toolkit-context-knowledge.mdx|Context X-Ray
packages/core/docs/content/locales/ko-KR/using-your-agent.mdx|**Shared awareness is two-way.** You and the agent both read and write `application_state`, so "reply to this" or "summarize the selection" just works — and when the agent navigates, the real UI moves with it.
packages/core/docs/content/locales/pt-BR/agent-surfaces.mdx|Context awareness
packages/core/docs/content/locales/pt-BR/agent-surfaces.mdx|Deep links
packages/core/docs/content/locales/pt-BR/agent-surfaces.mdx|Generative UI
packages/core/docs/content/locales/pt-BR/agent-surfaces.mdx|Native Chat UI
packages/core/docs/content/locales/pt-BR/dispatch.mdx|"summarize last week's signups"
packages/core/docs/content/locales/pt-BR/frames.mdx|type: \"code\"
packages/core/docs/content/locales/pt-BR/getting-started.mdx|Hello world
Expand All @@ -197,6 +233,12 @@ packages/core/docs/content/locales/pt-BR/template-slides.mdx|"10-slide pitch dec
packages/core/docs/content/locales/pt-BR/toolkit-capability-packages.mdx|Creative Context
packages/core/docs/content/locales/pt-BR/toolkit-context-knowledge.mdx|Context X-Ray
packages/core/docs/content/locales/pt-BR/using-your-agent.mdx|**Shared awareness is two-way.** You and the agent both read and write `application_state`, so "reply to this" or "summarize the selection" just works — and when the agent navigates, the real UI moves with it.
packages/core/docs/content/locales/zh-CN/agent-surfaces.mdx|A2A Protocol
packages/core/docs/content/locales/zh-CN/agent-surfaces.mdx|Automation-First Apps
packages/core/docs/content/locales/zh-CN/agent-surfaces.mdx|External Agents
packages/core/docs/content/locales/zh-CN/agent-surfaces.mdx|Generative UI
packages/core/docs/content/locales/zh-CN/agent-surfaces.mdx|Native Chat UI
packages/core/docs/content/locales/zh-CN/agent-surfaces.mdx|SQL state
packages/core/docs/content/locales/zh-CN/dispatch.mdx|"summarize last week's signups"
packages/core/docs/content/locales/zh-CN/frames.mdx|type: \"code\"
packages/core/docs/content/locales/zh-CN/getting-started.mdx|Agent-callable and UI-callable operations
Expand All @@ -223,6 +265,12 @@ packages/core/docs/content/locales/zh-CN/template-slides.mdx|"10-slide pitch dec
packages/core/docs/content/locales/zh-CN/toolkit-capability-packages.mdx|Creative Context
packages/core/docs/content/locales/zh-CN/toolkit-context-knowledge.mdx|Context X-Ray
packages/core/docs/content/locales/zh-CN/using-your-agent.mdx|**Shared awareness is two-way.** You and the agent both read and write `application_state`, so "reply to this" or "summarize the selection" just works — and when the agent navigates, the real UI moves with it.
packages/core/docs/content/locales/zh-TW/agent-surfaces.mdx|A2A Protocol
packages/core/docs/content/locales/zh-TW/agent-surfaces.mdx|Automation-First Apps
packages/core/docs/content/locales/zh-TW/agent-surfaces.mdx|Context awareness
packages/core/docs/content/locales/zh-TW/agent-surfaces.mdx|External Agents
packages/core/docs/content/locales/zh-TW/agent-surfaces.mdx|Generative UI
packages/core/docs/content/locales/zh-TW/agent-surfaces.mdx|Native Chat UI
packages/core/docs/content/locales/zh-TW/dispatch.mdx|"summarize last week's signups"
packages/core/docs/content/locales/zh-TW/frames.mdx|type: \"code\"
packages/core/docs/content/locales/zh-TW/getting-started.mdx|Agent-callable and UI-callable operations
Expand Down
Loading