@agent-native/core 0.77.3 → 0.77.4

package/corpus/core/docs/content/locales/ar-SA/template-forms.md

@@ -10,7 +10,7 @@ Forms عبارة عن أداة إنشاء نماذج أصلية للوكيل. ق
 ```an-wireframe
 {
   "surface": "desktop",
-  "html": "<div style='display:flex;flex-direction:column;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px;padding:14px 16px;border-bottom:1.4px solid var(--wf-line)'><strong>الاشتراك التجريبي</strong><span class='wf-pill accent'>published</span><div style='flex:1'></div><button>يشارك</button><button class='primary'>إلغاء النشر</button></div><div style='display:flex;gap:8px;padding:12px 16px;border-bottom:1.4px solid var(--wf-line)'><span class='wf-pill accent'>يحرر</span><span class='wf-pill'>النتائج 187</span><span class='wf-pill'>إعدادات</span><span class='wf-pill'>التكامل</span></div><div style='display:flex;flex-direction:column;gap:12px;padding:30px 78px;overflow:hidden'><h2 style='margin:0'>الاشتراك التجريبي</h2><p class='wf-muted' style='margin:0'>Reserve a spot in the upcoming private beta cohort.</p><div class='wf-card'><strong>الاسم الكامل</strong><input value='Ada Lovelace'/></div><div class='wf-card'><strong>البريد الإلكتروني للعمل</strong><input value='you@company.com'/></div><div class='wf-card'><strong>دورك</strong><input value='Select...'/></div><div class='wf-card'><strong>حجم الفريق</strong><input value='Select...'/></div></div></div>"
+  "html": "<div style='display:flex;flex-direction:column;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px;padding:14px 16px;border-bottom:1.4px solid var(--wf-line)'><strong>الاشتراك التجريبي</strong><span class='wf-pill accent'>published</span><div style='flex:1'></div><button>يشارك</button><button class='primary'>إلغاء النشر</button></div><div style='display:flex;gap:8px;padding:12px 16px;border-bottom:1.4px solid var(--wf-line)'><span class='wf-pill accent'>يحرر</span><span class='wf-pill'>النتائج 187</span><span class='wf-pill'>إعدادات</span><span class='wf-pill'>التكامل</span></div><div style='display:flex;flex-direction:column;gap:12px;padding:30px 78px;overflow:hidden'><h2 style='margin:0'>الاشتراك التجريبي</h2><p class='wf-muted' style='margin:0'>احجز مكانًا في مجموعة البيتا الخاصة القادمة.</p><div class='wf-card'><strong>الاسم الكامل</strong><input value='Ada Lovelace'/></div><div class='wf-card'><strong>البريد الإلكتروني للعمل</strong><input value='you@company.com'/></div><div class='wf-card'><strong>دورك</strong><input value='Select...'/></div><div class='wf-card'><strong>حجم الفريق</strong><input value='Select...'/></div></div></div>"
 }
 ```
 
@@ -18,7 +18,7 @@ Forms عبارة عن أداة إنشاء نماذج أصلية للوكيل. ق
 
 ```an-diagram title="بناء ونشر وجمع" summary="يقوم الوكيل والمحرر المرئي بتحرير تعريف نموذج SQL-backed واحد. لم تتم مصادقة صفحة التعبئة العامة، ويتم توجيه عمليات الإرسال من جانب الخادم إلى وجهاتك."
 {
-  "html": "<div class=\"diagram-flow\"><div class=\"diagram-col\"><div class=\"diagram-node\">Agent prompt<br><small class=\"diagram-muted\">\"add an NPS question\"</small></div><div class=\"diagram-node\">Visual editor<br><small class=\"diagram-muted\">labels, validation, order</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">create-form · update-form</span><small class=\"diagram-muted\">fields JSON, settings JSON</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">forms table<br><small class=\"diagram-muted\">SQL via Drizzle</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">Public fill page<br><small class=\"diagram-muted\">unauthenticated</small></div><div class=\"diagram-box\">responses<br><small class=\"diagram-muted\">+ Slack / webhook / Sheets</small></div></div></div>",
+  "html": "<div class=\"diagram-flow\"><div class=\"diagram-col\"><div class=\"diagram-node\">موجه الوكيل<br><small class=\"diagram-muted\">\"add an NPS question\"</small></div><div class=\"diagram-node\">محرر مرئي<br><small class=\"diagram-muted\">التسميات والتحقق والترتيب</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">create-form · update-form</span><small class=\"diagram-muted\">JSON للحقول وJSON للإعدادات</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">forms table<br><small class=\"diagram-muted\">SQL عبر Drizzle</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">صفحة تعبئة عامة<br><small class=\"diagram-muted\">unauthenticated</small></div><div class=\"diagram-box\">responses<br><small class=\"diagram-muted\">+ Slack / webhook / جداول</small></div></div></div>",
   "css": ".diagram-flow{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-flow .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-flow .diagram-arrow{font-size:22px;line-height:1}.diagram-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
 }
 ```
@@ -94,7 +94,7 @@ npx @agent-native/core@latest create my-platform
 
 يتم تعريف الأشكال `fields` و`settings` JSON في `templates/forms/shared/types.ts` (`FormField`، `FormSettings`). تتم إزالة الإعدادات الخاصة بالمالك مثل خطاف الويب التكاملي URL والأصول المسموح بها قبل أن تصل أي بيانات إلى صفحة التعبئة العامة عبر `toPublicFormSettings`.
 
