@agent-native/core 0.87.0 → 0.90.1

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

@@ -34,7 +34,7 @@ Agent d'application intact.
     <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 @@ Dans le bac à sable iframe, chaque extension dispose de ces assistants sur `win
 | `appAction(name, params)`                        | Appelez l'un des actions du modèle hôte                                          | `appAction('list-emails', { view: 'inbox' })`             |
 | `appFetch(path, options)`                        | Appeler les points de terminaison du framework autorisés sous `/_agent-native/*` | `appFetch('/_agent-native/application-state/navigation')` |
 | `dbQuery(sql, args)`                             | Lecture à partir de SQL (portée automatiquement sur l'utilisateur)               | `dbQuery('SELECT id, name FROM tools')`                   |
-| `dbExec(sql, args)`                              | Écrire dans SQL                                                                  | `dbExec('INSERT INTO ...')`                               |
+| `dbExec(sql, args)`                              | Legacy trusted SQL writes for editor/admin extensions                            | Prefer `appAction` for app data writes                    |
 | `extensionFetch(url, options)`                   | Atteignez les API externes via un proxy sécurisé avec des secrets                | `extensionFetch('https://api.github.com/user')`           |
 | `extensionData.set(collection, id, data, opts?)` | Conserver les données par extension (portée utilisateur/organisation)            | `extensionData.set('notes', id, { text: '...' })`         |
 | `extensionData.list(collection, opts?)`          | Liste des éléments persistants                                                   | `extensionData.list('notes', { scope: 'all' })`           |
@@ -397,7 +397,7 @@ Les extensions locales ont un modèle d'autorisation v1 plus strict :
 
 - `extensionData` est disponible pour les petits états d'exécution, sauf s'il est désactivé.
 - Les appels `appAction` doivent être explicitement répertoriés dans `permissions.appActions`.
-- `dbQuery`, `dbExec` et `extensionFetch` sont bloqués pour le moment.
+- `dbQuery` et `extensionFetch` sont bloqués pour le moment.
 - La mise à jour, la suppression, le partage et l'historique basés sur SQL actions renvoient un message qui
   pointe vers le fichier d'entrée local.
 
@@ -430,6 +430,8 @@ Le framework permet à l'agent de modifier directement le code source de l'appli
 
 Règle générale : **si c'est pour un utilisateur ou une équipe, c'est une extension.** Si chaque utilisateur du modèle doit l'obtenir, expédiez-le comme une véritable fonctionnalité.
 
+Pour une récupération de données personnalisée destinée à alimenter des graphiques et tableaux natifs plutôt qu'une UI de widget sur mesure, voir [Programmes de données](/docs/data-programs) — un script `run-code` stocké et actualisable auquel les panneaux de dashboard se lient directement, sans aucun iframe d'extension.
+
 ## Sécurité {#security}
 
 <Callout id="doc-block-frp4nq" tone="success">
@@ -444,7 +446,7 @@ Les extensions s'exécutent dans une iframe en bac à sable :
 - **Injection de secret côté serveur** via le modèle `${keys.NAME}` — la valeur réelle de la clé n'atteint jamais le navigateur.
 - **Secrets verrouillés par domaine** — chaque clé est liée à une liste verte URL ; le proxy refuse les demandes adressées aux autres hôtes.
 - **Protection des réseaux privés** : les extensions ne peuvent pas atteindre les adresses internes.
-- **Authentification requise** : les extensions ne s'exécutent que pour les utilisateurs connectés et les appels `dbQuery`/`dbExec` sont automatiquement étendus.
+- **Authentification requise** : les extensions ne s'exécutent que pour les utilisateurs connectés et les appels `dbQuery` sont automatiquement étendus.
 
 ## Quelques choses à savoir sur la dénomination {#naming-back-compat}
 

package/docs/content/locales/fr-FR/key-concepts.mdx

@@ -239,20 +239,17 @@ export const forms = table("forms", {
 ```
 
 ```bash
-# Actions de base pour une inspection rapide de la base de données et une maintenance ponctuelle
+# Actions de base pour une inspection rapide de la base de données
 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"]'
-# find/replace chirurgical sur une grande colonne de texte – envoie une différence, pas la valeur entière
-pnpm action db-patch --table documents --column content \
-  --where "id='doc-1'" --find "old heading" --replace "new heading"
 ```
 
-Le plug-in de chat de l'agent de production active par défaut les écritures brutes dans la base de données
-(`databaseTools: "write"`) pour que les agents puissent corriger les données appartenant à l'application sans attendre un
-nouvelle action typée. Ces écritures sont limitées à l'utilisateur/à l'organisation authentifié. Définir
-`databaseTools: "read"` pour conserver uniquement l'inspection `db-schema` / `db-query`, ou
-`databaseTools: "off"` / `false` nécessite l'application saisie actions pour toutes les données
+Le plug-in de chat de l'agent de production met les outils SQL bruts en lecture seule par défaut
+(`databaseTools: "read"`), donc les agents inspectent les données avec `db-schema` /
+`db-query` et écrivent via les actions typées de l'application. Définissez
+`databaseTools: "write"` (ou `true`) seulement pour les surfaces de maintenance
+qui doivent exposer `db-exec` / `db-patch`; utilisez
+`databaseTools: "off"` / `false` pour exiger des actions typées pour toutes les données
 accès.
 
 ## Pont de discussion pour les agents {#agent-chat-bridge}
@@ -439,6 +436,7 @@ Ceux-ci se trouvent au-dessus du même contrat et ont leurs propres détails :
 
 - **[Dispatch](/docs/dispatch)** : le plan de contrôle de l'espace de travail : boîte de réception partagée, coffre-fort de secrets, tâches planifiées et orchestrateur qui délègue à des applications spécialisées via A2A.
 - **[Extensions](/docs/extensions)** : mini-applications Alpine.js en bac à sable que l'agent crée au moment de l'exécution, sans modification ni migration de la source.
+- **[Programmes de données](/docs/data-programs)** : scripts `run-code` stockés et rédigés par l'agent qui fournissent aux panneaux de dashboard un résultat mis en cache et actualisable, au lieu d'une action de fournisseur codée en dur.
 - **[A2A Protocol](/docs/a2a-protocol)** : comment les applications du même espace de travail se découvrent et s'appellent via JSON-RPC.
 
 ## Ce que vous obtenez gratuitement {#what-you-get-for-free}

package/docs/content/locales/fr-FR/real-time-collaboration.mdx

@@ -261,11 +261,8 @@ export default createCollabPlugin({
 ### 4. Utilisez le hook client
 
 ```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)
 
@@ -367,12 +364,14 @@ Importer la présence côté client et l'éditeur UI à partir du sous-chemin du
 
 ```ts
 import {
-  PresenceBar,
-  LiveCursorOverlay,
-  RemoteSelectionRings,
   useCollaborativeDoc,
   usePresence,
 } from "@agent-native/core/client/collab";
+import {
+  PresenceBar,
+  LiveCursorOverlay,
+  RemoteSelectionRings,
+} from "@agent-native/toolkit/collab-ui";
 ```
 
 Les assistants de présence d'agent côté serveur restent dans le package de collaboration de niveau inférieur :
@@ -458,7 +457,7 @@ L'agent (AGENT_CLIENT_ID) apparaît comme un participant de première classe ave
 Rend les curseurs distants sous forme d'étiquettes positionnées de manière absolue sur un élément conteneur :
 
 ```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" }}>
@@ -478,7 +477,7 @@ Le curseur de l'agent s'affiche distinctement avec une icône scintillante. Les
 Rend les anneaux de contour colorés + les balises de nom sur les éléments sélectionnés à distance :
 
 ```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/fr-FR/sharing.mdx

@@ -93,9 +93,10 @@ Chaque modèle qui stocke le travail créé par l'utilisateur utilise ce modèle
 - **Diapositives** — présentations
 - **Conception** – conceptions et éléments
 - **Clips** – enregistrements d'écran (style Loom)
+- **Plan** — visual plans and PR recaps
 - **Formulaires** — définitions de formulaire
 - **Calendrier** — événements et liens de réservation
-- **Analytics** — tableaux de bord (déploiement — voir `AGENTS.md` du modèle d'analyse)
+- **Analytics** — dashboards, saved analyses, and tokenized session replays
 - **Extensions** – mini-applications en bac à sable (voir [Extensions](/docs/extensions#sharing))
 
 Chacun d'entre eux utilise le même assistant de schéma `ownableColumns()`, la même action `share-resource` et la même `<ShareButton>` UI. Passez d'un modèle à un autre et la boîte de dialogue de partage semble identique.
@@ -136,15 +137,22 @@ Pour les listes, déposez un `<VisibilityBadge visibility={row.visibility} />`
 
 Le framework monte automatiquement ces actions dans chaque modèle : l'agent les appelle en tant qu'outils et le UI les appelle via `useActionQuery` / `useActionMutation` :
 
-| Actions                   | Ce qu'il fait                                                                                                                              |
-| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
-| `share-resource`          | Accorder à un utilisateur ou à une organisation l'accès à un rôle spécifique. Le `notify` en option contrôle les notifications par e-mail. |
-| `unshare-resource`        | Révoquer l'accès d'un utilisateur ou d'une organisation.                                                                                   |
-| `list-resource-shares`    | Afficher la visibilité actuelle ainsi que toutes les autorisations explicites.                                                             |
-| `set-resource-visibility` | Passez à `private`, `org` ou `public`.                                                                                                     |
+| Actions                      | Ce qu'il fait                                                                                                                              |
+| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| `share-resource`             | Accorder à un utilisateur ou à une organisation l'accès à un rôle spécifique. Le `notify` en option contrôle les notifications par e-mail. |
+| `unshare-resource`           | Révoquer l'accès d'un utilisateur ou d'une organisation.                                                                                   |
+| `list-resource-shares`       | Afficher la visibilité actuelle ainsi que toutes les autorisations explicites.                                                             |
+| `set-resource-visibility`    | Passez à `private`, `org` ou `public`.                                                                                                     |
+| `create-agent-resource-link` | Mint a temporary read-only `agent_access` URL for a registered agent-readable resource.                                                    |
 
 Dites à l'agent "Partagez cette conception avec l'équipe marketing en tant qu'éditeurs" et il appellera `share-resource` sur le même point de terminaison que celui utilisé par UI. Le résultat apparaît dans la boîte de dialogue de partage lors du prochain rendu.
 
+## 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`.
+
 ## L'intégrer dans un nouveau modèle {#building}
 
 Si vous créez un modèle (voir [Creating Templates](/docs/creating-templates)), le partage de câblage est court. Deux ajouts à votre schéma :

package/docs/content/locales/hi-IN/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/hi-IN/cloneable-saas.mdx

@@ -1,19 +1,19 @@
 ---
-title: "टेम्पलेट"
+title: "ऐप्स"
 description: "एक कार्यशील SaaS उत्पाद को फोर्क करें और इसे अपना बनाएं - एजेंट शामिल।"
 ---
 
-# टेम्पलेट्स
+# ऐप्स
 
-क्या आप अपना खुद का AI-पावर्ड एनालिटिक्स टूल भेजना चाहते हैं? मेल क्लाइंट? फॉर्म बिल्डर? एक टेम्प्लेट चुनें, और आपको मिनटों में एक कार्यशील SaaS मिल जाएगा - एजेंट, डेटाबेस, ऑथ, और परिनियोजन पाइपलाइन पहले से ही तैयार है।
+क्या आप अपना खुद का AI-पावर्ड एनालिटिक्स टूल भेजना चाहते हैं? मेल क्लाइंट? फॉर्म बिल्डर? एक उदाहरण ऐप चुनें, और आपको मिनटों में एक कार्यशील SaaS मिल जाएगा - एजेंट, डेटाबेस, ऑथ, और परिनियोजन पाइपलाइन पहले से ही तैयार है।
 
-अधिकांश "टेम्प्लेट" आपको एक खाली मचान और एक लंबी TODO सूची देते हैं। एजेंट-नेटिव उसे फ़्लिप करता है। प्रत्येक एक **पूर्ण, SaaS-ग्रेड उत्पाद** है - पहले ही दिन से चलाने योग्य, पहले से ही शिप करने योग्य, और अनुकूलित करने, ब्रांड करने और तैनात करने के लिए पूरी तरह से आपका। उन्हें क्लोन करने योग्य SaaS के रूप में सोचें, स्टार्टर किट के रूप में नहीं: आप एक तैयार उत्पाद फोर्क कर रहे हैं, बॉयलरप्लेट को नहीं देख रहे हैं।
+अधिकांश स्टार्टर टेम्प्लेट आपको एक खाली मचान और एक लंबी TODO सूची देते हैं। एजेंट-नेटिव उसे फ़्लिप करता है। प्रत्येक उदाहरण ऐप एक **पूर्ण, SaaS-ग्रेड उत्पाद** है - पहले ही दिन से चलाने योग्य, पहले से ही शिप करने योग्य, और अनुकूलित करने, ब्रांड करने और तैनात करने के लिए पूरी तरह से आपका। उन्हें क्लोन करने योग्य SaaS के रूप में सोचें, स्टार्टर किट के रूप में नहीं: आप एक तैयार उत्पाद फोर्क कर रहे हैं, बॉयलरप्लेट को नहीं देख रहे हैं।
 
-## टेम्प्लेट उपलब्ध हैं {#catalog}
+## उदाहरण ऐप्स {#catalog}
 
 प्रत्येक एक वास्तविक ऐप है जिसका आप आज उपयोग कर सकते हैं, और इसके अपने संस्करण के लिए लॉन्चिंग पैड भी है।
 
-| टेम्पलेट                                  | यह क्या है                                                                                                           |
+| ऐप                                        | यह क्या है                                                                                                           |
 | ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
 | [**Chat**](/docs/template-chat)           | टिकाऊ थ्रेड्स, actions, ऑथ और कस्टम UI या अपने स्वयं के बैकएंड के लिए एक साफ पथ के साथ न्यूनतम चैट-पहला ऐप।          |
 | [**Mail**](/docs/template-mail)           | एक एजेंट-देशी सुपरह्यूमन। इनबॉक्स, लेबल, एआई ट्राइएज, कीबोर्ड-प्रथम, ड्राफ्ट और एजेंट के माध्यम से भेजना।            |
@@ -35,16 +35,16 @@ description: "एक कार्यशील SaaS उत्पाद को फ
 
 ## आपको बॉक्स से क्या मिलता है {#what-you-get}
 
-प्रत्येक टेम्प्लेट उन हिस्सों के साथ भेजा जाता है जिन्हें बनाने में आम तौर पर महीनों का समय लगता है:
+प्रत्येक उदाहरण ऐप उन हिस्सों के साथ भेजा जाता है जिन्हें बनाने में आम तौर पर महीनों का समय लगता है:
 
 - **एक कार्यशील एजेंट** - पहले से ही ऐप से जुड़ा हुआ है, पहले से ही आपके डेटा पर actions लेने में सक्षम है, आप जो देख रहे हैं उसके बारे में पहले से ही संदर्भ-जागरूक है। यह कैसे काम करता है इसके लिए [Messaging the agent](/docs/messaging) देखें।
 - **प्रामाणिक** — साइन इन, सत्र, संगठन, बहु-किरायेदार अलगाव। पहले ही हो चुका है.
-- **एक डेटाबेस** - प्रत्येक टेम्पलेट की अपनी स्कीमा, क्वेरीज़ और माइग्रेशन जाने के लिए तैयार हैं। अपना खुद का SQL डेटाबेस (Postgres, SQLite, Turso, D1) लाएँ - फ्रेमवर्क अनुकूल है।
+- **एक डेटाबेस** - प्रत्येक उदाहरण ऐप की अपनी स्कीमा, क्वेरीज़ और माइग्रेशन जाने के लिए तैयार हैं। अपना खुद का SQL डेटाबेस (Postgres, SQLite, Turso, D1) लाएँ - फ्रेमवर्क अनुकूल है।
 - **एक वास्तविक समय UI** - एजेंट जो करता है उसके साथ स्क्रीन सिंक में रहती है। चैट में "ईमेल का मसौदा तैयार करें" पर क्लिक करें, ड्राफ्ट को तुरंत अपने इनबॉक्स में देखें।
 - **तैनाती के लिए तैयार** - नेटलिफाई, वर्सेल, क्लाउडफ्लेयर, AWS, या कहीं और जो नोड चलाता है, पर पुश करें। कोई वेंडर लॉक-इन नहीं।
 - **ब्रांडिंग हुक** — नाम, रंग, लोगो, कॉपी सभी को बदलना आसान है।
 
-यह कोई सैद्धांतिक दावा नहीं है। फ़्रेमवर्क का लेखक मेल टेम्पलेट पर अपना वास्तविक इनबॉक्स चलाता है, कैलेंडर टेम्पलेट पर अपना वास्तविक कैलेंडर चलाता है, और एनालिटिक्स टेम्पलेट पर अपना वास्तविक विश्लेषण चलाता है। टेम्प्लेट दैनिक-ड्राइवर सॉफ़्टवेयर हैं।
+यह कोई सैद्धांतिक दावा नहीं है। फ़्रेमवर्क का लेखक Mail ऐप पर अपना वास्तविक इनबॉक्स चलाता है, Calendar ऐप पर अपना वास्तविक कैलेंडर चलाता है, और Analytics ऐप पर अपना वास्तविक विश्लेषण चलाता है। ये दैनिक उपयोग वाले ऐप हैं।
 
 ## आप क्या करते हैं {#what-you-do}
 
@@ -56,7 +56,7 @@ description: "एक कार्यशील SaaS उत्पाद को फ
 <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">एक पूरा ऐप</small>
   </div>
   <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
   <div class="diagram-card">
@@ -98,8 +98,8 @@ description: "एक कार्यशील SaaS उत्पाद को फ
 
 </Diagram>
 
-1. **एक टेम्प्लेट चुनें।** CLI पिकर का उपयोग करें, या दस्तावेज़ ब्राउज़ करें और शुरू करने के लिए एक चुनें।
-2. **इसे ब्रांड करें।** नाम, रंग, लोगो और कॉपी बदलें। अधिकांश टेम्प्लेट इसे एक ही कॉन्फ़िगरेशन फ़ाइल में प्रदर्शित करते हैं।
+1. **एक उदाहरण ऐप चुनें।** CLI पिकर का उपयोग करें, या दस्तावेज़ ब्राउज़ करें और शुरू करने के लिए एक चुनें।
+2. **इसे ब्रांड करें।** नाम, रंग, लोगो और कॉपी बदलें। अधिकांश उदाहरण ऐप्स इसे एक ही कॉन्फ़िगरेशन फ़ाइल में प्रदर्शित करते हैं।
 3. **इसे अनुकूलित करें।** एजेंट से कहें कि वह आपके लिए आवश्यक कॉलम जोड़ें, इनबॉक्स समूहों को कैसे बदलें, अपने आंतरिक API से कनेक्ट करें, एक नया दृश्य जोड़ें। एजेंट कोड संपादित करता है; आप अंतर की समीक्षा करें.
 4. **इसे शिप करें।** परिनियोजन आदेश चलाएँ। अब आपके पास अपने स्वयं के डोमेन पर अपना स्वयं का उत्पादन SaaS है।
 
@@ -159,7 +159,7 @@ description: "एक कार्यशील SaaS उत्पाद को फ
 
 ## फोर्क नहीं करना चाहते? {#hosted}
 
-आपको ऐसा करने की आवश्यकता नहीं है। प्रत्येक टेम्प्लेट `agent-native.com` - `mail.agent-native.com`, `calendar.agent-native.com` इत्यादि पर एक होस्टेड ऐप के रूप में भी उपलब्ध है। होस्ट किए गए संस्करण का निःशुल्क या सशुल्क उपयोग करें; केवल तभी फोर्क करें जब आप कुछ ऐसा बदलना चाहते हैं जो होस्ट किया गया संस्करण उजागर न हो।
+आपको ऐसा करने की आवश्यकता नहीं है। प्रत्येक उदाहरण ऐप `agent-native.com` - `mail.agent-native.com`, `calendar.agent-native.com` इत्यादि पर एक होस्टेड ऐप के रूप में भी उपलब्ध है। होस्ट किए गए संस्करण का निःशुल्क या सशुल्क उपयोग करें; केवल तभी फोर्क करें जब आप कुछ ऐसा बदलना चाहते हैं जो होस्ट किया गया संस्करण उजागर न हो।
 
 ## इसे कौशल के साथ आज़माएं {#try-with-a-skill}
 
@@ -168,10 +168,10 @@ description: "एक कार्यशील SaaS उत्पाद को फ
 ## इस पर निर्माण
 
 - [**Getting Started**](/docs/getting-started) - chat-first app बनाएं, action जोड़ें, structured result render करें और page तक बढ़ाएं
-- [**Messaging the agent**](/docs/messaging) - उपयोगकर्ता (और आप) प्रत्येक टेम्पलेट के साथ शिप करने वाले एजेंट से कैसे बात करते हैं
-- [**Multi-App Workspace**](/docs/multi-app-workspace) - कई टेम्पलेट्स को एक कार्यक्षेत्र में बंडल करें जो ऑथ, ब्रांड और एजेंट को साझा करता है
-- [**Dispatch**](/docs/template-dispatch) - कार्यक्षेत्र नियंत्रण विमान टेम्पलेट
-- [**Creating Templates**](/docs/creating-templates) - लेखक और अपना स्वयं का टेम्पलेट प्रकाशित करें
+- [**Messaging the agent**](/docs/messaging) - उपयोगकर्ता (और आप) प्रत्येक ऐप के साथ शिप करने वाले एजेंट से कैसे बात करते हैं
+- [**Multi-App Workspace**](/docs/multi-app-workspace) - कई ऐप्स को एक कार्यक्षेत्र में बंडल करें जो ऑथ, ब्रांड और एजेंट को साझा करता है
+- [**Dispatch**](/docs/template-dispatch) - कार्यक्षेत्र नियंत्रण विमान ऐप
+- [**Creating Templates**](/docs/creating-templates) - लेखक और अपना स्वयं का ऐप टेम्पलेट प्रकाशित करें
 
 ### डेवलपर्स के लिए {#dev-details}
 
@@ -181,10 +181,10 @@ description: "एक कार्यशील SaaS उत्पाद को फ
 npx @agent-native/core@latest create my-platform
 ```
 
-आपको एक बहु-चयन पिकर मिलेगा। एक ऐप (स्टैंडअलोन) या कई (वर्कस्पेस - ऐप्स शेयर ऑथ, ब्रांड, एजेंट कॉन्फ़िगरेशन और डेटाबेस) चुनें। प्रत्येक चयनित टेम्प्लेट को आपकी आवश्यक प्रत्येक फ़ाइल के साथ `apps/<name>/` में रखा गया है। टेम्पलेट UI के बजाय बिना browser UI वाली automation के लिए, `npx @agent-native/core@latest create my-agent --headless` का उपयोग करें।
+आपको एक बहु-चयन पिकर मिलेगा। एक ऐप (स्टैंडअलोन) या कई (वर्कस्पेस - ऐप्स शेयर ऑथ, ब्रांड, एजेंट कॉन्फ़िगरेशन और डेटाबेस) चुनें। प्रत्येक चयनित ऐप को आपकी आवश्यक प्रत्येक फ़ाइल के साथ `apps/<name>/` में रखा गया है। ऐप UI के बजाय बिना browser UI वाली automation के लिए, `npx @agent-native/core@latest create my-agent --headless` का उपयोग करें।
 
 `.env` (ज्यादातर `ANTHROPIC_API_KEY` और `DATABASE_URL`), `pnpm install`, `pnpm dev` भरें और यह काम करता है। नहीं "TODO: लॉगिन लागू करें," कोई प्लेसहोल्डर रूट नहीं।
 
 परिनियोजन लक्ष्य: कोई भी Nitro-संगत होस्ट (नोड, क्लाउडफ्लेयर, नेटलिफाई, वर्सेल, डेनो, लैम्ब्डा, बन) और कोई भी Drizzle-संगत SQL डेटाबेस (SQLite, Postgres, Turso, D1, Supabase, Neon)। कार्यस्थानों के लिए, `npx @agent-native/core@latest deploy` प्रत्येक ऐप को एक ही बार में बनाता है और उन्हें एक ही मूल में शिप करता है। [Deployment](/docs/deployment) देखें.
 
-अपना स्वयं का टेम्पलेट लिखने और प्रकाशित करने के लिए, [Creating Templates](/docs/creating-templates) देखें।
+अपना स्वयं का ऐप टेम्पलेट लिखने और प्रकाशित करने के लिए, [Creating Templates](/docs/creating-templates) देखें।

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

@@ -25,7 +25,9 @@ import { ResourcesPanel } from "@agent-native/core/client/resources";
 `@agent-native/core/client` या एक केंद्रित `@agent-native/core/client/*` उपपथ
 इसलिए बंडलर ब्राउज़र-सुरक्षित प्रविष्टि चुनते हैं।
 
-`@agent-native/toolkit` का उपयोग उन पुन: उपयोग योग्य ऐप-बिल्डिंग हिस्सों के लिए करें जो मूल रनटाइम अनुबंध का भाग नहीं हैं: shadcn-शैली UI primitives, साझा hooks, सरल ऐप shell helpers, और अन्य template composition modules. संक्रमण के दौरान Core compatibility re-exports रखता है, लेकिन नए template और app code को toolkit modules सीधे import करने चाहिए:
+`@agent-native/toolkit` का उपयोग उन पुन: उपयोग योग्य ऐप-बिल्डिंग हिस्सों के लिए करें जो मूल रनटाइम अनुबंध का भाग नहीं हैं: shadcn-शैली UI primitives, साझा hooks, सरल ऐप shell helpers, और अन्य template composition modules. संक्रमण के दौरान Core compatibility re-exports रखता है.
+
+पुन: उपयोग योग्य packages Toolkit modules सीधे import कर सकते हैं:
 
 ```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";
 ```
 
+Template apps के अंदर app-local adapters को प्राथमिकता दें, ताकि teams primitives को एक बार बदलें और reused Toolkit surfaces वही local implementation इस्तेमाल करें:
+
+```tsx
+import { Button } from "@/components/ui/button";
+import { useToast } from "@/hooks/use-toast";
+```
+
 <Diagram id="doc-block-109zkj3" title={"एक परत नीचे गिराएं, ढांचे से बाहर नहीं"} summary={"प्रत्येक परत आपको क्रोम पर अधिक नियंत्रण प्रदान करते हुए समान रनटाइम - क्रियाएं, थ्रेड स्थिति और SQL-backed सिंक रखती है।"}>
 
 ```html
@@ -437,15 +446,16 @@ function WorkspaceResources() {
 
 ## अन्य सार्वजनिक UI {#other-ui}
 
-| क्षेत्र       | APIs                                                  | आयात पथ                                   |
-| ------------- | ----------------------------------------------------- | ----------------------------------------- |
-| साझा करना     | `<ShareButton>`, `<ShareDialog>`, `<VisibilityBadge>` | `@agent-native/core/client/sharing`       |
-| सूचनाएं       | `<NotificationsBell>`                                 | `@agent-native/core/client/notifications` |
-| प्रगति        | `<RunsTray>`, प्रगति हुक और प्रकार                    | `@agent-native/core/client/progress`      |
-| ऑनबोर्डिंग    | `useOnboarding()`, ऑनबोर्डिंग पैनल हुक                | `@agent-native/core/client/onboarding`    |
-| अवलोकनशीलता   | `<ObservabilityDashboard>`, `<ThumbsFeedback>`        | `@agent-native/core/client/observability` |
-| संसाधन        | `<ResourcesPanel>`, `<ResourceTree>`, संसाधन हुक      | `@agent-native/core/client/resources`     |
-| समृद्ध संपादक | `<SharedRichEditor>`, स्लैश कमांड, ब्लॉक नोड हुक      | `@agent-native/core/client/editor`        |
+| क्षेत्र       | APIs                                             | आयात पथ                                   |
+| ------------- | ------------------------------------------------ | ----------------------------------------- |
+| साझा करना     | `<ShareButton>`, `<ShareDialog>`                 | `@agent-native/core/client/sharing`       |
+| Sharing UI    | `<VisibilityBadge>`                              | `@agent-native/toolkit/sharing`           |
+| सूचनाएं       | `<NotificationsBell>`                            | `@agent-native/core/client/notifications` |
+| प्रगति        | `<RunsTray>`, प्रगति हुक और प्रकार               | `@agent-native/core/client/progress`      |
+| ऑनबोर्डिंग    | `useOnboarding()`, ऑनबोर्डिंग पैनल हुक           | `@agent-native/core/client/onboarding`    |
+| अवलोकनशीलता   | `<ObservabilityDashboard>`, `<ThumbsFeedback>`   | `@agent-native/core/client/observability` |
+| संसाधन        | `<ResourcesPanel>`, `<ResourceTree>`, संसाधन हुक | `@agent-native/core/client/resources`     |
+| समृद्ध संपादक | `<SharedRichEditor>`, स्लैश कमांड, ब्लॉक नोड हुक | `@agent-native/core/client/editor`        |
 
 ## एकमुश्त पाठ समापन {#one-off-text-completion}