@agent-native/core 0.83.0 → 0.84.1

package/dist/styles/agent-native.css

@@ -167,17 +167,6 @@
   container: agent-native-main / inline-size;
 }
 
-.agent-layout-main-surface::before,
-.agent-sidebar-main-surface::before {
-  content: "";
-  position: absolute;
-  inset: 0;
-  z-index: 20;
-  pointer-events: none;
-  border-radius: inherit;
-  box-shadow: var(--agent-native-raised-outline);
-}
-
 .agent-layout-shell
   :where(.agent-layout-main-surface, .agent-sidebar-main-surface)
   > :first-child
@@ -537,6 +526,57 @@
   }
 }
 
+/* Guided questions size themselves from the rendered container, not viewport
+   breakpoints, so they stay readable in narrow chat sidebars. */
+.guided-question-flow {
+  container-type: inline-size;
+  container-name: guided-question-flow;
+}
+
+.guided-question-flow-options {
+  grid-template-columns: minmax(0, 1fr);
+}
+
+@container guided-question-flow (min-width: 42rem) {
+  .guided-question-flow-inner {
+    padding: 2rem;
+  }
+
+  .guided-question-flow-header {
+    margin-bottom: 1.5rem;
+  }
+
+  .guided-question-flow-title {
+    font-size: 1.5rem;
+    line-height: 2rem;
+  }
+
+  .guided-question-flow-options {
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+  }
+
+  .guided-question-flow-footer {
+    margin-top: 1.25rem;
+    padding-top: 1rem;
+  }
+}
+
+@container guided-question-flow (max-width: 24rem) {
+  .guided-question-flow-description {
+    font-size: 0.8125rem;
+    line-height: 1.25rem;
+  }
+
+  .guided-question-flow-footer {
+    align-items: stretch;
+    flex-direction: column;
+  }
+
+  .guided-question-flow-footer > :last-child {
+    justify-content: flex-end;
+  }
+}
+
 /* Connect AI card: use the card width, not the viewport, so narrow embedded
    sidebars stack the copy and actions before the secondary button clips. */
 .agent-builder-setup-card {
@@ -548,6 +588,32 @@
   container-name: agent-builder-setup;
 }
 
+.agent-builder-setup-card--sidebar .agent-builder-setup-card__actions {
+  gap: 0.25rem;
+}
+
+.agent-builder-setup-card--sidebar .agent-builder-setup-card__builder-button {
+  justify-content: center;
+  min-height: 2rem;
+}
+
+.agent-builder-setup-card--sidebar .agent-builder-setup-card__key-button {
+  align-self: center;
+  justify-content: center;
+  width: auto;
+  min-height: 1.5rem;
+  height: 1.5rem;
+  border: 0;
+  background: transparent;
+  color: hsl(var(--muted-foreground));
+  padding-inline: 0.25rem;
+}
+
+.agent-builder-setup-card--sidebar .agent-builder-setup-card__key-button:hover {
+  background: transparent;
+  color: hsl(var(--foreground));
+}
+
 @container agent-builder-setup (max-width: 560px) {
   .agent-builder-setup-card__content {
     align-items: stretch;
@@ -564,23 +630,19 @@
 
   .agent-builder-setup-card__builder-cta {
     align-items: stretch;
-    flex: 1 1 11rem;
+    flex: 0 1 auto;
   }
 
-  .agent-builder-setup-card__builder-button,
-  .agent-builder-setup-card__key-button {
+  .agent-builder-setup-card__builder-button {
     justify-content: center;
     min-width: 0;
     width: 100%;
   }
 
   .agent-builder-setup-card__key-button {
-    border: 1px solid hsl(var(--border));
-    background: hsl(var(--background));
-    color: hsl(var(--foreground));
-    flex: 1 1 8rem;
-    height: 2rem;
-    padding-inline: 0.75rem;
+    flex: 0 0 auto;
+    min-width: 0;
+    width: auto;
   }
 }
 
@@ -629,6 +691,28 @@
   overflow: visible;
 }
 
+[data-agent-empty-state="compact-setup"] > .agent-chat-scroll {
+  flex: 0 0 auto;
+  overflow: visible;
+}
+
+[data-agent-empty-state="compact-setup"] .agent-empty-state {
+  height: auto;
+  min-height: 5rem;
+  gap: 0.5rem;
+  padding-block: 0.875rem;
+}
+
+[data-agent-empty-state="compact-setup"] .agent-empty-state > div:first-child {
+  width: 2rem;
+  height: 2rem;
+}
+
+[data-agent-empty-state="compact-setup"] .agent-empty-state svg {
+  width: 1rem;
+  height: 1rem;
+}
+
 .agent-thinking-indicator {
   display: inline-flex;
   align-items: center;

package/dist/styles/rich-markdown-editor.css

@@ -333,11 +333,12 @@
   display: flex;
   align-items: center;
   border-radius: 6px;
-  background: hsl(0 0% 15%);
+  background: hsl(var(--popover));
+  color: hsl(var(--popover-foreground));
   padding: 3px;
   box-shadow:
     0 4px 16px rgb(0 0 0 / 0.25),
-    0 0 0 1px rgb(255 255 255 / 0.06);
+    0 0 0 1px hsl(var(--border));
 }
 
 .an-rich-md-bubble-items,
@@ -351,7 +352,7 @@
   padding: 3px 6px;
   border-radius: 4px;
   font-size: 12px;
-  color: rgb(255 255 255 / 0.76);
+  color: hsl(var(--popover-foreground) / 0.76);
   background: none;
   border: none;
   cursor: pointer;
@@ -359,20 +360,20 @@
 }
 
 .an-rich-md-bubble-button:hover {
-  background: rgb(255 255 255 / 0.12);
-  color: white;
+  background: hsl(var(--accent));
+  color: hsl(var(--accent-foreground));
 }
 
 .an-rich-md-bubble-button--active {
-  background: rgb(255 255 255 / 0.18);
-  color: white;
+  background: hsl(var(--accent));
+  color: hsl(var(--accent-foreground));
 }
 
 .an-rich-md-bubble-divider {
   width: 1px;
   height: 16px;
   margin: 0 2px;
-  background: rgb(255 255 255 / 0.2);
+  background: hsl(var(--border));
 }
 
 .an-rich-md-link-editor {
@@ -384,7 +385,7 @@
   border: none;
   outline: none;
   background: transparent;
-  color: white;
+  color: hsl(var(--popover-foreground));
   font-size: 12px;
   padding: 2px 4px;
 }