-```an-schema title="Forms data model" summary="Three tables. Fields and integrations are JSON columns on forms, so the agent's edits are surgical patches rather than cross-table row changes."
+```an-schema title="نموذج بيانات النماذج" summary="ثلاث جداول. الحقول وعمليات التكامل عبارة عن أعمدة JSON في النماذج، لذا فإن تعديلات الوكيل عبارة عن تصحيحات جراحية بدلاً من تغييرات الصفوف عبر الجدول."
 {
   "entities": [
     {
@@ -106,9 +106,9 @@ npx @agent-native/core@latest create my-platform
         { "name": "title", "type": "string" },
         { "name": "description", "type": "string", "nullable": true },
         { "name": "slug", "type": "string", "note": "unique; public URL" },
-        { "name": "fields", "type": "json", "note": "FormField[] — all field types" },
-        { "name": "settings", "type": "json", "note": "FormSettings — integrations, etc." },
-        { "name": "status", "type": "enum", "note": "draft | published | closed" },
+        { "name": "fields", "type": "json", "note": "FormField[] — جميع أنواع الحقول" },
+        { "name": "settings", "type": "json", "note": "إعدادات النموذج — عمليات التكامل، وما إلى ذلك." },
+        { "name": "status", "type": "enum", "note": "مسودة | نشرت | مغلق" },
         { "name": "deleted_at", "type": "datetime", "nullable": true, "note": "soft delete" },
         { "name": "owner_email", "type": "string" },
         { "name": "org_id", "type": "id", "nullable": true }
@@ -117,7 +117,7 @@ npx @agent-native/core@latest create my-platform
     {
       "id": "responses",
       "name": "responses",
-      "note": "One submission per row",
+      "note": "إرسال واحد لكل صف",
       "fields": [
         { "name": "id", "type": "id", "pk": true },
         { "name": "form_id", "type": "id", "fk": "forms.id" },
@@ -130,12 +130,12 @@ npx @agent-native/core@latest create my-platform
     {
       "id": "form_shares",
       "name": "form_shares",
-      "note": "Framework shares table — principals to roles per form",
+      "note": "جدول مشاركات إطار العمل — المبادئ الأساسية للأدوار لكل نموذج",
       "fields": [
         { "name": "id", "type": "id", "pk": true },
         { "name": "form_id", "type": "id", "fk": "forms.id" },
         { "name": "principal", "type": "string", "note": "user or org" },
-        { "name": "role", "type": "enum", "note": "viewer | editor | admin" }
+        { "name": "role", "type": "enum", "note": "عارض | محرر | admin" }
       ]
     }
   ],

package/corpus/core/docs/content/locales/ar-SA/template-mail.md

@@ -10,7 +10,7 @@ description: "عميل بريد إلكتروني مدعوم من الوكيل.
 ```an-wireframe
 {
   "surface": "desktop",
-  "html": "<div style='display:flex;flex-direction:column;min-height:500px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:12px;padding:12px 16px;border-bottom:1.4px solid var(--wf-line)'><strong>Inbox 16</strong><div style='flex:1'></div><span data-icon='search' aria-label='Search'></span><span data-icon='edit' aria-label='Compose'></span><span data-icon='bell' aria-label='Notify'></span></div><div style='display:flex;flex-direction:column;padding:8px 14px;gap:6px'><div class='wf-box' style='display:grid;grid-template-columns:155px 1fr auto;gap:12px;align-items:center'><strong>Priya Mehta</strong><span><strong>Q3 launch</strong> — final assets ready for review</span><span>★</span></div><div class='wf-box' style='display:grid;grid-template-columns:155px 1fr auto;gap:12px;align-items:center'><strong>Acme Billing</strong><span>Your monthly invoice is ready</span><span>11:10 AM</span></div><div class='wf-box' style='display:grid;grid-template-columns:155px 1fr auto;gap:12px;align-items:center'><span>Marcus Tang</span><span>Onboarding flow research findings</span><span>Yesterday</span></div><div class='wf-box' style='display:grid;grid-template-columns:155px 1fr auto;gap:12px;align-items:center'><span>GitHub</span><span>[framework] PR ready for review</span><span>Yesterday</span></div><div class='wf-box' style='display:grid;grid-template-columns:155px 1fr auto;gap:12px;align-items:center'><span>Linear</span><span>Issue ENG-1287 assigned to you</span><span>May 2</span></div><div class='wf-box' style='display:grid;grid-template-columns:155px 1fr auto;gap:12px;align-items:center'><span>Stripe</span><span>Weekly payments summary</span><span>Apr 29</span></div><div class='wf-box' style='display:grid;grid-template-columns:155px 1fr auto;gap:12px;align-items:center'><span>Calendly</span><span>New booking confirmed</span><span>Apr 28</span></div></div></div>"
+  "html": "<div style='display:flex;flex-direction:column;min-height:500px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:12px;padding:12px 16px;border-bottom:1.4px solid var(--wf-line)'><strong>صندوق الوارد 16</strong><div style='flex:1'></div><span data-icon='search' aria-label='بحث'></span><span data-icon='edit' aria-label='إنشاء'></span><span data-icon='bell' aria-label='إشعار'></span></div><div style='display:flex;flex-direction:column;padding:8px 14px;gap:6px'><div class='wf-box' style='display:grid;grid-template-columns:155px 1fr auto;gap:12px;align-items:center'><strong>بريا ميهتا</strong><span><strong>إطلاق الربع الثالث</strong> — الأصول النهائية جاهزة للمراجعة</span><span>★</span></div><div class='wf-box' style='display:grid;grid-template-columns:155px 1fr auto;gap:12px;align-items:center'><strong>فوترة Acme</strong><span>فاتورتك الشهرية جاهزة</span><span>11:10 AM</span></div><div class='wf-box' style='display:grid;grid-template-columns:155px 1fr auto;gap:12px;align-items:center'><span>ماركوس تانغ</span><span>مسار الإعداد research findings</span><span>أمس</span></div><div class='wf-box' style='display:grid;grid-template-columns:155px 1fr auto;gap:12px;align-items:center'><span>GitHub</span><span>[framework] PR جاهز للمراجعة</span><span>أمس</span></div><div class='wf-box' style='display:grid;grid-template-columns:155px 1fr auto;gap:12px;align-items:center'><span>Linear</span><span>تم تعيين Issue ENG-1287 لك</span><span>2 مايو</span></div><div class='wf-box' style='display:grid;grid-template-columns:155px 1fr auto;gap:12px;align-items:center'><span>Stripe</span><span>ملخص المدفوعات الأسبوعي</span><span>29 أبريل</span></div><div class='wf-box' style='display:grid;grid-template-columns:155px 1fr auto;gap:12px;align-items:center'><span>Calendly</span><span>تم تأكيد حجز جديد</span><span>28 أبريل</span></div></div></div>"
 }
 ```
 
@@ -156,13 +156,13 @@ npx @agent-native/core@latest add-app
 
 تتخذ رسائل البريد الإلكتروني التي تتدفق عبر API الشكل `{ id, threadId, from, to, cc, subject, snippet, body, date, isRead, isStarred, isArchived, isTrashed, labelIds, accountEmail, attachments }`.
 
-```an-schema title="Mail SQL tables" summary="Email itself lives in Gmail. The SQL tables hold what Gmail doesn't: queued drafts, send-tracking events, and OAuth tokens. Settings and ephemeral state live in the settings and application_state stores."
+```an-schema title="جداول البريد SQL" summary="البريد الإلكتروني نفسه موجود في Gmail. تحتوي جداول SQL على ما لا يحتوي عليه Gmail: المسودات الموضوعة في قائمة الانتظار، وأحداث تتبع الإرسال، والرموز المميزة OAuth. الإعدادات والحالة المؤقتة موجودة في الإعدادات ومتاجر application_state."
 {
   "entities": [
     {
       "id": "queued_email_drafts",
       "name": "queued_email_drafts",
-      "note": "Teammate/Slack-requested drafts awaiting owner review",
+      "note": "مسودات طلبها زميل الفريق/Slack بانتظار مراجعة المالك",
       "fields": [
         { "name": "id", "type": "id", "pk": true },
         { "name": "assignedTo", "type": "string", "note": "org member who reviews/sends" },
@@ -174,7 +174,7 @@ npx @agent-native/core@latest add-app
     {
       "id": "email_tracking",
       "name": "email_tracking",
-      "note": "Open-pixel events for sent messages",
+      "note": "أحداث البكسل المفتوحة للرسائل المرسلة",
       "fields": [
         { "name": "id", "type": "id", "pk": true },
         { "name": "messageId", "type": "string" },
@@ -184,7 +184,7 @@ npx @agent-native/core@latest add-app
     {
       "id": "email_link_tracking",
       "name": "email_link_tracking",
-      "note": "Link-click events for sent messages",
+      "note": "أحداث النقر على الرابط للرسائل المرسلة",
       "fields": [
         { "name": "id", "type": "id", "pk": true },
         { "name": "messageId", "type": "string", "fk": "email_tracking.messageId" },
@@ -195,7 +195,7 @@ npx @agent-native/core@latest add-app
     {
       "id": "oauth_tokens",
       "name": "oauth_tokens",
-      "note": "Framework table — one row per connected Google account",
+      "note": "جدول الإطار — صف واحد لكل حساب Google متصل",
       "fields": [
         { "name": "id", "type": "id", "pk": true },
         { "name": "provider", "type": "string", "note": "\"google\"" },
@@ -228,7 +228,7 @@ npx @agent-native/core@latest add-app
 
 **تغيير UI.** المسارات موجودة في `templates/mail/app/routes/` والمكونات في `templates/mail/app/components/email/` و`templates/mail/app/components/layout/`. يستخدم التطبيق عناصر shadcn/ui الأولية من `app/components/ui/` وأيقونات Tabler - التزم بها.
 
-**تغيير كيفية تصرف الوكيل.** توجد إرشادات الوكيل في `templates/mail/AGENTS.md` وskills في `templates/mail/.agents/skills/` (`email-drafts`، `real-time-sync`، `security`، `self-modifying-code`، وغيرها). يتم تغيير سلوك الوكيل عن طريق تعديل تخفيض السعر - وليس التعليمات البرمجية.
+**تغيير كيفية تصرف الوكيل.** توجد إرشادات الوكيل في `templates/mail/AGENTS.md` وskills في `templates/mail/.agents/skills/` (`email-drafts`، `real-time-sync`، `security`، `self-modifying-code`، وغيرها). يتم تغيير سلوك الوكيل عن طريق تعديل Markdown - وليس التعليمات البرمجية.
 
 **تغيير البيانات أو الإعدادات.** توجد مخططات جداول التتبع والهياكل ذات الصلة في `templates/mail/server/db/`. تمر إعدادات القراءة والكتابة عبر `readSetting` / `writeSetting` من `@agent-native/core/settings`. تستخدم حالة التطبيق (التنقل، والمسودات، والأوامر المفردة) `readAppState` / `writeAppState` من `@agent-native/core/application-state`.
 

package/corpus/core/docs/content/locales/ar-SA/template-plan.md

@@ -396,14 +396,14 @@ pnpm dev
 | `plan_guest_mints` | سجلات الحد الأقصى لإصدار جلسة الضيف                                                                                                                                                          |
 | `plan_assets`      | أصول الصور المضمنة المخزنة كـ base64 (احتياطي عند عدم وجود موفر تحميل)                                                                                                                       |
 
-```an-schema title="Plan data model" summary="One plan row owns ordered sections plus comments, events, versions, shares, and inline assets."
+```an-schema title="نموذج بيانات الخطة" summary="يحتوي صف الخطة الواحد على أقسام مرتبة بالإضافة إلى التعليقات والأحداث والإصدارات والمشاركات والأصول المضمنة."
 {
   "entities": [
     { "id": "plans", "name": "plans", "note": "each plan or recap", "fields": [
       { "name": "id", "type": "text", "pk": true },
       { "name": "title", "type": "text" },
       { "name": "brief", "type": "text", "nullable": true },
-      { "name": "kind", "type": "enum", "note": "plan | recap" },
+      { "name": "kind", "type": "enum", "note": "خطة | خلاصة" },
       { "name": "status", "type": "text" },
       { "name": "source", "type": "text", "nullable": true },
       { "name": "hosted_plan_id", "type": "text", "nullable": true, "note": "hosted_plan_url paired" },
@@ -442,7 +442,7 @@ pnpm dev
     { "id": "plan_shares", "name": "plan_shares", "note": "per-principal grants", "fields": [
       { "name": "id", "type": "text", "pk": true },
       { "name": "plan_id", "type": "text", "fk": "plans.id" },
-      { "name": "role", "type": "enum", "note": "viewer | editor | admin" }
+      { "name": "role", "type": "enum", "note": "عارض | محرر | admin" }
     ] },
     { "id": "plan_guest_mints", "name": "plan_guest_mints", "note": "rate-limit records for guest session issuance", "fields": [
       { "name": "id", "type": "text", "pk": true }

package/corpus/core/docs/content/locales/ar-SA/template-slides.md

@@ -10,7 +10,7 @@ description: "قم بإنشاء تشكيلات من الموجه، وتحرير
 ```an-wireframe
 {
   "surface": "desktop",
-  "html": "<div style='display:flex;flex-direction:column;gap:12px;padding:16px;min-height:530px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>Q3 Board Update</h1><span class='wf-pill accent'>Title slide</span><div style='flex:1'></div><button>Preview</button><button>Present</button><button class='primary'>مشاركة</button></div><main style='display:grid;grid-template-columns:1fr 220px;gap:12px;flex:1;min-height:0'><section class='wf-card' style='display:flex;align-items:center;justify-content:center;text-align:center;padding:36px'><div><strong style='font-size:28px'>Q3 Board Update</strong><br/><small>Maya Chen · CEO</small><div style='height:46px'></div><span class='wf-pill'>Product momentum</span></div></section><section style='display:flex;flex-direction:column;gap:10px'><div class='wf-card'><strong>Slide outline</strong><div class='wf-box'>1 Title</div><div class='wf-box'>2 Agenda</div><div class='wf-box'>3 Metrics</div><div class='wf-box'>4 Shipped</div></div><div class='wf-card' style='flex:1'><strong>Speaker notes</strong><p class='wf-muted' style='margin:8px 0 0'>Open with launch progress and retention story.</p></div></section></main><div style='display:grid;grid-template-columns:repeat(5,1fr);gap:8px'><div class='wf-box'>1 Title</div><div class='wf-box'>2 Agenda</div><div class='wf-box'>3 Metrics</div><div class='wf-box'>4 Shipped</div><div class='wf-box'>5 Risks</div></div></div>"
+  "html": "<div style='display:flex;flex-direction:column;gap:12px;padding:16px;min-height:530px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>تحديث مجلس الإدارة للربع الثالث</h1><span class='wf-pill accent'>شريحة العنوان</span><div style='flex:1'></div><button>Preview</button><button>Present</button><button class='primary'>مشاركة</button></div><main style='display:grid;grid-template-columns:1fr 220px;gap:12px;flex:1;min-height:0'><section class='wf-card' style='display:flex;align-items:center;justify-content:center;text-align:center;padding:36px'><div><strong style='font-size:28px'>تحديث مجلس الإدارة للربع الثالث</strong><br/><small>مايا تشين · CEO</small><div style='height:46px'></div><span class='wf-pill'>زخم المنتج</span></div></section><section style='display:flex;flex-direction:column;gap:10px'><div class='wf-card'><strong>مخطط الشريحة</strong><div class='wf-box'>1 العنوان</div><div class='wf-box'>2 جدول الأعمال</div><div class='wf-box'>3 مقاييس</div><div class='wf-box'>4 تم شحنه</div></div><div class='wf-card' style='flex:1'><strong>ملاحظات المتحدث</strong><p class='wf-muted' style='margin:8px 0 0'>افتح بتقدم الإطلاق وقصة الاحتفاظ.</p></div></section></main><div style='display:grid;grid-template-columns:repeat(5,1fr);gap:8px'><div class='wf-box'>1 العنوان</div><div class='wf-box'>2 جدول الأعمال</div><div class='wf-box'>3 مقاييس</div><div class='wf-box'>4 تم شحنه</div><div class='wf-box'>5 مخاطر</div></div></div>"
 }
 ```
 
@@ -111,7 +111,7 @@ pnpm dev
 
 تعيش جميع بيانات سطح السفينة في SQL عبر Drizzle ORM. المخطط: `templates/slides/server/db/schema.ts`.
 
-```an-schema title="Slides data model" summary="A deck owns its slides as JSON in decks.data; comments, versions, shares, and design systems hang off it."
+```an-schema title="نموذج بيانات الشرائح" summary="A deck owns its slides as JSON in decks.data; comments, versions, shares, and design systems hang off it."
 {
   "entities": [
     {
@@ -132,8 +132,8 @@ pnpm dev
       "fields": [
         { "name": "id", "type": "text", "pk": true },
         { "name": "deck_id", "type": "text", "fk": "decks.id" },
-        { "name": "slide_id", "type": "text", "note": "Slide the comment lives on" },
-        { "name": "thread_id", "type": "text", "note": "Threading" },
+        { "name": "slide_id", "type": "text", "note": "قم بتمرير التعليق مباشرة" },
+        { "name": "thread_id", "type": "text", "note": "خيوط" },
         { "name": "parent_id", "type": "text", "nullable": true },
         { "name": "content", "type": "text" },
         { "name": "quoted_text", "type": "text", "nullable": true },
@@ -145,11 +145,11 @@ pnpm dev
     {
       "id": "deck_versions",
       "name": "deck_versions",
-      "note": "Point-in-time snapshots for restore",
+      "note": "لقطات في وقت محدد للاستعادة",
       "fields": [
         { "name": "deck_id", "type": "text", "fk": "decks.id" },
         { "name": "title", "type": "text" },
-        { "name": "data", "type": "text", "note": "Full deck JSON" },
+        { "name": "data", "type": "text", "note": "المجموعة الكاملة JSON" },
         { "name": "change_label", "type": "text", "nullable": true }
       ]
     },
@@ -167,11 +167,11 @@ pnpm dev
     {
       "id": "deck_share_links",
       "name": "deck_share_links",
-      "note": "Persisted public share-link snapshots",
+      "note": "لقطات ارتباط المشاركة العامة المستمرة",
       "fields": [
         { "name": "token", "type": "text", "pk": true },
         { "name": "title", "type": "text" },
-        { "name": "slides", "type": "text", "note": "JSON slides snapshot" },
+        { "name": "slides", "type": "text", "note": "JSON لقطة سريعة للشرائح" },
         { "name": "aspect_ratio", "type": "text", "nullable": true },
         { "name": "created_at", "type": "text" }
       ]

package/corpus/core/docs/content/locales/ar-SA/template-videos.md

@@ -10,7 +10,7 @@ description: "استديو فيديو برمجي للرسومات المتحرك
 ```an-wireframe
 {
   "surface": "desktop",
-  "html": "<div style='display:flex;flex-direction:column;gap:12px;padding:16px;min-height:530px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>Logo reveal</h1><span class='wf-pill accent'>6 seconds</span><div style='flex:1'></div><button>Preview</button><button class='primary'>Render</button></div><div class='wf-card' style='flex:1;display:flex;align-items:center;justify-content:center;min-height:250px'><div style='text-align:center'><strong>Remotion preview</strong><br/><small class='wf-muted'>logo scales in as the title fades</small></div></div><div class='wf-card' style='display:flex;flex-direction:column;gap:10px'><div style='display:flex;gap:8px;align-items:center'><span class='wf-pill'>0s</span><span class='wf-pill'>2s</span><span class='wf-pill'>4s</span><span class='wf-pill'>6s</span><div style='flex:1'></div><button>New track</button></div><div class='wf-box'>Title fade · 0-48 frames</div><div class='wf-box'>Logo scale · 48-120 frames</div><div class='wf-box'>Camera push · 72-144 frames</div></div></div>"
+  "html": "<div style='display:flex;flex-direction:column;gap:12px;padding:16px;min-height:530px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>إظهار الشعار</h1><span class='wf-pill accent'>6 seconds</span><div style='flex:1'></div><button>Preview</button><button class='primary'>Render</button></div><div class='wf-card' style='flex:1;display:flex;align-items:center;justify-content:center;min-height:250px'><div style='text-align:center'><strong>معاينة Remotion</strong><br/><small class='wf-muted'>logo scales in as the title fades</small></div></div><div class='wf-card' style='display:flex;flex-direction:column;gap:10px'><div style='display:flex;gap:8px;align-items:center'><span class='wf-pill'>0s</span><span class='wf-pill'>2s</span><span class='wf-pill'>4s</span><span class='wf-pill'>6s</span><div style='flex:1'></div><button>مسار جديد</button></div><div class='wf-box'>تلاشي العنوان · الإطارات 0-48</div><div class='wf-box'>تكبير الشعار · الإطارات 48-120</div><div class='wf-box'>دفع الكاميرا · الإطارات 72-144</div></div></div>"
 }
 ```
 
@@ -18,7 +18,7 @@ description: "استديو فيديو برمجي للرسومات المتحرك
 
 ```an-diagram title="الرسوم المتحركة كبيانات" summary="التكوين هو مكون React؛ تتم قراءة كل رسم متحرك من المسار، لذا يقوم الوكيل والمخطط الزمني بتحرير نفس البيانات."
 {
-  "html": "<div class=\"diagram-flow\"><div class=\"diagram-col\"><div class=\"diagram-node\">Timeline<br><small class=\"diagram-muted\">drag, resize, scrub</small></div><div class=\"diagram-node\">Agent<br><small class=\"diagram-muted\">\"fade in at 2s\"</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">AnimationTrack</span><small class=\"diagram-muted\">startFrame / easing / animatedProps</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>React composition<br><small class=\"diagram-muted\">Remotion &lt;Player&gt;</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">MP4 / WebM</div></div>",
+  "html": "<div class=\"diagram-flow\"><div class=\"diagram-col\"><div class=\"diagram-node\">Timeline<br><small class=\"diagram-muted\">سحب، تغيير حجم، تنقل زمني</small></div><div class=\"diagram-node\">Agent<br><small class=\"diagram-muted\">\"fade in at 2s\"</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">AnimationTrack</span><small class=\"diagram-muted\">startFrame / easing / animatedProps</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>تركيب React<br><small class=\"diagram-muted\">Remotion &lt;Player&gt;</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">MP4 / WebM</div></div>",
   "css": ".diagram-flow{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-flow .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}.diagram-flow .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -99,7 +99,7 @@ pnpm dev
 
 مخطط جانب الخادم موجود في `templates/videos/server/db/schema.ts`:
 
-```an-schema title="Video data model" summary="SQL-backed compositions plus design systems and nestable folders, each with a framework shares table."
+```an-schema title="نموذج بيانات الفيديو" summary="SQL المؤلفات المدعومة بالإضافة إلى أنظمة التصميم والمجلدات المتداخلة، كل منها مزود بجدول مشاركات إطار العمل."
 {
   "entities": [
     {
@@ -110,7 +110,7 @@ pnpm dev
         { "name": "id", "type": "text", "pk": true },
         { "name": "title", "type": "text" },
         { "name": "type", "type": "text" },
-        { "name": "data", "type": "text", "note": "Full composition JSON blob" },
+        { "name": "data", "type": "text", "note": "التركيبة الكاملة JSON blob" },
         { "name": "created_at", "type": "text" },
         { "name": "updated_at", "type": "text" }
       ]
@@ -138,7 +138,7 @@ pnpm dev
     {
       "id": "folder_memberships",
       "name": "folder_memberships",
-      "note": "Many-to-many join",
+      "note": "انضمام متعدد إلى متعدد",
       "fields": [
         { "name": "folder_id", "type": "text", "fk": "folders.id" },
         { "name": "composition_id", "type": "text", "fk": "compositions.id" }

package/corpus/core/docs/content/locales/ar-SA/tracking.md

@@ -5,7 +5,7 @@ description: "تحليلات من جانب الخادم مع موفري خدما
 
 # تتبع التحليلات
 
-وظيفة واحدة، وجهات متعددة. اتصل بـ `track()` من أي رمز من جانب الخادم - actions والمكونات الإضافية ومسارات الخادم - ويتم إرسال الحدث إلى كل مزود تحليلات مسجل. لا توجد تبعيات SDK، ولا توجد نصوص برمجية من جانب العميل، ولا يوجد حظر. يتوفر نفس `track()` أيضًا في [browser/app code](#client) ويوجه إلى نفس مقدمي الخدمة.
+وظيفة واحدة، وجهات متعددة. اتصل بـ `track()` من أي رمز من جانب الخادم - actions والمكونات الإضافية ومسارات الخادم - ويتم إرسال الحدث إلى كل مزود تحليلات مسجل. لا توجد تبعيات SDK، ولا توجد نصوص برمجية من جانب العميل, ولا يوجد حظر. يتوفر نفس `track()` أيضًا في [browser/app code](#client) ويوجه إلى نفس مقدمي الخدمة.
 
 هذه هي تحليلات _product_ — تتدفق أحداث تطبيقك إلى PostHog/Mixpanel/Amplitude. للحصول على مقاييس جودة_الوكيل (التتبعات والتكلفة والتقييمات والملاحظات) المخزنة في قاعدة البيانات الخاصة بك، راجع [Observability](/docs/observability).
 
@@ -21,7 +21,7 @@ track(
 
 ```an-diagram title="استدعاء مسار واحد () لكل مزود" summary="يصل المتصلون بالخادم والعميل إلى نفس السجل، مما يؤدي إلى إرسال كل حدث إلى جميع مقدمي الخدمة النشطين بالتوازي."
 {
-  "html": "<div class=\"trk\"><div class=\"diagram-col\"><div class=\"diagram-node\">Server code<br><small class=\"diagram-muted\">actions &middot; plugins &middot; routes</small></div><div class=\"diagram-node\">Browser code<br><small class=\"diagram-muted\">POST /_agent-native/track</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Provider registry</span><small class=\"diagram-muted\">fan-out, fire-and-forget</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">PostHog</div><div class=\"diagram-box\">Mixpanel</div><div class=\"diagram-box\">Amplitude</div><div class=\"diagram-box\">Webhook</div></div></div>",
+  "html": "<div class=\"trk\"><div class=\"diagram-col\"><div class=\"diagram-node\">كود الخادم<br><small class=\"diagram-muted\">actions &middot; plugins &middot; routes</small></div><div class=\"diagram-node\">كود المتصفح<br><small class=\"diagram-muted\">POST /_agent-native/track</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Provider registry</span><small class=\"diagram-muted\">تشعيب، إرسال بلا انتظار</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">PostHog</div><div class=\"diagram-box\">Mixpanel</div><div class=\"diagram-box\">Amplitude</div><div class=\"diagram-box\">Webhook</div></div></div>",
   "css": ".trk{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.trk .diagram-col{display:flex;flex-direction:column;gap:8px}.trk .diagram-arrow{font-size:22px;line-height:1}.trk .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
 }
 ```
@@ -100,13 +100,13 @@ export default defineAction({
 
 ## التتبع من جانب العميل {#client}
 
-يعمل `track()` أيضًا من خلال رمز المتصفح/التطبيق. قم باستيراد توأم العميل من `@agent-native/core/client` وقم بتسميته بنفس الطريقة - فهو ينشر الحدث إلى مسار إطار العمل في `POST /_agent-native/track`، والذي يعيد توجيهه إلى موفري جانب الخادم المسجلين **نفسهم** (PostHog، Mixpanel، Amplitude، webhook). لا يتم شحن أي تحليلات SDK إلى المتصفح ولا يتم الكشف عن مفاتيح الموفر من جانب العميل.
+يعمل `track()` أيضًا من خلال رمز المتصفح/التطبيق. قم باستيراد توأم العميل من `@agent-native/core/client` وقم بتسميته بنفس الطريقة - فهو ينشر الحدث إلى مسار إطار العمل في `POST /_agent-native/track`، والذي يعيد توجيهه إلى موفري جانب الخادم المسجلين **نفسهم** (PostHog، Mixpanel، Amplitude, webhook). لا يتم شحن أي تحليلات SDK إلى المتصفح ولا يتم الكشف عن مفاتيح الموفر من جانب العميل.
 
-```an-api title="The client tracking route"
+```an-api title="مسار تتبع العميل"
 {
   "method": "POST",
   "path": "/_agent-native/track",
-  "summary": "Forward a browser event to the registered server-side providers",
+  "summary": "قم بإعادة توجيه حدث المتصفح إلى موفري الخدمة المسجلين",
   "auth": "Session required + same-origin/CSRF marker (set automatically by the client helper). Not an open analytics relay.",
   "params": [
     { "name": "name", "in": "body", "type": "string", "required": true, "description": "Event name. Capped at 200 characters." },
@@ -130,7 +130,7 @@ track("checkout.completed", { total: 49.99, items: 3 });
 - **أطلق النار وانسى.** لا يؤدي ذلك أبدًا إلى حظر UI، ولا يؤدي مطلقًا إلى رمي أخطاء الشبكة أو ابتلاعها.
 - **تمت المصادقة عليه، للطرف الأول فقط.** يتطلب المسار جلسة وعلامة CSRF من نفس المصدر (يتم تعيينها تلقائيًا بواسطة المساعد)، لذلك لا يمكن استخدامه كترحيل تحليلات مفتوح. يبلغ الحد الأقصى لـ `name` 200 حرف و`properties` يصل إلى 16 كيلو بايت تقريبًا؛ يتم رفض الحمولات كبيرة الحجم أو المشوهة.
 
-يختلف هذا عن القياس عن بعد للمتصفح الداخلي لإطار العمل (`trackEvent()` / مشاهدات الصفحة التلقائية - راجع [Browser defaults](#browser-defaults) أدناه)، والذي يدعم تحليلات المنتج الخاصة بـ Agent Native. استخدم `track()` لأحداث التحليلات الخاصة بتطبيقك والتي يجب أن تصل إلى مقدمي الخدمة الذين تم تكوينهم.
+يختلف هذا عن القياس عن بعد للمتصفح الداخلي لإطار العمل (`trackEvent()` / مشاهدات الصفحة التلقائية - راجع [Browser defaults](#browser-defaults) أدناه), والذي يدعم تحليلات المنتج الخاصة بـ Agent Native. استخدم `track()` لأحداث التحليلات الخاصة بتطبيقك والتي يجب أن تصل إلى مقدمي الخدمة الذين تم تكوينهم.
 
 ## متقدم: الموفرون المخصصون والداخليون {#advanced}
 

package/corpus/core/docs/content/locales/ar-SA/using-your-agent.md

@@ -1,17 +1,17 @@
 ---
 title: "استخدام الوكيل الخاص بك"
-description: "الحلقة اليومية للعمل مع الوكيل: فهو يرى ما تنظر إليه، وتقوم بتوجيهه، وتضمينه، واستخدام UI-light، والمشاركة في التحرير بجانبه."
+description: "الحلقة اليومية للعمل مع الوكيل: فهو يرى ما تنظر إليه، وتقوم بتوجيهه، وتضمينه، واستخدام واجهة خفيفة، والمشاركة في التحرير بجانبه."
 ---
 
 # استخدام الوكيل الخاص بك
 
 الفكرة المحددة وراء Agent-Native هي أن الوكيل وUI **شريكان متساويان** — راجع [What Is Agent-Native?](/docs/what-is-agent-native) لمعرفة السبب. يتناول هذا القسم النصف الآخر من هذا الوعد: ما تشعر به عند العمل فعليًا مع الوكيل بمجرد تثبيته بجوار تطبيقك.
 
-هناك خط اتصال بسيط. يرى الوكيل ما تنظر إليه، وتوجهه نحو ما تريد، ويمكنك **تضمينه** في أي مكان، ويمكنك الانتقال بالكامل **UI-light** عندما يكون ذلك مناسبًا بشكل أفضل، ويمكنك **المشاركة في تحرير** نفس المستندات في نفس الوقت. كل منها عبارة عن صفحة في هذا القسم.
+هناك خط اتصال بسيط. يرى الوكيل ما تنظر إليه، وتوجهه نحو ما تريد، ويمكنك **تضمينه** في أي مكان، ويمكنك الانتقال بالكامل **واجهة خفيفة** عندما يكون ذلك مناسبًا بشكل أفضل، ويمكنك **المشاركة في تحرير** نفس المستندات في نفس الوقت. كل منها عبارة عن صفحة في هذا القسم.
 
 ```an-diagram title="الحلقة اليومية" summary="خمس طرق للعمل مع وكيل مُرسى — كل منها عبارة عن صفحة في هذا القسم."
 {
-  "html": "<div class=\"diagram-loop\"><div class=\"diagram-card\"><strong>Sees</strong><small class=\"diagram-muted\">your view &amp; selection</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>Direct</strong><small class=\"diagram-muted\">@-mentions &amp; voice</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>Embed</strong><small class=\"diagram-muted\">drop into any app</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>UI-light</strong><small class=\"diagram-muted\">chat is the product</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card accent-card\"><span class=\"diagram-pill accent\">Co-edit</span><small class=\"diagram-muted\">live, side by side</small></div></div>",
+  "html": "<div class=\"diagram-loop\"><div class=\"diagram-card\"><strong>Sees</strong><small class=\"diagram-muted\">your view &amp; selection</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>Direct</strong><small class=\"diagram-muted\">@-mentions &amp; voice</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>Embed</strong><small class=\"diagram-muted\">drop into any app</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>واجهة خفيفة</strong><small class=\"diagram-muted\">chat is the product</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card accent-card\"><span class=\"diagram-pill accent\">تحرير مشترك</span><small class=\"diagram-muted\">مباشر، جنبا إلى جنب</small></div></div>",
   "css": ".diagram-loop{display:flex;align-items:stretch;gap:10px;flex-wrap:wrap}.diagram-loop .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;min-width:130px;flex:1}.diagram-loop .diagram-arrow{align-self:center;font-size:22px;line-height:1}"
 }
 ```
@@ -49,7 +49,7 @@ description: "الحلقة اليومية للعمل مع الوكيل: فهو
 ← [**Drop-in Agent**](/docs/drop-in-agent) - قم بتثبيت `<AgentPanel>` و`<AgentSidebar>` و`sendToAgentChat()` في أي تطبيق React.
 ← [**Agent Surfaces**](/docs/agent-surfaces) - اختر ما إذا كان سير العمل يجب أن يكون بدون رأس، أو الدردشة أولاً، أو مضمنًا، أو تطبيقًا كاملاً.
 
-## يمكنك استخدام UI-light {#ui-light}
+## يمكنك استخدام واجهة خفيفة {#ui-light}
 
 لا يحتاج كل تطبيق إلى لوحة تحكم كاملة. عندما يكون الوكيل هو المنتج، يمكنك تخطي معظم UI المخصصة: افتح التطبيق، واطلب ما تريد، واترك الوكيل يقوم بالباقي. لا يزال لدى الوكيل سطح الإدارة الخاص به - السجل ومساحة العمل والإعدادات - ولكن التفاعل الأساسي هو المحادثة وليس النقرات.
 

package/corpus/core/docs/content/locales/ar-SA/voice-input.md

@@ -21,7 +21,7 @@ description: "الإملاء الصوتي في مؤلف دردشة الوكيل
 
 ```an-diagram title="احتياطي مزود النسخ الصوتي" summary="يسجل الملحن الصوت، ثم يرشد موفري الخادم بالترتيب، وينتقل إلى Web Speech API في المتصفح فقط في حالة عدم توفر موفر خادم."
 {
-  "html": "<div class=\"diagram-voice\"><div class=\"diagram-node\">Mic button<br><small class=\"diagram-muted\">records webm/opus</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card col\"><div class=\"diagram-pill accent\">1 &middot; Builder Gemini</div><small class=\"diagram-muted\">default when Builder connected</small><div class=\"diagram-pill\">2 &middot; BYOK cloud</div><small class=\"diagram-muted\">Gemini &middot; Groq &middot; OpenAI Whisper</small></div><div class=\"diagram-arrow diagram-warn\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box diagram-warn\" data-rough>3 &middot; Browser Web Speech<br><small class=\"diagram-muted\">fallback on 400 &middot; streams live</small></div></div>",
+  "html": "<div class=\"diagram-voice\"><div class=\"diagram-node\">زر الميكروفون<br><small class=\"diagram-muted\">يسجل webm/opus</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card col\"><div class=\"diagram-pill accent\">1 &middot; Builder Gemini</div><small class=\"diagram-muted\">الافتراضي عند اتصال Builder</small><div class=\"diagram-pill\">2 &middot; BYOK cloud</div><small class=\"diagram-muted\">Gemini &middot; Groq &middot; OpenAI Whisper</small></div><div class=\"diagram-arrow diagram-warn\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box diagram-warn\" data-rough>3 &middot; Browser Web Speech<br><small class=\"diagram-muted\">fallback on 400 &middot; streams live</small></div></div>",
   "css": ".diagram-voice{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-voice .col{display:flex;flex-direction:column;gap:6px;padding:14px}.diagram-voice .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -43,17 +43,17 @@ Builder هو المسار الأسهل: قم بتوصيل Builder.io من الإ
 ```an-callout
 {
   "tone": "info",
-  "body": "**Credential resolution order:** the route checks the user's own encrypted secret first, then the shared deployment key. A power user with their own key always overrides the shared one. If neither exists, the route returns a 400 the composer recognizes and silently falls back to browser Web Speech."
+  "body": "**ترتيب تحليل بيانات الاعتماد:** يتحقق المسار من السر المشفر الخاص بالمستخدم أولاً، ثم مفتاح النشر المشترك. دائمًا ما يتجاوز المستخدم القوي الذي لديه مفتاحه الخاص المفتاح المشترك. إذا لم يكن أي منهما موجودًا، فسيرجع المسار الرقم 400 الذي يتعرف عليه الملحن ويعود بصمت إلى المتصفح Web Speech."
 }
 ```
 
 ## الطريق {#route}
 
-```an-api title="Voice transcription route"
+```an-api title="مسار النسخ الصوتي"
 {
   "method": "POST",
   "path": "/_agent-native/transcribe-voice",
-  "summary": "Transcribe a recorded audio clip into prompt text",
+  "summary": "قم بنسخ مقطع صوتي مسجل إلى نص سريع",
   "auth": "Active session (Better Auth cookie). Same-origin only.",
   "description": "The composer POSTs the recorded clip here; the route resolves a provider and returns the transcribed text. You should not call this directly.",
   "params": [

package/corpus/core/docs/content/locales/ar-SA/what-is-agent-native.md

@@ -52,7 +52,7 @@ Agent-native هو وسيلة لبناء البرامج حيث يكون وكيل
 
 ```an-diagram title="مبدأ السلم" summary="تتوقف معظم الفرق عند الدرجة 1 أو 2. ويتم تحديد Agent-native في الدرجة 3 — وهو تطبيق حقيقي ووكيل حقيقي على سطح عمل مشترك واحد."
 {
-  "html": "<div class=\"diagram-ladder\"><div class=\"diagram-card rung rung-3\"><span class=\"diagram-pill accent\">Rung 3 · agent-native</span><strong>Agent + UI as equal partners</strong><small class=\"diagram-muted\">One action surface. Every agent tool is also a button; every button runs the same logic the agent uses.</small></div><div class=\"diagram-card rung rung-2\"><span class=\"diagram-pill\">Rung 2</span><strong>A chat with tools</strong><small class=\"diagram-muted\">The agent can act — but it is still just a chat window. No dashboards, lists, or shortcuts.</small></div><div class=\"diagram-card rung rung-1\"><span class=\"diagram-pill warn\">Rung 1</span><strong>A single LLM call</strong><small class=\"diagram-muted\">Prompt in, string out. Impressive in a demo; breaks the moment reality gets messy.</small></div></div>",
+  "html": "<div class=\"diagram-ladder\"><div class=\"diagram-card rung rung-3\"><span class=\"diagram-pill accent\">الدرجة 3 · agent-native</span><strong>الوكيل + الواجهة كشريكين متساويين</strong><small class=\"diagram-muted\">One action surface. Every agent tool is also a button; every button runs the same logic the agent uses.</small></div><div class=\"diagram-card rung rung-2\"><span class=\"diagram-pill\">الدرجة 2</span><strong>دردشة مع أدوات</strong><small class=\"diagram-muted\">يمكن للوكيل التصرف — لكنه لا يزال مجرد نافذة دردشة. لا توجد لوحات معلومات أو قوائم أو اختصارات.</small></div><div class=\"diagram-card rung rung-1\"><span class=\"diagram-pill warn\">الدرجة 1</span><strong>استدعاء LLM واحد</strong><small class=\"diagram-muted\">Prompt in, string out. Impressive in a demo; breaks the moment reality gets messy.</small></div></div>",
   "css": ".diagram-ladder{display:flex;flex-direction:column;gap:14px}.diagram-ladder .rung{display:flex;flex-direction:column;gap:6px;padding:16px 18px}.diagram-ladder .rung-2{margin-inline-end:48px}.diagram-ladder .rung-1{margin-inline-end:96px}"
 }
 ```
@@ -91,7 +91,7 @@ Agent-native هو وسيلة لبناء البرامج حيث يكون وكيل
 
 ```an-diagram title="نظام واحد، طريقتان للدخول" summary="يكتب الوكيل وواجهة المستخدم نفس الإجراءات ونفس قاعدة البيانات. مهما فعل أحدهما يرى الآخر."
 {
-  "html": "<div class=\"diagram-parity\"><div class=\"diagram-col\"><div class=\"diagram-node\">Human<br><small class=\"diagram-muted\">clicks, forms, shortcuts</small></div><div class=\"diagram-node\">Agent<br><small class=\"diagram-muted\">natural language · A2A · Slack</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Actions</span><small class=\"diagram-muted\">defined once</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">قاعدة بيانات SQL</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-box\">UI updates live</div></div>",
+  "html": "<div class=\"diagram-parity\"><div class=\"diagram-col\"><div class=\"diagram-node\">Human<br><small class=\"diagram-muted\">نقرات، نماذج، اختصارات</small></div><div class=\"diagram-node\">Agent<br><small class=\"diagram-muted\">لغة طبيعية · A2A · Slack</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Actions</span><small class=\"diagram-muted\">defined once</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">قاعدة بيانات SQL</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-box\">تتحدث الواجهة مباشرة</div></div>",
   "css": ".diagram-parity{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-parity .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-parity .diagram-arrow{font-size:22px;line-height:1}.diagram-parity .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
 }
 ```
@@ -165,9 +165,9 @@ Agent-native هو وسيلة لبناء البرامج حيث يكون وكيل
   "language": "ts",
   "code": "import { defineAction } from \"@agent-native/core/action\";\nimport { z } from \"zod\";\n\nexport default defineAction({\n  description: \"Reply to an email thread\",\n  schema: z.object({ emailId: z.string(), body: z.string() }),\n  run: async ({ emailId, body }) => {\n    // db and schema come from your app's server/db setup\n    await db.insert(schema.replies).values({ emailId, body });\n  },\n});",
   "annotations": [
-    { "lines": "5", "label": "Tool surface", "note": "The `description` is what the agent reads to decide when to call this as a tool." },
+    { "lines": "5", "label": "سطح الأداة", "note": "`description` هو ما يقرأه الوكيل ليقرر متى يتم استدعاء هذا كأداة." },
     { "lines": "6", "label": "عقد typed", "note": "يقوم zod `schema` واحد بالتحقق من الإدخال من **كل** سطح — agent وواجهة المستخدم وHTTP وMCP وA2A." },
-    { "lines": "7-10", "label": "One implementation", "note": "The `run` body is the single source of truth. The UI button and the agent tool both execute exactly this." }
+    { "lines": "7-10", "label": "تنفيذ واحد", "note": "جسد `run` هو المصدر الوحيد للحقيقة. يقوم كل من الزر UI وأداة الوكيل بتنفيذ هذا بالضبط." }
   ]
 }
 ```

package/corpus/core/docs/content/locales/ar-SA/workspace-connections.md

@@ -18,7 +18,7 @@ description: "البيانات الوصفية للموفر المشترك وال
 
 ```an-diagram title="اتصل مرة واحدة، وامنح التطبيقات، وأعد استخدام بيانات الاعتماد" summary="يحتوي الاتصال على بيانات تعريف الموفر (ليست أسرارًا أبدًا) وبيانات الاعتماد التي تشير إلى المخزن. تفتح المنح لكل تطبيق هذه الميزة. تقرأ التطبيقات حالة استعداد واحدة."
 {
-  "html": "<div class=\"diagram-conn\"><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill accent\">Connection</span><div class=\"diagram-box\" data-rough>named provider account<br><small class=\"diagram-muted\">provider, label, status, scopes, config &middot; never stores secret values</small></div><div class=\"diagram-muted\">credentialRef &rarr; pointer to a vault secret</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill\">Grant</span><div class=\"diagram-box\" data-rough>per-app permission<br><small class=\"diagram-muted\">no grant = no credential access</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill ok\">Readiness</span><small class=\"diagram-muted\">what the app sees</small><div class=\"sev-row\"><span class=\"diagram-pill ok\">connected</span><span class=\"diagram-pill warn\">needs_grant</span></div><div class=\"sev-row\"><span class=\"diagram-pill warn\">needs_credentials</span><span class=\"diagram-pill warn\">needs_attention</span></div><div class=\"sev-row\"><span class=\"diagram-pill\">not_configured</span></div></div></div>",
+  "html": "<div class=\"diagram-conn\"><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill accent\">Connection</span><div class=\"diagram-box\" data-rough>named provider account<br><small class=\"diagram-muted\">provider, label, الحالة، النطاقات، الإعدادات &middot; never stores secret values</small></div><div class=\"diagram-muted\">credentialRef &rarr; pointer to a vault secret</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill\">Grant</span><div class=\"diagram-box\" data-rough>per-app permission<br><small class=\"diagram-muted\">no grant = no credential access</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill ok\">Readiness</span><small class=\"diagram-muted\">what the app sees</small><div class=\"sev-row\"><span class=\"diagram-pill ok\">connected</span><span class=\"diagram-pill warn\">needs_grant</span></div><div class=\"sev-row\"><span class=\"diagram-pill warn\">needs_credentials</span><span class=\"diagram-pill warn\">needs_attention</span></div><div class=\"sev-row\"><span class=\"diagram-pill\">not_configured</span></div></div></div>",
   "css": ".diagram-conn{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-conn .col{display:flex;flex-direction:column;gap:8px;padding:14px;min-width:220px}.diagram-conn .diagram-arrow{font-size:22px;line-height:1}.diagram-conn .sev-row{display:flex;gap:8px;flex-wrap:wrap}"
 }
 ```
@@ -58,32 +58,32 @@ await upsertWorkspaceConnectionGrant({
 });
 ```
 
-```an-schema title="The connection model" summary="A connection records safe provider metadata and credentialRefs (pointers, not secrets). Each grant unlocks one app — one connection, many grants."
+```an-schema title="نموذج الاتصال" summary="A connection records safe provider metadata and credentialRefs (pointers, not secrets). Each grant unlocks one app — one connection, many grants."
 {
   "entities": [
     {
       "id": "conn",
       "name": "workspace_connections",
-      "note": "Named provider account. Never stores secret values.",
+      "note": "حساب الموفر المسمى. لا تقم أبدًا بتخزين القيم السرية.",
       "fields": [
         { "name": "id", "type": "string", "pk": true, "note": "e.g. acme-slack" },
-        { "name": "provider", "type": "string", "note": "stable provider id, e.g. slack" },
+        { "name": "provider", "type": "string", "note": "معرف الموفر الثابت، على سبيل المثال. الركود" },
         { "name": "label", "type": "string" },
         { "name": "accountId", "type": "string", "nullable": true },
         { "name": "accountLabel", "type": "string", "nullable": true },
         { "name": "status", "type": "string", "note": "e.g. connected" },
         { "name": "scopes", "type": "string[]", "nullable": true },
-        { "name": "config", "type": "json", "nullable": true, "note": "safe, non-secret config" },
+        { "name": "config", "type": "json", "nullable": true, "note": "تكوين آمن وغير سري" },
         { "name": "credentialRefs", "type": "json", "nullable": true, "note": "pointers to vault keys, e.g. { key, scope }" }
       ]
     },
     {
       "id": "grant",
       "name": "workspace_connection_grants",
-      "note": "Per-app permission to use a connection.",
+      "note": "إذن لكل تطبيق لاستخدام الاتصال.",
       "fields": [
         { "name": "connectionId", "type": "string", "fk": "conn.id" },
-        { "name": "appId", "type": "string", "note": "e.g. brain, analytics" }
+        { "name": "appId", "type": "string", "note": "على سبيل المثال. الدماغ والتحليلات" }
       ]
     }
   ],
@@ -208,7 +208,7 @@ const brainCatalog = await listWorkspaceConnectionProviderCatalogForApp({
 
 ```an-diagram title="مخزن الاتصال مقابل المخزن" summary="يمتلك القبو القيمة السرية. يمتلك الاتصال بيانات تعريف الموفر بالإضافة إلى بيانات الاعتماد (المؤشرات). في وقت التنفيذ، يقوم التطبيق بحل المرجع من خلال اتصال ممنوح ويقرأ القيمة من المخزن."
 {
-  "html": "<div class=\"diagram-vault\"><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill accent\">Connection store</span><div class=\"diagram-box\" data-rough>provider account + metadata<br><small class=\"diagram-muted\">status, scopes, config</small></div><div class=\"diagram-box\" data-rough>credentialRef<br><small class=\"diagram-muted\">{ key: SLACK_BOT_TOKEN, scope: org }</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">App action</span><small class=\"diagram-muted\">resolves at execution time through a granted ref</small><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill ok\">Vault</span><div class=\"diagram-box\" data-rough>secret value<br><small class=\"diagram-muted\">never returned to the agent or UI</small></div></div></div>",
+  "html": "<div class=\"diagram-vault\"><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill accent\">مخزن الاتصالات</span><div class=\"diagram-box\" data-rough>provider account + metadata<br><small class=\"diagram-muted\">الحالة، النطاقات، الإعدادات</small></div><div class=\"diagram-box\" data-rough>credentialRef<br><small class=\"diagram-muted\">{ key: SLACK_BOT_TOKEN, scope: org }</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">إجراء التطبيق</span><small class=\"diagram-muted\">resolves at execution time through a granted ref</small><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill ok\">Vault</span><div class=\"diagram-box\" data-rough>secret value<br><small class=\"diagram-muted\">لا تعاد أبدا إلى الوكيل أو الواجهة</small></div></div></div>",
   "css": ".diagram-vault{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-vault .col{display:flex;flex-direction:column;gap:8px;padding:14px;min-width:220px}.diagram-vault .diagram-card{display:flex;flex-direction:column;gap:6px;padding:12px 14px}.diagram-vault .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```