@agent-native/core 0.100.1 → 0.101.2

package/corpus/README.md

@@ -27,5 +27,5 @@ rg -n "defineAction|useActionQuery" node_modules/@agent-native/core/corpus
 
 ## Generated Counts
 
-- core files: 2255
-- template files: 5587
+- core files: 2258
+- template files: 5620

package/corpus/core/CHANGELOG.md

@@ -1,5 +1,78 @@
 # @agent-native/core
 
+## 0.101.2
+
+### Patch Changes
+
+- 616e2b9: Copying an assistant message now preserves formatting when pasting into apps
+  that read rich clipboard content (e.g. Slack), while still pasting as markdown
+  in editors like Notion. Falls back to plain-text copy where the browser does
+  not support rich clipboard writes.
+
+## 0.101.1
+
+### Patch Changes
+
+- f25194e: Keep centered chat composer skeletons aligned with the real composer while the chat UI loads.
+- f25194e: Document PR Visual Recap's cost drivers and cheaper model options (`claude-haiku-4-5`, `gpt-5.6-luna`/`gpt-5.6-terra`, `openai-compatible` providers), and note that the Claude backend now defaults to `claude-sonnet-5` when `VISUAL_RECAP_MODEL` is unset. Adds a matching cost/model-choice section to the Visual Plans template doc.
+- f25194e: Fail closed when first-party scaffolds cannot be downloaded from the CLI's immutable core version tags instead of mixing newer templates with an older runtime.
+- f25194e: Expose the embedded OG font resolver so template social images keep their text visible in serverless runtimes.
+- f25194e: Stop agent turns from looping across alternating read-only docs and source search tools.
+- f25194e: Publish PR Visual Recap helpers as a dependency-light CLI package so recap workflows no longer install the full Agent-Native framework dependency graph.
+- Updated dependencies [f25194e]
+- Updated dependencies [f25194e]
+- Updated dependencies [f25194e]
+  - @agent-native/recap-cli@0.3.0
+
+## 0.101.0
+
+### Minor Changes
+
+- fb281f4: Export first-class A2A auth primitives for the HTTP action route so workspaces
+  stop reaching into core internals:
+  - `verifyA2AToken` (and `A2ATokenPayload`) from `@agent-native/core/a2a` — the
+    same verifier the `/_agent-native/a2a` endpoint uses, including org-level
+    fallback secrets. Apps no longer need to reimplement a partial HS256 verifier.
+  - `AGENT_RUN_OWNER_CONTEXT_KEY`, `seedAgentRunOwnerContext`, and
+    `AgentRunOwnerContext` from `@agent-native/core/server` — a typed contract for
+    pre-seeding the resolved caller, replacing the hardcoded context-key string.
+  - A new `actionRouteAuth` option on `createAgentChatPlugin` (and `ActionRouteAuthAdapter`
+    / `actionRouteAuth` on `mountActionRoutes`). Its `resolveCaller` runs before
+    the `getSession` chain on `/_agent-native/actions/*`, letting apps accept A2A
+    JWTs declaratively instead of intercepting Nitro's `request` hook. Returning
+    `null` defers to the existing framework auth chain; throwing hard-rejects the
+    request with a 401 so an invalid credential can't fall through to a
+    same-origin session cookie. A resolved caller's org comes exclusively from
+    the verified credential — the adapter-returned `orgId`
+    (`ActionRouteResolvedCaller`) or the owner-email membership lookup — never
+    from ambient session/org cookie state, so a request carrying both a valid
+    A2A bearer and an unrelated browser cookie can't execute under the cookie
+    user's org. A2A writes stay org-scoped.
+
+  All additive — existing callers are unaffected.
+
+## 0.100.4
+
+### Patch Changes
+
+- f2ed084: Add public-safe review reads and client gating, root-thread agent routing, durable resolution notes, and capability-aware review panels.
+
+## 0.100.3
+
+### Patch Changes
+
+- a6742d1: Publish PR Visual Recap helpers as a dependency-light CLI package so recap workflows no longer install the full Agent-Native framework dependency graph.
+- Updated dependencies [a6742d1]
+  - @agent-native/recap-cli@0.2.0
+
+## 0.100.2
+
+### Patch Changes
+
+- f8cf755: Add a native local-runtime sign-in handoff for Codex-backed ChatGPT subscriptions in Agent composer surfaces.
+- f8cf755: Fix Slack integration fallbacks and link replies directly to Dispatch chat threads.
+- f8cf755: Keep workspace-shared app secrets decryptable across sibling apps.
+
 ## 0.100.1
 
 ### Patch Changes

package/corpus/core/docs/content/locales/ar-SA/pr-visual-recap.mdx

@@ -102,13 +102,13 @@ PR Visual Recap هو إجراء GitHub يحول كل طلب سحب إلى **مر
 npx @agent-native/core@latest skills add visual-plan --with-github-action
 ```
 
-يؤدي ذلك إلى تثبيت مهارة `visual-plan` (والتي تتضمن مهارة `visual-recap` التي يتم تشغيلها) ويكتب `.github/workflows/pr-visual-recap.yml` في الريبو الخاص بك. يستدعي سير العمل **الأوامر الفرعية CLI المنشورة** من خلال `npx @agent-native/core@latest recap <subcommand>` — بما في ذلك `gate` و`collect-diff` و`block-reference` و`scan` و`build-prompt` و`publish` و`shot` و`comment` و`check` و `usage` - لذلك لا يتم نسخ أي شيء إلى الريبو الخاص بك كنصوص برمجية مساعدة. `setup` و`doctor` هما المساعدان التفاعليان اللذان تقومان بتشغيلهما محليًا؛ `gate` هي خطوة بوابة الأمان التي يتم تشغيلها في سير العمل قبل كل ملخص.
+يؤدي ذلك إلى تثبيت مهارة `visual-plan` (والتي تتضمن مهارة `visual-recap` التي يتم تشغيلها) ويكتب `.github/workflows/pr-visual-recap.yml` في الريبو الخاص بك. يستدعي سير العمل **الأوامر الفرعية CLI المنشورة** من خلال `npx @agent-native/recap-cli@latest recap <subcommand>` — بما في ذلك `gate` و`collect-diff` و`block-reference` و`scan` و`build-prompt` و`publish` و`shot` و`comment` و`check` و `usage` - لذلك لا يتم نسخ أي شيء إلى الريبو الخاص بك كنصوص برمجية مساعدة. `setup` و`doctor` هما المساعدان التفاعليان اللذان تقومان بتشغيلهما محليًا؛ `gate` هي خطوة بوابة الأمان التي يتم تشغيلها في سير العمل قبل كل ملخص.
 
 ثم قم بتشغيل مساعد الإعداد الموجه:
 
 ```bash
