@agent-native/core 0.84.35 → 0.84.37

package/corpus/core/docs/content/locales/ar-SA/faq.mdx

@@ -11,15 +11,15 @@ description: "الأسئلة الشائعة حول Agent-Native - ما هو، و
 
 ### ما هو الوكيل الأصلي؟ {#what-is-agent-native}
 
-Agent-native هو إطار عمل لبناء التطبيقات حيث يكون وكيل الذكاء الاصطناعي وسطح المنتج المحيط به شريكين متساويين. يمكن أن يبدأ هذا السطح كعميل بلا رأس بإجراء مخصص واحد، أو ينمو ليصبح دردشة غنية، أو يصبح UI كاملاً. الثابت هو أن الوكلاء والبشر يتشاركون نفس actions وقاعدة البيانات والحالة. راجع [What Is Agent-Native?](/docs/what-is-agent-native) للحصول على الشرح الكامل.
+Agent-native هو framework لبناء التطبيقات حيث يكون AI agent وسطح المنتج المحيط به شريكين متساويين. يبدأ المسار المعتاد بالدردشة، ثم يضيف typed actions، ويعرض نتائج منظمة inline، ثم ينمو إلى صفحات دائمة فوق نفس SQL state. الثابت هو أن agents والبشر يتشاركون نفس actions وقاعدة البيانات والحالة. راجع [What Is Agent-Native?](/docs/what-is-agent-native) للحصول على الشرح الكامل.
 
 ### لمن هذا؟ {#who-is-this-for}
 
 Agent-native مخصص للأشخاص الذين يريدون تطبيقًا حقيقيًا ووكيل AI للعمل من نفس البيانات وactions. المسارات الشائعة هي:
 
 - **استخدم تطبيقًا مستضافًا** إذا كنت تريد البريد أو التقويم أو النماذج أو الخطة أو أي قالب نهائي آخر بدون إعداد - ابدأ من [template gallery](/templates).
-- **ابدأ بالدردشة** إذا كنت تريد تطبيقًا أساسيًا يمكن للمستخدمين التحدث إليه على الفور، ثم قم بتوسيع نطاقه إلى actions والشاشات - ابدأ بـ [Getting Started](/docs/getting-started) أو [Chat](/docs/template-chat).
-- **ابدأ بـ primitive-first** إذا كنت تريد إجراءً واحدًا وحلقة وكيل تطبيق بدون رأس قبل الالتزام بـ UI - ابدأ بـ [Getting Started](/docs/getting-started).
+- **ابدأ بالدردشة** إذا كنت تريد المسار الافتراضي من الصفر: يتحدث المستخدمون مع agent فورًا، ثم توسع التطبيق باستخدام actions ونتائج أصلية وشاشات - ابدأ بـ [Getting Started](/docs/getting-started) أو [Chat](/docs/template-chat).
+- **ابدأ بـ automation-first** إذا كنت تبني مهام مجدولة أو queues أو scripts أو integration workers أو workflows لوكلاء خارجيين بدون UI في المتصفح بعد - ابدأ بـ [Automation-First Apps](/docs/pure-agent-apps).
 - **تفرع القالب وتخصيصه** إذا كنت تريد توصيل منتج SaaS الخاص بك بالمصادقة وقاعدة البيانات وUI والوكيل actions بالفعل - راجع [Templates](/docs/cloneable-saas).
 - **الإنشاء من الصفر** إذا كنت تريد أساسيات إطار العمل لمنتج جديد يستند إلى الوكيل - فابدأ بـ [Getting Started](/docs/getting-started).
 - **قم بتوصيل وكيل آخر أو أداة تعليمات برمجية أخرى** إذا كنت تريد أن يستخدم Claude أو ChatGPT أو Codex أو Cursor أو GitHub Copilot / VS Code تطبيقًا أصليًا للوكيل - راجع [External Agents](/docs/external-agents) و[Skills Guide](/docs/skills-guide).
@@ -130,7 +130,7 @@ Anthropic Claude وOpenAI (عائلة GPT-5) وGoogle Gemini وأي مزود ي
 
 ### هل يمكنني إنشاء شيء لا تغطيه النماذج؟ {#build-from-scratch}
 
-نعم. إذا كنت تريد تطبيقًا أساسيًا للدردشة، فقم بتشغيل `npx @agent-native/core@latest create my-chat-app --template chat`؛ يمكنك الحصول على سلاسل محادثات متينة، وactions، والمصادقة، وحالة وقت التشغيل المدعومة بـ SQL، ومساحة لإضافة شاشاتك الخاصة. إذا كنت تريد أصغر تطبيق للإجراء أولاً بدون UI، فقم بتشغيل `npx @agent-native/core@latest create my-agent --headless`. راجع [Getting Started](/docs/getting-started)، و[Pure-Agent Apps](/docs/pure-agent-apps)، و[Chat](/docs/template-chat).
+نعم. إذا كنت تريد agentic app أساسيًا، فقم بتشغيل `npx @agent-native/core@latest create my-chat-app --template chat`؛ تحصل على chat threads متينة وactions ومصادقة وحالة وقت تشغيل مدعومة بـ SQL وعرض native inline ومساحة لإضافة شاشاتك الخاصة. إذا كنت تبني automation بلا متصفح، فقم بتشغيل `npx @agent-native/core@latest create my-agent --headless`. راجع [Getting Started](/docs/getting-started)، و[Automation-First Apps](/docs/pure-agent-apps)، و[Chat](/docs/template-chat).
 
 ### هل يمكنني تجربته بدون تفرع القالب؟ {#try-with-a-skill}
 

package/corpus/core/docs/content/locales/ar-SA/getting-started.mdx

@@ -1,259 +1,193 @@
 ---
 title: "الخطوات الأولى"
-description: "قم بإنشاء تطبيق وكيل، وافهم التعليمات، وskills، وactions، ثم شاهد الوكيل وهو يستدعي الإجراء الأول."
+description: "أنشئ agentic app تبدأ بالدردشة، أضف action، اعرض النتائج المنظمة داخل الدردشة، ثم وسعها إلى صفحة دائمة يستطيع agent فتحها."
 ---
 
