@agent-native/core 0.86.1 → 0.88.0

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

@@ -0,0 +1,77 @@
+---
+title: "Toolkit de Agent-Native"
+description: "Kits reutilizables para colaboración, ajustes, compartir, navegación, presencia, historial, configuración y UX del agente."
+---
+
+# Toolkit de Agent-Native
+
+Las apps de Agent-Native no deberían reconstruir la fontanería del workspace.
+Las apps son dueñas de sus modelos, acciones y vistas de producto. El framework
+y `@agent-native/toolkit` son dueños de las piezas reutilizables que todas las
+apps deberían heredar: colaboración, compartir, ajustes, navegación,
+organización, configuración, UX del agente, historial y visibilidad operativa.
+
+El objetivo es que los usuarios aprendan una sola forma de compartir, conectar
+claves, ver al agente editar junto a ellos, encontrar ajustes y entender qué
+cambió.
+
+## Contrato del toolkit {#toolkit-contract}
+
+Mueve comportamiento al toolkit cuando sea:
+
+- **De workspace** - los usuarios esperan que funcione igual en todas las apps.
+- **Visible para el agente** - el agente necesita la misma capacidad mediante
+  acciones, instrucciones o estado de aplicación.
+- **Gobernado** - aplican permisos, auditoría, secretos, política de org,
+  facturación o reglas de compartir.
+- **Repetido** - dos apps ya construyeron UI o lógica parecida.
+- **No específico del dominio** - la app aporta nombres y acciones de recursos,
+  pero el patrón de interacción es genérico.
+
+Mantén lo local cuando dependa de un modelo de dominio o de un flujo propio de
+la app.
+
+## Kits reutilizables {#reusable-kits}
+
+- **Settings kit** - pestañas estándar para cuenta, workspace, modelos de AI,
+  claves LLM, conexiones, secretos, uso, notificaciones, changelog y preferencias
+  de app. La configuración durable vive en Settings; la barra lateral del agente
+  conserva controles contextuales y enlaces profundos.
+- **Collaboration kit** - edición en tiempo real, documentos Yjs, presencia,
+  presencia del agente, cursores, selecciones remotas, resaltado de ediciones y
+  undo/redo compartido. Ver
+  [Real-Time Collaboration](/docs/real-time-collaboration).
+- **Sharing kit** - un solo modelo de privacidad y permisos para privado,
+  workspace, org, enlace público, invitaciones, roles, expiraciones y acceso
+  legible por agentes. Ver [Sharing & Privacy](/docs/sharing).
+- **Navigation and command kit** - app shell, navegación, breadcrumbs, app
+  switcher, command palette, recursos recientes, recursos fijados y búsqueda.
+- **Organization kit** - carpetas, tags, favoritos, archivo, papelera,
+  propietarios, membresía y metadata común.
+- **Setup and connections kit** - claves API, OAuth, conexiones, estado de
+  modelos, secretos faltantes y onboarding declarativo. Ver
+  [Workspace Connections](/docs/workspace-connections).
+- **Agent UX kit** - sidebar, composer, contexto preparado, menciones, voz,
+  aprobación humana, UI generativa, progreso y estado visible para el agente.
+- **History and recovery kit** - audit log, activity feed, version history,
+  checkpoints, undo, redo, restore y proof-of-done. Ver
+  [Audit Log](/docs/audit-log).
+- **Comments and review kit** - comentarios anclados, pines, menciones,
+  solicitudes de revisión, threads resueltos y tareas de seguimiento del agente.
+- **Workflow and observability kit** - notificaciones, aprobaciones, runs en
+  background, jobs recurrentes, traces, evals, feedback y líneas de tiempo. Ver
+  [Observability](/docs/observability).
+
+## Orden de implementación {#implementation-order}
+
+1. Consolidar la configuración durable en pestañas estándar de Settings.
+2. Normalizar colaboración, presence, agent presence, undo/redo y edición en
+   tiempo real detrás de adapters compartidos.
+3. Mover navegación, comandos, recientes, favoritos, carpetas, tags, archivo y
+   papelera a primitivas compartidas.
+4. Registrar todos los recursos compartibles en el mismo modelo de permisos y
+   acceso legible por agentes.
+5. Dar a cada recurso colaborativo una historia consistente de actividad,
+   comentarios, revisión, restore y auditoría.
+6. Unificar notificaciones, aprobaciones, estado de runs, traces, evals y
+   feedback.

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

@@ -25,6 +25,15 @@ 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:
+
+```tsx
+import { Button } from "@agent-native/toolkit/ui/button";
+import { Toaster } from "@agent-native/toolkit/ui/sonner";
+import { useToast } from "@agent-native/toolkit/hooks/use-toast";
+import { useSetHeaderActions } from "@agent-native/toolkit/app-shell";
+```
+
 <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

