@agent-native/core 0.87.0 → 0.90.1

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

@@ -34,7 +34,7 @@ App-Agent intakt.
     <div class="ext-helpers">
       <span class="diagram-pill">appAction</span
       ><span class="diagram-pill">appFetch</span
-      ><span class="diagram-pill">dbQuery / dbExec</span
+      ><span class="diagram-pill">dbQuery</span
       ><span class="diagram-pill">extensionData</span
       ><span class="diagram-pill">extensionFetch</span>
     </div>
@@ -227,7 +227,7 @@ Innerhalb der Iframe-Sandbox verfügt jede Erweiterung über diese Helfer auf `w
 | `appAction(name, params)`                        | Rufen Sie einen beliebigen actions der Host-Vorlage auf             | `appAction('list-emails', { view: 'inbox' })`             |
 | `appFetch(path, options)`                        | Zulässige Framework-Endpunkte unter `/_agent-native/*` aufrufen     | `appFetch('/_agent-native/application-state/navigation')` |
 | `dbQuery(sql, args)`                             | Lesen aus SQL (automatisch auf den Benutzer beschränkt)             | `dbQuery('SELECT id, name FROM tools')`                   |
-| `dbExec(sql, args)`                              | In SQL schreiben                                                    | `dbExec('INSERT INTO ...')`                               |
+| `dbExec(sql, args)`                              | Legacy trusted SQL writes for editor/admin extensions               | Prefer `appAction` for app data writes                    |
 | `extensionFetch(url, options)`                   | Treffen Sie externe APIs über einen sicheren Proxy mit Geheimnissen | `extensionFetch('https://api.github.com/user')`           |
 | `extensionData.set(collection, id, data, opts?)` | Daten pro Erweiterung beibehalten (Benutzer-/Organisationsbereich)  | `extensionData.set('notes', id, { text: '...' })`         |
 | `extensionData.list(collection, opts?)`          | Persistente Elemente auflisten                                      | `extensionData.list('notes', { scope: 'all' })`           |
@@ -397,7 +397,7 @@ Lokale Erweiterungen haben ein strengeres v1-Berechtigungsmodell:
 
 - `extensionData` ist für den kleinen Laufzeitstatus verfügbar, sofern es nicht deaktiviert ist.
 - `appAction`-Aufrufe müssen explizit in `permissions.appActions` aufgeführt werden.
-- `dbQuery`, `dbExec` und `extensionFetch` sind vorerst blockiert.
+- `dbQuery` und `extensionFetch` sind vorerst blockiert.
 - SQL-gestützte Aktualisierung, Löschung, Freigabe und Verlauf actions geben eine Meldung zurück, die
   zeigt zurück auf die lokale Eintragsdatei.
 
@@ -430,6 +430,8 @@ Mit dem Framework kann der Agent den Quellcode der App direkt bearbeiten – Kom
 
 Faustregel: **Wenn es für einen Benutzer oder ein Team ist, handelt es sich um eine Erweiterung.** Wenn jeder Benutzer der Vorlage sie erhalten soll, liefern Sie sie als echtes Feature aus.
 
+Für benutzerdefinierten Datenabruf, der native Diagramme und Tabellen speisen soll statt einer eigens gebauten Widget-UI, siehe [Datenprogramme](/docs/data-programs) — ein gespeichertes, aktualisierbares `run-code`-Skript, an das sich Dashboard-Panels direkt binden, ganz ohne Extension-iframe.
+
 ## Sicherheit {#security}
 
 <Callout id="doc-block-frp4nq" tone="success">
@@ -444,7 +446,7 @@ Erweiterungen werden in einem Sandbox-Iframe ausgeführt:
 - **Serverseitige geheime Injektion** über die `${keys.NAME}`-Vorlage – der tatsächliche Schlüsselwert erreicht nie den Browser.
 - **Domänengesperrte Geheimnisse** – jeder Schlüssel ist an eine URL-Zulassungsliste gebunden; Der Proxy lehnt Anfragen an andere Hosts ab.
 - **Privater Netzwerkschutz** – Erweiterungen können interne Adressen nicht erreichen.
-- **Authentifizierung erforderlich** – Erweiterungen werden nur für angemeldete Benutzer ausgeführt und `dbQuery`-/`dbExec`-Aufrufe werden automatisch eingeschränkt.
+- **Authentifizierung erforderlich** – Erweiterungen werden nur für angemeldete Benutzer ausgeführt und `dbQuery`-Aufrufe werden automatisch eingeschränkt.
 
 ## Ein paar Dinge, die Sie über die Benennung wissen sollten {#naming-back-compat}
 

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

@@ -239,20 +239,17 @@ export const forms = table("forms", {
 ```
 
 ```bash
-# Kernaktionen für eine schnelle Datenbankinspektion und einmalige Wartung
+# Kernaktionen für eine schnelle Datenbankinspektion
 pnpm action db-schema                                       # show all tables
 pnpm action db-query --sql "SELECT * FROM forms"
-pnpm action db-exec --sql "UPDATE forms SET status = ? WHERE id = ?" --args '["closed","form-1"]'
-# Chirurgisches find/replace für eine große Textspalte – sendet einen Unterschied, nicht den gesamten Wert
-pnpm action db-patch --table documents --column content \
-  --where "id='doc-1'" --find "old heading" --replace "new heading"
 ```
 
-Das Produktionsagenten-Chat-Plugin ermöglicht standardmäßig Rohdatenbank-Schreibvorgänge.
-(`databaseTools: "write"`), damit Agenten App-eigene Daten reparieren können, ohne auf eine
-neue typisierte Aktion. Diese Schreibvorgänge sind auf den authentifizierten Benutzer/die authentifizierte Organisation beschränkt. Festlegen
-`databaseTools: "read"`, um nur die `db-schema`/`db-query`-Inspektion beizubehalten, oder
-`databaseTools: "off"` / `false` erfordert die typisierte App actions für alle Daten
+Das Produktions-Agent-Chat-Plugin setzt rohe SQL-Werkzeuge standardmäßig auf read-only
+(`databaseTools: "read"`). Agenten prüfen App-Daten mit `db-schema` /
+`db-query` und schreiben über typisierte App-Actions. Setze
+`databaseTools: "write"` (oder `true`) nur für bewusste Wartungsflächen, die
+auch scoped `db-exec` / `db-patch` anbieten sollen; `databaseTools: "off"` /
+`false` erfordert typisierte App-Actions für alle Daten
 Zugriff.
 
 ## Agent-Chat-Brücke {#agent-chat-bridge}
@@ -437,6 +434,7 @@ Diese basieren auf demselben Vertrag und haben ihre eigenen Tiefgänge:
 
 - **[Dispatch](/docs/dispatch)** – die Steuerungsebene des Arbeitsbereichs: gemeinsamer Posteingang, Geheimspeicher, geplante Jobs und ein Orchestrator, der über A2A an spezielle Apps delegiert.
 - **[Extensions](/docs/extensions)** – Sandbox-Alpine.js-Mini-Apps, die der Agent zur Laufzeit erstellt, keine Quelländerungen oder Migrationen.
+- **[Datenprogramme](/docs/data-programs)** – gespeicherte, vom Agenten verfasste `run-code`-Skripte, die Dashboard-Panels ein zwischengespeichertes, aktualisierbares Ergebnis liefern statt einer fest codierten Provider-action.
 - **[A2A Protocol](/docs/a2a-protocol)** – wie Apps im selben Arbeitsbereich einander über JSON-RPC erkennen und aufrufen.
 
 ## Was Sie kostenlos bekommen {#what-you-get-for-free}

package/docs/content/locales/de-DE/real-time-collaboration.mdx

@@ -258,11 +258,8 @@ export default createCollabPlugin({
 ### 4. Verwenden Sie den Client-Hook
 
 ```ts
-import {
-  useCollaborativeDoc,
-  emailToColor,
-  emailToName,
-} from "@agent-native/core/client";
+import { useCollaborativeDoc } from "@agent-native/core/client";
+import { emailToColor, emailToName } from "@agent-native/toolkit/collab-ui";
 
 const TAB_ID = generateTabId(); // or Math.random().toString(36)
 
@@ -364,12 +361,14 @@ Clientseitige Präsenz und Editor UI aus dem fokussierten Browser-Unterpfad impo
 
 ```ts
 import {
-  PresenceBar,
-  LiveCursorOverlay,
-  RemoteSelectionRings,
   useCollaborativeDoc,
   usePresence,
 } from "@agent-native/core/client/collab";
+import {
+  PresenceBar,
+  LiveCursorOverlay,
+  RemoteSelectionRings,
+} from "@agent-native/toolkit/collab-ui";
 ```
 
 Serverseitige Agentenpräsenz-Helfer bleiben im Collab-Paket auf niedrigerer Ebene:
@@ -455,7 +454,7 @@ Der Agent (AGENT_CLIENT_ID) erscheint als erstklassiger Teilnehmer mit `isAgent:
 Rendert Remote-Cursor als absolut positionierte Beschriftungen über einem Containerelement:
 
 ```tsx
-import { LiveCursorOverlay } from "@agent-native/core/client";
+import { LiveCursorOverlay } from "@agent-native/toolkit/collab-ui";
 
 // cursor positions stored as { x, y } normalized 0–1 under presence.cursor
 <div ref={containerRef} style={{ position: "relative" }}>
@@ -475,7 +474,7 @@ Der Cursor des Agenten wird deutlich mit einem Glitzersymbol dargestellt. Cursor
 Rendert farbige Umrissringe + Namensschilder über entfernt ausgewählten Elementen:
 
 ```tsx
-import { RemoteSelectionRings } from "@agent-native/core/client";
+import { RemoteSelectionRings } from "@agent-native/toolkit/collab-ui";
 
 <div ref={containerRef} style={{ position: "relative" }}>
   {content}

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

@@ -93,9 +93,10 @@ Jede Vorlage, die vom Benutzer erstellte Arbeiten speichert, verwendet dieses Mo
 - **Folien** – Decks
 - **Design** – Designs und Assets
 - **Clips** – Bildschirmaufnahmen (Loom-Stil)
+- **Plan** — visual plans and PR recaps
 - **Formulare** – Formulardefinitionen
 - **Kalender** – Veranstaltungen und Buchungslinks
-- **Analytics** – Dashboards (Einführung – siehe `AGENTS.md` der Analytics-Vorlage)
+- **Analytics** – dashboards, saved analyses, and tokenized session replays
 - **Erweiterungen** – Sandbox-Mini-Apps (siehe [Extensions](/docs/extensions#sharing))
 
 Alle davon verwenden denselben `ownableColumns()`-Schema-Helfer, dieselbe `share-resource`-Aktion und denselben `<ShareButton>` UI. Wenn Sie von einer Vorlage zu einer anderen wechseln, sieht der Freigabedialog identisch aus.
@@ -136,15 +137,22 @@ Fügen Sie bei Listen neben jeder Zeile ein `<VisibilityBadge visibility={row.vi
 
 Das Framework mountet diese actions automatisch in jeder Vorlage – der Agent nennt sie als Tools und der UI ruft sie über `useActionQuery` / `useActionMutation` auf:
 
-| Aktion                    | Was es tut                                                                                                                                   |
-| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
-| `share-resource`          | Gewähren Sie einem Benutzer oder einer Organisation Zugriff für eine bestimmte Rolle. Optionales `notify` steuert E-Mail-Benachrichtigungen. |
-| `unshare-resource`        | Zugriff für einen Benutzer oder eine Organisation widerrufen.                                                                                |
-| `list-resource-shares`    | Aktuelle Sichtbarkeit sowie alle expliziten Gewährungen anzeigen.                                                                            |
-| `set-resource-visibility` | Wechseln Sie zu `private`, `org` oder `public`.                                                                                              |
+| Aktion                       | Was es tut                                                                                                                                   |
+| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
+| `share-resource`             | Gewähren Sie einem Benutzer oder einer Organisation Zugriff für eine bestimmte Rolle. Optionales `notify` steuert E-Mail-Benachrichtigungen. |
+| `unshare-resource`           | Zugriff für einen Benutzer oder eine Organisation widerrufen.                                                                                |
+| `list-resource-shares`       | Aktuelle Sichtbarkeit sowie alle expliziten Gewährungen anzeigen.                                                                            |
+| `set-resource-visibility`    | Wechseln Sie zu `private`, `org` oder `public`.                                                                                              |
+| `create-agent-resource-link` | Mint a temporary read-only `agent_access` URL for a registered agent-readable resource.                                                      |
 
 Sagen Sie dem Agenten: „Teilen Sie dieses Design mit dem Marketingteam als Redakteuren“, und er ruft `share-resource` für denselben Endpunkt auf, den UI verwendet. Das Ergebnis wird beim nächsten Rendern im Freigabedialog angezeigt.
 
+## Agent-readable share links {#agent-readable-links}
+
+Human share links should also work for agents when the resource is a document-like artifact: plans, documents, decks, designs, analytics dashboards, saved analyses, clips, and similar "things you would send to a person." Public links expose a small SSR discovery script that points at structured JSON. Private resources use a short-lived `agent_access` token scoped to exactly one resource.
+
+Register the resource with `agentReadable`, add a read-only JSON context endpoint, inject the SSR discovery script with `renderAgentReadableResourceDiscoveryScript()`, and let agents call `create-agent-resource-link` when they need a temporary private URL. The endpoint must return data only when the row is `public` or `verifyScopedAgentAccessToken()` accepts the token for that exact `resourceKind` and `resourceId`.
+
 ## In eine neue Vorlage einbauen {#building}
 
 Wenn Sie eine Vorlage erstellen (siehe [Creating Templates](/docs/creating-templates)), ist die gemeinsame Nutzung der Verkabelung kurz. Zwei Ergänzungen zu Ihrem Schema:

package/docs/content/locales/es-ES/agent-native-toolkit.mdx

@@ -0,0 +1,103 @@
+---
+title: "Toolkit"
+description: "Reusable app-building primitives that sit between @agent-native/core and template apps."
+---
+
+# Toolkit
+
+`@agent-native/core` owns the foundational runtime: actions, app state, auth,
+SQL, server plugins, agent chat, sharing access checks, and collaboration
+transport. `@agent-native/toolkit` owns reusable app-building pieces that sit on
+top of that runtime: UI primitives, app-local adapters, shell helpers, sharing
+badges, and collaboration UI.
+
+Apps should compose those pieces through local adapters. That keeps app UI easy
+to customize without copying Toolkit implementation code.
+
+<WireframeBlock id="doc-block-toolkit-layering">
+  <Screen
+    surface="desktop"
+    html={
+      "<div style='min-height:520px;box-sizing:border-box;padding:48px 36px;display:flex;align-items:center;justify-content:center'><div style='width:min(900px,100%);display:grid;grid-template-columns:1fr;gap:18px'><div class='wf-card' style='padding:22px 24px'><div style='display:flex;align-items:center;justify-content:space-between;gap:16px'><div><strong>App</strong><p class='wf-muted' style='margin:6px 0 0'>Domain routes, actions, local UI adapters, product-specific views</p></div><span class='wf-pill'>@/components/ui/button</span></div></div><div class='wf-card' style='padding:22px 24px;border-color:hsl(var(--primary))'><div style='display:flex;align-items:center;justify-content:space-between;gap:16px'><div><strong>Toolkit</strong><p class='wf-muted' style='margin:6px 0 0'>Reusable primitives, collab UI, sharing UI, app shell hooks</p></div><span class='wf-pill'>ToolkitProvider</span></div><div style='display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:10px;margin-top:16px'><span class='wf-pill'>UI</span><span class='wf-pill'>Collab UI</span><span class='wf-pill'>Sharing UI</span><span class='wf-pill'>Shell</span></div></div><div class='wf-card' style='padding:22px 24px'><div style='display:flex;align-items:center;justify-content:space-between;gap:16px'><div><strong>Core</strong><p class='wf-muted' style='margin:6px 0 0'>Actions, SQL, auth, sharing runtime, Yjs transport, app state</p></div><span class='wf-pill'>@agent-native/core</span></div></div></div></div>"
+    }
+  />
+</WireframeBlock>
+
+## What Ships Today {#what-ships-today}
+
+- **UI primitives**: shadcn-style components under
+  `@agent-native/toolkit/ui/*`.
+- **App adapters**: template-local wrappers such as
+  `@/components/ui/button` that re-export Toolkit primitives until an app wants
+  to customize them.
+- **ToolkitProvider**: an override layer that lets reusable Toolkit UI use an
+  app's local primitives, starting with `Button`.
+- **Collaboration UI**: presence avatars, live cursors, remote selection rings,
+  recent edit highlights, and agent presence chips under
+  `@agent-native/toolkit/collab-ui`.
+- **Sharing UI**: the reusable `VisibilityBadge` under
+  `@agent-native/toolkit/sharing`.
+- **Shell and hooks**: app-shell header actions plus shared hooks such as
+  `useIsMobile` and `useToast`.
+
+## Compatibility {#compatibility}
+
+Existing imports from `@agent-native/core/client` keep working. Core now exposes
+thin re-export shims for Toolkit-owned visual pieces while keeping runtime
+behavior in core.
+
+Those core shims are temporary migration support, not the long-term dependency
+direction. The next major can remove them; after that, reusable app-building
+packages should import Toolkit directly, and behaviorful Toolkit kits may compose
+core runtime APIs as peer/runtime dependencies instead of pushing more UI back
+into core.
+
+Extract future behaviorful kits one at a time before broadening the split.
+Sharing is the first candidate to validate that model because it exercises
+access checks, action-backed data, and share-link UI together.
+
+That means this keeps working:
+
+```tsx
+import { PresenceBar, VisibilityBadge } from "@agent-native/core/client";
+```
+
+New reusable app code should prefer Toolkit or app-local adapters:
+
+```tsx
+import { PresenceBar } from "@agent-native/toolkit/collab-ui";
+import { Button } from "@/components/ui/button";
+```
+
+## Boundary {#boundary}
+
+Move code into Toolkit when it is reusable app-building UI or a pure UI contract.
+Keep code in core when it owns access control, SQL, actions, request context,
+Yjs transport, auth, or other runtime guarantees.
+
+Good Toolkit candidates:
+
+- Components that render the same interaction across apps.
+- Display-only helpers and structural prop types.
+- Base components that receive data and callbacks from an app or core wrapper.
+- App-shell hooks and adapters that do not own domain data.
+
+Keep app-local:
+
+- Domain-specific workflows.
+- Resource-specific mutations and routes.
+- Custom visual systems an app intentionally owns.
+
+Keep core-owned:
+
+- Sharing actions and access checks.
+- Collaboration storage, awareness transport, and Yjs document sync.
+- Auth, sessions, app state, SQL, and server plugins.
+
+## Pages {#pages}
+
+- [UI Primitives](/docs/toolkit-ui)
+- [App Adapters](/docs/toolkit-app-adapters)
+- [Collaboration UI](/docs/toolkit-collaboration-ui)
+- [Sharing UI](/docs/toolkit-sharing-ui)
+- [Shell & Hooks](/docs/toolkit-shell-hooks)

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

@@ -1,19 +1,19 @@
 ---
-title: "Plantillas"
+title: "Apps"
 description: "Bifurque un producto SaaS que funcione y hágalo suyo, incluido el agente."
 ---
 
-# Plantillas
+# Apps
 
-¿Quiere enviar su propia herramienta de análisis basada en IA? ¿Cliente de correo? ¿Constructor de formularios? Elija una plantilla y tendrá un SaaS funcional en minutos: el agente, la base de datos, la autenticación y el proceso de implementación ya están conectados.
+¿Quiere enviar su propia herramienta de análisis basada en IA? ¿Cliente de correo? ¿Constructor de formularios? Elija una app de ejemplo y tendrá un SaaS funcional en minutos: el agente, la base de datos, la autenticación y el proceso de implementación ya están conectados.
 
-La mayoría de las "plantillas" le brindan un marco en blanco y una larga lista TODO. El agente nativo cambia eso. Cada uno es un **producto completo de nivel SaaS**: ya se puede ejecutar desde el primer día, ya se puede enviar y es completamente suyo para personalizarlo, personalizarlo e implementarlo. Piensa en ellos como SaaS clonable, no como kits de inicio: estás entregando un producto terminado, no mirando un texto estándar.
+La mayoría de las plantillas iniciales le brindan un marco en blanco y una larga lista TODO. El agente nativo cambia eso. Cada app de ejemplo es un **producto completo de nivel SaaS**: ya se puede ejecutar desde el primer día, ya se puede enviar y es completamente suyo para personalizarlo, darle marca e implementarlo. Piensa en ellas como SaaS clonable, no como kits de inicio: estás entregando un producto terminado, no mirando un texto estándar.
 
-## Plantillas disponibles {#catalog}
+## Apps de ejemplo {#catalog}
 
 Cada una es una aplicación real que puedes usar hoy y la plataforma de lanzamiento para tu propia versión.
 
-| Plantilla                                 | Qué es                                                                                                                                           |
+| App                                       | Qué es                                                                                                                                           |
 | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
 | [**Chat**](/docs/template-chat)           | Aplicación mínima de chat primero con hilos duraderos, actions, autenticación y una ruta limpia hacia UI personalizado o su propio backend.      |
 | [**Mail**](/docs/template-mail)           | Un sobrehumano nativo del agente. Bandeja de entrada, etiquetas, clasificación por IA, teclado primero, borradores y envíos a través del agente. |
@@ -35,16 +35,16 @@ Vea el catálogo completo en [Apps](/apps) o vaya directamente a uno; por ejempl
 
 ## Lo que obtienes de la caja {#what-you-get}
 
-Cada plantilla se envía con las piezas que normalmente tardan meses en construirse:
+Cada app de ejemplo se envía con las piezas que normalmente tardan meses en construirse:
 
 - **Un agente en funcionamiento**: ya conectado a la aplicación, ya capaz de tomar actions de sus datos, ya consciente del contexto sobre lo que está viendo. Consulte [Messaging the agent](/docs/messaging) para saber cómo funciona.
 - **Auth**: inicio de sesión, sesiones, organizaciones, aislamiento multiinquilino. Ya hecho.
-- **Una base de datos**: cada plantilla tiene su esquema, consultas y migraciones listas para funcionar. Traiga su propia base de datos SQL (Postgres, SQLite, Turso, D1): el marco se adapta.
+- **Una base de datos**: cada app de ejemplo tiene su esquema, consultas y migraciones listas para funcionar. Traiga su propia base de datos SQL (Postgres, SQLite, Turso, D1): el marco se adapta.
 - **Un UI** en tiempo real: la pantalla permanece sincronizada con lo que hace el agente. Haga clic en "redactar un correo electrónico" en el chat y observe cómo el borrador aparece en su bandeja de entrada inmediatamente.
 - **Listo para implementar**: envíelo a Netlify, Vercel, Cloudflare, AWS o cualquier otro lugar que ejecute Node. Sin dependencia del proveedor.
 - **Ganchos de marca**: el nombre, los colores, el logotipo y el texto son fáciles de cambiar.
 
-Esta no es una afirmación teórica. El autor del marco ejecuta su bandeja de entrada real en la plantilla Correo, su calendario real en la plantilla Calendario y sus análisis reales en la plantilla Análisis. Las plantillas son un software de uso diario.
+Esta no es una afirmación teórica. El autor del marco ejecuta su bandeja de entrada real en la app Mail, su calendario real en la app Calendar y sus análisis reales en la app Analytics. Estas apps son software de uso diario.
 
 ## Qué haces {#what-you-do}
 
@@ -56,7 +56,7 @@ El camino desde "Quiero mi propio SaaS" hasta "Tengo mi propio SaaS" es corto:
 <div class="diagram-fork">
   <div class="diagram-card">
     <span class="diagram-pill">1</span><strong>Pick</strong
-    ><small class="diagram-muted">a complete template</small>
+    ><small class="diagram-muted">una app completa</small>
   </div>
   <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
   <div class="diagram-card">
@@ -98,8 +98,8 @@ El camino desde "Quiero mi propio SaaS" hasta "Tengo mi propio SaaS" es corto:
 
 </Diagram>
 
-1. **Elija una plantilla.** Utilice el selector CLI o explore los documentos y elija una para comenzar.
-2. **Marca.** Cambia el nombre, los colores, el logotipo y el texto. La mayoría de las plantillas exponen esto en un único archivo de configuración.
+1. **Elija una app de ejemplo.** Utilice el selector CLI o explore los documentos y elija una para comenzar.
+2. **Marca.** Cambia el nombre, los colores, el logotipo y el texto. La mayoría de las apps de ejemplo exponen esto en un único archivo de configuración.
 3. **Personalízalo.** Pídele al agente que agregue la columna que necesitas, cambia la forma en que se agrupa la bandeja de entrada, conéctate a tu API interno, agrega una nueva vista. El agente edita el código; revisas la diferencia.
 4. **Envíelo.** Ejecute el comando de implementación. Ahora tienes tu propio SaaS de producción en tu propio dominio.
 
@@ -159,7 +159,7 @@ El resultado: Claude: flexibilidad a nivel de código para cada usuario, con una
 
 ## ¿No quieres bifurcar? {#hosted}
 
-No es necesario. Cada plantilla también está disponible como una aplicación alojada en `agent-native.com`: `mail.agent-native.com`, `calendar.agent-native.com`, etc. Utilice la versión alojada de forma gratuita o de pago; bifurca solo cuando quieras cambiar algo que la versión alojada no expone.
+No es necesario. Cada app de ejemplo también está disponible como una aplicación alojada en `agent-native.com`: `mail.agent-native.com`, `calendar.agent-native.com`, etc. Utilice la versión alojada de forma gratuita o de pago; bifurca solo cuando quieras cambiar algo que la versión alojada no expone.
 
 ## Pruébalo con una habilidad {#try-with-a-skill}
 
@@ -168,10 +168,10 @@ No es necesario. Cada plantilla también está disponible como una aplicación a
 ## Aprovechando esto
 
 - [**Getting Started**](/docs/getting-started): crea una app chat-first, añade una action, renderiza un resultado estructurado y crece hacia una página
-- [**Messaging the agent**](/docs/messaging): cómo los usuarios (y usted) hablan con el agente que se envía con cada plantilla
-- [**Multi-App Workspace**](/docs/multi-app-workspace): agrupa varias plantillas en un espacio de trabajo que comparte autenticación, marca y agente
-- [**Dispatch**](/docs/template-dispatch): la plantilla del plano de control del espacio de trabajo
-- [**Creating Templates**](/docs/creating-templates): crea y publica tu propia plantilla
+- [**Messaging the agent**](/docs/messaging): cómo los usuarios (y usted) hablan con el agente que se envía con cada app
+- [**Multi-App Workspace**](/docs/multi-app-workspace): agrupa varias apps en un espacio de trabajo que comparte autenticación, marca y agente
+- [**Dispatch**](/docs/template-dispatch): la app del plano de control del espacio de trabajo
+- [**Creating Templates**](/docs/creating-templates): crea y publica tu propia plantilla de app
 
 ### Para desarrolladores {#dev-details}
 
@@ -181,10 +181,10 @@ Si está realizando un scaffolding ahora, el comando CLI es:
 npx @agent-native/core@latest create my-platform
 ```
 
-Obtendrás un selector de selección múltiple. Elija una aplicación (independiente) o varias (espacio de trabajo: las aplicaciones comparten autenticación, marca, configuración del agente y base de datos). Cada plantilla seleccionada se estructura en `apps/<name>/` con cada archivo que necesita. Para una automatización sin UI de navegador en lugar de una plantilla UI, use `npx @agent-native/core@latest create my-agent --headless`.
+Obtendrás un selector de selección múltiple. Elija una aplicación (independiente) o varias (espacio de trabajo: las aplicaciones comparten autenticación, marca, configuración del agente y base de datos). Cada app seleccionada se estructura en `apps/<name>/` con cada archivo que necesita. Para una automatización sin UI de navegador en lugar de una UI de app, use `npx @agent-native/core@latest create my-agent --headless`.
 
 Complete `.env` (principalmente `ANTHROPIC_API_KEY` y `DATABASE_URL`), `pnpm install`, `pnpm dev` y funciona. Sin "TODO: implementar inicio de sesión", sin rutas de marcador de posición.
 
 Destinos de implementación: cualquier host compatible con Nitro (Node, Cloudflare, Netlify, Vercel, Deno, Lambda, Bun) y cualquier base de datos SQL compatible con Drizzle (SQLite, Postgres, Turso, D1, Supabase, Neon). Para los espacios de trabajo, `npx @agent-native/core@latest deploy` crea todas las aplicaciones a la vez y las envía detrás de un único origen. Ver [Deployment](/docs/deployment).
 
-Para crear y publicar su propia plantilla, consulte [Creating Templates](/docs/creating-templates).
+Para crear y publicar su propia plantilla de app, consulte [Creating Templates](/docs/creating-templates).

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

@@ -25,7 +25,9 @@ Evite importar componentes UI desde el paquete básico `@agent-native/core`. Usa
 `@agent-native/core/client` o una subruta `@agent-native/core/client/*` enfocada
 para que los paquetes elijan la entrada segura para el navegador.
 
-Use `@agent-native/toolkit` para piezas reutilizables de construcción de aplicaciones que no forman parte del contrato fundacional del runtime: primitivas UI estilo shadcn, hooks compartidos, ayudantes simples de shell de aplicación y otros módulos para componer plantillas. Core conserva reexports de compatibilidad durante la transición, pero el código nuevo de plantillas y aplicaciones debe importar módulos de toolkit directamente:
+Use `@agent-native/toolkit` para piezas reutilizables de construcción de aplicaciones que no forman parte del contrato fundacional del runtime: primitivas UI estilo shadcn, hooks compartidos, ayudantes simples de shell de aplicación y otros módulos para componer plantillas. Core conserva reexports de compatibilidad durante la transición.
+
+Los paquetes reutilizables pueden importar módulos de Toolkit directamente:
 
 ```tsx
 import { Button } from "@agent-native/toolkit/ui/button";
@@ -34,6 +36,13 @@ import { useToast } from "@agent-native/toolkit/hooks/use-toast";
 import { useSetHeaderActions } from "@agent-native/toolkit/app-shell";
 ```
 
+Dentro de las apps de plantilla, prefiera adaptadores locales de la app para que los equipos puedan sustituir primitivas una vez y hacer que cada superficie reutilizada de Toolkit use la implementación local:
+
+```tsx
+import { Button } from "@/components/ui/button";
+import { useToast } from "@/hooks/use-toast";
+```
+
 <Diagram id="doc-block-1v79shu" title="Bajar una capa, no fuera del marco." summary={"Cada capa mantiene el mismo tiempo de ejecución (acciones, estado del subproceso y sincronización SQL-backed) al tiempo que le brinda más control sobre Chrome."}>
 
 ```html
@@ -443,7 +452,8 @@ function WorkspaceResources() {
 
 | Área               | APIs                                                                       | Ruta de importación                       |
 | ------------------ | -------------------------------------------------------------------------- | ----------------------------------------- |
-| Compartir          | `<ShareButton>`, `<ShareDialog>`, `<VisibilityBadge>`                      | `@agent-native/core/client/sharing`       |
+| Compartir          | `<ShareButton>`, `<ShareDialog>`                                           | `@agent-native/core/client/sharing`       |
+| Sharing UI         | `<VisibilityBadge>`                                                        | `@agent-native/toolkit/sharing`           |
 | Notificaciones     | `<NotificationsBell>`                                                      | `@agent-native/core/client/notifications` |
 | Progreso           | `<RunsTray>`, ganchos de progreso y tipos                                  | `@agent-native/core/client/progress`      |
 | Incorporación      | `useOnboarding()`, ganchos para panel de incorporación                     | `@agent-native/core/client/onboarding`    |