-# البدء
-
-توفر تطبيقات Agent-Native لوكيل الذكاء الاصطناعي وUI نفس actions والبيانات
-الحالة. يتم إنشاء الوكيل الأساسي من التعليمات التي ترشده، skills التي تعلم
-السلوك القابل للتكرار، وactions الذي يتيح له القيام بعمل حقيقي.
-
-**هل تريد تطبيقًا كاملاً للبدء منه؟** استنساخ أحد نماذجنا الغنية —
-[Chat](/docs/template-chat), [Mail](/docs/template-mail),
-[Calendar](/docs/template-calendar), [Content](/docs/template-content),
-[Analytics](/docs/template-analytics)، و[many more](/docs/cloneable-saas) —
-كل تطبيق كامل المواصفات تقوم بتخصيصه.
-
-هل تريد البناء من الصفر؟ الخيار الوحيد أمامك هو ما إذا كنت تريد UI —
-كل شيء بعد (كتابة التعليمات، إضافة skills، تعريف actions، التشغيل
-الوكيل) هو نفسه في كلتا الحالتين.
-
-<FileTree
-  id="doc-block-x4p7u4"
-  title={"agent أساسي من Agent-Native"}
-  entries={[
-    {
-      path: "AGENTS.md",
-      note: "تعليمات دائمة: الهدف، القواعد، النبرة، وخريطة ما يستطيع agent فعله",
-    },
-    {
-      path: ".agents/skills/customer-research/SKILL.md",
-      note: "playbook قابل لإعادة الاستخدام يحمّله agent عندما تطابق المهمة",
-    },
-    {
-      path: "actions/summarize-week.ts",
-      note: "code typed يمكن لل agent و UI و CLI و HTTP و MCP و A2A و jobs و webhooks تشغيله",
-    },
-  ]}
-/>
-
-هذا صحيح سواء بدأت بالدردشة UI، أو وكيل بلا رأس، أو تطبيق كامل.
-يغير UI السطح؛ التعليمات، skills، وactions تعطي الوكيل
-التوجيه والسلوك.
-
-## 1. أنشئ تطبيقك
-
-ستحتاج إلى [Node.js 22+](https://nodejs.org) و[pnpm](https://pnpm.io).
-
-قم بتشغيل `create` بدون أي علامات وسيسألك عن الطريقة التي تريد البدء بها (قالب كامل،
-الدردشة أو مقطوعة الرأس) قبل أي شيء آخر:
+# الخطوات الأولى
 
-```bash
-npx @agent-native/core@latest create my-app
-```
+Agent-Native مخصص لبناء agentic applications: يشترك AI agent وواجهة UI في نفس [actions](/docs/actions) وبيانات SQL و application state. المسار الأساسي يبدأ من Chat app كي يستطيع المستخدمون التحدث مع agent فورًا، ثم يضيف أسطح التطبيق التي يحتاجها سير العمل.
+
+المسار المفيد:
+
+1. إنشاء Chat app.
+2. إضافة action.
+3. عرض نتيجة action داخل الدردشة كواجهة أصلية.
+4. حفظ البيانات في SQL.
+5. إضافة صفحة يستطيع agent فتحها عندما يكون الفحص البصري أنسب.
 
-أو قم بتمرير علامة لتخطي المطالبة:
+## 1. أنشئ Chat app {#create-your-app}
 
-**هل تريد UI؟** ابدأ من قالب الدردشة. تحصل على وكيل عامل بالإضافة إلى
-دردشة قابلة للتخصيص UI، وكل إجراء تضيفه يظهر فيها تلقائيًا:
+تحتاج إلى [Node.js 22+](https://nodejs.org) و[pnpm](https://pnpm.io).
 
 ```bash
 npx @agent-native/core@latest create my-app --template chat
+cd my-app
+pnpm install
+pnpm dev
 ```
 
-**فقط البدائي بلا رأس؟** ابدأ بلا رأس — نفس actions والوكيل
-حلقة، بدون غلاف UI:
-
-```bash
-npx @agent-native/core@latest create my-agent --headless
+يتضمن القالب durable chat threads و auth و live sync ومجلد `actions/` و actions القياسية `view-screen` و `navigate` وتطبيق React يمكن توسيعه.
+
+## 2. أضف action {#add-an-action}
+
+Action هي عملية typed operation مشتركة بين agent و UI. في هذا المسار أنشئ `actions/analyze-responses.ts`: تحلل ردود النماذج وتعيد شكلاً موثقًا لرسم مخصص داخل الدردشة.
+
+<!-- prettier-ignore -->
+```ts
+// actions/analyze-responses.ts
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+const responseChartResultSchema = z.object({
+  title: z.string(),
+  points: z.array(z.object({ day: z.string(), responses: z.number() })),
+});
+
+export default defineAction({
+  description: "Analyze recent form responses and render a custom chart.",
+  schema: z.object({ 
+    formId: z.string().default("demo") 
+  }),
+  outputSchema: responseChartResultSchema,
+  chatUI: { 
+    renderer: "responses.response-chart", 
+    title: "مخطط الردود" 
+  },
+  readOnly: true,
+  run: async ({ formId }) => ({
+    title: `Responses for ${formId}`,
+    points: [{ day: "Mon", responses: 12 }, { day: "Tue", responses: 18 }, { day: "Wed", responses: 24 }, { day: "Thu", responses: 21 }],
+  }),
+});
 ```
 
-ثم قم بالتثبيت من المجلد الذي قمت بإنشائه:
+شغلها مباشرة:
 
 ```bash
-cd my-agent # أو تطبيقي إذا اخترت قالب الدردشة
-pnpm install
+pnpm action analyze-responses --formId demo
 ```
 
-من الآن فصاعدًا، أصبح الاثنان متطابقين.
-
-## 2. أضف إجراءً
-
-الإجراء هو عملية واحدة يمكن لوكيلك — وUI — الاتصال بها. كلا السقالات
-اشحن بهذا المثال:
-
-<AnnotatedCode
-  id="doc-block-pxjqe1"
-  title={"أول action لك"}
-  filename="actions/hello.ts"
-  language="ts"
-  code={
-    'import { defineAction } from "@agent-native/core/action";\nimport { z } from "zod";\n\nexport default defineAction({\n  description: "قل مرحبًا من الوكيل المحلي.",\n  schema: z.object({\n    name: z.string().default("world"),\n  }),\n  http: { method: "GET" },\n  readOnly: true,\n  run: async ({ name }) => {\n    return { message: `Hello, ${name}!` };\n  },\n});'
-  }
-  annotations={[
-    {
-      lines: "5",
-      label: "وصف الأداة",
-      note: "يقرأ الوكيل `description` ليقرر متى يستدعيه كأداة.",
-    },
-    {
-      lines: "6-8",
-      label: "عقد typed",
-      note: "يتحقق zod `schema` واحد من الإدخال من كل سطح: الوكيل، UI، HTTP، MCP وA2A.",
-    },
-    {
-      lines: "9",
-      label: "فعل HTTP",
-      note: "اجعل هذا الإجراء متاحًا كنقطة نهاية HTTP تُركّب تلقائيًا.",
-    },
-    {
-      lines: "10",
-      label: "للقراءة فقط",
-      note: "تشير `readOnly` إلى أن الإجراء آمن للاستدعاء دون موافقة وقابل للتخزين المؤقت للاستعلامات.",
-    },
-    {
-      lines: "11-13",
-      label: "تنفيذ واحد",
-      note: "جسم `run` هو مصدر الحقيقة الوحيد الذي تنفذه كل الواجهات.",
-    },
-  ]}
-/>
-
-استبدل `hello` بالعملية الحقيقية الأولى في مجالك. قمت بتعريفه مرة واحدة؛
-يلتقطه كل سطح.
-
-استخدم `AGENTS.md` للحصول على إرشادات يجب تطبيقها في كل دورة. استخدم مهارة عندما
-إلى سير عمل أو إجراء مجال قابل لإعادة الاستخدام. استخدم الإجراء عندما يكون
-يحتاج الوكيل إلى طريقة مكتوبة وقابلة للاختبار لقراءة البيانات أو كتابتها أو الاتصال بـ API أو
-إجراء الموافقة.
-
-## 3. قم بتشغيله
-
-استدعاء الإجراء مباشرة:
+أو اسأل agent في المتصفح:
 
-```bash
-pnpm action hello --name Steve
-```
+> حلّل الردود الأخيرة لنموذج العرض.
 
-أو اطلب من الوكيل أن يتصل بك:
+## 3. اعرض النتيجة داخل الدردشة {#render-inline}
 
-```bash
-pnpm agent "Call the hello action for Steve and explain what happened."
-```
+لأن action تعلن `outputSchema` و `chatUI.renderer` خاصًا بالمنتج، لا يحول transcript البيانات المنظمة إلى نص عادي. سجّل مكون React لذلك المعرّف نفسه عند بدء التطبيق، مثل استيراد `app/chat-renderers.tsx` مرة واحدة من `app/root.tsx`:
 
-إذا بدأت من قالب الدردشة، فقم بتشغيل التطبيق واستخدم نفس الوكيل في
-المتصفح - يمكنه بالفعل استدعاء كل إجراء تحدده:
+<!-- prettier-ignore -->
+```tsx
+import { registerActionChatRenderer, type ToolRendererProps,} from "@agent-native/core/client/chat";
+
+type ResponseChartResult = {
+  title: string;
+  points: Array<{ day: string; responses: number }>;
+};
+
+function ResponseChart({ context }: ToolRendererProps) {
+  const result = context.resultJson as ResponseChartResult;
+  const max = Math.max(...result.points.map((point) => point.responses), 1);
+  return (
+    <section className="rounded-lg border bg-card p-4">
+      <h3 className="text-sm font-medium">{result.title}</h3>
+      <div className="mt-4 flex h-32 items-end gap-2">
+        {result.points.map((point) => (
+          <div key={point.day} className="flex flex-1 flex-col items-center gap-2">
+            <div className="w-full rounded-t bg-primary" style={{ height: `${(point.responses / max) * 100}%` }} />
+            <span className="text-xs text-muted-foreground">{point.day}</span>
+          </div>
+        ))}
+      </div>
+    </section>
+  );
+}
 
-```bash
-pnpm dev
+registerActionChatRenderer({
+  id: "responses.response-chart",
+  renderer: "responses.response-chart",
+  Component: ResponseChart,
+});
 ```
 
-يمكن الآن الوصول إلى هذا الإجراء الواحد من خلال الدردشة UI، وCLI، وHTTP، وMCP، وA2A،
-المهام المجدولة، وwebhooks. حدد مرة واحدة، اتصل من أي مكان.
-
-<Diagram id="doc-block-xp12gz" title={"إجراء واحد، على كل سطح"} summary={"يتم إرسال ملف defineAction واحد إلى كل مستهلك بدون أي أسلاك إضافية."}>
-
-```html
-<div class="diagram-fan">
-  <div class="diagram-box" data-rough>defineAction</div>
-  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
-  <div class="diagram-surfaces">
-    <span class="diagram-pill">واجهة الدردشة</span
-    ><span class="diagram-pill">CLI</span><span class="diagram-pill">HTTP</span
-    ><span class="diagram-pill">MCP</span><span class="diagram-pill">A2A</span
-    ><span class="diagram-pill">مهام مجدولة</span
-    ><span class="diagram-pill">Webhooks</span>
-  </div>
-</div>
-```
+للمخرجات العامة القابلة لإعادة الاستخدام، يوفّر framework أيضًا renderers مدمجة هي `data-chart` و `data-table`، إضافة إلى `data-insights` لبطاقات تجمع الملخص والرسم والجدول. راجع [Native Chat UI](/docs/native-chat-ui).
 
-```css
-.diagram-fan {
-  display: flex;
-  align-items: center;
-  gap: 14px;
-  flex-wrap: wrap;
-}
-.diagram-fan .diagram-surfaces {
-  display: flex;
-  flex-wrap: wrap;
-  gap: 8px;
-  max-width: 420px;
-}
-.diagram-fan .diagram-arrow {
-  font-size: 22px;
-  line-height: 1;
-}
-```
+<WireframeBlock id="doc-block-inline-result-wireframe-ar">
+  <Screen
+    surface="desktop"
+    html={
+      "<div style='min-height:340px;box-sizing:border-box;padding:24px;display:flex;justify-content:center;align-items:center;background:var(--wf-bg)'><div style='width:min(530px,100%);display:flex;flex-direction:column;gap:14px'><div class='wf-card' data-rough style='align-self:flex-end;max-width:70%;padding:12px 14px'><strong>User</strong><p style='margin:6px 0 0'>حلّل ردود العرض.</p></div><div class='wf-card' data-rough style='align-self:flex-start;width:min(370px,100%);padding:14px'><strong>Agent</strong><p class='wf-muted' style='margin:6px 0 12px'>تم العرض باستخدام responses.response-chart.</p><section class='wf-card' data-rough style='padding:14px'><h3 style='margin:0 0 12px;font-size:14px'>مخطط الردود</h3><div data-rough='line:bottom' style='height:104px;display:flex;align-items:end;gap:8px;border-bottom:1.4px solid var(--wf-line);padding-bottom:4px'><div style='flex:1;display:flex;flex-direction:column;align-items:center;gap:6px'><div data-rough style='height:38px;width:100%;background:color-mix(in srgb, var(--wf-accent) 24%, transparent);border:1.4px solid var(--wf-accent);border-radius:8px 8px 3px 3px'></div><span class='wf-muted'>إث</span></div><div style='flex:1;display:flex;flex-direction:column;align-items:center;gap:6px'><div data-rough style='height:62px;width:100%;background:color-mix(in srgb, var(--wf-accent) 30%, transparent);border:1.4px solid var(--wf-accent);border-radius:8px 8px 3px 3px'></div><span class='wf-muted'>ثل</span></div><div style='flex:1;display:flex;flex-direction:column;align-items:center;gap:6px'><div data-rough style='height:86px;width:100%;background:color-mix(in srgb, var(--wf-accent) 36%, transparent);border:1.4px solid var(--wf-accent);border-radius:8px 8px 3px 3px'></div><span class='wf-muted'>أر</span></div><div style='flex:1;display:flex;flex-direction:column;align-items:center;gap:6px'><div data-rough style='height:54px;width:100%;background:color-mix(in srgb, var(--wf-accent) 42%, transparent);border:1.4px solid var(--wf-accent);border-radius:8px 8px 3px 3px'></div><span class='wf-muted'>خم</span></div></div></section></div></div></div>"
+    }
+  />
+</WireframeBlock>
 
-</Diagram>
+## 4. احفظ البيانات في SQL {#persist-data}
 
-## تم بناء الحالة في
+عندما تحتاج النتيجة إلى المراجعة أو المقارنة أو التحديث، احفظها في SQL واجعل القراءة والكتابة خلف actions:
 
-لا يعني مقطوع الرأس أنه عديم الجنسية. Actions، الجلسات، حالة التطبيق، المواضيع،
-سجل التشغيل وبيانات الاعتماد كلها موجودة في SQL. محليًا، هذا هو SQLite في
-`data/app.db`; in production you set `DATABASE_URL`. See
-[Deployment](/docs/deployment).
+عرّف الجدول باستخدام helpers المحمولة من framework، وليس عبر imports من `drizzle-orm/sqlite-core` أو `drizzle-orm/pg-core`:
 
-<Callout id="doc-block-afa3pw" tone="info">
+```ts
+// server/db/schema.ts
+import { integer, now, table, text } from "@agent-native/core/db/schema";
 
-**لا يزال تطبيق Headless تطبيقًا حقيقيًا.** تستمر حلقة وكيل التطبيق في الجلسات والسلاسل وعمليات التشغيل والإعدادات وبيانات الاعتماد في SQL — وهي ليست مطالبة عديمة الحالة. يمكنك إضافة UI لاحقًا دون لمس أفعالك أو حالتك.
+export const responseInsights = table("response_insights", {
+  id: text("id").primaryKey(),
+  formId: text("form_id").notNull(),
+  title: text("title").notNull(),
+  summary: text("summary").notNull(),
+  responseCount: integer("response_count").notNull(),
+  createdAt: text("created_at").notNull().default(now()),
+  updatedAt: text("updated_at").notNull().default(now()),
+});
+```
 
-</Callout>
+تختار هذه helpers backend SQL المضبوط، لذلك يعمل schema نفسه على SQLite محليًا وفي الإنتاج على Postgres أو Turso/libSQL أو D1 أو أي provider SQL مدعوم.
 
-## تخصيص UI
+- `create-response-insight` يكتب insight جديدًا.
+- `list-response-insights` يقرأ بيانات الصفحة.
+- `update-response-insight` يحدث السجل.
+- `analyze-responses` يستمر في إعادة widget الدردشة الأصلي.
 
-إذا بدأت من قالب الدردشة، فإن UI متاح لك لتحريره. الدردشة نفسها
-هو مسار صغير مبني على مكون `<AgentChatSurface>`:
+لا تنشئ REST route مكررة للمتصفح فقط؛ يجب أن تشترك UI و agent في actions.
 
-```tsx
-// app/routes/_index.tsx
-import { AgentChatSurface } from "@agent-native/core/client";
+## 5. أضف صفحة يستطيع agent فتحها {#add-a-page}
 
-export default function ChatRoute() {
-  return <AgentChatSurface mode="page" className="h-full" />;
-}
-```
+أضف route باسم `/response-insights` واستخدم `useActionQuery("list-response-insights")` و `useActionMutation("create-response-insight")`. هذه الصفحة عرض لحالة SQL؛ وتظل البيانات مكتوبة عبر نفس actions.
 
-- **`app/routes/_index.tsx`** — صفحة الدردشة. تغيير الاقتراحات، فارغ
-  الحالة والتخطيط.
-- **`app/root.tsx`** — غلاف التطبيق. أضف مساراتك وشاشاتك الخاصة حول
-  الوكيل.
-- أسقط الوكيل في أي شاشة باستخدام `<AgentSidebar>`، واعمل عليه يدويًا من
-  مع `sendToAgentChat()`، أو قم بتشغيل الإجراء مباشرة باستخدام
-  `useActionMutation()`.
+<WireframeBlock id="doc-block-response-insights-page-wireframe-ar">
+  <Screen
+    surface="desktop"
+    html={
+      "<main style='min-height:440px;box-sizing:border-box;padding:28px;background:var(--wf-bg)'><section style='max-width:960px;margin:0 auto;display:grid;grid-template-columns:minmax(0,1fr) 260px;gap:16px;align-items:stretch'><section class='wf-card' data-rough style='display:flex;flex-direction:column;gap:16px'><header><h2 style='margin:0 0 4px;font-size:28px'>رؤى الردود</h2><p class='wf-muted' style='margin:0'>رؤى أنشأها الوكيل من ردود النموذج.</p></header><button class='primary' data-rough style='align-self:flex-start'>حلّل نموذج العرض</button><section style='display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:12px'><article class='wf-box' data-rough style='padding:12px'><strong>موضوع التسعير</strong><p class='wf-muted' style='margin:8px 0 0'>المستخدمون يطلبون خطة للفرق.</p></article><article class='wf-box' data-rough style='padding:12px'><strong>تراجع في الإعداد</strong><p class='wf-muted' style='margin:8px 0 0'>تحتاج ثلاث خطوات إلى نص أوضح.</p></article></section><section class='wf-card' data-rough style='display:flex;flex-direction:column;gap:10px'><div class='wf-row wf-box' data-rough style='padding:10px 12px;gap:12px;justify-content:space-between'><strong>نموذج العرض</strong><span class='wf-muted'>تم تحليل 42 ردًا</span></div><div class='wf-row wf-box' data-rough style='padding:10px 12px;gap:12px;justify-content:space-between'><strong>الخطوة التالية</strong><span class='wf-muted'>راجع مسودتي رؤى</span></div></section></section><aside class='wf-card' data-rough style='height:100%;box-sizing:border-box;display:flex;flex-direction:column;gap:12px'><strong>الدردشة</strong><div class='wf-box' data-rough style='align-self:flex-end;max-width:210px;padding:10px 12px'><span class='wf-muted'>أنت</span><p style='margin:4px 0 0'>افتح رؤى الردود.</p></div><div class='wf-box' data-rough style='align-self:flex-start;max-width:210px;padding:10px 12px'><span class='wf-muted'>Agent</span><p style='margin:4px 0 0'>تم فتح رؤى الردود.</p></div></aside></section></main>"
+    }
+  />
+</WireframeBlock>
 
-راجع [Drop-in Agent](/docs/drop-in-agent) للتعرف على مجموعة المكونات الكاملة، و
-[Native واجهة الدردشة](/docs/native-chat-ui) لعرض نتائج الإجراء على هيئة جداول
-المخططات والبطاقات المكتوبة بدلاً من النص العادي.
+وسع `view-screen` و `navigate` كي يعرف agent المسار الحالي ويستطيع فتح `/response-insights`. يمكن للنتائج أيضًا تضمين `href: "/response-insights"` لعرض زر "افتح رؤى الردود" في الدردشة.
 
-**بدأت بدون رأس وتريد UI لاحقًا؟** قالب الدردشة _هو_ UI على الطريق المنحدر —
-طبقة `app/` (جهاز التوجيه React + Vite) هي بالضبط ما تمثله السقالة مقطوعة الرأس
-يترك. أنظف خطوة هي البدء (أو إعادة السقالة) من الدردشة
-قالب; يتم ترحيل حالة `actions/` والوكيل وحالة SQL دون تغيير. انظر
-[Agent Surfaces](/docs/agent-surfaces) لكل سطح بينهما.
+عندما تفتح الدردشة الكاملة صفحة تطبيق، استخدم `AgentChatSurface` و `AgentSidebar` و `useAgentChatHomeHandoff` و `useAgentChatHomeHandoffLinks` و `chatViewTransition` من [Agent Surfaces](/docs/agent-surfaces#rich-chat) كي تنتقل الدردشة إلى اللوحة الجانبية مع الحفاظ على نفس thread.
 
-## بنية المشروع
+## بنية المشروع {#project-structure}
 
 ```text
 my-app/
-  actions/         # إجراءات يمكن للوكيل استدعاؤها
-  app/             # واجهة React أمامية (لقوالب UI فقط؛ تُحذف في وضع headless)
-  server/          # خادم Nitro API (مسارات، إضافات)
-  AGENTS.md        # تعليمات الوكيل الدائمة
-  .agents/         # مهارات يمكن للوكيل جلبها عند الحاجة
-  data/app.db      # حالة SQLite محلية عند عدم ضبط DATABASE_URL
+  actions/         # عمليات يمكن للوكيل وواجهة المستخدم استدعاؤها
+  app/             # مسارات React وصفحاته وواجهات الدردشة
+  server/          # خادم Nitro ومخطط SQL
+  AGENTS.md        # تعليمات دائمة لوكيل التطبيق
+  .agents/         # المهارات التي يحمّلها الوكيل عند الحاجة
+  data/app.db      # حالة SQLite المحلية عند عدم ضبط DATABASE_URL
 ```
 
-## إلى أين ستتجه بعد ذلك
-
-- **[Key Concepts](/docs/key-concepts)** — البنية الأساسية: SQL، actions،
-  المزامنة والوعي بالسياق.
-- **[Actions](/docs/actions)** — الإجراء الكامل API: المخططات، وHTTP، والمصادقة، و
-  الموافقة.
-- **[Agent Surfaces](/docs/agent-surfaces)** — بدون رأس، دردشة، عربة جانبية مدمجة،
-  والتطبيق الكامل.
-- **[Drop-in Agent](/docs/drop-in-agent)** — أضف دردشة الوكيل إلى أي تطبيق React.
-- **[Deployment](/docs/deployment)** — ضع تطبيقك على نطاقك الخاص.
-- **[FAQ](/docs/faq)** — أسئلة حول الإعداد والمنتج.
+## هل تريد نقطة بداية كاملة للتحليلات؟ {#analytics-starting-point}
+
+مثال رؤى الردود أعلاه صغير عمدًا كي ترى أجزاء framework بوضوح. إذا كنت تبني منتج analytics حقيقيًا، فابدأ من [Analytics](/docs/template-analytics). إنه نقطة بداية قوية: صل providers الخاصة بك، استخدم dashboards و agent actions الموجودة، ثم خصص التطبيق من هناك.
+
+## الخطوات التالية {#next}
+
+- **[Actions](/docs/actions)** — schemas و auth و approvals و hooks و transport.
+- **[Native Chat UI](/docs/native-chat-ui)** — عرض نتائج actions كجداول ورسوم و typed cards.
+- **[Chat Template](/docs/template-chat)** — أصغر chat-first app.
+- **[Analytics Template](/docs/template-analytics)** — نقطة بداية قوية لتطبيق analytics؛ صل providers ثم خصص من هناك.
+- **[Context Awareness](/docs/context-awareness)** — `view-screen` و `navigate` و route state والعناصر المحددة.
+- **[Agent Surfaces](/docs/agent-surfaces)** — chat و inline UI و app pages و embedded sidecars و automation و agents الخارجية.

package/corpus/core/docs/content/locales/ar-SA/pure-agent-apps.mdx

@@ -1,16 +1,11 @@
 ---
-title: "تطبيقات Pure-Agent"
-description: "التطبيقات التي يكون فيها الوكيل هو المنتج بالكامل: حلقة وكيل التطبيق هي الباب الأمامي، وتتم إضافة UI فقط عندما يحتاج إليه البشر."
+title: "Automation-First Apps"
+description: "Agent-Native apps بلا متصفح من أجل scheduled jobs وqueues وscripts وintegration workers وagents خارجية."
 ---
 
-# تطبيقات Pure-Agent
+# Automation-First Apps
 
-تطبيق الوكيل النقي هو الحد الأدنى من تطبيق الوكيل الأصلي: حلقة وكيل التطبيق هي
-منتج، وليس لوحة معلومات. يمكنك إرسال طلب من المحطة، Slack، عبر البريد الإلكتروني،
-مهمة مجدولة، أو وكيل آخر، أو الدردشة — "تلخيص رسائل البريد الإلكتروني غير المقروءة"، أو "نشر
-المقاييس اليومية إلى Slack" - ويعمل الوكيل ويعيد النتيجة أينما كانت
-ينتمي. لا يزال تطبيقًا حقيقيًا: actions، الجلسات، حالة التطبيق، السجل،
-الإعدادات وبيانات الاعتماد وسجلات المشاركة كلها موجودة في SQL.
+Automation-first app هو Agent-Native app بلا متصفح من أجل scheduled jobs وqueues وscripts وintegration workers وagents خارجية. ليس المسار الافتراضي في Getting Started، لكنه مفيد عندما لا يحتاج workflow إلى صفحة بعد. لا يزال app حقيقيًا: actions وsessions وapplication state وrun history وsettings وcredentials وسجلات المشاركة كلها موجودة في SQL.
 
 <Diagram id="doc-block-1l5rx7k" title={"حلقة وكيل التطبيق هي الباب الأمامي"} summary={"تصل العديد من نقاط الدخول إلى حلقة وكيل واحدة عبر إجراءات وحالة SQL-backed؛ تعود النتائج إلى المكان الذي جاء منه الطلب. تتم إضافة واجهة المستخدم فقط عندما يحتاج البشر إلى الإشراف."}>
 

package/corpus/core/docs/content/locales/ar-SA/template-chat.mdx

@@ -7,7 +7,7 @@ description: "تطبيق بسيط للوكيل الأصلي للدردشة أو
 
 الدردشة هي نقطة البداية الأساسية لتطبيق الوكيل الأصلي. فهو يوفر لك غلافًا نظيفًا على طراز ChatGPT مع الدردشة في المركز، وقائمة المواضيع على اليسار، والتنقل القياسي في التطبيق، والمصادقة، والمزامنة المباشرة، وactions، ومثال واحد للإجراء. ابدأ هنا عندما تريد تطبيق متصفح حقيقي يمكنك البناء عليه دون الالتزام بقالب المجال.
 
-إذا كنت تريد أقل وقت تشغيل للإجراء فقط بدون متصفح UI، فابدأ بـ [Pure-Agent Apps](/docs/pure-agent-apps). إذا كنت تريد شكل منتج مجال نهائي، فابدأ من [Calendar](/docs/template-calendar)، أو [Mail](/docs/template-mail)، أو [Content](/docs/template-content)، أو [Forms](/docs/template-forms)، أو [Analytics](/docs/template-analytics)، أو قالب مجال آخر.
+إذا كنت تريد runtime من نوع automation-first بدون متصفح UI، فابدأ بـ [Automation-First Apps](/docs/pure-agent-apps). إذا كنت تريد شكل منتج مجال نهائي، فابدأ من [Calendar](/docs/template-calendar)، أو [Mail](/docs/template-mail)، أو [Content](/docs/template-content)، أو [Forms](/docs/template-forms)، أو [Analytics](/docs/template-analytics)، أو قالب مجال آخر.
 
 <WireframeBlock id="doc-block-xghzfw">
   <Screen
@@ -200,4 +200,4 @@ export default function ChatRoute() {
 - [**Agent Surfaces**](/docs/agent-surfaces) - أنماط بدون رأس، والدردشة، والمضمنة، والتطبيقات الكاملة
 - [**Actions**](/docs/actions) — اتصال نظام الدردشة وUI معًا
 - [**Native واجهة الدردشة**](/docs/native-chat-ui) — أساسيات سطح الدردشة وخيارات وقت التشغيل
-- [**Pure-Agent Apps**](/docs/pure-agent-apps) — تطبيقات الإجراءات فقط التي يمكن أن تتطور إلى Chat لاحقًا
+- [**Automation-First Apps**](/docs/pure-agent-apps) — automations وqueues وscripts وexternal agent workflows بدون UI في المتصفح

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

@@ -99,7 +99,7 @@ description: "الحلقة اليومية للعمل مع الوكيل: فهو
 
 لا يحتاج كل تطبيق إلى لوحة تحكم كاملة. عندما يكون الوكيل هو المنتج، يمكنك تخطي معظم UI المخصصة: افتح التطبيق، واطلب ما تريد، واترك الوكيل يقوم بالباقي. لا يزال لدى الوكيل سطح الإدارة الخاص به - السجل ومساحة العمل والإعدادات - ولكن التفاعل الأساسي هو المحادثة وليس النقرات.
 
-← [**Pure-Agent Apps**](/docs/pure-agent-apps) — التطبيقات التي يكون فيها الوكيل هو المنتج بالكامل.
+← [**Automation-First Apps**](/docs/pure-agent-apps) — تطبيقات بلا متصفح من أجل jobs وqueues وscripts وagents خارجية.
 
 ## يمكنك المشاركة في التحرير معه {#you-co-edit}
 
@@ -113,5 +113,5 @@ description: "الحلقة اليومية للعمل مع الوكيل: فهو
 - [**Agent Mentions**](/docs/agent-mentions) - قم بتوجيهه باستخدام إشارات `@`
 - [**Voice Input**](/docs/voice-input) — قم بتوجيهه عن طريق التحدث
 - [**Drop-in Agent**](/docs/drop-in-agent) - قم بتضمينه في أي تطبيق React
-- [**Pure-Agent Apps**](/docs/pure-agent-apps) - انتقل إلى UI عندما يكون الوكيل هو المنتج
+- [**Automation-First Apps**](/docs/pure-agent-apps) - تطبيقات بلا متصفح من أجل jobs وqueues وscripts وagents خارجية
 - [**Real-Time Collaboration**](/docs/real-time-collaboration) — تحرير نفس المستند معًا

package/corpus/core/docs/content/locales/de-DE/cloneable-saas.mdx

@@ -30,7 +30,7 @@ Jede davon ist eine echte App, die Sie heute verwenden können, und die Startram
 | [**Plan**](/docs/template-plan)           | Visuelle Pläne und PR-Zusammenfassungen mit Diagrammen, Wireframes und Anmerkungen.                                                                        |
 | [**Dispatch**](/docs/template-dispatch)   | Die Workspace-Steuerungsebene: gemeinsame Geheimnisse, wiederverwendbare Integrationen, Slack/Telegram, geplante Jobs.                                     |
 
-Sie möchten keine Domain-App? Verwenden Sie [Chat](/docs/template-chat), wenn Sie eine einfache App wünschen, mit der Benutzer sofort sprechen können, oder beginnen Sie mit einer Aktion in [Pure-Agent Apps](/docs/pure-agent-apps).
+Sie möchten keine Domain-App? Verwenden Sie [Chat](/docs/template-chat), wenn Sie eine einfache App wünschen, mit der Benutzer sofort sprechen können und die mit actions, nativen Ergebnissen und Seiten wachsen kann. Verwenden Sie [Automation-First Apps](/docs/pure-agent-apps) nur, wenn der Workflow noch keine Browser-UI braucht.
 
 Sehen Sie sich den vollständigen Katalog unter [Apps](/apps) an oder springen Sie direkt zu einem – [Dispatch](/docs/template-dispatch) ist beispielsweise ein großartiger Ausgangspunkt, wenn Sie eine App im Workspace-Stil wünschen.
 
@@ -168,7 +168,7 @@ Nicht bereit für den Gerüstbau? Sie können einem Codierungsagenten, den Sie b
 
 ## Darauf aufbauen
 
-- [**Getting Started**](/docs/getting-started) – Erstellen Sie eine minimale Chat-App oder einen Headless-Agenten
+- [**Getting Started**](/docs/getting-started) – Erstellen Sie eine chat-first App, fügen Sie eine action hinzu, rendern Sie ein strukturiertes Ergebnis und wachsen Sie zu einer Seite
 - [**Messaging the agent**](/docs/messaging) – wie Benutzer (und Sie) mit dem Agenten kommunizieren, der mit jeder Vorlage geliefert wird
 - [**Multi-App Workspace**](/docs/multi-app-workspace) – Bündeln Sie mehrere Vorlagen in einem Arbeitsbereich, der Authentifizierung, Marke und Agent teilt
 - [**Dispatch**](/docs/template-dispatch) – die Vorlage für die Steuerungsebene des Arbeitsbereichs
@@ -182,7 +182,7 @@ Wenn Sie jetzt ein Gerüst erstellen, lautet der CLI-Befehl:
 npx @agent-native/core@latest create my-platform
 ```
 
-Sie erhalten eine Mehrfachauswahl-Auswahl. Wählen Sie eine App (eigenständig) oder mehrere (Arbeitsbereich – Apps teilen sich Authentifizierung, Marke, Agentenkonfiguration und Datenbank). Jede ausgewählte Vorlage wird mit jeder benötigten Datei in `apps/<name>/` eingebunden. Für eine reine Aktions-App anstelle einer Vorlage UI verwenden Sie `npx @agent-native/core@latest create my-agent --headless`.
+Sie erhalten eine Mehrfachauswahl-Auswahl. Wählen Sie eine App (eigenständig) oder mehrere (Arbeitsbereich – Apps teilen sich Authentifizierung, Marke, Agentenkonfiguration und Datenbank). Jede ausgewählte Vorlage wird mit jeder benötigten Datei in `apps/<name>/` eingebunden. Für eine Automation ohne Browser-UI anstelle einer Vorlage UI verwenden Sie `npx @agent-native/core@latest create my-agent --headless`.
 
 Geben Sie `.env` (hauptsächlich `ANTHROPIC_API_KEY` und `DATABASE_URL`), `pnpm install`, `pnpm dev` ein und es funktioniert. Kein „TODO: Login implementieren“, keine Platzhalterrouten.
 

package/corpus/core/docs/content/locales/de-DE/faq.mdx

@@ -11,15 +11,15 @@ Häufig gestellte Fragen zu Agent-Native, sortiert von „Ich suche nur“ bis
 
 ### Was ist Agent-nativ? {#what-is-agent-native}
 
-Agent-native ist ein Framework zum Erstellen von Apps, bei dem der KI-Agent und die ihn umgebende Produktoberfläche gleichberechtigte Partner sind. Diese Oberfläche kann als Headless-Agent mit einer benutzerdefinierten Aktion beginnen, sich zu einem Rich-Chat entwickeln oder zu einem vollwertigen UI werden. Die Invariante besteht darin, dass Agenten und Menschen denselben actions, dieselbe Datenbank und denselben Status teilen. Die vollständige Erklärung finden Sie unter [What Is Agent-Native?](/docs/what-is-agent-native).
+Agent-native ist ein Framework zum Erstellen von Apps, bei dem der KI-Agent und die ihn umgebende Produktoberfläche gleichberechtigte Partner sind. Der übliche Weg beginnt mit Chat, fügt typisierte actions hinzu, rendert strukturierte Ergebnisse inline und wächst zu dauerhaften Seiten auf demselben SQL-Zustand. Die Invariante besteht darin, dass Agenten und Menschen denselben actions, dieselbe Datenbank und denselben Status teilen. Die vollständige Erklärung finden Sie unter [What Is Agent-Native?](/docs/what-is-agent-native).
 
 ### Für wen ist das? {#who-is-this-for}
 
 Agent-native ist für Leute gedacht, die möchten, dass eine echte App und ein KI-Agent mit denselben Daten und actions arbeiten. Die allgemeinen Pfade sind:
 
 - **Verwenden Sie eine gehostete App**, wenn Sie E-Mail, Kalender, Formulare, Pläne oder eine andere fertige Vorlage ohne Einrichtung wünschen – beginnen Sie bei [template gallery](/templates).
-- **Beginnen Sie mit Chat**, wenn Sie eine einfache App wünschen, mit der Benutzer sofort sprechen können, dann erweitern Sie sie mit actions und Bildschirmen – beginnen Sie mit [Getting Started](/docs/getting-started) oder [Chat](/docs/template-chat).
-- **Starten Sie primitiv zuerst**, wenn Sie eine Aktion und eine kopflose App-Agent-Schleife wünschen, bevor Sie sich an UI festlegen – beginnen Sie mit [Getting Started](/docs/getting-started).
+- **Beginnen Sie mit Chat**, wenn Sie den Standardpfad von Grund auf möchten: Benutzer sprechen sofort mit dem Agenten, und Sie erweitern mit actions, nativen Ergebnissen und Bildschirmen – beginnen Sie mit [Getting Started](/docs/getting-started) oder [Chat](/docs/template-chat).
+- **Beginnen Sie automation-first**, wenn Sie geplante Aufgaben, Queues, Skripte, integration workers oder externe Agenten-Workflows ohne Browser-UI bauen – beginnen Sie mit [Automation-First Apps](/docs/pure-agent-apps).
 - **Forken und passen Sie eine Vorlage an**, wenn Sie Ihr eigenes SaaS-Produkt mit Authentifizierung, Datenbank, UI und Agentenaktionen bereits verkabelt haben möchten – siehe [Templates](/docs/cloneable-saas).
 - **Erstellen Sie von Grund auf**, wenn Sie die Framework-Grundelemente für ein neues agentengesteuertes Produkt benötigen – beginnen Sie mit [Getting Started](/docs/getting-started).
 - **Verbinden Sie einen anderen Agenten oder ein anderes Code-Tool**, wenn Sie möchten, dass Claude, ChatGPT, Codex, Cursor oder GitHub Copilot/VS-Code eine agentennative App verwenden – siehe [External Agents](/docs/external-agents) und [Skills Guide](/docs/skills-guide).
@@ -130,7 +130,7 @@ Das ist der springende Punkt. Forken Sie eine Vorlage und passen Sie sie an, ind
 
 ### Kann ich etwas erstellen, das die Vorlagen nicht abdecken? {#build-from-scratch}
 
-Ja. Wenn Sie eine einfache Chat-App wünschen, führen Sie `npx @agent-native/core@latest create my-chat-app --template chat` aus. Sie erhalten dauerhafte Chat-Threads, actions, Authentifizierung, SQL-gestützten Laufzeitstatus und Platz zum Hinzufügen eigener Bildschirme. Wenn Sie die kleinste Action-First-App ohne UI wünschen, führen Sie `npx @agent-native/core@latest create my-agent --headless` aus. Siehe [Getting Started](/docs/getting-started), [Pure-Agent Apps](/docs/pure-agent-apps) und [Chat](/docs/template-chat).
+Ja. Wenn Sie eine einfache agentic app wünschen, führen Sie `npx @agent-native/core@latest create my-chat-app --template chat` aus. Sie erhalten dauerhafte Chat-Threads, actions, Authentifizierung, SQL-gestützten Laufzeitstatus, natives Inline-Rendering und Platz zum Hinzufügen eigener Bildschirme. Wenn Sie eine Automation ohne Browser bauen, führen Sie `npx @agent-native/core@latest create my-agent --headless` aus. Siehe [Getting Started](/docs/getting-started), [Automation-First Apps](/docs/pure-agent-apps) und [Chat](/docs/template-chat).
 
 ### Kann ich es ausprobieren, ohne eine Vorlage zu forken? {#try-with-a-skill}