@agent-native/core 0.93.0 → 0.94.0

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

@@ -127,6 +127,8 @@ import { defineAction } from "@agent-native/core/action";
 import { track } from "@agent-native/core/tracking";
 import { z } from "zod";
 
+import { getDb, schema } from "../server/db/index.js";
+
 export default defineAction({
   description: "Create a new project.",
   schema: z.object({
@@ -134,14 +136,15 @@ export default defineAction({
     template: z.string().optional(),
   }),
   run: async ({ name, template }, ctx) => {
-    const project = await db
-      .insert(projects)
+    const db = getDb();
+    const [project] = await db
+      .insert(schema.projects)
       .values({ name, template })
       .returning();
 
-    track("project.created", { name, template }, { userId: ctx.userEmail });
+    track("project.created", { name, template }, { userId: ctx?.userEmail });
 
-    return { ok: true, projectId: project[0].id };
+    return { ok: true, projectId: project.id };
   },
 });
 ```
@@ -349,5 +352,5 @@ interface TrackingEvent {
 ## ما هي الخطوة التالية
 
 - [**Actions**](/docs/actions) — حيث تنشأ معظم مكالمات التتبع
-- [**Server Plugins**](/docs/server) — يعمل `registerBuiltinProviders()` في البرنامج الإضافي للمسارات الأساسية عند بدء التشغيل
-- [**Secrets**](/docs/security) - إدارة مفاتيح API لموفري التتبع
+- [**Server Plugins**](/docs/server#server-plugins) — يعمل `registerBuiltinProviders()` في البرنامج الإضافي للمسارات الأساسية عند بدء التشغيل
+- [**الأمان — إدارة الأسرار**](/docs/security#secrets) - إدارة مفاتيح API لموفري التتبع

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

@@ -92,21 +92,14 @@ description: "الحلقة اليومية للعمل مع الوكيل: فهو
 
 الوكيل ليس تطبيقًا منفصلاً يمكنك الانتقال إليه. إنه يأتي كمجموعة من مكونات React - شريط جانبي، ولوحة أولية، ومكالمة `sendToAgentChat()` - التي تضعها في أي تطبيق. اعرض `<AgentSidebar>` لمنح كل شاشة وكيلًا قابلاً للتبديل، أو قم بتوصيل زر لتسليم مهمة معينة إلى الدردشة بدلاً من تشغيل مكالمة LLM لمرة واحدة.
 
-← [**Drop-in Agent**](/docs/drop-in-agent) - قم بتثبيت `<AgentPanel>` و`<AgentSidebar>` و`sendToAgentChat()` في أي تطبيق React.
-← [**Agent Surfaces**](/docs/agent-surfaces) - اختر ما إذا كان سير العمل يجب أن يكون بدون رأس، أو الدردشة أولاً، أو مضمنًا، أو تطبيقًا كاملاً.
-
 ## يمكنك استخدام واجهة خفيفة {#ui-light}
 
 لا يحتاج كل تطبيق إلى لوحة تحكم كاملة. عندما يكون الوكيل هو المنتج، يمكنك تخطي معظم UI المخصصة: افتح التطبيق، واطلب ما تريد، واترك الوكيل يقوم بالباقي. لا يزال لدى الوكيل سطح الإدارة الخاص به - السجل ومساحة العمل والإعدادات - ولكن التفاعل الأساسي هو المحادثة وليس النقرات.
 
-← [**Automation-First Apps**](/docs/pure-agent-apps) — تطبيقات بلا متصفح من أجل jobs وqueues وscripts وagents خارجية.
-
 ## يمكنك المشاركة في التحرير معه {#you-co-edit}
 
 عندما تعمل أنت والوكيل على نفس المستند، لا تتناوبان. من خلال التعاون في الوقت الفعلي، يتم بث تعديلات الوكيل جنبًا إلى جنب مع تعديلاتك - مؤشرات مباشرة، بدون استبدال - بنفس الطريقة التي يقوم بها زميل الفريق. يمكنك الاستمرار في الكتابة أثناء العمل، وسيرى التغييرات فور حدوثها.
 
-← [**Real-Time Collaboration**](/docs/real-time-collaboration) — تحرير تعاوني متعدد المستخدمين باستخدام المؤشرات المباشرة وتحريرات الوكيل في نفس المستند.
-
 ## ما هي الخطوة التالية {#whats-next}
 
 - [**Context Awareness**](/docs/context-awareness) — يعرف الوكيل ما تنظر إليه

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

@@ -9,6 +9,12 @@ description: "الإملاء الصوتي في مؤلف دردشة الوكيل
 
 يتعامل إطار العمل مع كل هذا تلقائيًا. يحصل المستخدمون المتصلون بـ Builder على Gemini Flash-Lite المستضاف على Builder افتراضيًا؛ وإلا يمكن للمستخدمين إحضار مفتاح الموفر الخاص بهم أو العودة إلى التعرف على الكلام في المتصفح.
 
+## وضع المحادثة الصوتية الفورية {#realtime-speech-mode}
+
+عند فتح الميكروفون، تتيح نافذة منبثقة الاختيار بين **محادثة صوتية فورية** و**إملاء قابل للتحرير**. يتطلب الوضع الفوري مفتاح `OPENAI_API_KEY` مخصصًا للمستخدم، ويوصل المتصفح بنموذج `gpt-realtime-2.1` عبر WebRTC. تنكمش الدردشة إلى كرة صوتية في الزاوية السفلية اليسرى؛ انقر على الكرة لإظهار الدردشة أو إخفائها من دون إنهاء المحادثة.
+
+يستخدم نموذج المحادثة الصوتية أدوات Agent Native المصادق عليها نفسها التي تستخدمها الدردشة، لذا يمكنه التنقل داخل التطبيق واستدعاء الإجراءات أثناء التحدث. تظل الإجراءات التي تتطلب موافقة معلقة حتى توافق عليها. لا يُخزن الصوت مطلقًا في SQL؛ يحتفظ Agent Native فقط بحالة موجزة للجلسة والنص المنسوخ. لا تتجاوز مدة الجلسة الفورية 60 دقيقة.
+
 ## كيفية العمل {#how-it-works}
 
 يسجل زر صوت الملحن الصوت في المتصفح، ثم يختار الموفر:

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

@@ -425,10 +425,9 @@ const brainCatalog = await listWorkspaceConnectionProviderCatalogForApp({
 
 ### إعداد طائرة التحكم في الإرسال
 
-يكشف Dispatch عن مستوى التحكم actions الذي يكتب نفس وظائف المتجر المشتركة التي يمكن للتطبيق الاتصال بها مباشرة:
+يكشف Dispatch عن إجراءات مستوى التحكم التي تكتب عبر وظائف المتجر المشتركة نفسها التي يمكن للتطبيق استدعاؤها مباشرة — إذ يتحقق إجراء `upsert-workspace-connection` من صحة الإدخال مقابل كتالوج الموفّرين، ثم يفوّض إلى `upsertWorkspaceConnection()` نفسها الموضحة في هذه الصفحة:
 
 ```ts
-// templates/dispatch/actions/upsert-workspace-connection.ts delegates to this.
 await upsertWorkspaceConnection({
   id: "team-slack",
   provider: "slack",
@@ -493,3 +492,11 @@ await upsertWorkspaceConnectionGrant({
 حافظ على الحدود صارمة: عرض بيانات تعريف الموفر آمن؛ تبقى قيم بيانات الاعتماد في المخزن.
 
 </details>
+
+## ما التالي {#whats-next}
+
+- [**Dispatch**](/docs/dispatch) — التطبيق الذي يدير عادةً إعداد اتصالات مساحة العمل والمخزن
+- [**الأمان**](/docs/security) — مخزن بيانات الاعتماد ونطاق الأسرار ونموذج الوصول الذي تشير إليه الاتصالات
+- [**التهيئة**](/docs/onboarding#checking-workspace-connections-in-onboarding) — التحقق من جاهزية الاتصال من قائمة إعداد القالب
+- [**عملاء MCP**](/docs/mcp-clients) — مشاركة بيانات اعتماد خادم MCP عبر مساحة العمل كنمط إعداد قابل لإعادة الاستخدام
+- [**Brain**](/docs/template-brain) — التطبيق المرجعي لصفحة مصادر الموفّرين المبنية على هذا النموذج

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

@@ -5,7 +5,11 @@ description: "تخصيص Claude على مستوى التعليمات البرم
 
 # مساحة العمل
 
-> **ما هو مستند مساحة العمل؟** تغطي هذه الصفحة **طبقة التخصيص** — ما هي مساحة العمل. للحصول على شكل النشر (مونوريبو واحد، العديد من التطبيقات) راجع [Multi-App Workspaces](/docs/multi-app-workspace)؛ بالنسبة للحوكمة (من يراجع ويوافق ويمتلك ماذا) راجع [Workspace Governance](/docs/workspace-management).
+<Callout tone="info">
+
+**ما هو مستند مساحة العمل؟** تغطي هذه الصفحة **طبقة التخصيص** — ما هي مساحة العمل. للحصول على شكل النشر (مونوريبو واحد، العديد من التطبيقات) راجع [Multi-App Workspaces](/docs/multi-app-workspace)؛ بالنسبة للحوكمة (من يراجع ويوافق ويمتلك ماذا) راجع [Workspace Governance](/docs/workspace-management).
+
+</Callout>
 
 يأتي كل تطبيق وكيل أصلي مزودًا بـ **مساحة عمل**: طبقة التخصيص التي تجعل الوكيل ملكًا لك. فهو يحتوي على تعليمات الفريق (`AGENTS.md`)، والتعلم المشترك (`LEARNINGS.md`)، والذاكرة المنظمة الشخصية (`memory/MEMORY.md`)، وskills الذي يسحبه الوكيل عند الطلب، والوكلاء الفرعيين المخصصين، والمهام المجدولة، وخوادم MCP المتصلة — كل ما تتوقعه من إعداد Claude Code / Codex.
 
@@ -82,7 +86,7 @@ description: "تخصيص Claude على مستوى التعليمات البرم
 | `CLAUDE.md` / skills لكل مشروع         | `AGENTS.md` لكل تطبيق + موارد ذاكرة مساحة العمل  |
 | تكوين MCP في ملف JSON                  | تكوين MCP في JSON _أو_ الإعدادات UI، لكل نطاق    |
 
-نفس الإمكانيات. اقتصاد مختلف. راجع [Templates](/docs/cloneable-saas) لمعرفة سبب أهمية ذلك بالنسبة إلى SaaS.
+نفس الإمكانيات. اقتصاد مختلف. راجع [التطبيقات](/docs/cloneable-saas) لمعرفة سبب أهمية ذلك بالنسبة إلى SaaS.
 
 ## نظرة عامة {#overview}
 
@@ -220,11 +224,9 @@ workspace context/brand.md
 -> personal context/brand.md
 ```
 
-اجعل ملفات `context/` قصيرة وواقعية — بضع نقاط يمكن للوكيل قراءتها:
-
-```text
-<!-- context/brand.md -->
+على سبيل المثال:
 
+```text filename="context/brand.md"
 # العلامة التجارية
 
 - Voice: direct, warm, concrete
@@ -389,15 +391,9 @@ Skills هي ملفات موارد Markdown ضمن مسار `skills/` (يفضل `
 
 استخدم الوكلاء المخصصين للتفويض داخل تطبيق واحد. استخدم الوكلاء المتصلين عندما تحتاج إلى الاتصال بتطبيق آخر عبر A2A.
 
-## @ وضع العلامات {#at-tagging}
-
-اكتب `@` في مدخلات الدردشة للإشارة إلى عناصر مساحة العمل. تظهر قائمة منسدلة عند المؤشر تعرض الوكلاء والملفات المطابقة. استخدم مفاتيح الأسهم للتنقل وEnter للاختيار. يظهر العنصر المحدد كشريحة مضمنة في الإدخال.
-
-عندما ترسل رسالة، يتم تمرير **الملفات/الموارد** كمراجع يمكن للوكيل قراءتها، ويعمل **الوكلاء المخصصون** محليًا باستخدام تعليمات ملفاتهم الشخصية، ويتم استدعاء **الوكلاء المتصلين** عبر A2A.
+## الإشارة بـ @ وأوامر / {#at-tagging}
 
-## / أوامر الشرطة المائلة {#slash-commands}
-
-اكتب `/` في بداية السطر لاستدعاء إحدى المهارات. تعرض القائمة المنسدلة skills المتاحة بأسمائها وأوصافها؛ يؤدي تحديد واحدة إلى إضافة شريحة مضمنة ويتضمن محتواها كسياق عند إرسال الرسالة. إذا لم يتم تكوين skills، فإن القائمة المنسدلة ترتبط بهذه المستندات.
+اكتب `@` في إدخال الدردشة للإشارة إلى وكيل أو ملف أو مورد، أو `/` لاستدعاء مهارة — يفتح كلاهما قائمة منسدلة عند المؤشر ويضيف شريحة مضمنة عند تحديد عنصر. راجع [إشارات الوكيل](/docs/agent-mentions) للآليات الكاملة (التوجيه و`MentionProvider` واختيار الوكيل الفرعي)، و[دليل المهارات](/docs/skills-guide) لمعرفة كيفية تأليف المهارات واكتشافها.
 
 ## وضع الكود مقابل وضع التطبيق {#dev-vs-prod}
 
@@ -417,10 +413,6 @@ Skills هي ملفات موارد Markdown ضمن مسار `skills/` (يفضل `
 
 راجع [Workspace Connections](/docs/workspace-connections) للتعرف على أمثلة التشغيل السريع والاتصال/المنح/بيانات الاعتماد API، وأمثلة Slack وHubSpot وGitHub الملموسة.
 
----
-
-# المرجع
-
 ## المورد API {#resource-api}
 
 يمكن إدارة الموارد من كود الخادم، actions، أو REST API.
@@ -464,3 +456,12 @@ pnpm action resource-write --path "notes/meeting.md" --content "# ملاحظات
 # حذف مورد
 pnpm action resource-delete --path "notes/old.md"
 ```
+
+## الخطوة التالية {#whats-next}
+
+- [**دليل المهارات**](/docs/skills-guide) — تأليف ملفات المهارات المشار إليها من `skills/` وتحديد نطاقها
+- [**إشارات الوكيل**](/docs/agent-mentions) — الآليات الكاملة لإشارات `@` وأوامر `/`
+- [**المهام المتكررة**](/docs/recurring-jobs) — جدولة المطالبات المنشأة من المهام المجدولة
+- [**حوكمة مساحة العمل**](/docs/workspace-management) — من يراجع تغييرات مساحة العمل ويوافق عليها ويمتلكها
+- [**مساحات العمل متعددة التطبيقات**](/docs/multi-app-workspace) — شكل النشر الذي تمتد إليه مساحة عمل واحدة
+- [**اتصالات مساحة العمل**](/docs/workspace-connections) — مشاركة بيانات اعتماد المزوّدين بين التطبيقات

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

@@ -11,7 +11,7 @@ Actions sind die einzige Quelle der Wahrheit für alles, was Ihre App tut. Defin
 - **Typsichere React-Hooks** – `useActionQuery("name")` und `useActionMutation("name")` im Frontend, Typen aus dem Schema abgeleitet.
 - **Imperative Client-Aufrufe** – `callAction("name", params)`, wenn ein Hook nicht passt.
 - **Framework-Transport** – wird automatisch vom Framework hinter diesen Hooks bereitgestellt und ist für externe HTTP-Clients verfügbar.
-- **Ein MCP-Tool** – verfügbar für benutzerdefinierte MCP-Apps von Claude, ChatGPT, Claude Desktop/Code, Cursor, Codex und alle anderen MCP-Clients.
+- **Ein MCP-Tool** – verfügbar für benutzerdefinierte MCP-Apps von Claude, ChatGPT, Claude Desktop/Code, Cursor, Codex und alle anderen MCP-Hosts.
 - **Ein A2A-Tool** – wird von anderen agentennativen Apps über A2A aufgerufen.
 - **Ein CLI-Befehl** – `pnpm action <name>` für Skripterstellung und Entwicklungsschleifen.
 
@@ -562,7 +562,7 @@ export default defineAction({
 });
 ```
 
-Behalten Sie `link` als Fallback für CLI- und Nicht-UI-MCP-Clients bei; Es ist auch das Startziel der Einbettung. Die Embed Bridge – die signierte Embed-Start-Sitzung, Transplantation vs. Controlled-Frame-Rendering, die `ui/*` Host Bridge, CSP und Height Clamping – ist Eigentum von [External Agents](/docs/external-agents#mcp-app-bridge).
+Behalten Sie `link` als Fallback für CLI- und Nicht-UI-MCP-Hosts bei; Es ist auch das Startziel der Einbettung. Die Embed Bridge – die signierte Embed-Start-Sitzung, Transplantation vs. Controlled-Frame-Rendering, die `ui/*` Host Bridge, CSP und Height Clamping – ist Eigentum von [External Agents](/docs/external-agents#mcp-app-bridge).
 
 ## Standard actions {#standard-actions}
 

package/corpus/core/docs/content/locales/de-DE/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/de-DE/agent-surfaces.mdx

@@ -141,8 +141,7 @@ pnpm install
 
 Definieren Sie dann den dauerhaften Betrieb:
 
-```ts
-// actions/summarize-week.ts
+```ts filename="actions/summarize-week.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -496,12 +495,11 @@ Halten Sie den Vertrag klein: Definieren Sie dauerhafte Operationen als actions,
 Widget-Ergebnisse, wenn der Chat umfangreiches UI benötigt, und Vollbildanzeigen nur hinzufügen, wenn Benutzer
 müssen persistente Objekte durchsuchen, vergleichen, konfigurieren oder zusammenarbeiten.
 
-## Verwandte Dokumente {#related-docs}
+## Wie geht es weiter? {#related-docs}
 
-- [Actions](/docs/actions) – Definieren Sie den Headless-Vorgang einmal.
-- [Native Chat-Oberfläche](/docs/native-chat-ui) – typisierte Aktionsergebnisse im Chat rendern.
-- [Drop-in Agent](/docs/drop-in-agent) – Chat-, Seitenleisten- oder Bedienfeldoberflächen bereitstellen.
-- [Component API](/docs/components) – React Chat-/Komponistenstücke auf niedrigerer Ebene.
-- [Embedding SDK](/docs/embedding-sdk) – Agent-Native zu einer vorhandenen App hinzufügen.
-- [External Agents](/docs/external-agents) – MCP-kompatible Hosts mit einer App verbinden.
-- [A2A Protocol](/docs/a2a-protocol) – Agenten von anderen Agenten anrufen.
+- [**Actions**](/docs/actions) – Definieren Sie den Vorgang einmal; jede Oberfläche oben ruft denselben auf
+- [**Native Chat-Oberfläche**](/docs/native-chat-ui) – Typisierte Aktionsergebnisse als Tabellen, Diagramme und Karten im Chat rendern
+- [**Generative UI**](/docs/generative-ui) – Temporäre oder persistierte Sandbox-UI direkt im Chat generieren
+- [**Automation-First Apps**](/docs/pure-agent-apps) – Das vollständige browserlose Muster für Jobs, Warteschlangen, Skripte und externe Agenten
+- [**External Agents**](/docs/external-agents) – MCP-kompatible Hosts mit einer App verbinden
+- [**A2A Protocol**](/docs/a2a-protocol) – Agenten aus anderen Agent-Native-Apps aufrufen

package/corpus/core/docs/content/locales/de-DE/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/de-DE/authentication.mdx

@@ -15,7 +15,7 @@ Auth wird automatisch über `autoMountAuth(app)` im Authentifizierungsserver-Plu
 - **Remote MCP OAuth:** Standard OAuth 2.1 für MCP-Hosts wie Claude-Code und ChatGPT-Anschlüsse.
 - **Benutzerdefiniert:** Bringen Sie Ihre eigene Authentifizierung über den `getSession`-Rückruf mit.
 
-<Diagram id="doc-block-1hpxy2j" title="Drei Wege rein, eine Sitzung" summary={"Browserbesucher, programmatische MCP-Clients und benutzerdefinierte Anbieter werden alle in dieselbe AuthSession aufgelöst, die das Downstream-Scoping liest."}>
+<Diagram id="doc-block-1hpxy2j" title="Drei Wege rein, eine Sitzung" summary={"Browserbesucher, MCP-Hosts und benutzerdefinierte Anbieter werden alle in dieselbe AuthSession aufgelöst, die das Downstream-Scoping liest."}>
 
 ```html
 <div class="auth-modes">

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

@@ -476,10 +476,12 @@ Aktion, damit UI und Agent die gleiche Funktion nutzen.
 ```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,
@@ -494,3 +496,11 @@ export default defineAction({
 Verwenden Sie stattdessen `sendToAgentChat({ background: true, openSidebar: false })`, wenn
 Die Arbeit erfordert Tools, Status, Überprüfbarkeit, Benutzersteuerung oder mehrere Schritte
 Begründung.
+
+## Wie geht es weiter {#whats-next}
+
+- [**Drop-in Agent**](/docs/drop-in-agent) — `<AgentSidebar>` und `<AgentPanel>` mit einer tutorialorientierten Einführung einbinden
+- [**Native Chat UI**](/docs/native-chat-ui) — der Action-Ergebnisvertrag hinter Daten-Widgets und benutzerdefinierten Renderern
+- [**Actions**](/docs/actions) — `defineAction()`, Schemas und die von diesen Komponenten aufgerufene Action-Oberfläche
+- [**Real-Time Collaboration**](/docs/real-time-collaboration) — Kollaborations-Hooks und Anwesenheitskomponenten im Detail
+- [**Sharing**](/docs/sharing) — Verdrahtung von `<ShareButton>` und `<ShareDialog>` für besitzbare Ressourcen

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

@@ -44,7 +44,6 @@ Jede Vorlage folgt dem gleichen allgemeinen Layout:
 <FileTree
   id="doc-block-153a4yn"
   title="Projektstruktur des Templates"
-  title="my-template/"
   entries={[
     {
       path: "app/",
@@ -172,8 +171,7 @@ Die vier Bereiche jeder Vorlage sind über eine gemeinsame Aktionsoberfläche un
 
 Definieren Sie Domänentabellen mit den Framework-Drizzle-Helfern, damit Schemata über SQLite, Postgres, D1, Turso, Supabase, Neon und andere unterstützte Backends hinweg portierbar bleiben:
 
-```ts
-// server/db/schema.ts
+```ts filename="server/db/schema.ts"
 import {
   table,
   text,
@@ -204,8 +202,7 @@ Schemaänderungen müssen additiv sein. Fügen Sie Tabellen und Spalten über `r
 
 Für App-Lese- und Schreibvorgänge verwenden Sie den Abfrage-Builder von Drizzle und die portablen Operatoren von `drizzle-orm`. Schreiben Sie keinen Produktcode mit rohem SQL, wenn Drizzle die Abfrage ausdrücken kann, und importieren Sie nicht aus `drizzle-orm/sqlite-core` oder `drizzle-orm/pg-core` in Vorlagen.
 
-```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 @@ Bevorzugen Sie für die App-Navigation einen `navigate`-Befehl, der einen gleich
 `path`, wenn URL bekannt ist. Schreiben Sie nicht auch `__set_url__` für denselben Zug;
 Dieser Schlüssel ist für die Framework-URL-Tools und nur URL-Filteränderungen reserviert.
 
-```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/de-DE/cross-app-sso.mdx

@@ -9,7 +9,11 @@ Jede gehostete App bei `*.agent-native.com` führt ihre eigene Bereitstellung mi
 
 Dies ist das gleiche Vertrauensprimitiv, das [A2A](/docs/a2a-protocol) und [External Agents](/docs/external-agents) bereits verwenden – ein `A2A_SECRET`-signiertes JWT, das an der Anforderungsgrenze überprüft wird – angewendet auf den menschlichen Anmeldepfad anstelle von Agent-zu-Agent-Aufrufen.
 
-> **Einheitliche Bereitstellung vs. Bereitstellung pro Domäne.** Wenn Sie alle Apps an einem Ursprung hosten (`your-agents.com/mail`, `your-agents.com/calendar`), erhalten Sie bereits eine gemeinsame Anmeldung über eine einzige Cookie-Domäne – kein Verbund erforderlich. Cross-App SSO ist nur erforderlich, wenn Apps auf separaten Domänen ausgeführt werden. Siehe [Multi-App Workspaces — Unified deploy](/docs/multi-app-workspace#deployment).
+<Callout tone="info">
+
+**Einheitliche Bereitstellung vs. Bereitstellung pro Domäne.** Wenn Sie alle Apps an einem Ursprung hosten (`your-agents.com/mail`, `your-agents.com/calendar`), erhalten Sie bereits eine gemeinsame Anmeldung über eine einzige Cookie-Domäne – kein Verbund erforderlich. Cross-App SSO ist nur erforderlich, wenn Apps auf separaten Domänen ausgeführt werden. Siehe [Multi-App Workspaces — Unified deploy](/docs/multi-app-workspace#deployment).
+
+</Callout>
 
 ## Was und warum {#what-why}
 
@@ -86,15 +90,17 @@ Der Ablauf ist eine standardmäßige Autorisierung → Signiertes Token → Rüc
 
 </Diagram>
 
-1. **App → Versenden (autorisieren).** Die App sendet den Benutzer an die Identitätsbehörde:
+1. **App → Dispatch (Autorisierung).** Die app-seitige Route `GET /_agent-native/identity/login` (auf die die Schaltfläche „Mit Agent-Native anmelden“ verweist) erstellt die Weiterleitung und sendet den Benutzer an die Identitätsautorität:
 
-   ```
+   ```http
    GET https://dispatch.agent-native.com/_agent-native/identity/authorize
        ?app=<requesting-app>
        &redirect_uri=<app-callback-url>
        &state=<csrf-state>
    ```
 
+   `redirect_uri` ist die app-eigene Route `GET /_agent-native/identity/callback` – die Route, die in Schritt 3 das signierte Token empfängt.
+
 <Endpoint id="cross-app-sso-identity-authorize-de-de" title="Identity Authorize Endpoint" method="GET" path="/_agent-native/identity/authorize" summary={"Dispatch (Identitätsbehörde) authentifiziert den Menschen und leitet ihn mit einem signierten Identitätstoken zurück"} auth="Sitzung weiterleiten (interaktive Anmeldung, falls keine)" params={[
   {
     "name": "app",
@@ -143,7 +149,7 @@ Der Ablauf ist eine standardmäßige Autorisierung → Signiertes Token → Rüc
    | `scope`      | Immer `"identity"` – dieses Token autorisiert nur die Anmeldung                  |
    | `exp`        | **≤ 2 Minuten** ab Problem                                                       |
 
-4. **App verifiziert und JIT-Links per E-Mail.** Die App überprüft die Token-Signatur mit ihrem eigenen `A2A_SECRET`, überprüft `scope: "identity"` und `exp` und führt dann **Just-in-Time-Verknüpfung ausschließlich per verifizierter E-Mail** durch:
+4. **Die App überprüft und verknüpft Just-in-Time per E-Mail.** Die Route `GET /_agent-native/identity/callback` überprüft die Token-Signatur mit `A2A_SECRET`, prüft `scope: "identity"` und `exp` und führt dann **Just-in-Time-Verknüpfung ausschließlich anhand der verifizierten E-Mail-Adresse** durch:
    - Wenn ein lokaler Benutzer mit dieser E-Mail existiert → unverändert wiederverwenden.
    - Wenn nicht → erstellen Sie einen lokalen Benutzer für diese E-Mail.
 
@@ -290,9 +296,13 @@ Sobald eine App verifiziert ist, wiederholen Sie die Schritte 2–3 für die nä
 **5. Rollback = Deaktivieren Sie die Umgebungsvariable bei der Bereitstellung dieser App.**
 Um eine App zurückzusetzen, **entfernen Sie `AGENT_NATIVE_IDENTITY_HUB_URL` aus der Umgebung dieser App und stellen Sie sie erneut bereit/starten Sie sie neu.** Die App kehrt sofort zu ihrem vorherigen Authentifizierungsverhalten zurück. Es gibt **keine Datenänderung, die rückgängig gemacht werden kann** – Identitätszeilen wurden immer nur hinzugefügt, und das Deaktivieren der Variablen macht den Verbundpfad einfach wieder in den Ruhezustand. Die Umstellung und das Rollback jeder App sind unabhängig und umkehrbar.
 
-> Beim Rollout werden Benutzer abgemeldet, wenn jede App aktiviert wird (sie authentifizieren sich erneut über Dispatch), aber sie melden sich immer wieder beim **gleichen E-Mail-abgeglichenen Konto mit intakten Daten** an, da Identitätszeilen nie zerstört oder umbenannt, sondern nur hinzugefügt werden.
+<Callout tone="info">
+
+Beim Rollout werden Benutzer abgemeldet, wenn jede App aktiviert wird (sie authentifizieren sich erneut über Dispatch), aber sie melden sich immer wieder beim **gleichen E-Mail-abgeglichenen Konto mit intakten Daten** an, da Identitätszeilen nie zerstört oder umbenannt, sondern nur hinzugefügt werden.
+
+</Callout>
 
-## Verwandt {#related}
+## Wie geht es weiter? {#whats-next}
 
 - [Authentication](/docs/authentication) – lokale Authentifizierungsmodi, Sitzungen, Organisationen, die `A2A_SECRET`-Umgebungsvariable.
 - [A2A Protocol](/docs/a2a-protocol) – das signierte JWT-Vertrauensmodell mit Überprüfung an der Grenze, das hier wiederverwendet wird.

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

@@ -452,3 +452,11 @@ Weitere Informationen zum eingebetteten Agent-Panel im Vergleich zu Cloud-Frame-
 ## Mehrinstanzbereitstellungen {#multi-instance}
 
 Agent-native Apps speichern den gesamten Status in SQL über Drizzle und synchronisieren den UI über [polling](/docs/key-concepts#polling-sync) mit der Datenbank – kein Dateisystemstatus, keine Sticky Sessions, keine In-Memory-Caches. Das bedeutet, dass Bereitstellungen mit mehreren Instanzen und serverlosen Bereitstellungen sofort funktionieren: Richten Sie jede Instanz auf denselben `DATABASE_URL` und sie konvergieren automatisch. Siehe [Key Concepts — Data in SQL](/docs/key-concepts#data-in-sql) und [Portability](/docs/key-concepts#hosting-agnostic).
+
+## Wie geht es weiter?
+
+- [**Database**](/docs/database#production) — Wählen Sie vor der ersten Produktionsbereitstellung ein persistentes SQL-Backend
+- [**Security**](/docs/security) — Die Produktionscheckliste und die auf dieser Seite erwähnten Opt-in-Flags
+- [**Authentication**](/docs/authentication) — OAuth-Anmeldedaten und Umgebungsvariablen für den gewählten Authentifizierungsmodus
+- [**Multi-App Workspace**](/docs/multi-app-workspace) — Das Workspace-Modell hinter dem Single-Origin-Build von `deploy`
+- [**Frames**](/docs/frames) — Das eingebettete Agent-Panel gegenüber dem Cloud-Frame von Builder.io für UI-Änderungen in der Produktion

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

@@ -136,13 +136,9 @@ Snapshot, bis Sie ihn erneut aktualisieren/überprüfen, also scannen Sie den Co
 Tool- oder MCP-App-Metadatenänderungen. Wenn Sie noch alte Pro-App-Konnektoren haben
 neben Dispatch aktiviert, jeden veralteten Connector aktualisieren oder erneut verbinden; Aktualisierung
 Dispatch schreibt den zwischengespeicherten Kalender/Mail/usw. von ChatGPT oder Claude nicht neu.
-Schnappschüsse. Die Bereiche sind:
-
-| Geltungsbereich | Was es ermöglicht                                        |
-| --------------- | -------------------------------------------------------- |
-| `mcp:read`      | Schreibgeschützte Tools und Tool-/Ressourcenerkennung    |
-| `mcp:write`     | Entwurf, Aktualisierung und andere Änderungen actions    |
-| `mcp:apps`      | Inline-MCP-Apps, Diagramme, Dashboards, Entwürfe und UIs |
+Schnappschüsse. Die Bereiche `mcp:read` / `mcp:write` / `mcp:apps` sind
+dieselben, die unten unter [Standard-OAuth für Remote-MCP](#standard-oauth)
+beschrieben werden.
 
 Cursor, Goose, Postman, MCPJam und VS Code GitHub Copilot verwenden dieselbe Fernbedienung
 MCP URL über ihre eigenen MCP-Server UIs, wenn ihr Build Remote-OAuth unterstützt

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

@@ -11,11 +11,9 @@ Wie agentennative Apps unter der Haube funktionieren – die Prinzipien und die
 
 Bei jeder agentennativen App arbeiten drei Dinge zusammen:
 
-> **Agent** – Autonome KI, die Daten liest, Daten schreibt, actions ausführt und Code ändert. Anpassbar mit skills und Anleitung.
->
-> **Anwendung** – Die Produktoberfläche um den Agenten. Dabei kann es sich zunächst um einen reinen Aktionsmodus, einen umfassenden Chat, eine kleine Steuerungsebene oder um eine vollständige React-UI mit Dashboards, Abläufen und Visualisierungen handeln.
->
-> **Computer** – Datenbank, Browser, Codeausführung. Agenten arbeiten direkt mit SQL und integrierten Tools; MCP-Server sind optionale Add-Ons, nicht die Grundlage.
+- **Agent** – Autonome KI, die Daten liest, Daten schreibt, actions ausführt und Code ändert. Anpassbar mit skills und Anleitung.
+- **Anwendung** – Die Produktoberfläche um den Agenten. Dabei kann es sich zunächst um einen reinen Aktionsmodus, einen umfassenden Chat, eine kleine Steuerungsebene oder um eine vollständige React-UI mit Dashboards, Abläufen und Visualisierungen handeln.
+- **Computer** – Datenbank, Browser, Codeausführung. Agenten arbeiten direkt mit SQL und integrierten Tools; MCP-Server sind optionale Add-Ons, nicht die Grundlage.
 
 <Diagram id="doc-block-1lep3dk" title="Agent, Anwendung und Computer" summary={"Drei Ebenen arbeiten über einen gemeinsamen SQL-Speicher zusammen. Der Agent und die Anwendung lesen und schreiben dieselben Daten."}>
 
@@ -278,8 +276,7 @@ Warum nicht einen LLM inline aufrufen?
 
 Wenn der Agent etwas Komplexes tun muss – einen API aufrufen, Daten verarbeiten, die Datenbank abfragen – führt er eine **Aktion** aus. Actions sind TypeScript-Dateien in `actions/`, die ein Standard-`defineAction()` exportieren:
 
-```ts
-// actions/fetch-data.ts
+```ts filename="actions/fetch-data.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -381,9 +378,8 @@ Ein _Frame_ ist die Umgebung, die den Agenten neben Ihrer App hostet – lokal i
 
 Agent-native Apps umfassen ein eingebettetes Agent-Panel, das den KI-Agenten neben der App UI bereitstellt. Dadurch funktioniert die Architektur: Der Agent benötigt einen Computer (Datenbank, Browser, Codeausführung) und die App benötigt den Agenten für die KI-Arbeit.
 
-> **Embedded Agent Panel** – Chat und optionales CLI-Terminal in jede App integriert. Unterstützt Claude-Code, Codex, Gemini, OpenCode und Builder.io. Läuft lokal. Kostenlos und Open Source.
->
-> **Cloud** – Bereitstellung in jeder Cloud mit Echtzeit-Zusammenarbeit, visueller Bearbeitung, Rollen und Berechtigungen. Am besten für Teams.
+- **Embedded Agent Panel** – Chat und optionales CLI-Terminal in jede App integriert. Unterstützt Claude-Code, Codex, Gemini, OpenCode und Builder.io. Läuft lokal. Kostenlos und Open Source.
+- **Cloud** – Bereitstellung in jeder Cloud mit Echtzeit-Zusammenarbeit, visueller Bearbeitung, Rollen und Berechtigungen. Am besten für Teams.
 
 ## Kontextbewusstsein {#context-awareness}
 
@@ -455,14 +451,11 @@ Die Übernahme des Frameworks ist vor allem deshalb wertvoll, weil Sie nichts me
 
 Das ist das „und alles andere“, was Sie sonst selbst zusammenkleben würden.
 
-## Tieftauchgänge {#deep-dives}
-
-Detaillierte Anleitungen zu bestimmten Mustern:
+## Wie geht es weiter? {#deep-dives}
 
-- [What Is Agent-Native?](/docs/what-is-agent-native) – die Vision und Philosophie
-- [Context Awareness](/docs/context-awareness) – Navigationsstatus, Bildschirmansicht, Navigationsbefehle
-- [Skills Guide](/docs/skills-guide) – Framework skills, Domäne skills, benutzerdefiniertes skills erstellen
-- [Native Chat-Oberfläche](/docs/native-chat-ui) – aktionsdeklarierte Tabellen, Diagramme und BYO-Laufzeitstatus
-- [Agent Surfaces](/docs/agent-surfaces) – Headless, Rich Chat, eingebetteter Sidecar und vollständige App-Pfade
-- [A2A Protocol](/docs/a2a-protocol) – Agent-zu-Agent-Kommunikation
-- [Multi-App Workspace](/docs/multi-app-workspace) – Hosten Sie viele Apps in einem Monorepo mit gemeinsamer Authentifizierung, skills, Komponenten und Anmeldeinformationen
+- [**What Is Agent-Native?**](/docs/what-is-agent-native) — Die Vision und Philosophie hinter diesen Regeln
+- [**Context Awareness**](/docs/context-awareness) — Navigationsstatus sowie view-screen- und navigate-Befehle im Detail
+- [**Skills Guide**](/docs/skills-guide) — Framework-Skills, Domänen-Skills und das Erstellen eigener Skills
+- [**Native Chat UI**](/docs/native-chat-ui) — Von Actions deklarierte Tabellen, Diagramme und die Haltung zu eigenen Laufzeiten
+- [**Agent Surfaces**](/docs/agent-surfaces) — Chat, native Inline-UI, vollständige App-Seiten, eingebettete Sidecars, Automatisierung und externe Agentenpfade
+- [**A2A Protocol**](/docs/a2a-protocol) — Agent-zu-Agent-Kommunikation

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

@@ -17,7 +17,7 @@ Ein neues `npx @agent-native/core@latest create`-Gerüst wird bereits geliefert
 - **Organisationswechsel** – die Sitzung verfolgt die aktive Organisation (`session.orgId`) und durch den Wechsel werden die Daten geändert, die der Benutzer und der Agent sehen.
 - **Datenisolierung pro Organisation** – jede Abfrage wird automatisch auf die aktive Organisation beschränkt.
 
-Wenn Sie Agent-nativ für ein CRM, einen Projekt-Tracker, einen Support-Posteingang oder ein anderes Team-Tool evaluieren, ist die mandantenfähige Grundlage bereits vorhanden. Alle Erstanbieter-Vorlagen sind mehrmandantenfähig – die Liste finden Sie unter [Cloneable SaaS templates](/docs/cloneable-saas).
+Wenn Sie Agent-nativ für ein CRM, einen Projekt-Tracker, einen Support-Posteingang oder ein anderes Team-Tool evaluieren, ist die mandantenfähige Grundlage bereits vorhanden. Alle Erstanbieter-Vorlagen sind mehrmandantenfähig – die Liste finden Sie unter [Vorlagen](/docs/cloneable-saas).
 
 <Diagram id="doc-block-5xksqg" title="Org-Mitgliedschaft und Isolation" summary={"Benutzer treten Organisationen als owner/admin/member bei. Jede besitzbare Zeile trägt den org_id des Mandanten, der sie besitzt, und keine Zeile verliert über die Grenze hinweg."}>
 
@@ -117,8 +117,8 @@ Mandantendaten werden durch eine `org_id`-Spalte isoliert (hinzugefügt von `own
 
 Dies ist dieselbe Pipeline, die für die Festlegung des Bereichs pro Benutzer verwendet wird. Informationen zur Mechanik auf SQL-Ebene, zum `ownableColumns()`-Vertrag und zu den Wachen `accessFilter` / `resolveAccess` / `assertAccess` finden Sie unter [Security → Data Scoping](/docs/security#data-scoping) – die einzige Quelle der Wahrheit für die Scoping-Pipeline.
 
-## Verwandte Dokumente {#related}
+## Wie geht es weiter? {#related}
 
-- [Authentication](/docs/authentication#organizations) – Sitzungen, soziale Anbieter und die Organisationsverwaltungsoberfläche
-- [Security → Data Scoping](/docs/security#data-scoping) – Isolation auf SQL-Ebene, der `ownableColumns()`-Vertrag und Zugriffsschutz
-- [Multi-App Workspace](/docs/multi-app-workspace) – Hosten mehrerer agentennativer Apps in einem Monorepo mit gemeinsamer Authentifizierung und RBAC
+- [**Authentication**](/docs/authentication#organizations) — Sitzungen, soziale Anbieter und die Organisationsverwaltungsoberfläche
+- [**Security — Data Scoping**](/docs/security#data-scoping) — Isolation auf SQL-Ebene, der `ownableColumns()`-Vertrag und Zugriffsschutz
+- [**Multi-App Workspace**](/docs/multi-app-workspace) — Hosten mehrerer Agent-Native-Apps in einem Monorepo mit gemeinsamer Authentifizierung und RBAC

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

@@ -113,6 +113,7 @@ Der Schweregrad steuert den Badge-Stil im Dropdown-Menü und wird an die Kanäle
 | `inbox`   | Bleibt in der `notifications`-Tabelle; treibt die Glocke an UI | Immer an – Teil des Grundelements.                                   |
 | `webhook` | POST JSON zu einem konfigurierten URL                          | `NOTIFICATIONS_WEBHOOK_URL` Umgebungsvariable beim Start festgelegt. |
 
+E-Mail, Slack und Webhook werden neben dem Posteingang immer registriert. Bei der Zustellung werden zuerst die URL bzw. Empfänger aus den Metadaten der Benachrichtigung verwendet und dann die passende Umgebungsvariable. Ist beides nicht festgelegt, führt der Kanal bei der Ausgabe nichts aus.
 Der Webhook-Kanal löst `${keys.NAME}`-Referenzen sowohl im URL als auch im `NOTIFICATIONS_WEBHOOK_AUTH` anhand des Ad-hoc-[secrets](/docs/security) des Eigentümers auf, sodass der Rohwert niemals in den Kontext des Agenten gelangt. Es werden URL-Zulassungslisten pro Schlüssel erzwungen – dieselbe Regel, die das Automatisierungstool `web-request` verwendet.
 
 <Diagram id="doc-block-za29cd" title={"Kanäle und Schweregrad"} summary={"Der Posteingang ist immer aktiviert. Webhook benötigt eine Umgebungsvariable; Benutzerdefinierte Kanäle werden beim Start registriert. Der Schweregrad bestimmt die Gestaltung des Abzeichens und wird an alle Kanäle weitergegeben."}>
@@ -203,7 +204,7 @@ await notify(
 
 Registrieren Sie einen benutzerdefinierten Kanal von einem beliebigen Server-Plugin.
 
-```ts
+```ts filename="server/plugins/notifications-slack-ops.ts"
 import { registerNotificationChannel } from "@agent-native/core/notifications";
 
 registerNotificationChannel({
@@ -274,15 +275,15 @@ interface NotificationMeta {
 
 Wird durch das Core-Routes-Plugin bei `/_agent-native/notifications/*` gemountet. Alle Routen beziehen sich auf die E-Mail-Adresse der authentifizierten Sitzung.
 
-| Methode  | Pfad                                                |
-| -------- | --------------------------------------------------- |
-| `GET`    | `/_agent-native/notifications?unread=true&limit=50` |
-| `GET`    | `/_agent-native/notifications/count`                |
-| `POST`   | `/_agent-native/notifications/:id/read`             |
-| `POST`   | `/_agent-native/notifications/read-all`             |
-| `DELETE` | `/_agent-native/notifications/:id`                  |
+| Methode  | Pfad                                                           |
+| -------- | -------------------------------------------------------------- |
+| `GET`    | `/_agent-native/notifications?unread=true&limit=50&before=ISO` |
+| `GET`    | `/_agent-native/notifications/count`                           |
+| `POST`   | `/_agent-native/notifications/:id/read`                        |
+| `POST`   | `/_agent-native/notifications/read-all`                        |
+| `DELETE` | `/_agent-native/notifications/:id`                             |
 
-<Endpoint id="doc-block-fro2p7" title="Benachrichtigungen auflisten" summary={"The route behind listNotifications() — scoped to the authenticated session's email."} method="GET" path={"/_agent-native/notifications?unread=true&limit=50"} summary={"Letzte Benachrichtigungen für den aktuellen Benutzer auflisten"} auth={"Authenticated session; results are scoped to the session's email."} params={[
+<Endpoint id="doc-block-fro2p7" title="Benachrichtigungen auflisten" method="GET" path={"/_agent-native/notifications?unread=true&limit=50&before=ISO"} summary={"Letzte Benachrichtigungen für den aktuellen Benutzer auflisten"} auth={"Authenticated session; results are scoped to the session's email."} params={[
   {
     "name": "unread",
     "in": "query",
@@ -296,6 +297,13 @@ Wird durch das Core-Routes-Plugin bei `/_agent-native/notifications/*` gemountet
     "type": "number",
     "required": false,
     "description": "Max rows to return."
+  },
+  {
+    "name": "before",
+    "in": "query",
+    "type": "string",
+    "required": false,
+    "description": "ISO-Zeitstempel-Cursor – gibt für die Seitennavigation Benachrichtigungen zurück, die vor diesem Zeitpunkt erstellt wurden."
   }
 ]} responses={[
   {
@@ -308,7 +316,7 @@ Wird durch das Core-Routes-Plugin bei `/_agent-native/notifications/*` gemountet
 
 ## UI-Komponente {#ui}
 
-```tsx
+```tsx filename="app/components/HeaderBar.tsx"
 import { NotificationsBell } from "@agent-native/core/client/notifications";
 
 export function HeaderBar() {

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

@@ -51,8 +51,11 @@ Ein `Processor` ist ein schleifeninterner **Beobachter/Leitplanke** für den Age
 
 </Diagram>
 
-> [!WARNING]
-> Ein Prozessor ist eine **Konfiguration**, kein Werkzeug, keine Aktion und kein Authoring DSL. Prozessoren beobachten nur, verändern ihren eigenen Stream-Scope-Status und `abort()`. Sie definieren niemals das App-Verhalten, ersetzen actions oder erscheinen im Modell. App-Vorgänge gehören zu [actions](/docs/actions).
+<Callout id="doc-block-proc1cfg" tone="warning">
+
+Ein Prozessor ist eine **Konfiguration**, kein Werkzeug, keine Aktion und kein Authoring DSL. Prozessoren beobachten nur, verändern ihren eigenen Stream-Scope-Status und `abort()`. Sie definieren niemals das App-Verhalten, ersetzen actions oder erscheinen im Modell. App-Vorgänge gehören zu [actions](/docs/actions).
+
+</Callout>
 
 ## Die Haken {#hooks}
 
@@ -133,10 +136,13 @@ await runAgentLoop({
 
 **Kein Overhead, wenn nicht verwendet.** Die Schleife baut die Prozessorkette nur auf, wenn mindestens ein Prozessor bereitgestellt wird; Wenn `processors` weggelassen oder leer ist, wird keiner der Nahtcodes ausgeführt und die Schleife bleibt Byte für Byte unverändert. Hooks werden in der Reihenfolge der Registrierung ausgeführt und können synchron oder asynchron sein.
 
-> [!NOTE]
-> Der Loop-Level-Seam ist heute lieferbar und kann direkt von Subagenten, A2A, MCP und Tests aufgerufen werden. Das Einfädeln von `processors` durch den HTTP-Chat-Handler (damit ein Pro-Request-Resolver sie konfigurieren kann, ohne `runAgentLoop` direkt aufzurufen) ist eine praktische Installation, die noch nicht verkabelt ist – konfigurieren Sie Prozessoren vorerst an der `runAgentLoop`-Aufrufseite.
+<Callout id="doc-block-proc1note" tone="info">
+
+Der Loop-Level-Seam ist heute lieferbar und kann direkt von Subagenten, A2A, MCP und Tests aufgerufen werden. Das Einfädeln von `processors` durch den HTTP-Chat-Handler (damit ein Pro-Request-Resolver sie konfigurieren kann, ohne `runAgentLoop` direkt aufzurufen) ist eine praktische Installation, die noch nicht verkabelt ist – konfigurieren Sie Prozessoren vorerst an der `runAgentLoop`-Aufrufseite.
+
+</Callout>
 
-## Verwandt
+## Wie geht es weiter
 
 - [**Durable Resume**](/docs/durable-resume) – wie die Schleife Unterbrechungen übersteht, ohne abgeschlossene Nebenwirkungen erneut auszuführen.
 - [**Custom Agents & Teams**](/docs/agent-teams) – Subagenten führen dieselbe Schleife aus und können ihre eigenen Prozessoren tragen.