BuilderIO · kapunahelewong · Aug 11, 2026 · Aug 5, 2026 · Aug 5, 2026 · Aug 6, 2026
diff --git a/.changeset/rewrite-key-concepts-doc.md b/.changeset/rewrite-key-concepts-doc.md
@@ -0,0 +1,5 @@
+---
+"@agent-native/core": patch
+---
+
+Rework the Key Concepts doc for clarity: reordered "What Agent Native includes" into a table right after the five rules, removed em dashes and rhetorical questions throughout, added missing context around the SQL stores and action examples, and translated into all 10 locales.
diff --git a/packages/core/docs/content/key-concepts.mdx b/packages/core/docs/content/key-concepts.mdx
diff --git a/packages/core/docs/content/locales/ar-SA/key-concepts.mdx b/packages/core/docs/content/locales/ar-SA/key-concepts.mdx
diff --git a/packages/core/docs/content/locales/de-DE/key-concepts.mdx b/packages/core/docs/content/locales/de-DE/key-concepts.mdx
diff --git a/packages/core/docs/content/locales/es-ES/key-concepts.mdx b/packages/core/docs/content/locales/es-ES/key-concepts.mdx
diff --git a/packages/core/docs/content/locales/fr-FR/key-concepts.mdx b/packages/core/docs/content/locales/fr-FR/key-concepts.mdx
diff --git a/packages/core/docs/content/locales/hi-IN/agent-surfaces.mdx b/packages/core/docs/content/locales/hi-IN/agent-surfaces.mdx
@@ -1,10 +1,10 @@
 ---
-title: "Agent Surfaces"
+title: "एजेंट Surfaces"
 description: "चुनें कि एक एजेंटिक ऐप चैट से इनलाइन UI, टिकाऊ ऐप पेज, एम्बेडेड साइडकार, ऑटोमेशन और बाहरी एजेंट एक्सेस तक कैसे बढ़ता है।"
 search: "agentic app rich chat native chat UI full app automation headless BYO agent runtime AgentChatRuntime embed actions MCP A2A HTTP CLI"
 ---
 
-# Agent Surfaces
+# एजेंट Surfaces
 
 एक **surface** वह तरीका है जिससे उपयोगकर्ता (या अन्य सिस्टम) आपके ऐप के साथ इंटरैक्ट करते हैं: एक चैट विंडो, एक डैशबोर्ड पेज, एक बैकग्राउंड जॉब, किसी अन्य एजेंट से एक API कॉल। Agent-Native आपको इन्हें बिना अपनी मूल लॉजिक को फिर से बनाए मिक्स और मैच करने देता है, क्योंकि हर surface एक ही अंतर्निहित actions चलाता है। यदि आप Agent-Native में नए हैं, तो पहले [Key Concepts](/docs/key-concepts) पढ़ें।
 

diff --git a/packages/core/docs/content/locales/hi-IN/key-concepts.mdx b/packages/core/docs/content/locales/hi-IN/key-concepts.mdx
diff --git a/packages/core/docs/content/locales/ja-JP/key-concepts.mdx b/packages/core/docs/content/locales/ja-JP/key-concepts.mdx
diff --git a/packages/core/docs/content/locales/ko-KR/key-concepts.mdx b/packages/core/docs/content/locales/ko-KR/key-concepts.mdx
diff --git a/packages/core/docs/content/locales/pt-BR/key-concepts.mdx b/packages/core/docs/content/locales/pt-BR/key-concepts.mdx
diff --git a/packages/core/docs/content/locales/zh-CN/key-concepts.mdx b/packages/core/docs/content/locales/zh-CN/key-concepts.mdx
diff --git a/packages/core/docs/content/locales/zh-TW/key-concepts.mdx b/packages/core/docs/content/locales/zh-TW/key-concepts.mdx