-npx @agent-native/core@latest recap setup
-npx @agent-native/core@latest recap doctor
+npx @agent-native/recap-cli@latest recap setup
+npx @agent-native/recap-cli@latest recap doctor
 ```
 
 يقوم `recap setup` بتحديث سير العمل، ويستخدم `gh` لتعيين GitHub Actions
@@ -118,7 +118,7 @@ npx @agent-native/core@latest recap doctor
 ملف سير العمل الذي تم إنشاؤه وافتح PR لمشاهدته قيد التشغيل.
 
 افتراضيًا، ينشئ سير العمل موجه الوكيل الخاص به من أحدث حزمة
-إرشادات `visual-recap` في `@agent-native/core@latest`، بما في ذلك أي شقيق
+إرشادات `visual-recap` في `@agent-native/recap-cli@latest`، بما في ذلك أي شقيق
 الملفات المرجعية التي تأتي معها المهارة. إذا تم تخصيص الريبو الخاص بك عن قصد و
 يثبت مجلد `visual-recap` المخصص له، ويضبط متغير المستودع
 `VISUAL_RECAP_SKILL_SOURCE=repo`.
@@ -135,8 +135,8 @@ npx @agent-native/core@latest recap doctor
 علامات الاقتباس في JSON مطلوبة. تحدد هذه القيمة مشغّل مهمة `recap` الكاملة. لتكوينه أثناء الإعداد الموجّه، مرّر قيمة JSON نفسها إلى `--runs-on`، ثم تحقق من سير العمل وتوفر المشغّل باستخدام `doctor`:
 
 ```bash
-npx @agent-native/core@latest recap setup --runs-on '["self-hosted","linux","x64","visual-recap"]'
-npx @agent-native/core@latest recap doctor
+npx @agent-native/recap-cli@latest recap setup --runs-on '["self-hosted","linux","x64","visual-recap"]'
+npx @agent-native/recap-cli@latest recap doctor
 ```
 
 تستخدم بوابة الأمان الخفيفة `ubuntu-latest` بشكل منفصل. يمكن للمستودعات التي تعطل مشغّلات GitHub المستضافة ضبط `VISUAL_RECAP_GATE_RUNS_ON` على تسمية نصية واحدة بلا JSON، أو استخدام `--gate-runs-on visual-recap-gate`. تُستخدم التسمية المخصصة فقط لمؤلفي `OWNER` أو `MEMBER` أو `COLLABORATOR` من المستودع نفسه؛ تُفرض `ubuntu-latest` على الفروع والمؤلفين الآخرين وقد تبقى عملياتهم بلا جدولة عند تعطيل مشغّلات GitHub المستضافة. استخدم مشغّلًا مخصصًا ويفضل أن يكون مؤقتًا؛ لا تسحب البوابة القياسية شجرة PR وتقيّم منطق سير العمل وبيانات PR الوصفية.
@@ -160,12 +160,30 @@ npx @agent-native/core@latest recap doctor
 
 خارج الواجهة الخلفية، يوجد متغيران في المستودع يضبطان _كيف_ يعمل الوكيل:
 
-- **`VISUAL_RECAP_MODEL`** يثبت النموذج الذي تم تمريره إلى CLI (`--model`) — على سبيل المثال `gpt-5.6-sol` لـ Codex، أو معرف نموذج Claude. اتركه بدون ضبط لاستخدام النموذج الافتراضي الخاص بـ CLI.
+- **`VISUAL_RECAP_MODEL`** يثبت النموذج الذي يتم تمريره إلى CLI (`--model`) — على سبيل المثال `gpt-5.6-luna` لـ Codex، أو معرف نموذج Claude، أو `deepseek-chat` لـ DeepSeek. وهو مطلوب لـ `openai-compatible`. بالنسبة للواجهة الخلفية **Claude**، فإن تركه بدون ضبط يستخدم الآن `claude-sonnet-5` افتراضيًا؛ اضبط المتغير صراحةً لاستخدام نموذج Claude مختلف، مثل `claude-haiku-4-5` الأرخص. بالنسبة للواجهة الخلفية **Codex**، فإن تركه بدون ضبط يستخدم النموذج الافتراضي الخاص بـ Codex CLI.
 - **`VISUAL_RECAP_REASONING`** يضبط عمق الاستدلال: `none` أو `minimal` أو `low` أو `medium` أو `high` أو `xhigh`. وينطبق ذلك على الواجهة الخلفية Codex؛ يعتمد منطق Claude على النموذج، لذلك يتم تجاهل هذا المتغير هناك.
 - **`VISUAL_RECAP_SKILL_SOURCE`** يتحكم في الحداثة السريعة: يستخدم `auto`/unset أحدث توجيهات المهارات المجمعة، بينما يتم تثبيت `repo` في مجلد مهارات `visual-recap` المحلي المخصص.
 
 على سبيل المثال، لتشغيل الملخص على Codex باستخدام GPT-5.6 Sol عند المنطق العالي، قم بتعيين متغيرات المستودع `VISUAL_RECAP_AGENT=codex`، و`VISUAL_RECAP_MODEL=gpt-5.6-sol`، و`VISUAL_RECAP_REASONING=high`.
 
+## التكلفة
+
+كل تشغيل للملخّص هو جلسة كاملة لوكيل ترميز يقرأ فرقًا حقيقيًا (diff)، وليس ملخصًا رخيصًا بقالب جاهز، لذا تتبع تكلفته اختيار النموذج وعدد مرات تشغيله:
+
+- **جلسة كاملة لكل دفعة (push) على طلب السحب.** يعمل المُشغّل الافتراضي عند `synchronize`، لذا فإن طلب سحب (PR) تم دفعه عشر مرات يشغّل الوكيل عشر مرات.
+- **طلب السحب بأكمله في كل مرة**، وليس فقط الالتزامات (commits) منذ آخر تشغيل — تتناسب التكلفة مع الحجم الإجمالي لطلب السحب، وليس مع حجم الفرق التزايدي.
+- **إدخال الفرق محدود بحوالي 600 كيلوبايت.** هذا يحدّ من أسوأ الحالات لكل تشغيل، لكن الفروقات الكبيرة لا تزال تكلف أكثر بشكل ملحوظ من الصغيرة.
+- **إعادة محاولة تلقائية واحدة عند الفشل**، والتي يمكن أن تضاعف تقريبًا تكلفة التشغيل الذي يفشل بشكل عابر.
+
+لتقليل التكلفة:
+
+- **ثبّت نموذجًا أرخص.** بالنسبة لـ Claude، اضبط `VISUAL_RECAP_MODEL=claude-haiku-4-5` للمستودعات البسيطة أو الصغيرة — إنه أرخص فئة من Claude؛ `claude-sonnet-5` (الافتراضي) هو الفئة المتوازنة.
+- **انتقل إلى Codex بنموذج أرخص.** اضبط `VISUAL_RECAP_AGENT=codex` مع `VISUAL_RECAP_MODEL=gpt-5.6-luna` (أرخص فئة من GPT-5.6) أو `gpt-5.6-terra` (فئة متوسطة)، واضبط `VISUAL_RECAP_REASONING=low` لخفض إنفاق رموز الاستدلال أكثر. يُطبَّق عمق الاستدلال على Codex فقط.
+- **وجّهه إلى مزود متوافق مع OpenAI أرخص.** اضبط `VISUAL_RECAP_AGENT=openai-compatible` مع `VISUAL_RECAP_BASE_URL`/`VISUAL_RECAP_MODEL`/`VISUAL_RECAP_API_KEY` مستهدفًا DeepSeek أو Kimi أو أي نقطة نهاية أخرى متوافقة مع OpenAI.
+- **قلّل من تكرار الملخصات.** عدّل `on.pull_request.types` في سير العمل المثبّت من `[opened, synchronize, reopened, ready_for_review, closed]` إلى `[opened, ready_for_review, closed]` بحيث يتم إنشاء الملخّص فقط عند فتح طلب السحب وعند دمجه، بدلاً من كل دفعة.
+
+يسجّل كل تشغيل ما أنفقه فعليًا: تُرفق خطوة `recap usage` في سير العمل استخدام الرموز والتكلفة بالخطة المنشورة، حتى تتمكن من الاطلاع على الإنفاق الفعلي لكل تشغيل بدلاً من التخمين.
+
 ## الأسرار والمتغيرات
 
 قم بتعيين هذه العناصر في **الإعدادات ← الأسرار والمتغيرات ← Actions** في مستودعك.
@@ -196,11 +214,11 @@ npx @agent-native/core@latest connect https://plan.agent-native.com --service-to
 
 **Solo: رمز شخصي لا يزال يعمل.** اصنعه باستخدام `npx @agent-native/core@latest connect`
 مقابل تطبيق الخطط الخاص بك. بالنسبة للتطبيق المستضاف، يقوم هذا أيضًا بكتابة محلي
-ملف رمز النشر المميز الذي يستطيع `npx @agent-native/core@latest recap setup` قراءته:
+ملف رمز النشر المميز الذي يستطيع `npx @agent-native/recap-cli@latest recap setup` قراءته:
 
 ```bash
 npx @agent-native/core@latest connect https://plan.agent-native.com --client codex