@@ -392,7 +393,7 @@
 .an-rich-md-link-editor button {
   border: none;
   background: none;
-  color: #60a5fa;
+  color: hsl(var(--primary));
   cursor: pointer;
   font-size: 11px;
   font-weight: 500;

package/docs/content/cloneable-saas.mdx

@@ -30,9 +30,9 @@ Each one is a real app you could use today, and the launching pad for your own v
 | [**Plan**](/docs/template-plan)           | Visual plans and PR recaps with diagrams, wireframes, and annotations.                                         |
 | [**Dispatch**](/docs/template-dispatch)   | The workspace control plane: shared secrets, reusable integrations, Slack/Telegram, scheduled jobs.            |
 
-Don't want a domain template? Use [Chat](/docs/template-chat) when you want a basic app users can talk to immediately, or start action-first with [Pure-Agent Apps](/docs/pure-agent-apps).
+Don't want a domain app? Use [Chat](/docs/template-chat) when you want a basic app users can talk to immediately, or start with an action in [Pure-Agent Apps](/docs/pure-agent-apps).
 
-See the full catalog under [Templates](/templates), or jump straight to one — for example, [Dispatch](/docs/template-dispatch) is a great place to start if you want a workspace-style app.
+See the full catalog under [Apps](/apps), or jump straight to one — for example, [Dispatch](/docs/template-dispatch) is a great place to start if you want a workspace-style app.
 
 ## What you get out of the box {#what-you-get}
 

package/docs/content/evals.mdx

@@ -90,13 +90,14 @@ export default defineEval({
 
 An eval passes only when **every** scorer meets the threshold. Key `defineEval` fields:
 
-| Field       | Type                  | Notes                                                         |
-| ----------- | --------------------- | ------------------------------------------------------------- |
-| `name`      | string                | Required. Shown in the report.                                |
-| `input`     | `{ prompt, history }` | Required `prompt`; optional prior `{ role, text }` turns.     |
-| `scorers`   | `Scorer[]`            | Required, at least one.                                       |
-| `threshold` | number `0..1`         | Per-scorer pass bar. Default `0.5`; overridable from the CLI. |
-| `run`       | function              | Optional override for custom setup (seed data, multi-turn).   |
+| Field        | Type                  | Notes                                                                                                           |
+| ------------ | --------------------- | --------------------------------------------------------------------------------------------------------------- |
+| `name`       | string                | Required. Shown in the report.                                                                                  |
+| `input`      | `{ prompt, history }` | Required `prompt`; optional prior `{ role, text }` turns.                                                       |
+| `scorers`    | `Scorer[]`            | Required, at least one, unless `skipReason` is set.                                                             |
+| `threshold`  | number `0..1`         | Per-scorer pass bar. Default `0.5`; overridable from the CLI.                                                   |
+| `run`        | function              | Optional override for custom setup (seed data, multi-turn).                                                     |
+| `skipReason` | string                | Optional reason to skip this eval without running the agent; useful for manual/nightly gates that need secrets. |
 
 The agent run handed to scorers is small and transport-agnostic:
 
@@ -225,11 +226,32 @@ The command discovers `**/*.eval.ts` and `evals/*.ts` under the current app, run
 
 Exit codes:
 
-| Code | Meaning                                                         |
-| ---- | --------------------------------------------------------------- |
-| `0`  | All evals passed — _or_ no eval files were found (CI-friendly). |
-| `1`  | At least one eval scored below threshold, or the suite errored. |
-| `2`  | Bad arguments (e.g. `--threshold` outside `[0, 1]`).            |
+| Code | Meaning                                                                          |
+| ---- | -------------------------------------------------------------------------------- |
+| `0`  | All evals passed, evals were skipped, or no eval files were found (CI-friendly). |
+| `1`  | At least one eval scored below threshold, or the suite errored.                  |
+| `2`  | Bad arguments (e.g. `--threshold` outside `[0, 1]`).                             |
+
+### Skipping gated evals {#skipping}
+
+Use `skipReason` when an eval suite is intentionally gated behind manual,
+nightly, or secret-backed execution:
+
+```ts
+export default defineEval({
+  name: "provider-backed source sync",
+  input: { prompt: "Refresh the source and summarize the changes." },
+  skipReason: process.env.SOURCE_SYNC_EVALS
+    ? undefined
+    : "Skipped because SOURCE_SYNC_EVALS is unset",
+  scorers: process.env.SOURCE_SYNC_EVALS ? [contains("updated")] : [],
+});
+```
+
+Skipped evals do not run the agent or scorers, do not fail the suite, and are
+reported distinctly with `status: "skipped"` and `skipReason` in JSON output.
+Use this for expensive or credential-dependent evals; keep cheap deterministic
+coverage in normal PR CI.
 
 ### As a CI deploy gate {#ci}
 

package/docs/content/faq.mdx

@@ -116,7 +116,7 @@ No. You don't train models, fine-tune, or deal with embeddings. You build a regu
 
 ### Can I migrate an existing app to agent-native? {#can-i-use-existing-code}
 
-You can, but agent-native works best when built from the ground up. The architecture — shared database, polling sync, actions, application state — needs to be integrated throughout. Starting from a template and customizing it is the recommended path. Think of it like the shift from desktop-first to mobile-first: you _can_ retrofit, but building native is better.
+You can, but agent-native works best when built from the ground up. The architecture — shared database, polling sync, actions, application state — needs to be integrated throughout. Starting from an app and customizing it is the recommended path. Think of it like the shift from desktop-first to mobile-first: you _can_ retrofit, but building native is better.
 
 ## Templates and what you can build {#templates}
 

package/docs/content/locales/ar-SA/cloneable-saas.mdx

@@ -30,9 +30,9 @@ description: "ابتكر منتج SaaS فعالاً واجعله ملكك - بم
 | [**Plan**](/docs/template-plan)           | الخطط المرئية وملخصات العلاقات العامة مع المخططات والإطارات السلكية والتعليقات التوضيحية.                                                  |
 | [**Dispatch**](/docs/template-dispatch)   | مستوى التحكم في مساحة العمل: الأسرار المشتركة، عمليات التكامل القابلة لإعادة الاستخدام، Slack/Telegram، المهام المجدولة.                   |
 
-ألا تريد قالب المجال؟ استخدم [Chat](/docs/template-chat) عندما تريد تطبيقًا أساسيًا يمكن للمستخدمين التحدث إليه على الفور، أو بدء الإجراء أولاً باستخدام [Pure-Agent Apps](/docs/pure-agent-apps).
+ألا تريد تطبيق مجال؟ استخدم [Chat](/docs/template-chat) عندما تريد تطبيقًا أساسيًا يمكن للمستخدمين التحدث إليه على الفور، أو ابدأ بإجراء في [Pure-Agent Apps](/docs/pure-agent-apps).
 
-اطلع على الكتالوج الكامل ضمن [Templates](/templates)، أو انتقل مباشرة إلى أحد الكتالوجات - على سبيل المثال، [Dispatch](/docs/template-dispatch) هو مكان رائع للبدء إذا كنت تريد تطبيقًا على طراز مساحة العمل.
+اطلع على الكتالوج الكامل ضمن [Apps](/apps)، أو انتقل مباشرة إلى أحد الكتالوجات - على سبيل المثال، [Dispatch](/docs/template-dispatch) هو مكان رائع للبدء إذا كنت تريد تطبيقًا على طراز مساحة العمل.
 
 ## ما الذي تحصل عليه خارج الصندوق {#what-you-get}
 

package/docs/content/locales/ar-SA/evals.mdx

@@ -231,6 +231,13 @@ agent-native eval --threshold 0.8    # override every eval's pass threshold (0..
 | `1`   | تم تسجيل تقييم واحد على الأقل أقل من الحد الأدنى، أو حدث خطأ في المجموعة.           |
 | `2`   | وسيطات غير صالحة (على سبيل المثال، `--threshold` خارج `[0, 1]`).                    |
 
+### تخطي التقييمات المحكومة {#skipping}
+
+استخدم `skipReason` عندما تكون مجموعة التقييمات مخصصة عمدا للتشغيل اليدوي أو
+الليلي أو المعتمد على الأسرار. لا تشغل التقييمات المتخطاة الوكيل أو أدوات
+التسجيل، ولا تفشل المجموعة، وتظهر في JSON مع `status: "skipped"` و
+`skipReason`. أبق التغطية الحتمية الرخيصة في CI العادي لطلبات السحب.
+
 ### كبوابة نشر CI {#ci}
 
 قم بإضافته إلى المسار الذي يتم تشغيله قبل النشر:

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

@@ -116,7 +116,7 @@ Anthropic Claude وOpenAI (عائلة GPT-5) وGoogle Gemini وأي مزود ي
 
 ### هل يمكنني ترحيل تطبيق موجود إلى الوكيل الأصلي؟ {#can-i-use-existing-code}
 
-يمكنك ذلك، ولكن الوكيل الأصلي يعمل بشكل أفضل عند إنشائه من الألف إلى الياء. يجب أن تكون البنية - قاعدة البيانات المشتركة، ومزامنة الاستقصاء، وactions، وحالة التطبيق - متكاملة طوال الوقت. البدء من القالب وتخصيصه هو المسار الموصى به. فكر في الأمر مثل التحول من سطح المكتب أولاً إلى الهاتف المحمول أولاً: يمكنك التعديل التحديثي، ولكن إنشاء المحتوى الأصلي هو الأفضل.
+يمكنك ذلك، ولكن الوكيل الأصلي يعمل بشكل أفضل عند إنشائه من الألف إلى الياء. يجب أن تكون البنية - قاعدة البيانات المشتركة، ومزامنة الاستقصاء، وactions، وحالة التطبيق - متكاملة طوال الوقت. البدء من تطبيق وتخصيصه هو المسار الموصى به. فكر في الأمر مثل التحول من سطح المكتب أولاً إلى الهاتف المحمول أولاً: يمكنك التعديل التحديثي، ولكن إنشاء المحتوى الأصلي هو الأفضل.
 
 ## النماذج وما يمكنك إنشاؤه {#templates}
 

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

@@ -13,7 +13,7 @@ description: "تطبيق بسيط للوكيل الأصلي للدردشة أو
   <Screen
     surface="desktop"
     html={
-      "<div style='min-height:560px;box-sizing:border-box;display:flex;align-items:center;justify-content:center;padding:56px 40px'><div style='display:flex;flex-direction:column;align-items:center;justify-content:center;gap:28px;width:min(700px,92%);min-height:430px'><div style='height:34px'></div><div style='text-align:center'><h1 style='margin:0'>كيف يمكنني المساعدة؟</h1><p class='wf-muted' style='margin:10px 0 0'>دردش حول أي شيء. أضف إجراءات أو مكونات أو صفحات أو مهام أو خلفيتك الخاصة.</p></div><div class='wf-card' style='width:100%;min-height:150px;display:flex;flex-direction:column;gap:18px'><span class='wf-muted'>راسل الوكيل...</span><div style='flex:1'></div><div style='display:flex;align-items:center;gap:10px'><span data-icon='plus' aria-label='Attach'></span><div style='flex:1'></div><span class='wf-pill'>Sonnet 4.6 · Auto</span><span class='wf-pill'>Act</span><button class='primary'>↑</button></div></div><div style='height:34px'></div></div></div>"
+      "<div style='min-height:560px;box-sizing:border-box;display:flex;align-items:center;justify-content:center;padding:56px 40px'><div style='display:flex;flex-direction:column;align-items:center;justify-content:center;gap:28px;width:min(700px,92%);min-height:430px'><div style='height:34px'></div><div style='text-align:center'><h1 style='margin:0'>كيف يمكنني المساعدة؟</h1><p class='wf-muted' style='margin:10px 0 0'>دردش حول أي شيء. أضف إجراءات أو مكونات أو صفحات أو مهام أو خلفيتك الخاصة.</p></div><div class='wf-card' style='width:100%;min-height:150px;display:flex;flex-direction:column;gap:18px'><span class='wf-muted'>راسل الوكيل...</span><div style='flex:1'></div><div style='display:flex;align-items:center;gap:10px'><span data-icon='plus' aria-label='Attach'></span><div style='flex:1'></div><span class='wf-pill'>Sonnet 5 · تلقائي</span><span class='wf-pill'>Act</span><button class='primary'>↑</button></div></div><div style='height:34px'></div></div></div>"
     }
   />
 </WireframeBlock>

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

@@ -30,9 +30,9 @@ Jede davon ist eine echte App, die Sie heute verwenden können, und die Startram
 | [**Plan**](/docs/template-plan)           | Visuelle Pläne und PR-Zusammenfassungen mit Diagrammen, Wireframes und Anmerkungen.                                                                        |
 | [**Dispatch**](/docs/template-dispatch)   | Die Workspace-Steuerungsebene: gemeinsame Geheimnisse, wiederverwendbare Integrationen, Slack/Telegram, geplante Jobs.                                     |
 
-Sie möchten keine Domain-Vorlage? Verwenden Sie [Chat](/docs/template-chat), wenn Sie eine einfache App wünschen, mit der Benutzer sofort sprechen können, oder beginnen Sie mit [Pure-Agent Apps](/docs/pure-agent-apps) zuerst mit der Aktion.
+Sie möchten keine Domain-App? Verwenden Sie [Chat](/docs/template-chat), wenn Sie eine einfache App wünschen, mit der Benutzer sofort sprechen können, oder beginnen Sie mit einer Aktion in [Pure-Agent Apps](/docs/pure-agent-apps).
 
-Sehen Sie sich den vollständigen Katalog unter [Templates](/templates) an oder springen Sie direkt zu einem – [Dispatch](/docs/template-dispatch) ist beispielsweise ein großartiger Ausgangspunkt, wenn Sie eine App im Workspace-Stil wünschen.
+Sehen Sie sich den vollständigen Katalog unter [Apps](/apps) an oder springen Sie direkt zu einem – [Dispatch](/docs/template-dispatch) ist beispielsweise ein großartiger Ausgangspunkt, wenn Sie eine App im Workspace-Stil wünschen.
 
 ## Was Sie im Lieferumfang enthalten {#what-you-get}
 

package/docs/content/locales/de-DE/evals.mdx

@@ -231,6 +231,14 @@ Exit-Codes:
 | `1`  | Mindestens eine Bewertung lag unter dem Schwellenwert oder die Suite ist fehlerhaft.                |
 | `2`  | Ungültige Argumente (z. B. `--threshold` außerhalb von `[0, 1]`).                                   |
 
+### Gated Evals überspringen {#skipping}
+
+Verwenden Sie `skipReason`, wenn eine Eval-Suite absichtlich nur manuell,
+nachts oder mit Secrets ausgeführt werden soll. Übersprungene Evals führen
+weder Agent noch Scorer aus, lassen die Suite nicht fehlschlagen und erscheinen
+in der JSON-Ausgabe mit `status: "skipped"` und `skipReason`. Günstige
+deterministische Abdeckung bleibt im normalen PR-CI.
+
 ### Als CI-Deploy-Gate {#ci}
 
 Fügen Sie es der Pipeline hinzu, die vor einer Bereitstellung ausgeführt wird:

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

@@ -116,7 +116,7 @@ Nein. Sie trainieren keine Modelle, nehmen keine Feinabstimmung vor und befassen
 
 ### Kann ich eine vorhandene App auf Agent-nativ migrieren? {#can-i-use-existing-code}
 
-Das ist möglich, aber Agent-nativ funktioniert am besten, wenn es von Grund auf neu entwickelt wird. Die Architektur – gemeinsam genutzte Datenbank, Polling-Synchronisierung, actions, Anwendungsstatus – muss durchgehend integriert sein. Der empfohlene Weg besteht darin, von einer Vorlage auszugehen und diese anzupassen. Stellen Sie sich das wie den Wechsel von Desktop-First zu Mobile-First vor: Sie _können_ nachrüsten, aber nativ zu bauen ist besser.
+Das ist möglich, aber Agent-nativ funktioniert am besten, wenn es von Grund auf neu entwickelt wird. Die Architektur – gemeinsam genutzte Datenbank, Polling-Synchronisierung, actions, Anwendungsstatus – muss durchgehend integriert sein. Der empfohlene Weg besteht darin, von einer App auszugehen und diese anzupassen. Stellen Sie sich das wie den Wechsel von Desktop-First zu Mobile-First vor: Sie _können_ nachrüsten, aber nativ zu bauen ist besser.
 
 ## Vorlagen und was Sie erstellen können {#templates}
 

package/docs/content/locales/de-DE/template-chat.mdx

@@ -13,7 +13,7 @@ Wenn Sie die kleinste reine Aktionslaufzeit ohne Browser UI wünschen, beginnen
   <Screen
     surface="desktop"
     html={
-      "<div style='min-height:560px;box-sizing:border-box;display:flex;align-items:center;justify-content:center;padding:56px 40px'><div style='display:flex;flex-direction:column;align-items:center;justify-content:center;gap:28px;width:min(700px,92%);min-height:430px'><div style='height:34px'></div><div style='text-align:center'><h1 style='margin:0'>Wie kann ich helfen?</h1><p class='wf-muted' style='margin:10px 0 0'>Chatte über alles. Füge Actions, Komponenten, Seiten, Jobs oder dein eigenes Backend hinzu.</p></div><div class='wf-card' style='width:100%;min-height:150px;display:flex;flex-direction:column;gap:18px'><span class='wf-muted'>Nachricht an den Agenten...</span><div style='flex:1'></div><div style='display:flex;align-items:center;gap:10px'><span data-icon='plus' aria-label='Attach'></span><div style='flex:1'></div><span class='wf-pill'>Sonnet 4.6 · Auto</span><span class='wf-pill'>Act</span><button class='primary'>↑</button></div></div><div style='height:34px'></div></div></div>"
+      "<div style='min-height:560px;box-sizing:border-box;display:flex;align-items:center;justify-content:center;padding:56px 40px'><div style='display:flex;flex-direction:column;align-items:center;justify-content:center;gap:28px;width:min(700px,92%);min-height:430px'><div style='height:34px'></div><div style='text-align:center'><h1 style='margin:0'>Wie kann ich helfen?</h1><p class='wf-muted' style='margin:10px 0 0'>Chatte über alles. Füge Actions, Komponenten, Seiten, Jobs oder dein eigenes Backend hinzu.</p></div><div class='wf-card' style='width:100%;min-height:150px;display:flex;flex-direction:column;gap:18px'><span class='wf-muted'>Nachricht an den Agenten...</span><div style='flex:1'></div><div style='display:flex;align-items:center;gap:10px'><span data-icon='plus' aria-label='Attach'></span><div style='flex:1'></div><span class='wf-pill'>Sonnet 5 · Standard</span><span class='wf-pill'>Act</span><button class='primary'>↑</button></div></div><div style='height:34px'></div></div></div>"
     }
   />
 </WireframeBlock>

package/docs/content/locales/es-ES/cloneable-saas.mdx

@@ -30,9 +30,9 @@ Cada una es una aplicación real que puedes usar hoy y la plataforma de lanzamie
 | [**Plan**](/docs/template-plan)           | Planos visuales y resúmenes de relaciones públicas con diagramas, esquemas y anotaciones.                                                        |
 | [**Dispatch**](/docs/template-dispatch)   | El plano de control del espacio de trabajo: secretos compartidos, integraciones reutilizables, Slack/Telegram, trabajos programados.             |
 
-¿No quieres una plantilla de dominio? Utilice [Chat](/docs/template-chat) cuando desee una aplicación básica con la que los usuarios puedan hablar inmediatamente o comience a actuar primero con [Pure-Agent Apps](/docs/pure-agent-apps).
+¿No quieres una aplicación de dominio? Utilice [Chat](/docs/template-chat) cuando desee una aplicación básica con la que los usuarios puedan hablar inmediatamente, o comience con una acción en [Pure-Agent Apps](/docs/pure-agent-apps).
 
-Vea el catálogo completo en [Templates](/templates) o vaya directamente a uno; por ejemplo, [Dispatch](/docs/template-dispatch) es un excelente lugar para comenzar si desea una aplicación estilo espacio de trabajo.
+Vea el catálogo completo en [Apps](/apps) o vaya directamente a uno; por ejemplo, [Dispatch](/docs/template-dispatch) es un excelente lugar para comenzar si desea una aplicación estilo espacio de trabajo.
 
 ## Lo que obtienes de la caja {#what-you-get}
 

package/docs/content/locales/es-ES/evals.mdx

@@ -231,6 +231,14 @@ Códigos de salida:
 | `1`    | Al menos una evaluación obtuvo una puntuación inferior al umbral o la suite tuvo un error.                |
 | `2`    | Malos argumentos (por ejemplo, `--threshold` fuera de `[0, 1]`).                                          |
 
+### Omitir evaluaciones gated {#skipping}
+
+Use `skipReason` cuando una suite de evaluaciones esté reservada
+intencionalmente para ejecución manual, nocturna o con secretos. Las
+evaluaciones omitidas no ejecutan el agente ni los scorers, no hacen fallar la
+suite y aparecen en JSON con `status: "skipped"` y `skipReason`. Mantenga la
+cobertura determinista barata en el CI normal de PR.
+
 ### Como puerta de implementación de CI {#ci}
 
 Agréguelo al proceso que se ejecuta antes de una implementación:

package/docs/content/locales/es-ES/faq.mdx

@@ -116,7 +116,7 @@ No. No se entrenan modelos, no se ajustan ni se ocupan de incrustaciones. Creas
 
 ### ¿Puedo migrar una aplicación existente a agente nativo? {#can-i-use-existing-code}
 
-Puedes, pero el agente nativo funciona mejor cuando se construye desde cero. La arquitectura (base de datos compartida, sincronización de sondeos, actions, estado de la aplicación) debe estar integrada en todo momento. Partir de una plantilla y personalizarla es el camino recomendado. Piense en ello como el cambio de una computadora de escritorio primero a una computadora móvil primero: _puede_ modernizarse, pero crear contenido nativo es mejor.
+Puedes, pero el agente nativo funciona mejor cuando se construye desde cero. La arquitectura (base de datos compartida, sincronización de sondeos, actions, estado de la aplicación) debe estar integrada en todo momento. Partir de una app y personalizarla es el camino recomendado. Piense en ello como el cambio de una computadora de escritorio primero a una computadora móvil primero: _puede_ modernizarse, pero crear contenido nativo es mejor.
 
 ## Plantillas y lo que puedes crear {#templates}
 

package/docs/content/locales/es-ES/template-chat.mdx

@@ -13,7 +13,7 @@ Si desea el tiempo de ejecución más pequeño de solo acciones sin navegador UI
   <Screen
     surface="desktop"
     html={
-      "<div style='min-height:560px;box-sizing:border-box;display:flex;align-items:center;justify-content:center;padding:56px 40px'><div style='display:flex;flex-direction:column;align-items:center;justify-content:center;gap:28px;width:min(700px,92%);min-height:430px'><div style='height:34px'></div><div style='text-align:center'><h1 style='margin:0'>¿Cómo puedo ayudar?</h1><p class='wf-muted' style='margin:10px 0 0'>Habla de cualquier cosa. Añade acciones, componentes, páginas, jobs o tu propio backend.</p></div><div class='wf-card' style='width:100%;min-height:150px;display:flex;flex-direction:column;gap:18px'><span class='wf-muted'>Escribe al agente...</span><div style='flex:1'></div><div style='display:flex;align-items:center;gap:10px'><span data-icon='plus' aria-label='Attach'></span><div style='flex:1'></div><span class='wf-pill'>Sonnet 4.6 · Auto</span><span class='wf-pill'>Act</span><button class='primary'>↑</button></div></div><div style='height:34px'></div></div></div>"
+      "<div style='min-height:560px;box-sizing:border-box;display:flex;align-items:center;justify-content:center;padding:56px 40px'><div style='display:flex;flex-direction:column;align-items:center;justify-content:center;gap:28px;width:min(700px,92%);min-height:430px'><div style='height:34px'></div><div style='text-align:center'><h1 style='margin:0'>¿Cómo puedo ayudar?</h1><p class='wf-muted' style='margin:10px 0 0'>Habla de cualquier cosa. Añade acciones, componentes, páginas, jobs o tu propio backend.</p></div><div class='wf-card' style='width:100%;min-height:150px;display:flex;flex-direction:column;gap:18px'><span class='wf-muted'>Escribe al agente...</span><div style='flex:1'></div><div style='display:flex;align-items:center;gap:10px'><span data-icon='plus' aria-label='Attach'></span><div style='flex:1'></div><span class='wf-pill'>Sonnet 5 · Predeterminado</span><span class='wf-pill'>Act</span><button class='primary'>↑</button></div></div><div style='height:34px'></div></div></div>"
     }
   />
 </WireframeBlock>

package/docs/content/locales/fr-FR/cloneable-saas.mdx

@@ -30,9 +30,9 @@ Chacune est une véritable application que vous pouvez utiliser aujourd'hui, et
 | [**Plan**](/docs/template-plan)           | Plans visuels et récapitulatifs des relations publiques avec diagrammes, wireframes et annotations.                                                            |
 | [**Dispatch**](/docs/template-dispatch)   | Le plan de contrôle de l'espace de travail : secrets partagés, intégrations réutilisables, Slack/Telegram, tâches planifiées.                                  |
 
-Vous ne voulez pas de modèle de domaine ? Utilisez [Chat](/docs/template-chat) lorsque vous souhaitez une application de base avec laquelle les utilisateurs peuvent parler immédiatement, ou lancez l'action en premier avec [Pure-Agent Apps](/docs/pure-agent-apps).
+Vous ne voulez pas d'application de domaine ? Utilisez [Chat](/docs/template-chat) lorsque vous souhaitez une application de base avec laquelle les utilisateurs peuvent parler immédiatement, ou commencez par une action dans [Pure-Agent Apps](/docs/pure-agent-apps).
 
-Consultez le catalogue complet sous [Templates](/templates) ou passez directement à l'un d'entre eux. Par exemple, [Dispatch](/docs/template-dispatch) est un excellent point de départ si vous souhaitez une application de style espace de travail.
+Consultez le catalogue complet sous [Apps](/apps) ou passez directement à l'un d'entre eux. Par exemple, [Dispatch](/docs/template-dispatch) est un excellent point de départ si vous souhaitez une application de style espace de travail.
 
 ## Ce que vous obtenez hors de la boîte {#what-you-get}
 

package/docs/content/locales/fr-FR/evals.mdx

@@ -231,6 +231,14 @@ Codes de sortie :
 | `1`  | Au moins une évaluation a obtenu un score inférieur au seuil, ou la suite a commis une erreur.      |
 | `2`  | Mauvais arguments (par exemple `--threshold` en dehors de `[0, 1]`).                                |
 
+### Ignorer les évaluations gated {#skipping}
+
+Utilisez `skipReason` lorsqu'une suite d'évaluations est volontairement réservée
+à une exécution manuelle, nocturne ou dépendante de secrets. Les évaluations
+ignorées n'exécutent ni l'agent ni les scorers, ne font pas échouer la suite, et
+apparaissent dans la sortie JSON avec `status: "skipped"` et `skipReason`.
+Gardez la couverture déterministe peu coûteuse dans le CI normal des PR.
+
 ### En tant que porte de déploiement CI {#ci}
 
 Ajoutez-le au pipeline qui s'exécute avant un déploiement :

package/docs/content/locales/fr-FR/faq.mdx

@@ -116,7 +116,7 @@ Non. Vous ne formez pas de modèles, n'ajustez pas et ne gérez pas les intégra
 
 ### Puis-je migrer une application existante vers une application native pour agent ? {#can-i-use-existing-code}
 
-C'est possible, mais l'agent natif fonctionne mieux lorsqu'il est construit à partir de zéro. L'architecture (base de données partagée, synchronisation des interrogations, actions, état de l'application) doit être intégrée partout. Partir d’un modèle et le personnaliser est le chemin recommandé. Pensez-y comme au passage d'un ordinateur de bureau d'abord à un mobile d'abord : vous _pouvez_ effectuer une mise à niveau, mais construire en natif, c'est mieux.
+C'est possible, mais l'agent natif fonctionne mieux lorsqu'il est construit à partir de zéro. L'architecture (base de données partagée, synchronisation des interrogations, actions, état de l'application) doit être intégrée partout. Partir d’une app et la personnaliser est le chemin recommandé. Pensez-y comme au passage d'un ordinateur de bureau d'abord à un mobile d'abord : vous _pouvez_ effectuer une mise à niveau, mais construire en natif, c'est mieux.
 
 ## Modèles et ce que vous pouvez créer {#templates}
 

package/docs/content/locales/fr-FR/template-chat.mdx

@@ -13,7 +13,7 @@ Si vous souhaitez le plus petit environnement d'exécution d'action uniquement s
   <Screen
     surface="desktop"
     html={
-      "<div style='min-height:560px;box-sizing:border-box;display:flex;align-items:center;justify-content:center;padding:56px 40px'><div style='display:flex;flex-direction:column;align-items:center;justify-content:center;gap:28px;width:min(700px,92%);min-height:430px'><div style='height:34px'></div><div style='text-align:center'><h1 style='margin:0'>Comment puis-je aider ?</h1><p class='wf-muted' style='margin:10px 0 0'>Discutez de tout. Ajoutez actions, composants, pages, jobs ou votre propre backend.</p></div><div class='wf-card' style='width:100%;min-height:150px;display:flex;flex-direction:column;gap:18px'><span class='wf-muted'>Écrire à l’agent...</span><div style='flex:1'></div><div style='display:flex;align-items:center;gap:10px'><span data-icon='plus' aria-label='Attach'></span><div style='flex:1'></div><span class='wf-pill'>Sonnet 4.6 · Auto</span><span class='wf-pill'>Act</span><button class='primary'>↑</button></div></div><div style='height:34px'></div></div></div>"
+      "<div style='min-height:560px;box-sizing:border-box;display:flex;align-items:center;justify-content:center;padding:56px 40px'><div style='display:flex;flex-direction:column;align-items:center;justify-content:center;gap:28px;width:min(700px,92%);min-height:430px'><div style='height:34px'></div><div style='text-align:center'><h1 style='margin:0'>Comment puis-je aider ?</h1><p class='wf-muted' style='margin:10px 0 0'>Discutez de tout. Ajoutez actions, composants, pages, jobs ou votre propre backend.</p></div><div class='wf-card' style='width:100%;min-height:150px;display:flex;flex-direction:column;gap:18px'><span class='wf-muted'>Écrire à l’agent...</span><div style='flex:1'></div><div style='display:flex;align-items:center;gap:10px'><span data-icon='plus' aria-label='Attach'></span><div style='flex:1'></div><span class='wf-pill'>Sonnet 5 · Par défaut</span><span class='wf-pill'>Act</span><button class='primary'>↑</button></div></div><div style='height:34px'></div></div></div>"
     }
   />
 </WireframeBlock>

package/docs/content/locales/hi-IN/cloneable-saas.mdx

@@ -30,9 +30,9 @@ description: "एक कार्यशील SaaS उत्पाद को फ
 | [**Plan**](/docs/template-plan)           | चित्र, वायरफ्रेम और एनोटेशन के साथ विज़ुअल योजनाएं और पीआर पुनर्कथन।                                                 |
 | [**Dispatch**](/docs/template-dispatch)   | कार्यस्थान नियंत्रण विमान: साझा रहस्य, पुन: प्रयोज्य एकीकरण, Slack/टेलीग्राम, निर्धारित कार्य।                       |
 
-डोमेन टेम्पलेट नहीं चाहिए? जब आप एक बुनियादी ऐप चाहते हैं जिससे उपयोगकर्ता तुरंत बात कर सकें तो [Chat](/docs/template-chat) का उपयोग करें, या [Pure-Agent Apps](/docs/pure-agent-apps) के साथ सबसे पहले कार्रवाई शुरू करें।
+डोमेन ऐप नहीं चाहिए? जब आप एक बुनियादी ऐप चाहते हैं जिससे उपयोगकर्ता तुरंत बात कर सकें तो [Chat](/docs/template-chat) का उपयोग करें, या [Pure-Agent Apps](/docs/pure-agent-apps) में एक action से शुरू करें।
 
-[Templates](/templates) के अंतर्गत पूरा कैटलॉग देखें, या सीधे एक पर जाएं - उदाहरण के लिए, यदि आप वर्कस्पेस-शैली ऐप चाहते हैं तो [Dispatch](/docs/template-dispatch) शुरू करने के लिए एक शानदार जगह है।
+[Apps](/apps) के अंतर्गत पूरा कैटलॉग देखें, या सीधे एक पर जाएं - उदाहरण के लिए, यदि आप वर्कस्पेस-शैली ऐप चाहते हैं तो [Dispatch](/docs/template-dispatch) शुरू करने के लिए एक शानदार जगह है।
 
 ## आपको बॉक्स से क्या मिलता है {#what-you-get}
 

package/docs/content/locales/hi-IN/evals.mdx

@@ -229,6 +229,14 @@ agent-native eval --threshold 0.8    # override every eval's pass threshold (0..
 | `1` | कम से कम एक ईवल ने सीमा से नीचे स्कोर किया, या सुइट में त्रुटि हुई। |
 | `2` | खराब तर्क (उदाहरण के लिए `[0, 1]` के बाहर `--threshold`)।           |
 
+### gated evals छोड़ना {#skipping}
+
+जब कोई eval suite केवल manual, nightly, या secret-backed execution के लिए हो,
+तो `skipReason` का उपयोग करें। छोड़े गए evals agent या scorers नहीं चलाते,
+suite को fail नहीं करते, और JSON output में `status: "skipped"` और
+`skipReason` के साथ दिखते हैं। सस्ती deterministic coverage को सामान्य PR CI
+में रखें।
+
 ### सीआई परिनियोजन गेट के रूप में {#ci}
 
 इसे उस पाइपलाइन में जोड़ें जो परिनियोजन से पहले चलती है:

package/docs/content/locales/hi-IN/faq.mdx

@@ -114,7 +114,7 @@ description: "एजेंट-नेटिव के बारे में स
 
 ### क्या मैं किसी मौजूदा ऐप को एजेंट-नेटिव में स्थानांतरित कर सकता हूं? {#can-i-use-existing-code}
 
-आप कर सकते हैं, लेकिन एजेंट-नेटिव सबसे अच्छा तब काम करता है जब उसे ज़मीन से ऊपर बनाया जाता है। आर्किटेक्चर - साझा डेटाबेस, पोलिंग सिंक, actions, एप्लिकेशन स्थिति - को संपूर्ण रूप से एकीकृत करने की आवश्यकता है। एक टेम्पलेट से शुरू करना और उसे अनुकूलित करना अनुशंसित पथ है। इसे डेस्कटॉप-फर्स्ट से मोबाइल-फर्स्ट में बदलाव की तरह समझें: आप रेट्रोफिट कर सकते हैं, लेकिन देशी निर्माण करना बेहतर है।
+आप कर सकते हैं, लेकिन एजेंट-नेटिव सबसे अच्छा तब काम करता है जब उसे ज़मीन से ऊपर बनाया जाता है। आर्किटेक्चर - साझा डेटाबेस, पोलिंग सिंक, actions, एप्लिकेशन स्थिति - को संपूर्ण रूप से एकीकृत करने की आवश्यकता है। एक ऐप से शुरू करना और उसे अनुकूलित करना अनुशंसित पथ है। इसे डेस्कटॉप-फर्स्ट से मोबाइल-फर्स्ट में बदलाव की तरह समझें: आप रेट्रोफिट कर सकते हैं, लेकिन देशी निर्माण करना बेहतर है।
 
 ## टेम्प्लेट और आप क्या बना सकते हैं {#templates}
 

package/docs/content/locales/hi-IN/template-chat.mdx

@@ -13,7 +13,7 @@ description: "एक न्यूनतम चैट-फर्स्ट एज
   <Screen
     surface="desktop"
     html={
-      "<div style='min-height:560px;box-sizing:border-box;display:flex;align-items:center;justify-content:center;padding:56px 40px'><div style='display:flex;flex-direction:column;align-items:center;justify-content:center;gap:28px;width:min(700px,92%);min-height:430px'><div style='height:34px'></div><div style='text-align:center'><h1 style='margin:0'>मैं कैसे मदद कर सकता हूं?</h1><p class='wf-muted' style='margin:10px 0 0'>किसी भी चीज़ पर चैट करें। actions, components, pages, jobs, या अपना backend जोड़ें।</p></div><div class='wf-card' style='width:100%;min-height:150px;display:flex;flex-direction:column;gap:18px'><span class='wf-muted'>एजेंट को संदेश भेजें...</span><div style='flex:1'></div><div style='display:flex;align-items:center;gap:10px'><span data-icon='plus' aria-label='Attach'></span><div style='flex:1'></div><span class='wf-pill'>Sonnet 4.6 · Auto</span><span class='wf-pill'>Act</span><button class='primary'>↑</button></div></div><div style='height:34px'></div></div></div>"
+      "<div style='min-height:560px;box-sizing:border-box;display:flex;align-items:center;justify-content:center;padding:56px 40px'><div style='display:flex;flex-direction:column;align-items:center;justify-content:center;gap:28px;width:min(700px,92%);min-height:430px'><div style='height:34px'></div><div style='text-align:center'><h1 style='margin:0'>मैं कैसे मदद कर सकता हूं?</h1><p class='wf-muted' style='margin:10px 0 0'>किसी भी चीज़ पर चैट करें। actions, components, pages, jobs, या अपना backend जोड़ें।</p></div><div class='wf-card' style='width:100%;min-height:150px;display:flex;flex-direction:column;gap:18px'><span class='wf-muted'>एजेंट को संदेश भेजें...</span><div style='flex:1'></div><div style='display:flex;align-items:center;gap:10px'><span data-icon='plus' aria-label='Attach'></span><div style='flex:1'></div><span class='wf-pill'>Sonnet 5 · स्वतः</span><span class='wf-pill'>Act</span><button class='primary'>↑</button></div></div><div style='height:34px'></div></div></div>"
     }
   />
 </WireframeBlock>

package/docs/content/locales/ja-JP/cloneable-saas.mdx

@@ -30,9 +30,9 @@ description: "動作する SaaS 製品をフォークして、エージェント
 | [**Plan**](/docs/template-plan)           | 図、ワイヤーフレーム、注釈を使用した視覚的な計画と PR の要約。                                                                          |
 | [**Dispatch**](/docs/template-dispatch)   | ワークスペース コントロール プレーン: 共有シークレット、再利用可能な統合、Slack/テレグラム、スケジュールされたジョブ。                  |
 
-ドメイン テンプレートが不要ですか?ユーザーがすぐに会話できる基本的なアプリが必要な場合は、[Chat](/docs/template-chat) を使用するか、[Pure-Agent Apps](/docs/pure-agent-apps) で最初にアクションを開始してください。
+ドメイン アプリが不要ですか?ユーザーがすぐに会話できる基本的なアプリが必要な場合は、[Chat](/docs/template-chat) を使用するか、[Pure-Agent Apps](/docs/pure-agent-apps) でアクションから始めてください。
 
-[Templates](/templates) で完全なカタログを参照するか、カタログに直接ジャンプしてください。たとえば、ワークスペース スタイルのアプリが必要な場合は、[Dispatch](/docs/template-dispatch) から始めるのが最適です。
+[Apps](/apps) で完全なカタログを参照するか、カタログに直接ジャンプしてください。たとえば、ワークスペース スタイルのアプリが必要な場合は、[Dispatch](/docs/template-dispatch) から始めるのが最適です。
 
 ## 箱から出してすぐに手に入るもの {#what-you-get}