package/corpus/core/docs/content/locales/es-ES/creating-templates.mdx

@@ -7,6 +7,8 @@ description: "Cómo crear y publicar sus propias plantillas de aplicaciones nati
 
 Las plantillas son aplicaciones nativas del agente completas y bifurcables que resuelven un flujo de trabajo real. Las plantillas propias se crean con la misma superficie de marco que usted utiliza: rutas React para UI, Drizzle SQL para datos, actions para operaciones, recursos del espacio de trabajo para el comportamiento del agente y sincronización de sondeos para que el agente y UI permanezcan alineados.
 
+Use `@agent-native/core` para el contrato de runtime: actions, plugins de servidor, helpers de base de datos, estado de aplicación, helpers de rutas y chat del agente. Use `@agent-native/toolkit` para UI reutilizable y helpers de construcción de apps, como primitivas compartidas, hooks de toast/móvil, selectores de fecha y slots simples de shell de aplicación. Mantenga locales las variantes específicas de una plantilla cuando codifiquen comportamiento de producto o identidad visual.
+
 Una buena plantilla:
 
 - Resuelve un flujo de trabajo de principio a fin, con datos iniciales útiles o un flujo de estado vacío.

package/corpus/core/docs/content/locales/es-ES/sharing.mdx

@@ -93,9 +93,10 @@ Cada plantilla que almacena trabajos escritos por usuarios utiliza este modelo.
 - **Diapositivas**: presentaciones
 - **Diseño**: diseños y recursos
 - **Clips**: grabaciones de pantalla (estilo Loom)
+- **Plan** — visual plans and PR recaps
 - **Formularios**: definiciones de formulario
 - **Calendario**: enlaces a eventos y reservas