-npx @agent-native/core@latest recap setup
+npx @agent-native/recap-cli@latest recap setup
 ```
 
 إذا كنت تفضل الإعداد اليدوي، فالصق الرمز المميز في سر GitHub. استخدم
@@ -209,16 +227,16 @@ npx @agent-native/core@latest recap setup
 
 ### اختياري (فقط في حالة تغيير الإعدادات الافتراضية)
 
-| سري/متغير                | الافتراضي                       | عندما تحتاج إليه                                                                                                                                           |
-| ------------------------ | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `OPENAI_API_KEY`         | —                               | سرية. اضبطه مع `VISUAL_RECAP_AGENT=codex` لتشغيل الخلاصة باستخدام Codex بدلاً من ذلك.                                                                      |
-| `VISUAL_RECAP_AGENT`     | `claude`                        | متغير. يحدد الواجهة الخلفية لعامل التشفير (`claude` أو `codex`).                                                                                           |
-| `VISUAL_RECAP_MODEL`     | كل CLI الافتراضي                | متغير. دبابيس النموذج - على سبيل المثال. `gpt-5.6-sol` لـ Codex، أو معرف طراز Claude. يستخدم Unset الإعداد الافتراضي الخاص بـ CLI.                         |
-| `VISUAL_RECAP_REASONING` | الإعداد الافتراضي لكل نموذج     | متغير. عمق الاستدلال: `none`، أو `minimal`، أو `low`، أو `medium`، أو `high`، أو `xhigh`. ينطبق على الواجهة الخلفية Codex.                                 |
-| `RECAP_CLI_VERSION`      | `latest`                        | متغير. تثبيت إصدار `@agent-native/core` CLI الذي يقوم سير العمل بتثبيته - على سبيل المثال. `1.5.0`. انظر [Version pinning](#version-pinning-copy-variant). |
-| `PLAN_RECAP_APP_URL`     | `https://plan.agent-native.com` | سرية. فقط عند الاستضافة الذاتية لتطبيق الخطط على مصدر مختلف.                                                                                               |
+| سري/متغير                | الافتراضي                                                    | عندما تحتاج إليه                                                                                                                                                                                                                                                                         |
+| ------------------------ | ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `OPENAI_API_KEY`         | —                                                            | سرية. اضبطه مع `VISUAL_RECAP_AGENT=codex` لتشغيل الخلاصة باستخدام Codex بدلاً من ذلك.                                                                                                                                                                                                    |
+| `VISUAL_RECAP_AGENT`     | `claude`                                                     | متغير. يحدد الواجهة الخلفية لعامل التشفير (`claude` أو `codex`).                                                                                                                                                                                                                         |
+| `VISUAL_RECAP_MODEL`     | `claude-sonnet-5` لـ Claude؛ مطلوب للواجهة الخلفية المتوافقة | متغير. معرف نموذج المزوّد للواجهات الخلفية المتوافقة مع OpenAI (مطلوب هناك). بالنسبة لـ Claude، تركه بدون ضبط يستخدم الآن `claude-sonnet-5` افتراضيًا — اضبطه لتجاوز ذلك، مثل `claude-haiku-4-5` لأرخص فئة. بالنسبة لـ Codex، تركه بدون ضبط يستخدم الإعداد الافتراضي الخاص بـ Codex CLI. |
+| `VISUAL_RECAP_REASONING` | الإعداد الافتراضي لكل نموذج                                  | متغير. عمق الاستدلال: `none`، أو `minimal`، أو `low`، أو `medium`، أو `high`، أو `xhigh`. ينطبق على الواجهة الخلفية Codex.                                                                                                                                                               |
+| `RECAP_CLI_VERSION`      | `latest`                                                     | متغير. تثبيت إصدار `@agent-native/recap-cli` CLI الذي يقوم سير العمل بتثبيته - على سبيل المثال. `1.5.0`. انظر [Version pinning](#version-pinning-copy-variant).                                                                                                                          |
+| `PLAN_RECAP_APP_URL`     | `https://plan.agent-native.com`                              | سرية. فقط عند الاستضافة الذاتية لتطبيق الخطط على مصدر مختلف.                                                                                                                                                                                                                             |
 
-يكتشف سير العمل تلقائيًا كيفية استدعاء مساعده CLI (المصدر المحلي داخل هذا monorepo، `@agent-native/core` المنشور في مكان آخر)، لذا لا يوجد متغير `RECAP_CLI` لتعيينه.
+يكتشف سير العمل تلقائيًا كيفية استدعاء مساعده CLI (المصدر المحلي داخل هذا monorepo، `@agent-native/recap-cli` المنشور في مكان آخر)، لذا لا يوجد متغير `RECAP_CLI` لتعيينه.
 
 ## لقطة شاشة مضمنة في التعليق
 
@@ -359,9 +377,9 @@ npx @agent-native/core@latest recap setup
 يتدفق نفس المساعد محليًا في وضع الملفات المحلية بدلاً من ذلك:
 
 ```bash
-npx @agent-native/core@latest recap collect-diff --base main --head HEAD --out recap.diff --stat recap.stat
-npx @agent-native/core@latest recap scan --diff recap.diff
-npx @agent-native/core@latest recap build-prompt --pr 123 --diff recap.diff --stat recap.stat --local-files --local-dir plans/pr-123-visual-recap
+npx @agent-native/recap-cli@latest recap collect-diff --base main --head HEAD --out recap.diff --stat recap.stat
+npx @agent-native/recap-cli@latest recap scan --diff recap.diff
+npx @agent-native/recap-cli@latest recap build-prompt --pr 123 --diff recap.diff --stat recap.stat --local-files --local-dir plans/pr-123-visual-recap
 ```
 
 أعط `recap-prompt.md` الذي تم إنشاؤه إلى وكيل الترميز الخاص بك. في وضع الملفات المحلية
@@ -391,7 +409,7 @@ npx @agent-native/core@latest plan local serve --dir plans/pr-123-visual-recap -
 
 ## تثبيت الإصدار (متغير النسخ) {#version-pinning-copy-variant}
 
-افتراضيًا، يقوم سير عمل النسخ المتغير بتثبيت `@agent-native/core@latest` في وقت التشغيل، لذا فإن كل عملية تلخيص تلتقط تلقائيًا أحدث CLI. إذا كان CI الخاص بك يحتاج إلى أدوات قابلة للتكرار، فقم بتعيين متغير المستودع **`RECAP_CLI_VERSION`** لتثبيت الإصدار المثبت:
+افتراضيًا، يقوم سير عمل النسخ المتغير بتثبيت `@agent-native/recap-cli@latest` في وقت التشغيل، لذا فإن كل عملية تلخيص تلتقط تلقائيًا أحدث CLI. إذا كان CI الخاص بك يحتاج إلى أدوات قابلة للتكرار، فقم بتعيين متغير المستودع **`RECAP_CLI_VERSION`** لتثبيت الإصدار المثبت:
 
 1. انتقل إلى الريبو الخاص بك **الإعدادات → الأسرار والمتغيرات → Actions → المتغيرات**.
 2. قم بإنشاء متغير باسم `RECAP_CLI_VERSION` بقيمة مثل `1.5.0`.
@@ -402,7 +420,7 @@ npx @agent-native/core@latest plan local serve --dir plans/pr-123-visual-recap -
 
 ## القائمة المسموح بها للفحص السري
 
-قبل نشر الملخّص، يقوم سير العمل بتشغيل `npx @agent-native/core@latest recap scan` لاكتشاف الأسرار المحتملة في الفرق. يتم حظر أي علاقات عامة يتطابق فرقها مع نمط سري معروف بتعليق توضيحي - لا يتم نشر الملخص، ولا يتم إرسال أي محتوى فرق إلى وكيل الترميز.
+قبل نشر الملخّص، يقوم سير العمل بتشغيل `npx @agent-native/recap-cli@latest recap scan` لاكتشاف الأسرار المحتملة في الفرق. يتم حظر أي علاقات عامة يتطابق فرقها مع نمط سري معروف بتعليق توضيحي - لا يتم نشر الملخص، ولا يتم إرسال أي محتوى فرق إلى وكيل الترميز.
 
 في حالات نادرة، يحتوي الريبو على تركيبات اختبار متعمدة أو سلاسل غير سرية تشبه بشكل سطحي الأنماط السرية (على سبيل المثال، مفتاح التثبيت في ملف اختبار). لمنع النتيجة الإيجابية الخاطئة، قم بإنشاء `.github/recap-scan-allowlist` في جذر المستودع الخاص بك.
 
@@ -436,7 +454,7 @@ EXAMPLE_API_KEY=placeholder-value
 
 ### لماذا نستخدم المتغير القابل لإعادة الاستخدام؟
 
-يقوم المثبت الافتراضي بنسخ سير العمل YAML الكامل ~360 سطرًا إلى الريبو الخاص بك (خيار **النسخ**). هذا هو الاختيار الصحيح لعمليات إعادة الشراء أو عمليات إعادة الشراء التي تحتاج إلى مراجعة كل سطر مما يتم تشغيله. الجانب السلبي هو أن إصلاحات الأخطاء والتحسينات لا تصل إليك أبدًا — تحتاج إلى إعادة تشغيل `npx @agent-native/core@latest recap setup` يدويًا بعد كل إصدار.
+يقوم المثبت الافتراضي بنسخ سير العمل YAML الكامل ~360 سطرًا إلى الريبو الخاص بك (خيار **النسخ**). هذا هو الاختيار الصحيح لعمليات إعادة الشراء أو عمليات إعادة الشراء التي تحتاج إلى مراجعة كل سطر مما يتم تشغيله. الجانب السلبي هو أن إصلاحات الأخطاء والتحسينات لا تصل إليك أبدًا — تحتاج إلى إعادة تشغيل `npx @agent-native/recap-cli@latest recap setup` يدويًا بعد كل إصدار.
 
 يقوم الخيار **القابل لإعادة الاستخدام** بكتابة متصل رفيع يصل إلى 20 سطرًا بدلاً من ذلك. يقوم بالتفويض إلى `BuilderIO/agent-native/.github/workflows/pr-visual-recap-reusable.yml` عبر `uses:`. يلتقط كل متصل تلقائيًا أحدث المنطق عند تشغيل سير العمل، دون الحاجة إلى تحديث محلي.
 
@@ -449,7 +467,7 @@ EXAMPLE_API_KEY=placeholder-value
 
 ### مقتطف المتصل
 
-هذا ما يكتبه `npx @agent-native/core@latest recap setup --reusable` (أو يمكنك لصقه يدويًا):
+هذا ما يكتبه `npx @agent-native/recap-cli@latest recap setup --reusable` (أو يمكنك لصقه يدويًا):
 
 ```yaml
 name: PR Visual Recap
@@ -484,7 +502,7 @@ jobs:
       skill-source: ${{ vars.VISUAL_RECAP_SKILL_SOURCE || 'auto' }}
       runs-on: ${{ vars.VISUAL_RECAP_RUNS_ON || '"ubuntu-latest"' }}
       gate-runs-on: ${{ vars.VISUAL_RECAP_GATE_RUNS_ON || 'ubuntu-latest' }}
-      # cli-version: "latest"  # pin to a specific @agent-native/core version
+      # cli-version: "latest"  # pin to a specific @agent-native/recap-cli version
 ```
 
 تنطبق الأسرار والمتغيرات نفسها الموضحة في [Secrets and variables](#secrets-and-variables). يمرر المتصل القابل لإعادة الاستخدام `VISUAL_RECAP_RUNS_ON` كـ `runs-on` للمهمة الكاملة، و`VISUAL_RECAP_GATE_RUNS_ON` كتسمية مفردة `gate-runs-on` للبوابة. يستخدم كلاهما `ubuntu-latest` عند الحذف.
@@ -493,15 +511,15 @@ jobs:
 
 ```bash
 # اكتب المتصل الرقيق بدلاً من النسخة الكاملة:
-npx @agent-native/core@latest recap setup --reusable
+npx @agent-native/recap-cli@latest recap setup --reusable
 
 # أو مع مرجع مثبت لقابلية التكرار:
-npx @agent-native/core@latest recap setup --reusable --ref v1.2.3
+npx @agent-native/recap-cli@latest recap setup --reusable --ref v1.2.3
 ```
 
 يقوم كلا الخيارين بكتابة سير العمل إلى `.github/workflows/pr-visual-recap.yml`. إذا كان سير العمل موجودًا بالفعل ومختلفًا، فسيرفض الأمر ويطلب منك تمرير `--force` للكتابة فوقه.
 
-بعد الكتابة، قم بتشغيل `npx @agent-native/core@latest recap doctor` كالمعتاد للتأكد من تكوين الأسرار.
+بعد الكتابة، قم بتشغيل `npx @agent-native/recap-cli@latest recap doctor` كالمعتاد للتأكد من تكوين الأسرار.
 
 ### تثبيت الإصدار
 
@@ -511,7 +529,7 @@ npx @agent-native/core@latest recap setup --reusable --ref v1.2.3
 uses: BuilderIO/agent-native/.github/workflows/pr-visual-recap-reusable.yml@v1.2.3
 ```
 
-يتحكم إدخال `cli-version` في إصدار `@agent-native/core` CLI الذي يتم تشغيله داخل سير العمل - اتركه في `"latest"` لتتبع الإصدار الأحدث، أو قم بتثبيته في سلسلة إصدار (على سبيل المثال، `"1.5.0"`) للحصول على إمكانية تكرار نتائج كاملة.
+يتحكم إدخال `cli-version` في إصدار `@agent-native/recap-cli` CLI الذي يتم تشغيله داخل سير العمل - اتركه في `"latest"` لتتبع الإصدار الأحدث، أو قم بتثبيته في سلسلة إصدار (على سبيل المثال، `"1.5.0"`) للحصول على إمكانية تكرار نتائج كاملة.
 
 ### سياق حدث Workflow_call
 

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

@@ -212,6 +212,13 @@ vscode://builder.agent-native/open?url=<encoded-plan-url>
 **نموذج الأسئلة المفتوحة** الموجود أسفل نفس الخطة. الرد عليه والإرسال
 يبدأ الوكيل في مراجعة الخطة الحالية.
 
+## التكلفة واختيار النموذج
+
+يؤدي إنشاء خطة أو ملخّص إلى تشغيل جلسة وكيلية كاملة على LLM الخاص بوكيل الترميز لديك، وليس مجرد ملء قالب خفيف، لذا تتناسب التكلفة مع حجم الفرق (diff) أو الخطة والنموذج الذي تختاره.
+
+- نموذج الدردشة الافتراضي الخاص بالتطبيق هو Sonnet 5؛ يمكنك تغييره في أي وقت من **الإعدادات**. Haiku هو خيار Claude الأرخص، وLuna هو الخيار الأرخص في عائلة GPT-5.6.
+- تعمل ملخصات طلبات السحب (PR) الآلية من GitHub Action بشكل منفصل عن التطبيق التفاعلي، ولها مقابض النموذج والتكلفة الخاصة بها — راجع [PR Visual Recap](/docs/pr-visual-recap) للاطلاع على `VISUAL_RECAP_MODEL` و`VISUAL_RECAP_AGENT` و`VISUAL_RECAP_REASONING`.
+
 ## ما يمكنك فعله به
 
 - **المراجعة قبل التنفيذ.** React للرسومات التخطيطية، والإطارات السلكية، وعلامات تبويب الخيارات،

package/corpus/core/docs/content/locales/de-DE/pr-visual-recap.mdx

@@ -102,13 +102,13 @@ explizit jederzeit:
 npx @agent-native/core@latest skills add visual-plan --with-github-action
 ```
 
-Dadurch wird der `visual-plan`-Skill installiert (der den `visual-recap`-Skill enthält, den die Aktion ausführt) und `.github/workflows/pr-visual-recap.yml` in Ihr Repo schreiben. Der Workflow ruft **veröffentlichte CLI-Unterbefehle** über `npx @agent-native/core@latest recap <subcommand>` auf – einschließlich `gate`, `collect-diff`, `block-reference`, `scan`, `build-prompt`, `publish`, `shot`, `comment`, `check` und `usage` – sodass nichts in Ihr kopiert wird repo als Hilfsskripte. `setup` und `doctor` sind die interaktiven Helfer, die Sie lokal ausführen; `gate` ist der Sicherheits-Gate-Schritt, den der Workflow vor jeder Zusammenfassung ausführt.
+Dadurch wird der `visual-plan`-Skill installiert (der den `visual-recap`-Skill enthält, den die Aktion ausführt) und `.github/workflows/pr-visual-recap.yml` in Ihr Repo schreiben. Der Workflow ruft **veröffentlichte CLI-Unterbefehle** über `npx @agent-native/recap-cli@latest recap <subcommand>` auf – einschließlich `gate`, `collect-diff`, `block-reference`, `scan`, `build-prompt`, `publish`, `shot`, `comment`, `check` und `usage` – sodass nichts in Ihr kopiert wird repo als Hilfsskripte. `setup` und `doctor` sind die interaktiven Helfer, die Sie lokal ausführen; `gate` ist der Sicherheits-Gate-Schritt, den der Workflow vor jeder Zusammenfassung ausführt.
 
 Führen Sie dann den geführten Einrichtungshelfer aus:
 
 ```bash
-npx @agent-native/core@latest recap setup
-npx @agent-native/core@latest recap doctor
+npx @agent-native/recap-cli@latest recap setup
+npx @agent-native/recap-cli@latest recap doctor
 ```
 
 `recap setup` aktualisiert den Workflow und verwendet `gh` zum Festlegen von GitHub Actions
@@ -118,7 +118,7 @@ gesetzt. Geheime Werte werden über stdin an `gh` gesendet, nicht über Befehlsa
 die generierte Workflow-Datei und öffnen Sie eine PR, um ihre Ausführung zu sehen.
 
 Standardmäßig erstellt der Workflow seine Agentenaufforderung aus dem neuesten Paket
-`visual-recap`-Anleitung in `@agent-native/core@latest`, einschließlich aller Geschwister
+`visual-recap`-Anleitung in `@agent-native/recap-cli@latest`, einschließlich aller Geschwister
 Referenzdateien, mit denen der Skill geliefert wird. Wenn Ihr Repo absichtlich angepasst wird und
 pinnen den festgeschriebenen `visual-recap`-Ordner an und legen die Repository-Variable fest
 `VISUAL_RECAP_SKILL_SOURCE=repo`.
@@ -135,8 +135,8 @@ Standardmäßig wird der Workflow auf von GitHub gehosteten `ubuntu-latest`-Runn
 Die JSON-Anführungszeichen sind erforderlich. Dieser Wert wählt den Runner für den vollständigen `recap`-Job. Übergeben Sie zur Konfiguration während der geführten Einrichtung denselben JSON-Wert an `--runs-on` und prüfen Sie anschließend den Workflow und die Verfügbarkeit des Runners mit `doctor`:
 
 ```bash
-npx @agent-native/core@latest recap setup --runs-on '["self-hosted","linux","x64","visual-recap"]'
-npx @agent-native/core@latest recap doctor
+npx @agent-native/recap-cli@latest recap setup --runs-on '["self-hosted","linux","x64","visual-recap"]'
+npx @agent-native/recap-cli@latest recap doctor
 ```
 
 Das einfache Gate verwendet separat `ubuntu-latest`. Repositorys ohne von GitHub gehostete Runner können `VISUAL_RECAP_GATE_RUNS_ON` auf ein einzelnes Klartext-Label ohne JSON setzen oder `--gate-runs-on visual-recap-gate` verwenden. Das benutzerdefinierte Label gilt nur für `OWNER`-, `MEMBER`- oder `COLLABORATOR`-Autoren desselben Repositorys; Forks und andere Autoren werden auf `ubuntu-latest` gezwungen und können ohne GitHub-gehostete Runner ungeplant bleiben. Nutzen Sie einen dedizierten, möglichst kurzlebigen Runner: Das Standard-Gate checkt den PR-Baum nicht aus und wertet Workflow-Logik sowie PR-Metadaten aus.
@@ -160,12 +160,30 @@ Wenn die Variable nicht gesetzt ist, verwendet die Aktion `claude`.
 
 Über das Backend hinaus optimieren zwei Repository-Variablen, _wie_ der Agent ausgeführt wird:
 
-- **`VISUAL_RECAP_MODEL`** pinnt das an CLI (`--model`) übergebene Modell – zum Beispiel `gpt-5.6-sol` für Codex oder eine Claude-Modell-ID. Lassen Sie es deaktiviert, um das eigene Standardmodell des CLI zu verwenden.
+- **`VISUAL_RECAP_MODEL`** pinnt das an CLI (`--model`) übergebene Modell – zum Beispiel `gpt-5.6-luna` für Codex, eine Claude-Modell-ID oder `deepseek-chat` für DeepSeek. Für `openai-compatible` ist sie erforderlich. Für das **Claude**-Backend führt ein nicht gesetzter Wert jetzt standardmäßig zu `claude-sonnet-5`; setzen Sie die Variable explizit, um ein anderes Claude-Modell zu verwenden, etwa das günstigere `claude-haiku-4-5`. Für das **Codex**-Backend verwendet ein nicht gesetzter Wert das eigene Standardmodell des Codex CLI.
 - **`VISUAL_RECAP_REASONING`** legt die Argumentationstiefe fest: `none`, `minimal`, `low`, `medium`, `high` oder `xhigh`. Es gilt für das Codex-Backend; Die Argumentation von Claude ist modellgesteuert, daher wird diese Variable dort ignoriert.
 - **`VISUAL_RECAP_SKILL_SOURCE`** steuert die Aktualität der Eingabeaufforderung: `auto`/unset verwendet die neueste gebündelte Skill-Anleitung, während `repo` an den festgeschriebenen Repository-lokalen `visual-recap`-Skill-Ordner angeheftet wird.
 
 Um beispielsweise die Zusammenfassung auf Codex mit GPT-5.6 Sol bei hoher Argumentation auszuführen, legen Sie die Repository-Variablen `VISUAL_RECAP_AGENT=codex`, `VISUAL_RECAP_MODEL=gpt-5.6-sol` und `VISUAL_RECAP_REASONING=high` fest.
 
+## Kosten
+
+Jeder Zusammenfassungslauf ist eine vollständige agentische Coding-Agent-Sitzung, die einen echten Diff liest, keine günstige, vorlagenbasierte Zusammenfassung – die Kosten hängen daher von der Modellwahl und davon ab, wie oft der Lauf ausgeführt wird:
+
+- **Eine vollständige Sitzung pro PR-Push.** Der Standard-Trigger reagiert auf `synchronize`, sodass ein PR, der zehnmal gepusht wird, den Agenten zehnmal ausführt.
+- **Jedes Mal der gesamte PR**, nicht nur die Commits seit dem letzten Lauf – die Kosten skalieren mit der Gesamtgröße des PR, nicht mit der inkrementellen Diff-Größe.
+- **Diff-Eingabe auf ~600KB begrenzt.** Dies begrenzt den ungünstigsten Fall pro Lauf, aber große Diffs kosten weiterhin spürbar mehr als kleine.
+- **Ein automatischer Wiederholungsversuch bei einem Fehler**, der die Kosten eines vorübergehend fehlgeschlagenen Laufs etwa verdoppeln kann.
+
+So senken Sie die Kosten:
+
+- **Pinnen Sie ein günstigeres Modell.** Setzen Sie für Claude `VISUAL_RECAP_MODEL=claude-haiku-4-5` bei einfachen oder kleinen Repositorys – das ist die günstigste Claude-Stufe; `claude-sonnet-5` (die Standardeinstellung) ist die ausgewogene Stufe.
+- **Wechseln Sie zu Codex mit einem günstigeren Modell.** Setzen Sie `VISUAL_RECAP_AGENT=codex` zusammen mit `VISUAL_RECAP_MODEL=gpt-5.6-luna` (die günstigste GPT-5.6-Stufe) oder `gpt-5.6-terra` (mittlere Stufe), und setzen Sie `VISUAL_RECAP_REASONING=low`, um die Ausgaben für Argumentations-Token weiter zu senken. Die Argumentationstiefe gilt nur für Codex.
+- **Nutzen Sie einen günstigeren OpenAI-kompatiblen Anbieter.** Setzen Sie `VISUAL_RECAP_AGENT=openai-compatible` zusammen mit `VISUAL_RECAP_BASE_URL`/`VISUAL_RECAP_MODEL`/`VISUAL_RECAP_API_KEY`, die auf DeepSeek, Kimi oder einen anderen OpenAI-kompatiblen Endpunkt verweisen.
+- **Fassen Sie seltener zusammen.** Bearbeiten Sie `on.pull_request.types` des installierten Workflows von `[opened, synchronize, reopened, ready_for_review, closed]` zu `[opened, ready_for_review, closed]`, sodass nur beim Öffnen und beim Mergen eines PR zusammengefasst wird, statt bei jedem Push.
+
+Jeder Lauf zeichnet auf, was er tatsächlich gekostet hat: Der `recap usage`-Schritt des Workflows fügt dem veröffentlichten Plan Token- und Kostennutzung hinzu, sodass Sie die tatsächlichen Ausgaben pro Lauf einsehen können, statt zu raten.
+
 ## Geheimnisse und Variablen
 
 Legen Sie diese in den **Einstellungen → Geheimnisse und Variablen → Actions** Ihres Repositorys fest.
@@ -196,11 +214,11 @@ Pläne-App.
 
 **Solo: Ein persönlicher Token funktioniert weiterhin.** Prägen Sie ihn mit `npx @agent-native/core@latest connect`
 gegen Ihre Pläne-App. Für die gehostete App schreibt dies auch eine lokale
-Publish-Token-Datei, die `npx @agent-native/core@latest recap setup` lesen kann:
+Publish-Token-Datei, die `npx @agent-native/recap-cli@latest recap setup` lesen kann:
 
 ```bash
 npx @agent-native/core@latest connect https://plan.agent-native.com --client codex
-npx @agent-native/core@latest recap setup
+npx @agent-native/recap-cli@latest recap setup
 ```
 
 Wenn Sie die manuelle Einrichtung bevorzugen, fügen Sie das Token in das GitHub-Geheimnis ein. Verwenden Sie ein
@@ -209,16 +227,16 @@ echtes Token.
 
 ### Optional (nur wenn Sie die Standardeinstellungen ändern)
 
-| Geheimnis/Variable       | Standard                          | Wenn Sie es brauchen                                                                                                                                        |
-| ------------------------ | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `OPENAI_API_KEY`         | —                                 | Geheimnis. Zusammen mit `VISUAL_RECAP_AGENT=codex` einstellen, um die Zusammenfassung stattdessen mit Codex auszuführen.                                    |
-| `VISUAL_RECAP_AGENT`     | `claude`                          | Variable. Wählt das Coding-Agent-Backend (`claude` oder `codex`) aus.                                                                                       |
-| `VISUAL_RECAP_MODEL`     | die Standardeinstellung jedes CLI | Variable. Steckt das Modell fest – z.B. `gpt-5.6-sol` für Codex oder eine Claude-Modell-ID. Unset verwendet die eigene Standardeinstellung von CLI.         |
-| `VISUAL_RECAP_REASONING` | Standardeinstellung jedes Modells | Variable. Argumentationstiefe: `none`, `minimal`, `low`, `medium`, `high` oder `xhigh`. Gilt für das Codex-Backend.                                         |
-| `RECAP_CLI_VERSION`      | `latest`                          | Variable. Pinnt die `@agent-native/core` CLI-Version, die der Workflow installiert – z. B. `1.5.0`. Siehe [Version pinning](#version-pinning-copy-variant). |
-| `PLAN_RECAP_APP_URL`     | `https://plan.agent-native.com`   | Geheimnis. Nur beim Selbsthosten der Plans-App an einem anderen Ursprung.                                                                                   |
+| Geheimnis/Variable       | Standard                                                              | Wenn Sie es brauchen                                                                                                                                                                                                                                                                                                                                        |
+| ------------------------ | --------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `OPENAI_API_KEY`         | —                                                                     | Geheimnis. Zusammen mit `VISUAL_RECAP_AGENT=codex` einstellen, um die Zusammenfassung stattdessen mit Codex auszuführen.                                                                                                                                                                                                                                    |
+| `VISUAL_RECAP_AGENT`     | `claude`                                                              | Variable. Wählt das Coding-Agent-Backend (`claude` oder `codex`) aus.                                                                                                                                                                                                                                                                                       |
+| `VISUAL_RECAP_MODEL`     | `claude-sonnet-5` für Claude; für das kompatible Backend erforderlich | Variable. Anbieter-Modell-ID für OpenAI-kompatible Backends (dort erforderlich). Für Claude führt ein nicht gesetzter Wert jetzt standardmäßig zu `claude-sonnet-5` – setzen Sie ihn, um es zu überschreiben, z. B. `claude-haiku-4-5` für die günstigste Stufe. Für Codex verwendet ein nicht gesetzter Wert die eigene Standardeinstellung des Codex CLI. |
+| `VISUAL_RECAP_REASONING` | Standardeinstellung jedes Modells                                     | Variable. Argumentationstiefe: `none`, `minimal`, `low`, `medium`, `high` oder `xhigh`. Gilt für das Codex-Backend.                                                                                                                                                                                                                                         |
+| `RECAP_CLI_VERSION`      | `latest`                                                              | Variable. Pinnt die `@agent-native/recap-cli` CLI-Version, die der Workflow installiert – z. B. `1.5.0`. Siehe [Version pinning](#version-pinning-copy-variant).                                                                                                                                                                                            |
+| `PLAN_RECAP_APP_URL`     | `https://plan.agent-native.com`                                       | Geheimnis. Nur beim Selbsthosten der Plans-App an einem anderen Ursprung.                                                                                                                                                                                                                                                                                   |
 
-Der Workflow erkennt automatisch, wie sein Hilfsprogramm CLI (lokale Quelle in diesem Monorepo, das an anderer Stelle veröffentlichte `@agent-native/core`) aufgerufen wird, sodass keine `RECAP_CLI`-Variable festgelegt werden muss.
+Der Workflow erkennt automatisch, wie sein Hilfsprogramm CLI (lokale Quelle in diesem Monorepo, das an anderer Stelle veröffentlichte `@agent-native/recap-cli`) aufgerufen wird, sodass keine `RECAP_CLI`-Variable festgelegt werden muss.
 
 ## Inline-Screenshot im Kommentar
 
@@ -359,9 +377,9 @@ Rekapitulieren, ohne Rekapitulationsinhalte an die Agent-Native-Plandatenbank zu
 gleicher Hilfsablauf lokal im Modus „Lokale Dateien“ stattdessen:
 
 ```bash
-npx @agent-native/core@latest recap collect-diff --base main --head HEAD --out recap.diff --stat recap.stat
-npx @agent-native/core@latest recap scan --diff recap.diff
-npx @agent-native/core@latest recap build-prompt --pr 123 --diff recap.diff --stat recap.stat --local-files --local-dir plans/pr-123-visual-recap
+npx @agent-native/recap-cli@latest recap collect-diff --base main --head HEAD --out recap.diff --stat recap.stat
+npx @agent-native/recap-cli@latest recap scan --diff recap.diff
+npx @agent-native/recap-cli@latest recap build-prompt --pr 123 --diff recap.diff --stat recap.stat --local-files --local-dir plans/pr-123-visual-recap
 ```
 
 Geben Sie das generierte `recap-prompt.md` an Ihren Codierungsagenten. Im lokalen Dateimodus
@@ -391,7 +409,7 @@ Die Zusammenfassung ist eine Überprüfungshilfe, die über dem normalen PR-Abla
 
 ## Versionspinning (Kopiervariante) {#version-pinning-copy-variant}
 
-Standardmäßig installiert der Kopiervarianten-Workflow `@agent-native/core@latest` zur Laufzeit, sodass bei jedem Wiederholungslauf automatisch das neueste CLI übernommen wird. Wenn Ihr CI reproduzierbare Tools benötigt, legen Sie die Repository-Variable **`RECAP_CLI_VERSION`** fest, um die installierte Version anzuheften:
+Standardmäßig installiert der Kopiervarianten-Workflow `@agent-native/recap-cli@latest` zur Laufzeit, sodass bei jedem Wiederholungslauf automatisch das neueste CLI übernommen wird. Wenn Ihr CI reproduzierbare Tools benötigt, legen Sie die Repository-Variable **`RECAP_CLI_VERSION`** fest, um die installierte Version anzuheften:
 
 1. Gehen Sie zu **Einstellungen → Geheimnisse und Variablen → Actions → Variablen** Ihres Repos.
 2. Erstellen Sie eine Variable namens `RECAP_CLI_VERSION` mit einem Wert wie `1.5.0`.
@@ -402,7 +420,7 @@ Verwenden Sie für die wiederverwendbare Caller-Variante stattdessen die Eingabe
 
 ## Zulassungsliste für geheime Scans
 
-Vor der Veröffentlichung einer Zusammenfassung führt der Workflow `npx @agent-native/core@latest recap scan` aus, um wahrscheinliche Geheimnisse im Diff zu erkennen. Jeder PR, dessen Diff mit einem bekannten geheimen Muster übereinstimmt, wird mit einem erläuternden Kommentar blockiert – die Zusammenfassung wird nicht veröffentlicht und es werden keine Diff-Inhalte an den Codierungsagenten gesendet.
+Vor der Veröffentlichung einer Zusammenfassung führt der Workflow `npx @agent-native/recap-cli@latest recap scan` aus, um wahrscheinliche Geheimnisse im Diff zu erkennen. Jeder PR, dessen Diff mit einem bekannten geheimen Muster übereinstimmt, wird mit einem erläuternden Kommentar blockiert – die Zusammenfassung wird nicht veröffentlicht und es werden keine Diff-Inhalte an den Codierungsagenten gesendet.
 
 In seltenen Fällen verfügt ein Repo über absichtliche Test-Fixtures oder nicht geheime Zeichenfolgen, die oberflächlich betrachtet geheimen Mustern ähneln (z. B. ein Fixture-Schlüssel in einer Testdatei). Um ein falsch positives Ergebnis zu unterdrücken, erstellen Sie `.github/recap-scan-allowlist` im Stammverzeichnis Ihres Repositorys.
 
@@ -436,7 +454,7 @@ Die Zulassungsliste wird nur vom Secret-Scan-Gate konsultiert. Es hat keinen Ein
 
 ### Warum die wiederverwendbare Variante verwenden?
 
-Das Standardinstallationsprogramm kopiert den vollständigen ~360-Zeilen-Workflow YAML in Ihr Repo (die Option **Kopieren**). Dies ist die richtige Wahl für Air-Gap-Repos oder Repos, die jede Zeile ihrer Ausführung prüfen müssen. Der Nachteil ist, dass Fehlerkorrekturen und Verbesserungen Sie nie erreichen – Sie müssen `npx @agent-native/core@latest recap setup` nach jeder Veröffentlichung manuell erneut ausführen.
+Das Standardinstallationsprogramm kopiert den vollständigen ~360-Zeilen-Workflow YAML in Ihr Repo (die Option **Kopieren**). Dies ist die richtige Wahl für Air-Gap-Repos oder Repos, die jede Zeile ihrer Ausführung prüfen müssen. Der Nachteil ist, dass Fehlerkorrekturen und Verbesserungen Sie nie erreichen – Sie müssen `npx @agent-native/recap-cli@latest recap setup` nach jeder Veröffentlichung manuell erneut ausführen.
 
 Die Option **wiederverwendbar** schreibt stattdessen einen dünnen Aufrufer mit ca. 20 Leitungen. Es wird über `uses:` an `BuilderIO/agent-native/.github/workflows/pr-visual-recap-reusable.yml` delegiert. Jeder Aufrufer ruft automatisch die neueste Logik ab, wenn der Workflow ausgeführt wird, ohne dass eine lokale Aktualisierung erforderlich ist.
 
@@ -449,7 +467,7 @@ Die Option **wiederverwendbar** schreibt stattdessen einen dünnen Aufrufer mit
 
 ### Anrufer-Snippet
 
-Das schreibt `npx @agent-native/core@latest recap setup --reusable` (oder Sie können es manuell einfügen):
+Das schreibt `npx @agent-native/recap-cli@latest recap setup --reusable` (oder Sie können es manuell einfügen):
 
 ```yaml
 name: PR Visual Recap
@@ -484,7 +502,7 @@ jobs:
       skill-source: ${{ vars.VISUAL_RECAP_SKILL_SOURCE || 'auto' }}
       runs-on: ${{ vars.VISUAL_RECAP_RUNS_ON || '"ubuntu-latest"' }}
       gate-runs-on: ${{ vars.VISUAL_RECAP_GATE_RUNS_ON || 'ubuntu-latest' }}
-      # cli-version: "latest"  # pin to a specific @agent-native/core version
+      # cli-version: "latest"  # pin to a specific @agent-native/recap-cli version
 ```
 
 Es gelten dieselben Geheimnisse und Variablen wie unter [Secrets and variables](#secrets-and-variables). Der wiederverwendbare Aufrufer leitet `VISUAL_RECAP_RUNS_ON` als `runs-on` für den vollständigen Job und `VISUAL_RECAP_GATE_RUNS_ON` als einfaches `gate-runs-on`-Label für das Gate weiter. Ohne Eingabe verwenden beide `ubuntu-latest`.
@@ -493,15 +511,15 @@ Es gelten dieselben Geheimnisse und Variablen wie unter [Secrets and variables](
 
 ```bash
 # Schreiben Sie den Thin Caller anstelle der vollständigen Kopie:
-npx @agent-native/core@latest recap setup --reusable
+npx @agent-native/recap-cli@latest recap setup --reusable
 
 # Oder mit einer angehefteten Referenz zur Reproduzierbarkeit:
-npx @agent-native/core@latest recap setup --reusable --ref v1.2.3
+npx @agent-native/recap-cli@latest recap setup --reusable --ref v1.2.3
 ```
 
 Beide Varianten schreiben den Workflow nach `.github/workflows/pr-visual-recap.yml`. Wenn bereits ein vorhandener Workflow vorhanden ist und dieser abweicht, lehnt der Befehl ab und fordert Sie auf, `--force` zum Überschreiben zu übergeben.
 
-Führen Sie nach dem Schreiben wie gewohnt `npx @agent-native/core@latest recap doctor` aus, um zu bestätigen, dass die Geheimnisse konfiguriert sind.
+Führen Sie nach dem Schreiben wie gewohnt `npx @agent-native/recap-cli@latest recap doctor` aus, um zu bestätigen, dass die Geheimnisse konfiguriert sind.
 
 ### Versionsfixierung
 
@@ -511,7 +529,7 @@ Standardmäßig verweist der Aufrufer auf `@main`, das immer die neueste veröff
 uses: BuilderIO/agent-native/.github/workflows/pr-visual-recap-reusable.yml@v1.2.3
 ```
 
-Die `cli-version`-Eingabe steuert, welche `@agent-native/core` CLI-Version im Workflow ausgeführt wird – belassen Sie sie bei `"latest"`, um die neueste Version zu verfolgen, oder heften Sie sie für eine vollständige Reproduzierbarkeit an eine Versionszeichenfolge (z. B. `"1.5.0"`).
+Die `cli-version`-Eingabe steuert, welche `@agent-native/recap-cli` CLI-Version im Workflow ausgeführt wird – belassen Sie sie bei `"latest"`, um die neueste Version zu verfolgen, oder heften Sie sie für eine vollständige Reproduzierbarkeit an eine Versionszeichenfolge (z. B. `"1.5.0"`).
 
 ### workflow_call-Ereigniskontext
 

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

@@ -214,6 +214,13 @@ Wenn es im ersten Durchgang noch verantwortbare Entscheidungen gibt, kann der Ag
 Formular **Offene Fragen** am Ende desselben Plans. Beantworten und senden
 Es wird dem Agenten eine Revisionsrunde gegen den bestehenden Plan eingeleitet.
 
+## Kosten und Modellwahl
+
+Das Erstellen eines Plans oder einer Zusammenfassung führt eine vollständige agentische Sitzung mit dem LLM Ihres Coding-Agenten aus, keine leichtgewichtige Vorlagenbefüllung – die Kosten skalieren daher mit der Größe des Diffs oder Plans und dem gewählten Modell.
+
+- Das eigene Standard-Chat-Modell der App ist Sonnet 5; ändern Sie es jederzeit in den **Einstellungen**. Haiku ist die günstigere Claude-Option, und Luna ist die günstigere Option in der GPT-5.6-Familie.
+- Automatisierte PR-Zusammenfassungen aus der GitHub Action laufen getrennt von der interaktiven App und haben eigene Regler für Modell und Kosten – siehe [PR Visual Recap](/docs/pr-visual-recap) für `VISUAL_RECAP_MODEL`, `VISUAL_RECAP_AGENT` und `VISUAL_RECAP_REASONING`.
+
 ## Was Sie damit machen können
 
 - **Überprüfung vor der Implementierung.** React zu Diagrammen, Wireframes, Optionsregisterkarten,