@agent-native/core 0.93.0 → 0.94.0

package/corpus/core/docs/content/getting-started.mdx

@@ -59,9 +59,7 @@ An action is one typed operation your agent and UI can both call. Replace the
 starter `hello` action with the first real operation in your domain. This example
 analyzes form responses and returns a validated shape for a custom chat chart:
 
-<!-- prettier-ignore -->
-```ts
-// actions/analyze-responses.ts
+```ts filename="actions/analyze-responses.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -72,18 +70,23 @@ const responseChartResultSchema = z.object({
 
 export default defineAction({
   description: "Analyze recent form responses and render a custom chart.",
-  schema: z.object({ 
-    formId: z.string().default("demo") 
+  schema: z.object({
+    formId: z.string().default("demo"),
   }),
   outputSchema: responseChartResultSchema,
-  chatUI: { 
-    renderer: "responses.response-chart", 
-    title: "Response chart" 
+  chatUI: {
+    renderer: "responses.response-chart",
+    title: "Response chart",
   },
   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 }],
+    points: [
+      { day: "Mon", responses: 12 },
+      { day: "Tue", responses: 18 },
+      { day: "Wed", responses: 24 },
+      { day: "Thu", responses: 21 },
+    ],
   }),
 });
 ```
@@ -108,9 +111,11 @@ The action above declares `outputSchema` and a product-specific
 into prose. Register a React component for that exact renderer id, for example
 by importing `app/chat-renderers.tsx` once from `app/root.tsx`:
 
-<!-- prettier-ignore -->
 ```tsx