-- **Analytics**: paneles (en implementación; consulte el `AGENTS.md` de la plantilla de análisis)
+- **Analytics**: dashboards, saved analyses, and tokenized session replays
 - **Extensiones**: miniaplicaciones en espacio aislado (consulte [Extensions](/docs/extensions#sharing))
 
 Cada uno de estos utiliza el mismo asistente de esquema `ownableColumns()`, la misma acción `share-resource` y el mismo `<ShareButton>` UI. Pase de una plantilla a otra y el cuadro de diálogo para compartir se verá idéntico.
@@ -136,15 +137,22 @@ Para las listas, coloque un `<VisibilityBadge visibility={row.visibility} />` al
 
 El marco monta automáticamente estos actions en cada plantilla: el agente los llama como herramientas y el UI los llama a través de `useActionQuery`/`useActionMutation`:
 
-| Acción                    | Qué hace                                                                                                                                       |
-| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
-| `share-resource`          | Otorgar acceso a un usuario u organización en una función específica. El `notify` opcional controla las notificaciones por correo electrónico. |
-| `unshare-resource`        | Revocar el acceso a un usuario u organización.                                                                                                 |
-| `list-resource-shares`    | Mostrar visibilidad actual más todas las subvenciones explícitas.                                                                              |
-| `set-resource-visibility` | Cambiar a `private`, `org` o `public`.                                                                                                         |
+| Acción                       | Qué hace                                                                                                                                       |
+| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
+| `share-resource`             | Otorgar acceso a un usuario u organización en una función específica. El `notify` opcional controla las notificaciones por correo electrónico. |
+| `unshare-resource`           | Revocar el acceso a un usuario u organización.                                                                                                 |
+| `list-resource-shares`       | Mostrar visibilidad actual más todas las subvenciones explícitas.                                                                              |
+| `set-resource-visibility`    | Cambiar a `private`, `org` o `public`.                                                                                                         |
+| `create-agent-resource-link` | Mint a temporary read-only `agent_access` URL for a registered agent-readable resource.                                                        |
 
 Dígale al agente "comparta este diseño con el equipo de marketing como editores" y llamará a `share-resource` contra el mismo punto final que utiliza UI. El resultado aparece en el cuadro de diálogo para compartir en el siguiente renderizado.
 
+## 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`.
+
 ## Construyéndolo en una nueva plantilla {#building}
 
 Si está creando una plantilla (consulte [Creating Templates](/docs/creating-templates)), el cableado compartido es corto. Dos adiciones a su esquema:

package/corpus/core/docs/content/locales/es-ES/template-analytics.mdx

@@ -149,6 +149,12 @@ El CLI imprime el desarrollador local URL. Inicia sesión con Google y luego abr
 
 **Session replay agent handoff.** Session recordings stay private, but the session detail page can mint a temporary **Copy for agent** link. The two-hour `agent_access` URL lets an external agent read replay summaries, timelines, and bounded event details without exposing blob/provider URLs or making the recording public.
 
+Implementation note: use the shared core agent-access helpers
+(`createScopedAgentAccessGrant`, `verifyScopedAgentAccessToken`,
+`buildAgentAccessUrl`, and `buildAgentAccessApiUrl`) for the SSR/bot-visible
+URL contract. Keep replay chunk authorization, diagnostics payloads, and the
+session detail UI local to Analytics.
+
 ### Trabajar con el agente
 
 El agente siempre sabe lo que estás mirando. El estado actual de la pantalla se inyecta en cada mensaje como un bloque `<current-screen>`: contiene la vista activa, el panel o análisis abierto y los filtros seleccionados.

package/corpus/core/docs/content/locales/es-ES/template-clips.mdx

@@ -133,6 +133,13 @@ agente.
 
 Temporary private agent links are also supported: the Share dialog can mint a two-hour `agent_access` URL for any recording the viewer can access. Agents use that token with the share page and JSON APIs, and the clip does not become public.
 
+Implementation note: use the shared core agent-access helpers
+(`createScopedAgentAccessGrant`, `verifyScopedAgentAccessToken`,
+`buildAgentAccessUrl`, and `buildAgentAccessApiUrl`) for the SSR/bot-visible
+URL contract. Keep Clips-specific visibility checks, transcript/frame payloads,
+and player UI local. New links use `agent_access`; routes should continue
+accepting the legacy `t` query where existing agent API URLs may already use it.
+
 Los puntos finales siguen las mismas reglas de público/contraseña/caducidad que la página para compartir.
 Los clips protegidos con contraseña requieren la contraseña una vez; regresan respuestas exitosas
 Enlaces tokenizados de corta duración para que los agentes posteriores no necesiten el texto sin formato

package/corpus/core/docs/content/locales/es-ES/tracking.mdx

@@ -241,6 +241,12 @@ La plantilla de Analytics almacena los metadatos de repetición en SQL (`session
 
 Cuando necesite entregar una grabación privada a un agente externo, use el control **Copiar para el agente** de la página de detalle de la sesión. Este genera un enlace `agent_access` de dos horas con alcance limitado a la grabación, renderiza en el servidor (SSR) una pequeña carga útil de descubrimiento en `/sessions/:recordingId`, y expone únicamente las API JSON de contexto/eventos del agente. La visibilidad de la grabación no cambia.
 
+Implementation note: the reusable layer is the core agent-access URL contract,
+not a replay-specific UI abstraction. Use `createScopedAgentAccessGrant`,
+`verifyScopedAgentAccessToken`, `buildAgentAccessUrl`, and
+`buildAgentAccessApiUrl` for scoped SSR and JSON API links; keep replay storage,
+diagnostics shaping, and access policy inside the Analytics template.
+
 Solo para desarrollo local, Analytics puede recurrir a fragmentos en línea de SQL limitados cuando el almacenamiento de blob privado no está disponible. Las implementaciones de producción deberían configurar almacenamiento de blob privado o cifrado en lugar de depender de Postgres para las cargas útiles de repetición.
 
 ## Avanzado: proveedores personalizados e internos {#advanced}

package/corpus/core/docs/content/locales/fr-FR/agent-native-toolkit.mdx

@@ -0,0 +1,79 @@
+---
+title: "Boîte à outils Agent-Native"
+description: "Kits réutilisables pour collaboration, réglages, partage, navigation, présence, historique, configuration et UX agent."
+---
+
+# Boîte à outils Agent-Native
+
+Les apps Agent-Native ne devraient pas reconstruire toute la plomberie du
+workspace. Les apps possèdent leurs modèles métier, leurs actions métier et
+leurs vues produit. Le framework et `@agent-native/toolkit` possèdent les
+surfaces réutilisables que chaque app devrait hériter : collaboration, partage,
+réglages, navigation, organisation, configuration, UX agent, historique et
+visibilité opérationnelle.
+
+L'objectif est que les utilisateurs apprennent une seule manière de partager,
+connecter des clés, voir l'agent modifier avec eux, trouver les réglages et
+comprendre ce qui a changé.
+
+## Contrat du toolkit {#toolkit-contract}
+
+Déplacez un comportement dans le toolkit quand il est :
+
+- **À l'échelle du workspace** - les utilisateurs s'attendent au même
+  fonctionnement dans toutes les apps.
+- **Visible par l'agent** - l'agent a besoin de la même capacité via actions,
+  instructions ou état applicatif.
+- **Gouverné** - permissions, audit, secrets, politique d'organisation,
+  facturation ou règles de partage s'appliquent.
+- **Répété** - deux apps ont déjà construit une UI ou une logique similaire.
+- **Non spécifique au domaine** - l'app fournit les noms et actions de
+  ressources, mais le modèle d'interaction est générique.
+
+Gardez le comportement local quand il dépend vraiment du domaine ou d'un flux
+spécifique à l'app.
+
+## Kits réutilisables {#reusable-kits}
+
+- **Settings kit** - onglets standard pour compte, workspace, modèles AI, clés
+  LLM, connexions, secrets, usage, notifications, changelog et préférences
+  d'app. La configuration durable vit dans Settings ; la sidebar agent garde des
+  contrôles contextuels et des liens profonds.
+- **Collaboration kit** - édition temps réel, documents Yjs, présence, présence
+  de l'agent, curseurs, sélections distantes, surlignage des éditions et
+  undo/redo partagé. Voir
+  [Real-Time Collaboration](/docs/real-time-collaboration).
+- **Sharing kit** - un seul modèle de confidentialité et permissions pour privé,
+  workspace, org, lien public, invitations, rôles, expirations et accès lisible
+  par l'agent. Voir [Sharing & Privacy](/docs/sharing).
+- **Navigation and command kit** - app shell, navigation, breadcrumbs, app
+  switcher, command palette, ressources récentes, ressources épinglées et
+  recherche.
+- **Organization kit** - dossiers, tags, favoris, archive, corbeille,
+  propriétaires, membres et metadata commune.
+- **Setup and connections kit** - clés API, OAuth, connexions, disponibilité des
+  modèles, secrets manquants et onboarding déclaratif. Voir
+  [Workspace Connections](/docs/workspace-connections).
+- **Agent UX kit** - sidebar, composer, contexte préparé, mentions, voix,
+  validation humaine, UI générative, progression et état visible par l'agent.
+- **History and recovery kit** - audit log, activity feed, version history,
+  checkpoints, undo, redo, restore et proof-of-done. Voir
+  [Audit Log](/docs/audit-log).
+- **Comments and review kit** - commentaires ancrés, pins, mentions, demandes de
+  review, threads résolus et tâches de suivi agent.
+- **Workflow and observability kit** - notifications, validations, runs en
+  arrière-plan, jobs récurrents, traces, evals, feedback et timelines. Voir
+  [Observability](/docs/observability).
+
+## Ordre d'implémentation {#implementation-order}
+
+1. Consolider la configuration durable dans des onglets Settings standard.
+2. Normaliser collaboration, presence, agent presence, undo/redo et édition
+   temps réel derrière des adapters partagés.
+3. Déplacer navigation, commandes, récents, favoris, dossiers, tags, archive et
+   corbeille vers des primitives partagées.
+4. Enregistrer chaque ressource partageable dans le même modèle de permissions
+   et d'accès lisible par l'agent.
+5. Donner à chaque ressource collaborative une histoire cohérente d'activité,
+   commentaires, review, restore et audit.
+6. Unifier notifications, validations, état des runs, traces, evals et feedback.

package/corpus/core/docs/content/locales/fr-FR/components.mdx

@@ -25,6 +25,15 @@ import { ResourcesPanel } from "@agent-native/core/client/resources";
 `@agent-native/core/client` ou un sous-chemin `@agent-native/core/client/*` ciblé
 les bundlers choisissent donc l'entrée sécurisée pour le navigateur.
 
+Utilisez `@agent-native/toolkit` pour les éléments réutilisables de construction d'applications qui ne font pas partie du contrat fondamental du runtime : primitives UI de style shadcn, hooks partagés, aides simples de shell d'application et autres modules de composition de modèles. Core conserve des réexportations de compatibilité pendant la transition, mais le nouveau code de modèle et d'application doit importer directement les modules toolkit :
+
+```tsx
+import { Button } from "@agent-native/toolkit/ui/button";
+import { Toaster } from "@agent-native/toolkit/ui/sonner";
+import { useToast } from "@agent-native/toolkit/hooks/use-toast";
+import { useSetHeaderActions } from "@agent-native/toolkit/app-shell";
+```
+
 <Diagram id="doc-block-n2zqzy" title={"Déposez un calque, pas hors du cadre"} summary={"Chaque couche conserve le même temps d'exécution (actions, état du thread et synchronisation SQL-backed) tout en vous donnant plus de contrôle sur le chrome."}>
 
 ```html

package/corpus/core/docs/content/locales/fr-FR/creating-templates.mdx

@@ -7,6 +7,8 @@ description: "Comment créer et publier vos propres modèles d'applications nati
 
 Les modèles sont des applications natives d'agent complètes et exploitables qui résolvent un véritable flux de travail. Les modèles propriétaires sont créés avec la même surface de structure que vous utilisez : routes React pour le UI, Drizzle SQL pour les données, actions pour les opérations, ressources d'espace de travail pour le comportement de l'agent et synchronisation des interrogations afin que l'agent et le UI restent alignés.
 
+Utilisez `@agent-native/core` pour le contrat de runtime : actions, plugins serveur, aides de base de données, état de l'application, aides de routage et chat de l'agent. Utilisez `@agent-native/toolkit` pour l'UI réutilisable de construction d'applications et les aides comme les primitives partagées, les hooks toast/mobile, les sélecteurs de date et les slots simples de shell d'application. Gardez les variantes propres au modèle locales lorsqu'elles encodent un comportement produit ou une identité visuelle.
+
 Un bon modèle :
 
 - Résout un flux de travail de bout en bout, avec des données de départ utiles ou un flux à état vide.

package/corpus/core/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/corpus/core/docs/content/locales/fr-FR/template-analytics.mdx

@@ -149,6 +149,12 @@ Le CLI imprime le développement local URL. Connectez-vous avec Google, puis ouv
 
 **Session replay agent handoff.** Session recordings stay private, but the session detail page can mint a temporary **Copy for agent** link. The two-hour `agent_access` URL lets an external agent read replay summaries, timelines, and bounded event details without exposing blob/provider URLs or making the recording public.
 
+Implementation note: use the shared core agent-access helpers
+(`createScopedAgentAccessGrant`, `verifyScopedAgentAccessToken`,
+`buildAgentAccessUrl`, and `buildAgentAccessApiUrl`) for the SSR/bot-visible
+URL contract. Keep replay chunk authorization, diagnostics payloads, and the
+session detail UI local to Analytics.
+
 ### Travailler avec l'agent
 
 L'agent sait toujours ce que vous regardez. L'état actuel de l'écran est injecté dans chaque message sous forme de bloc `<current-screen>` : il contient la vue active, le tableau de bord ou l'analyse ouvert et tous les filtres sélectionnés.

package/corpus/core/docs/content/locales/fr-FR/template-clips.mdx

@@ -133,6 +133,13 @@ agent.
 
 Temporary private agent links are also supported: the Share dialog can mint a two-hour `agent_access` URL for any recording the viewer can access. Agents use that token with the share page and JSON APIs, and the clip does not become public.
 
+Implementation note: use the shared core agent-access helpers
+(`createScopedAgentAccessGrant`, `verifyScopedAgentAccessToken`,
+`buildAgentAccessUrl`, and `buildAgentAccessApiUrl`) for the SSR/bot-visible
+URL contract. Keep Clips-specific visibility checks, transcript/frame payloads,
+and player UI local. New links use `agent_access`; routes should continue
+accepting the legacy `t` query where existing agent API URLs may already use it.
+
 Les points de terminaison suivent les mêmes règles de public/mot de passe/expiration que la page de partage.
 Les clips protégés par mot de passe nécessitent le mot de passe une seule fois ; les réponses positives reviennent
 Liens tokenisés de courte durée afin que les agents en aval n'aient pas besoin du texte brut

package/corpus/core/docs/content/locales/fr-FR/tracking.mdx

@@ -241,6 +241,12 @@ Le modèle Analytics stocke les métadonnées de relecture en SQL (`session_reco
 
 Lorsque vous devez transmettre un enregistrement privé à un agent externe, utilisez le contrôle **Copy for agent** de la page de détail de session. Il génère un lien `agent_access` limité à l'enregistrement, valide deux heures, effectue le rendu SSR d'une petite charge utile de découverte sur `/sessions/:recordingId`, et n'expose que les API JSON de contexte/événements de l'agent. La visibilité de l'enregistrement ne change pas.
 
+Implementation note: the reusable layer is the core agent-access URL contract,
+not a replay-specific UI abstraction. Use `createScopedAgentAccessGrant`,
+`verifyScopedAgentAccessToken`, `buildAgentAccessUrl`, and
+`buildAgentAccessApiUrl` for scoped SSR and JSON API links; keep replay storage,
+diagnostics shaping, and access policy inside the Analytics template.
+
 Pour le développement local uniquement, Analytics peut se replier sur des blocs SQL en ligne plafonnés lorsque le stockage blob privé n'est pas disponible. Les déploiements en production doivent configurer un stockage blob privé ou chiffré plutôt que de s'appuyer sur Postgres pour les charges utiles de relecture.
 
 ## Avancé : fournisseurs personnalisés et éléments internes {#advanced}

package/corpus/core/docs/content/locales/hi-IN/agent-native-toolkit.mdx

@@ -0,0 +1,74 @@
+---
+title: "Agent-Native Toolkit"
+description: "Collaboration, settings, sharing, navigation, presence, history, setup और Agent UX के लिए reusable kits."
+---
+
+# Agent-Native Toolkit
+
+Agent-Native apps को workspace की common plumbing बार-बार नहीं बनानी चाहिए।
+Apps अपने domain models, domain actions और product-specific views की owner होती
+हैं। Framework और `@agent-native/toolkit` उन reusable surfaces के owner हैं जो
+हर app को inherit करनी चाहिए: collaboration, sharing, settings, navigation,
+organization, setup, Agent UX, history और operational visibility.
+
+Users को sharing, API keys, agent editing presence, settings और change history
+के लिए हर app में नया pattern नहीं सीखना चाहिए।
+
+## Toolkit contract {#toolkit-contract}
+
+Behavior को toolkit में move करें जब वह:
+
+- **Workspace-wide** हो - users हर app में same behavior expect करते हैं।
+- **Agent-visible** हो - agent को actions, instructions या application state से
+  वही capability चाहिए।
+- **Governed** हो - permissions, audit, secrets, org policy, billing या sharing
+  rules apply होते हैं।
+- **Repeated** हो - दो apps similar UI या logic बना चुकी हैं।
+- **Non-domain-specific** हो - app resource names और actions देती है, लेकिन
+  interaction pattern generic है।
+
+जो behavior domain model या app-specific workflow से deeply जुड़ा है, उसे
+app-local रखें।
+
+## Reusable kits {#reusable-kits}
+
+- **Settings kit** - account, workspace, AI models, LLM keys, connections,
+  secrets, usage, notifications, changelog और app preferences के standard tabs.
+  Durable config Settings में रहे; agent sidebar contextual quick controls और
+  deep links रखे।
+- **Collaboration kit** - real-time editing, Yjs docs, presence, agent presence,
+  live cursors, remote selections, recent edit highlights और shared undo/redo.
+  देखें [Real-Time Collaboration](/docs/real-time-collaboration).
+- **Sharing kit** - private, workspace, org, public link, invites, roles,
+  expirations और agent-readable access के लिए एक privacy और permissions model.
+  देखें [Sharing & Privacy](/docs/sharing).
+- **Navigation and command kit** - app shell, nav, breadcrumbs, app switcher,
+  command palette, recents, pinned resources और search.
+- **Organization kit** - folders, tags, favorites, archive, trash, ownership,
+  membership और common metadata.
+- **Setup and connections kit** - API keys, OAuth, connections, model readiness,
+  missing secrets और declarative onboarding. देखें
+  [Workspace Connections](/docs/workspace-connections).
+- **Agent UX kit** - sidebar, composer, staged context, mentions, voice, human
+  approval, generative UI, progress और Agent-visible state.
+- **History and recovery kit** - audit log, activity feed, version history,
+  checkpoints, undo, redo, restore और proof-of-done. देखें
+  [Audit Log](/docs/audit-log).
+- **Comments and review kit** - anchored comments, pins, mentions, review
+  requests, resolved threads और Agent follow-up tasks.
+- **Workflow and observability kit** - notifications, approvals, background
+  runs, recurring jobs, traces, evals, feedback और run timelines. देखें
+  [Observability](/docs/observability).
+
+## Implementation order {#implementation-order}
+
+1. Durable configuration को standard Settings tabs में consolidate करें।
+2. collaboration, presence, agent presence, undo/redo और real-time editing को
+   shared adapters के पीछे normalize करें।
+3. navigation, commands, recents, favorites, folders, tags, archive और trash को
+   shared primitives में move करें।
+4. हर shareable resource को same permissions और agent-readable access model में
+   register करें।
+5. हर collaborative resource को activity, comments, review, restore और audit की
+   consistent story दें।
+6. notifications, approvals, run status, traces, evals और feedback unify करें।

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

@@ -25,6 +25,15 @@ 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 करने चाहिए:
+
+```tsx
+import { Button } from "@agent-native/toolkit/ui/button";
+import { Toaster } from "@agent-native/toolkit/ui/sonner";
+import { useToast } from "@agent-native/toolkit/hooks/use-toast";
+import { useSetHeaderActions } from "@agent-native/toolkit/app-shell";
+```
+
 <Diagram id="doc-block-109zkj3" title={"एक परत नीचे गिराएं, ढांचे से बाहर नहीं"} summary={"प्रत्येक परत आपको क्रोम पर अधिक नियंत्रण प्रदान करते हुए समान रनटाइम - क्रियाएं, थ्रेड स्थिति और SQL-backed सिंक रखती है।"}>
 
 ```html

package/corpus/core/docs/content/locales/hi-IN/creating-templates.mdx

@@ -7,6 +7,8 @@ description: "अपने स्वयं के एजेंट-नेटि
 
 टेम्प्लेट पूर्ण, फोर्केबल एजेंट-नेटिव ऐप्स हैं जो वास्तविक वर्कफ़्लो को हल करते हैं। प्रथम-पक्ष टेम्पलेट आपके द्वारा उपयोग की जाने वाली समान फ़्रेमवर्क सतह के साथ बनाए गए हैं: UI के लिए React रूट, डेटा के लिए Drizzle SQL, संचालन के लिए actions, एजेंट व्यवहार के लिए कार्यक्षेत्र संसाधन, और पोलिंग सिंक ताकि एजेंट और UI संरेखित रहें।
 
+`@agent-native/core` का उपयोग runtime contract के लिए करें: actions, server plugins, database helpers, app state, routing helpers, और agent chat. `@agent-native/toolkit` का उपयोग reusable app-building UI और helpers के लिए करें, जैसे shared primitives, toast/mobile hooks, date pickers, और simple app shell slots. जब variants product behavior या visual identity encode करते हैं, तो उन्हें template-local रखें.
+
 एक अच्छा टेम्पलेट:
 
 - उपयोगी बीज डेटा या खाली-अवस्था प्रवाह के साथ एक वर्कफ़्लो को शुरू से अंत तक हल करता है।

package/corpus/core/docs/content/locales/hi-IN/sharing.mdx

@@ -93,9 +93,10 @@ description: "Google-डॉक्स-शैली साझाकरण, फ़
 - **स्लाइड** — डेक
 - **डिज़ाइन** — डिज़ाइन और संपत्ति
 - **क्लिप्स** — स्क्रीन रिकॉर्डिंग (लूम-शैली)
+- **Plan** — visual plans and PR recaps
 - **फ़ॉर्म** — फॉर्म परिभाषाएँ
 - **कैलेंडर** — ईवेंट और बुकिंग लिंक
-- **एनालिटिक्स** - डैशबोर्ड (बाहर चल रहा है - एनालिटिक्स टेम्पलेट का `AGENTS.md` देखें)
+- **एनालिटिक्स** - dashboards, saved analyses, and tokenized session replays
 - **एक्सटेंशन** — सैंडबॉक्स्ड मिनी-ऐप्स ([Extensions](/docs/extensions#sharing) देखें)
 
 इनमें से हर एक समान `ownableColumns()` स्कीमा हेल्पर, समान `share-resource` क्रिया और समान `<ShareButton>` UI का उपयोग करता है। एक टेम्प्लेट से दूसरे टेम्प्लेट पर जाएं और शेयर डायलॉग समान दिखता है।
@@ -136,15 +137,22 @@ import { ShareButton } from "@agent-native/core/client";
 
 फ्रेमवर्क इन actions को प्रत्येक टेम्पलेट में ऑटो-माउंट करता है - एजेंट उन्हें टूल के रूप में कॉल करता है, और UI उन्हें `useActionQuery` / `useActionMutation` के माध्यम से कॉल करता है:
 
-| कार्रवाई                  | यह क्या करता है                                                                                                            |
-| ------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
-| `share-resource`          | किसी उपयोगकर्ता या संगठन को किसी विशिष्ट भूमिका तक पहुंच प्रदान करें। वैकल्पिक `notify` ईमेल सूचनाओं को नियंत्रित करता है। |
-| `unshare-resource`        | किसी उपयोगकर्ता या संगठन के लिए पहुंच रद्द करें।                                                                           |
-| `list-resource-shares`    | वर्तमान दृश्यता और सभी स्पष्ट अनुदान दिखाएं।                                                                               |
-| `set-resource-visibility` | `private`, `org`, या `public` में बदलें।                                                                                   |
+| कार्रवाई                     | यह क्या करता है                                                                                                            |
+| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
+| `share-resource`             | किसी उपयोगकर्ता या संगठन को किसी विशिष्ट भूमिका तक पहुंच प्रदान करें। वैकल्पिक `notify` ईमेल सूचनाओं को नियंत्रित करता है। |
+| `unshare-resource`           | किसी उपयोगकर्ता या संगठन के लिए पहुंच रद्द करें।                                                                           |
+| `list-resource-shares`       | वर्तमान दृश्यता और सभी स्पष्ट अनुदान दिखाएं।                                                                               |
+| `set-resource-visibility`    | `private`, `org`, या `public` में बदलें।                                                                                   |
+| `create-agent-resource-link` | Mint a temporary read-only `agent_access` URL for a registered agent-readable resource.                                    |
 
 एजेंट को बताएं "इस डिज़ाइन को संपादकों के रूप में मार्केटिंग टीम के साथ साझा करें" और यह UI द्वारा उपयोग किए जाने वाले उसी एंडपॉइंट के विरुद्ध `share-resource` को कॉल करता है। परिणाम अगले रेंडर पर शेयर डायलॉग में दिखाई देता है।
 
+## 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`.
+
 ## इसे एक नए टेम्पलेट में बनाना {#building}
 
 यदि आप एक टेम्प्लेट बना रहे हैं ([Creating Templates](/docs/creating-templates) देखें), तो वायरिंग शेयरिंग कम है। आपकी स्कीम में दो अतिरिक्त:

package/corpus/core/docs/content/locales/hi-IN/template-analytics.mdx

@@ -149,6 +149,12 @@ CLI स्थानीय डेव URL प्रिंट करता है
 
 **Session replay agent handoff.** Session recordings stay private, but the session detail page can mint a temporary **Copy for agent** link. The two-hour `agent_access` URL lets an external agent read replay summaries, timelines, and bounded event details without exposing blob/provider URLs or making the recording public.
 
+Implementation note: use the shared core agent-access helpers
+(`createScopedAgentAccessGrant`, `verifyScopedAgentAccessToken`,
+`buildAgentAccessUrl`, and `buildAgentAccessApiUrl`) for the SSR/bot-visible
+URL contract. Keep replay chunk authorization, diagnostics payloads, and the
+session detail UI local to Analytics.
+
 ### एजेंट के साथ काम करना
 
 एजेंट को हमेशा पता होता है कि आप क्या देख रहे हैं। वर्तमान स्क्रीन स्थिति को प्रत्येक संदेश में `<current-screen>` ब्लॉक के रूप में इंजेक्ट किया जाता है - इसमें सक्रिय दृश्य, खुला डैशबोर्ड या विश्लेषण और कोई भी चयनित फ़िल्टर शामिल होता है।

package/corpus/core/docs/content/locales/hi-IN/template-clips.mdx

@@ -133,6 +133,13 @@ APIs, इसलिए मॉडल जो केवल पाठ या स्
 
 Temporary private agent links are also supported: the Share dialog can mint a two-hour `agent_access` URL for any recording the viewer can access. Agents use that token with the share page and JSON APIs, and the clip does not become public.
 
+Implementation note: use the shared core agent-access helpers
+(`createScopedAgentAccessGrant`, `verifyScopedAgentAccessToken`,
+`buildAgentAccessUrl`, and `buildAgentAccessApiUrl`) for the SSR/bot-visible
+URL contract. Keep Clips-specific visibility checks, transcript/frame payloads,
+and player UI local. New links use `agent_access`; routes should continue
+accepting the legacy `t` query where existing agent API URLs may already use it.
+
 एंडपॉइंट शेयर पेज के समान सार्वजनिक/पासवर्ड/समाप्ति नियमों का पालन करते हैं।
 पासवर्ड-सुरक्षित क्लिप को एक बार पासवर्ड की आवश्यकता होती है; सफल प्रत्युत्तर वापस आते हैं
 अल्पकालिक टोकनयुक्त लिंक ताकि डाउनस्ट्रीम एजेंटों को प्लेनटेक्स्ट की आवश्यकता न हो

package/corpus/core/docs/content/locales/hi-IN/tracking.mdx

@@ -241,6 +241,12 @@ Analytics टेम्पलेट replay मेटाडेटा को SQL (`
 
 जब आपको किसी बाहरी एजेंट को एक प्राइवेट रिकॉर्डिंग सौंपने की आवश्यकता हो, तो session डिटेल पेज के **Copy for agent** नियंत्रण का उपयोग करें। यह एक दो-घंटे का, रिकॉर्डिंग-स्कोप्ड `agent_access` लिंक बनाता है, `/sessions/:recordingId` पर एक छोटा डिस्कवरी पेलोड SSR करता है, और केवल एजेंट context/events JSON APIs को एक्सपोज़ करता है। रिकॉर्डिंग की visibility नहीं बदलती।
 
+Implementation note: the reusable layer is the core agent-access URL contract,
+not a replay-specific UI abstraction. Use `createScopedAgentAccessGrant`,
+`verifyScopedAgentAccessToken`, `buildAgentAccessUrl`, and
+`buildAgentAccessApiUrl` for scoped SSR and JSON API links; keep replay storage,
+diagnostics shaping, and access policy inside the Analytics template.
+
 केवल स्थानीय विकास के लिए, Analytics प्राइवेट blob storage उपलब्ध न होने पर capped SQL inline chunks पर फ़ॉलबैक कर सकता है। प्रोडक्शन डिप्लॉयमेंट्स को replay payloads के लिए Postgres पर निर्भर रहने के बजाय प्राइवेट या एन्क्रिप्टेड blob storage कॉन्फ़िगर करना चाहिए।
 
 ## उन्नत: कस्टम प्रदाता और आंतरिक {#advanced}