-import { registerActionChatRenderer, type ToolRendererProps,} from "@agent-native/core/client/chat";
+import {
+  registerActionChatRenderer,
+  type ToolRendererProps,
+} from "@agent-native/core/client/chat";
 
 type ResponseChartResult = {
   title: string;
@@ -125,8 +130,14 @@ function ResponseChart({ context }: ToolRendererProps) {
       <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}%` }} />
+          <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>
         ))}
@@ -174,8 +185,7 @@ Inline chat is great for the first result. A real app needs durable data the
 agent can add, update, and revisit. Add a response-insights table in your schema
 and keep reads/writes behind actions:
 
-```ts
-// server/db/schema.ts
+```ts filename="server/db/schema.ts"
 import { integer, now, table, text } from "@agent-native/core/db/schema";
 
 export const responseInsights = table("response_insights", {
@@ -209,9 +219,7 @@ separate REST route just for the browser if an action is the operation.
 
 Now add a durable page for the data behind the chat result:
 
-<!-- prettier-ignore -->
-```tsx
-// app/routes/response-insights.tsx
+```tsx filename="app/routes/response-insights.tsx"
 import { useActionMutation, useActionQuery } from "@agent-native/core/client";
 
 export default function ResponseInsightsRoute() {
@@ -224,10 +232,15 @@ export default function ResponseInsightsRoute() {
         <h1>Response insights</h1>
         <p>Insights the agent created from form responses.</p>
       </header>
-      <button onClick={() => createInsight.mutate({ formId: "demo" })}>Analyze demo form</button>
+      <button onClick={() => createInsight.mutate({ formId: "demo" })}>
+        Analyze demo form
+      </button>
       <section>
         {insights.data?.map((insight) => (
-          <article key={insight.id}><h2>{insight.title}</h2><p>{insight.summary}</p></article>
+          <article key={insight.id}>
+            <h2>{insight.title}</h2>
+            <p>{insight.summary}</p>
+          </article>
         ))}
       </section>
     </main>
@@ -286,7 +299,7 @@ framework pieces. If you are building a real analytics product, start from
 connect your providers, use the existing dashboards and agent actions, then
 customize the app from there.
 
-## Where to go next {#next}
+## What's next {#next}
 
 - **[Actions](/docs/actions)** — schemas, auth, approvals, hooks, and transport.
 - **[Native Chat UI](/docs/native-chat-ui)** — render action results as tables,

package/corpus/core/docs/content/harness-agents.mdx

@@ -6,9 +6,13 @@ search: "harness agents AgentHarness ai-sdk HarnessAgent Claude Code Codex Pi Cu
 
 # Harness Agents
 
-> **Who is this for:** host authors wiring a full coding runtime (Claude Code,
-> Codex, Pi) into Agent-Native as the agent. Building an app? Start with
-> [Creating Templates](/docs/creating-templates).
+<Callout id="doc-block-harn1who" tone="info">
+
+**Who is this for:** host authors wiring a full coding runtime (Claude Code,
+Codex, Pi) into Agent-Native as the agent. Building an app? Start with
+[Creating Templates](/docs/creating-templates).
+
+</Callout>
 
 A harness agent is a full agent runtime — Claude Code, Codex, Pi, and similar —
 that owns its own loop, workspace, native file tools, session state, compaction,
@@ -408,7 +412,7 @@ one implementation of this contract, not the public abstraction.
 - Don't expose every app action to every harness session by default. Hand it a
   small, intentional tool set.
 
-## Related docs {#related-docs}
+## What's next
 
 - [Native Chat UI](/docs/native-chat-ui) — put your own agent behind the chat UI with `AgentChatRuntime`.
 - [Agent Surfaces](/docs/agent-surfaces) — choose headless, chat, sidecar, or full-app.

package/corpus/core/docs/content/human-approval.mdx

@@ -7,8 +7,13 @@ description: "Pause the agent before a high-consequence action runs — defineAc
 
 Most actions should just run. A few — sending an email, charging a card, deleting an account — are outward-facing and hard to undo, and you don't want the agent to do them autonomously. For those, `defineAction` has an opt-in **approval gate**: when the agent tries to call the action, the loop pauses, surfaces an Approve/Deny affordance to the human, and runs the action _only_ after the human approves that specific call.
 
-> [!WARNING]
-> Keep approvals rare. Every gated action is a hard stop in the agent loop — it interrupts the run and demands a human round-trip. Use `needsApproval` only for genuinely high-consequence, hard-to-undo, outward-facing operations. If you find yourself gating reads or routine writes, you're holding it wrong. The default is **off**, and almost every action should leave it off.
+<Callout tone="warning">
+  Keep approvals rare. Every gated action is a hard stop in the agent loop — it
+  interrupts the run and demands a human round-trip. Use `needsApproval` only
+  for genuinely high-consequence, hard-to-undo, outward-facing operations. If
+  you find yourself gating reads or routine writes, you're holding it wrong. The
+  default is **off**, and almost every action should leave it off.
+</Callout>
 
 ## The `needsApproval` gate {#needs-approval}
 
@@ -135,7 +140,7 @@ On `approval_required`, the chat UI renders an **Approve / Deny** affordance on
 
 The canonical (and intentionally rare) use of this gate in the framework is the Mail template's `send-email` action, which sets `needsApproval: true` so the agent can draft and queue freely but can never actually send a message without a human approving the specific send.
 
-## Related
+## What's next
 
 - [**Actions**](/docs/actions#needs-approval) — the full `defineAction` surface, including `outputSchema` for validating return values.
 - [**Security**](/docs/security) — when to reach for an approval gate vs. hiding an action from the model.

package/corpus/core/docs/content/internationalization.mdx

@@ -39,8 +39,7 @@ resolved locale/catalog into that script to avoid hydration mismatches.
 
 Each localized template keeps catalogs under `app/i18n/`:
 
-```ts
-// app/i18n/index.ts
+```ts filename="app/i18n/index.ts"
 import enUS from "./en-US";
 import type { AgentNativeI18nCatalog } from "@agent-native/core/client";
 
@@ -106,8 +105,8 @@ locale-sensitive date/number formatting inside translation strings.
 Public docs pages use the same core provider, but with
 `persistPreference={false}` so anonymous docs traffic uses localStorage and the
 browser language instead of SQL settings actions. The English source remains in
-`packages/core/docs/content/*.md`. Localized page overrides live next to it under
-`packages/core/docs/content/locales/<locale>/<slug>.md`.
+`packages/core/docs/content/*.mdx`. Localized page overrides live next to it under
+`packages/core/docs/content/locales/<locale>/<slug>.mdx`.
 
 Use the same BCP-47 locale codes as app catalogs. Keep the same slug as the
 English source, preserve stable anchors with `{#anchor}` on translated headings,
@@ -149,3 +148,9 @@ review.
 Do not translate stable identifiers such as action names, routes, enum values,
 app-state keys, database values, protocol fields, env var names, or provider
 names.
+
+## What's next
+
+- [**Client**](/docs/client) — the `AppProviders` wrapper and other browser hooks i18n builds on
+- [**Toolkit: Settings**](/docs/toolkit-settings) — put `<LanguagePicker>` on the standard settings page
+- [**Getting Started**](/docs/getting-started) — build your first app on a template that already ships localized catalogs

package/corpus/core/docs/content/key-concepts.mdx

@@ -11,11 +11,9 @@ How agent-native apps work under the hood — the principles and the architectur
 
 Every agent-native app is three things working together:
 
-> **Agent** — Autonomous AI that reads data, writes data, runs actions, and modifies code. Customizable with skills and instructions.
->
-> **Application** — The product surface around the agent. This may start as chat, add native inline results, grow into a small control plane, or become a full React UI with dashboards, flows, and visualizations.
->
-> **Computer** — Database, browser, code execution. Agents work directly with SQL and built-in tools; MCP servers are optional add-ons, not the foundation.
+- **Agent** — Autonomous AI that reads data, writes data, runs actions, and modifies code. Customizable with skills and instructions.
+- **Application** — The product surface around the agent. This may start as chat, add native inline results, grow into a small control plane, or become a full React UI with dashboards, flows, and visualizations.
+- **Computer** — Database, browser, code execution. Agents work directly with SQL and built-in tools; MCP servers are optional add-ons, not the foundation.
 
 <Diagram id="doc-block-t1f7pj" title="Agent, application, and computer" summary="Three layers working together over one shared SQL store. The agent and the application both read and write the same data.">
 
@@ -278,8 +276,7 @@ Why not call an LLM inline?
 
 When the agent needs to do something complex — call an API, process data, query the database — it runs an **action**. Actions are TypeScript files in `actions/` that export a default `defineAction()`:
 
-```ts
-// actions/fetch-data.ts
+```ts filename="actions/fetch-data.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -379,9 +376,8 @@ A _frame_ is the environment that hosts the agent next to your app — locally t
 
 Agent-native apps include an embedded agent panel that provides the AI agent alongside the app UI. This is what makes the architecture work: the agent needs a computer (database, browser, code execution), and the app needs the agent for AI work.
 
-> **Embedded Agent Panel** — Chat and optional CLI terminal built into every app. Supports Claude Code, Codex, Gemini, OpenCode, and Builder.io. Runs locally. Free and open source.
->
-> **Cloud** — Deploy to any cloud with real-time collaboration, visual editing, roles and permissions. Best for teams.
+- **Embedded Agent Panel** — Chat and optional CLI terminal built into every app. Supports Claude Code, Codex, Gemini, OpenCode, and Builder.io. Runs locally. Free and open source.
+- **Cloud** — Deploy to any cloud with real-time collaboration, visual editing, roles and permissions. Best for teams.
 
 ## Context awareness {#context-awareness}
 
@@ -452,14 +448,11 @@ Adopting the framework is valuable mostly because of what you stop having to bui
 
 That's the "and everything else" you'd otherwise be gluing together yourself.
 
-## Deep dives {#deep-dives}
-
-For detailed guidance on specific patterns:
+## What's next {#deep-dives}
 
-- [What Is Agent-Native?](/docs/what-is-agent-native) — the vision and philosophy
-- [Context Awareness](/docs/context-awareness) — navigation state, view-screen, navigate commands
-- [Skills Guide](/docs/skills-guide) — framework skills, domain skills, creating custom skills
-- [Native Chat UI](/docs/native-chat-ui) — action-declared tables, charts, and BYO runtime posture
-- [Agent Surfaces](/docs/agent-surfaces) — chat, native inline UI, full app pages, embedded sidecar, automation, and external-agent paths
-- [A2A Protocol](/docs/a2a-protocol) — agent-to-agent communication
-- [Multi-App Workspace](/docs/multi-app-workspace) — host many apps in one monorepo with shared auth, skills, components, and credentials
+- [**What Is Agent-Native?**](/docs/what-is-agent-native) — the vision and philosophy behind these rules
+- [**Context Awareness**](/docs/context-awareness) — navigation state, view-screen, and navigate commands in depth
+- [**Skills Guide**](/docs/skills-guide) — framework skills, domain skills, and creating custom skills
+- [**Native Chat UI**](/docs/native-chat-ui) — action-declared tables, charts, and BYO runtime posture
+- [**Agent Surfaces**](/docs/agent-surfaces) — chat, native inline UI, full app pages, embedded sidecar, automation, and external-agent paths
+- [**A2A Protocol**](/docs/a2a-protocol) — agent-to-agent communication

package/corpus/core/docs/content/local-file-mode.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Local File Mode"
-description: "Run agent-native apps with local Markdown, MDX, and other repo files as the source of truth - including Obsidian-style MDX docs with custom components."
+description: "Run agent-native apps with local Markdown, MDX, and other repo files as the source of truth - including a repo-native MDX docs workflow with custom components."
 ---
 
 # Local File Mode
@@ -16,16 +16,16 @@ Content editor, and saving writes back to the selected file. The same files can
 also be edited by Codex, Claude Code, the Agent-Native sidebar agent, or a normal
 editor.
 
-For Content, this makes the product feel like open-source Obsidian for MDX:
-your docs live as files, while the app adds a visual editor, agent actions,
-shareable copies, and rich interactive MDX components.
+For Content, this makes the product a repo-native MDX docs tool: your docs
+live as files, while the app adds a visual editor, agent actions, shareable
+copies, and rich interactive MDX components.
 
 Use Local File Mode when you want a repo-first workflow:
 
 - a docs repo with `docs/*.mdx`
 - a blog with `blog/*.mdx`
 - resources such as positioning, messaging, or team notes in `resources/*.md`
-- a personal Obsidian-style knowledge base with a richer MDX editor
+- a personal knowledge base with a richer MDX editor
 - docs that need interactive custom MDX blocks generated from local React code
 - app artifacts that should be easy for coding agents to inspect and patch
 
@@ -276,8 +276,7 @@ install snippets, or framework-specific code blocks.
 
 For example, add an interactive component next to your content:
 
-```tsx
-// components/ImpactCounter.tsx
+```tsx filename="components/ImpactCounter.tsx"
 import { useState } from "react";
 
 export function ImpactCounter({
@@ -449,7 +448,7 @@ For v1, local extensions are intentionally conservative:
 - raw SQL helpers and external `extensionFetch` are disabled
 - slot targets are declared in `extension.json`, not installed through SQL
 
-This gives local workspaces an Obsidian-like plugin surface without letting an
+This gives local workspaces a lightweight plugin surface without letting an
 arbitrary repo file inherit every capability of a database-backed extension.
 
 ## How Apps Use It
@@ -523,3 +522,10 @@ AGENT_NATIVE_ALLOW_LOCAL_FILES_IN_PRODUCTION=true
 Only set that for a trusted single-tenant deployment where everyone who can use
 the app is allowed to read and write the configured files. For normal hosted,
 multi-user apps, use database mode and SQL-backed sharing.
+
+## What's next
+
+- [**Database**](/docs/database) — the SQL-backed mode this page contrasts with
+- [**Sharing**](/docs/sharing) — the standard document-sharing model that database-mode copies use
+- [**Extensions**](/docs/extensions) — the SQL-backed extension model that local extensions intentionally simplify
+- [**Creating Templates**](/docs/creating-templates) — adopting the same local-artifact pattern in a new app

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

@@ -11,7 +11,7 @@ Actions هي المصدر الوحيد للحقيقة لأي شيء يفعله
 - **خطافات Typesafe React** — `useActionQuery("name")` و`useActionMutation("name")` في الواجهة الأمامية، الأنواع المستنتجة من المخطط.
 - **استدعاءات العميل الحتمية** — `callAction("name", params)` عندما لا يكون الخطاف مناسبًا.
 - **نقل إطار العمل** — يتم تركيبه تلقائيًا بواسطة إطار العمل خلف تلك الخطافات وهو متاح لعملاء HTTP الخارجيين.
-- **أداة MCP** — مكشوفة لتطبيقات Claude وChatGPT المخصصة MCP وClaude Desktop/Code وCursor وCodex وأي عميل MCP آخر.
+- **أداة MCP** — مكشوفة لتطبيقات Claude وChatGPT المخصصة MCP وClaude Desktop/Code وCursor وCodex وأي مضيف MCP آخر.
 - **أداة A2A** — يتم استدعاؤها بواسطة تطبيقات الوكيل الأصلية الأخرى عبر A2A.
 - **أمر CLI** — `pnpm action <name>` للبرمجة النصية وحلقات التطوير.
 
@@ -560,7 +560,7 @@ export default defineAction({
 });
 ```
 
-احتفظ بـ `link` كبديل لعملاء CLI وغير UI MCP؛ وهو أيضًا هدف إطلاق التضمين. جسر التضمين - جلسة بدء التضمين الموقعة، والزرع مقابل عرض الإطار المتحكم فيه، والجسر المضيف `ui/*`، وCSP، وتثبيت الارتفاع - مملوك لشركة [External Agents](/docs/external-agents#mcp-app-bridge).
+احتفظ بـ `link` كبديل لـ CLI ومضيفي MCP بدون واجهة مستخدم؛ وهو أيضًا هدف إطلاق التضمين. جسر التضمين - جلسة بدء التضمين الموقعة، والزرع مقابل عرض الإطار المتحكم فيه، والجسر المضيف `ui/*`، وCSP، وتثبيت الارتفاع - مملوك لشركة [External Agents](/docs/external-agents#mcp-app-bridge).
 
 ## قياسي actions {#standard-actions}
 

package/corpus/core/docs/content/locales/ar-SA/agent-native-toolkit.mdx

@@ -97,9 +97,9 @@ coherent kit instead of exposing package boundaries in the app.
 
 - [UI Primitives](/docs/toolkit-ui) cover shared shadcn-style primitives under
   `@agent-native/toolkit/ui/*`.
-- [App Adapters](/docs/toolkit-app-adapters) show how apps wrap Toolkit pieces
+- [App Adapters](/docs/toolkit-ui#app-adapters) show how apps wrap Toolkit pieces
   through local `@/components/*` adapters.
-- [Shell & Hooks](/docs/toolkit-shell-hooks) cover header actions, mobile hooks,
+- [Shell & Hooks](/docs/toolkit-ui#shell-hooks) cover header actions, mobile hooks,
   toasts, and small app-shell helpers.
 - [Component API](/docs/components) remains the lower-level reference for the
   public React exports.

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

@@ -139,8 +139,7 @@ pnpm install
 
 ثم حدد العملية الدائمة:
 
-```ts
-// actions/summarize-week.ts
+```ts filename="actions/summarize-week.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -494,12 +493,11 @@ export function AppShell({ children }) {
 نتائج الأدوات عندما تحتاج الدردشة إلى UI، وإضافة شاشات كاملة فقط عند المستخدمين
 تحتاج إلى تصفح الكائنات الثابتة أو مقارنتها أو تكوينها أو التعاون عليها.
 
-## المستندات ذات الصلة {#related-docs}
+## الخطوات التالية {#related-docs}
 
-- [Actions](/docs/actions) — حدد عملية مقطوعة الرأس مرة واحدة.
-- [Native واجهة الدردشة](/docs/native-chat-ui) — عرض نتائج الإجراءات المكتوبة في الدردشة.
-- [Drop-in Agent](/docs/drop-in-agent) — قم بتثبيت الدردشة أو الشريط الجانبي أو أسطح اللوحات.
-- [Component API](/docs/components) — مقطوعات الدردشة/الملحن React ذات المستوى الأدنى.
-- [Embedding SDK](/docs/embedding-sdk) — أضف Agent-Native إلى تطبيق موجود.
-- [External Agents](/docs/external-agents) — توصيل الأجهزة المضيفة المتوافقة مع MCP بأحد التطبيقات.
-- [A2A Protocol](/docs/a2a-protocol) — استدعاء الوكلاء من الوكلاء الآخرين.
+- [**Actions**](/docs/actions) — عرّف العملية مرة واحدة؛ كل سطح أعلاه يستدعي العملية نفسها
+- [**Native Chat UI**](/docs/native-chat-ui) — اعرض نتائج actions كجداول ومخططات وبطاقات في الدردشة
+- [**Generative UI**](/docs/generative-ui) — أنشئ واجهة مستخدم مؤقتة أو دائمة ضمن بيئة معزولة داخل الدردشة
+- [**Automation-First Apps**](/docs/pure-agent-apps) — النمط الكامل دون متصفح للوظائف وقوائم الانتظار والبرامج النصية والوكلاء الخارجيين
+- [**External Agents**](/docs/external-agents) — صِل المضيفين المتوافقين مع MCP بتطبيق
+- [**A2A Protocol**](/docs/a2a-protocol) — استدعِ الوكلاء من تطبيقات Agent-Native أخرى

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

@@ -239,6 +239,7 @@ interface AgentTask {
   summary: string; // full summary once completed
   currentStep: string; // latest step label (updated while running)
   createdAt: number;
+  delegationDepth?: number; // 1 for a direct sub-agent, 2 for a sub-agent of that sub-agent, etc.
   // Additional fields: parentThreadId, name, updatedAt, startedAt,
   // completedAt, runId, error
 }

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

@@ -15,7 +15,7 @@ description: "تكامل أفضل للمصادقة مع البريد الإلك
 - **جهاز التحكم عن بعد MCP OAuth:** معيار OAuth 2.1 لمضيفي MCP مثل Claude Code وموصلات ChatGPT.
 - **مخصص:** قم بإحضار المصادقة الخاصة بك عبر رد الاتصال `getSession`.
 
-<Diagram id="doc-block-5y2l0x" title={"ثلاث طرق في جلسة واحدة"} summary={"يقوم كل زوار المستعرض وعملاء MCP الآليين والموفرين المخصصين بالتوصل إلى نفس AuthSession الذي يقرأه النطاق النهائي."}>
+<Diagram id="doc-block-5y2l0x" title={"ثلاث طرق في جلسة واحدة"} summary={"يقوم كل زوار المستعرض ومضيفي MCP والموفرين المخصصين بالتوصل إلى نفس AuthSession الذي يقرأه النطاق النهائي."}>
 
 ```html
 <div class="auth-modes">

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

@@ -472,10 +472,12 @@ function WorkspaceResources() {
 ```ts
 import { defineAction } from "@agent-native/core/action";
 import { completeText } from "@agent-native/core/server";
+import { z } from "zod";
 
 export default defineAction({
   description: "Classify a short message",
-  run: async ({ body }: { body: string }) => {
+  schema: z.object({ body: z.string() }),
+  run: async ({ body }) => {
     const result = await completeText({
       systemPrompt: "Return exactly one label.",
       input: body,
@@ -490,3 +492,11 @@ export default defineAction({
 استخدم `sendToAgentChat({ background: true, openSidebar: false })` بدلاً من ذلك عندما
 يحتاج العمل إلى أدوات، أو حالة، أو إمكانية التدقيق، أو توجيه المستخدم، أو الخطوات المتعددة
 الاستدلال.
+
+## ما التالي {#whats-next}
+
+- [**Drop-in Agent**](/docs/drop-in-agent) — ثبّت `<AgentSidebar>` و`<AgentPanel>` مع شرح إرشادي يبدأ بالبرنامج التعليمي
+- [**Native Chat UI**](/docs/native-chat-ui) — عقد نتيجة الإجراء وراء عناصر واجهة البيانات وأدوات العرض المخصصة
+- [**Actions**](/docs/actions) — ‏`defineAction()` والمخططات وسطح الإجراءات الذي تستدعيه هذه المكونات
+- [**Real-Time Collaboration**](/docs/real-time-collaboration) — تفاصيل ربط التعاون ومكونات الحضور
+- [**Sharing**](/docs/sharing) — توصيل `<ShareButton>` و`<ShareDialog>` للموارد القابلة للامتلاك

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

@@ -44,7 +44,6 @@ npx @agent-native/core@latest create my-platform
 <FileTree
   id="doc-block-15r9qt6"
   title={"بنية مشروع ال template"}
-  title="my-template/"
   entries={[
     {
       path: "app/",
@@ -172,8 +171,7 @@ npx @agent-native/core@latest create my-platform
 
 حدد جداول المجال باستخدام إطار العمل المساعد Drizzle بحيث تظل المخططات قابلة للنقل عبر SQLite، وPostgres، وD1، وTurso، وSupabase، وNeon، والواجهات الخلفية المدعومة الأخرى:
 
-```ts
-// server/db/schema.ts
+```ts filename="server/db/schema.ts"
 import {
   table,
   text,
@@ -204,8 +202,7 @@ export const projectShares = createSharesTable("project_shares");
 
 لقراءة التطبيق وكتابته، استخدم منشئ الاستعلامات والمشغلات المحمولة Drizzle من `drizzle-orm`. لا تكتب رمز المنتج باستخدام SQL الخام عندما يتمكن Drizzle من التعبير عن الاستعلام، ولا تستورد من `drizzle-orm/sqlite-core` أو `drizzle-orm/pg-core` في القوالب.
 
-```ts
-// server/plugins/db.ts
+```ts filename="server/plugins/db.ts"
 import { runMigrations } from "@agent-native/core/db";
 
 export default runMigrations(
@@ -349,8 +346,7 @@ export function useNavigationState() {
 `path` عندما يكون URL معروفًا. ولا تكتب أيضًا `__set_url__` لنفس الحركة؛
 هذا المفتاح محجوز لأدوات إطار العمل URL وتغييرات مرشح URL فقط.
 
-```ts
-// actions/navigate.ts
+```ts filename="actions/navigate.ts"
 import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { z } from "zod";

package/corpus/core/docs/content/locales/ar-SA/cross-app-sso.mdx

@@ -9,7 +9,11 @@ description: "قم بتسجيل الدخول مرة واحدة عبر كل تط
 
 هذا هو نفس مبدأ الثقة الأساسي [A2A](/docs/a2a-protocol) و[External Agents](/docs/external-agents) الذي يستخدمه بالفعل - `A2A_SECRET` الموقع JWT والذي تم التحقق منه عند حد الطلب - والذي يتم تطبيقه على مسار تسجيل الدخول البشري بدلاً من مكالمات وكيل إلى وكيل.
 
-> **النشر الموحد مقابل النشر لكل مجال.** إذا كنت تستضيف جميع التطبيقات في مصدر واحد (`your-agents.com/mail`، `your-agents.com/calendar`)، فستحصل بالفعل على تسجيل دخول مشترك عبر مجال ملف تعريف ارتباط واحد - لا حاجة إلى اتحاد. يعد Cross-App SSO ضروريًا فقط عند تشغيل التطبيقات على مجالات منفصلة. انظر [Multi-App Workspaces — Unified deploy](/docs/multi-app-workspace#deployment).
+<Callout tone="info">
+
+**النشر الموحد مقابل النشر لكل مجال.** إذا كنت تستضيف جميع التطبيقات في مصدر واحد (`your-agents.com/mail`، `your-agents.com/calendar`)، فستحصل بالفعل على تسجيل دخول مشترك عبر مجال ملف تعريف ارتباط واحد - لا حاجة إلى اتحاد. يعد Cross-App SSO ضروريًا فقط عند تشغيل التطبيقات على مجالات منفصلة. انظر [Multi-App Workspaces — Unified deploy](/docs/multi-app-workspace#deployment).
+
+</Callout>
 
 ## ماذا ولماذا {#what-why}
 
@@ -86,15 +90,17 @@ description: "قم بتسجيل الدخول مرة واحدة عبر كل تط
 
 </Diagram>
 
-1. **التطبيق → إرسال (تفويض).** يرسل التطبيق المستخدم إلى سلطة الهوية:
+1. **التطبيق → Dispatch (التفويض).** ينشئ مسار `GET /_agent-native/identity/login` في التطبيق (وهو المسار الذي يرتبط به زر «تسجيل الدخول باستخدام Agent-Native») إعادة التوجيه ويرسل المستخدم إلى جهة الهوية:
 
-   ```
+   ```http
    GET https://dispatch.agent-native.com/_agent-native/identity/authorize
        ?app=<requesting-app>
        &redirect_uri=<app-callback-url>
        &state=<csrf-state>
    ```
 
+   `redirect_uri` هو مسار `GET /_agent-native/identity/callback` الخاص بهذا التطبيق — وهو المسار الذي يستقبل الرمز الموقّع في الخطوة 3.
+
 <Endpoint id="cross-app-sso-identity-authorize-ar-sa" title={"الهوية تأذن بنقطة النهاية"} method="GET" path="/_agent-native/identity/authorize" summary={"تقوم شركة Dispatch (سلطة الهوية) بالمصادقة على المستخدم وإعادة التوجيه مرة أخرى باستخدام رمز هوية موقّع"} auth={"جلسة الإرسال (تسجيل الدخول التفاعلي إذا لم يكن هناك)"} params={[
   {
     "name": "app",
@@ -143,7 +149,7 @@ description: "قم بتسجيل الدخول مرة واحدة عبر كل تط
    | `scope`      | `"identity"` دائمًا — يسمح هذا الرمز المميز بتسجيل الدخول فقط                    |
    | `exp`        | **≥ دقيقتين** من الإصدار                                                         |
 
-4. **يتحقق التطبيق من روابط JIT عبر البريد الإلكتروني.** يتحقق التطبيق من توقيع الرمز المميز باستخدام `A2A_SECRET` الخاص به، ويتحقق من `scope: "identity"` و`exp`، ثم ينفذ **الربط في الوقت المناسب تمامًا عن طريق البريد الإلكتروني الذي تم التحقق منه**:
+4. **يتحقق التطبيق ويربط الحساب في الوقت المناسب عبر البريد الإلكتروني.** يتحقق مسار `GET /_agent-native/identity/callback` في التطبيق من توقيع الرمز المميز باستخدام `A2A_SECRET` الخاص به، ويتحقق من `scope: "identity"` و`exp`، ثم ينفذ **الربط في الوقت المناسب حصريًا عبر البريد الإلكتروني المتحقق منه**:
    - في حالة وجود مستخدم محلي لديه هذا البريد الإلكتروني → أعد استخدامه دون تغيير.
    - إذا لم يكن الأمر كذلك، قم بإنشاء مستخدم محلي لهذا البريد الإلكتروني.
 
@@ -290,9 +296,13 @@ AGENT_NATIVE_IDENTITY_HUB_URL=https://dispatch.agent-native.com
 **5. التراجع = إلغاء تعيين env var عند نشر هذا التطبيق.**
 للتراجع عن أي تطبيق، **قم بإزالة `AGENT_NATIVE_IDENTITY_HUB_URL` من بيئة ذلك التطبيق وأعد نشره/أعد تشغيله.** يعود التطبيق فورًا إلى سلوك المصادقة السابق الخاص به. لا يوجد **لا يوجد تغيير في البيانات للتراجع عنه** — تمت إضافة صفوف الهوية فقط، كما أن إلغاء تعيين المتغير يجعل مسار الاتحاد خاملًا مرة أخرى. تعتبر عمليات الاستبدال والتراجع لكل تطبيق مستقلة وقابلة للعكس.
 
-> يقوم الطرح بتسجيل خروج المستخدمين عند تمكين كل تطبيق (يقومون بإعادة المصادقة عبر Dispatch)، ولكنهم دائمًا ما يقومون بتسجيل الدخول مرة أخرى إلى **نفس الحساب المطابق للبريد الإلكتروني مع الحفاظ على البيانات**، لأنه لا يتم إتلاف صفوف الهوية أو إعادة تسميتها أبدًا، بل تتم إضافتها فقط.
+<Callout tone="info">
+
+يقوم الطرح بتسجيل خروج المستخدمين عند تمكين كل تطبيق (يقومون بإعادة المصادقة عبر Dispatch)، ولكنهم دائمًا ما يقومون بتسجيل الدخول مرة أخرى إلى **نفس الحساب المطابق للبريد الإلكتروني مع الحفاظ على البيانات**، لأنه لا يتم إتلاف صفوف الهوية أو إعادة تسميتها أبدًا، بل تتم إضافتها فقط.
+
+</Callout>
 
-## ذات صلة {#related}
+## الخطوات التالية {#whats-next}
 
 - [Authentication](/docs/authentication) — أوضاع المصادقة المحلية، والجلسات، والمؤسسات، ومتغير البيئة `A2A_SECRET`.
 - [A2A Protocol](/docs/a2a-protocol) — نموذج الثقة JWT المُوقع، الذي يتم التحقق منه عند الحدود والذي يُعاد استخدامه.

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

@@ -452,3 +452,11 @@ export default createAgentChatPlugin({
 ## نشر المثيلات المتعددة {#multi-instance}
 
 تقوم تطبيقات Agent-Native بتخزين جميع الحالات في SQL عبر Drizzle ومزامنة UI عبر [polling](/docs/key-concepts#polling-sync) مع قاعدة البيانات - لا توجد حالة نظام ملفات، ولا توجد جلسات ثابتة، ولا توجد ذاكرة تخزين مؤقت في الذاكرة. وهذا يعني أن عمليات النشر متعددة المثيلات وبدون خادم تعمل خارج الصندوق: قم بتوجيه كل مثيل إلى نفس `DATABASE_URL` وستتقارب تلقائيًا. انظر [Key Concepts — Data in SQL](/docs/key-concepts#data-in-sql) و[Portability](/docs/key-concepts#hosting-agnostic).
+
+## الخطوات التالية
+
+- [**Database**](/docs/database#production) — اختر قاعدة بيانات SQL دائمة قبل أول نشر للإنتاج
+- [**Security**](/docs/security) — قائمة تحقق الإنتاج والعلامات الاختيارية المشار إليها في هذه الصفحة
+- [**Authentication**](/docs/authentication) — بيانات اعتماد OAuth ومتغيرات البيئة لوضع المصادقة الذي تختاره
+- [**Multi-App Workspace**](/docs/multi-app-workspace) — نموذج مساحة العمل وراء بنية `deploy` ذات الأصل الواحد
+- [**Frames**](/docs/frames) — لوحة الوكيل المضمنة مقارنةً بإطار Builder.io السحابي لتعديلات واجهة الإنتاج

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

@@ -136,13 +136,8 @@ ChatGPT: استخدم مساحة عمل حيث توجد موصلات MCP الم
 تغييرات البيانات التعريفية لتطبيق MCP. إذا كان لا يزال لديك موصلات قديمة لكل تطبيق
 ممكّن جنبًا إلى جنب مع Dispatch أو تحديث أو إعادة توصيل كل موصل قديم؛ التحديث
 لا يقوم Dispatch بإعادة كتابة تقويم/بريد ChatGPT أو Claude المخزن مؤقتًا/البريد/إلخ.
-لقطات. النطاقات هي:
-
-| النطاق      | ما يتيحه                                                          |
-| ----------- | ----------------------------------------------------------------- |
-| `mcp:read`  | أدوات للقراءة فقط واكتشاف الأدوات/الموارد                         |
-| `mcp:write` | الصياغة والتحديث وغيرها من تعديلات actions                        |
-| `mcp:apps`  | تطبيقات MCP المضمّنة، والمخططات، ولوحات المعلومات، والمسودات، وUI |
+لقطات. نطاقات `mcp:read` / `mcp:write` / `mcp:apps` هي نفسها الموضحة في
+[OAuth القياسي لـ MCP البعيد](#standard-oauth) أدناه.
 
 يستخدم كل من Cursor وGoose وPostman وMCPJam وVS Code GitHub Copilot نفس جهاز التحكم عن بعد
 MCP URL من خلال خادم MCP الخاص بهم UI عندما يدعم تصميمهم OAuth عن بعد