@agent-native/core 0.87.0 → 0.88.0

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,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/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/docs/content/locales/ja-JP/agent-native-toolkit.mdx

@@ -0,0 +1,67 @@
+---
+title: "Agent-Native ツールキット"
+description: "コラボレーション、設定、共有、ナビゲーション、プレゼンス、履歴、セットアップ、Agent UX の再利用可能なキット。"
+---
+
+# Agent-Native ツールキット
+
+Agent-Native のアプリは、workspace の共通機能を毎回作り直すべきではありません。
+アプリはドメインモデル、ドメイン action、固有のビューを持ちます。Framework と
+`@agent-native/toolkit` は、すべてのアプリが継承すべき再利用可能な面を持ちます:
+コラボレーション、共有、設定、ナビゲーション、整理、セットアップ、Agent UX、履歴、
+運用の可視性です。
+
+ユーザーが覚える共有方法、キー接続、Agent の共同編集表示、設定の場所、変更履歴の見方は
+ひとつであるべきです。
+
+## ツールキットの契約 {#toolkit-contract}
+
+次の条件に当てはまる動作は toolkit に移します。
+
+- **Workspace 全体** - すべてのアプリで同じ挙動が期待される。
+- **Agent から見える** - action、instructions、application state を通じて Agent も使う。
+- **Governed** - 権限、audit、secrets、org policy、billing、sharing rules が関係する。
+- **繰り返される** - 2 つ以上のアプリが似た UI やロジックを持つ。
+- **ドメイン固有ではない** - アプリはリソース名と action を渡し、操作パターンは汎用。
+
+ドメインモデルやアプリ固有の workflow に強く結びつくものは app-local に残します。
+
+## 再利用可能なキット {#reusable-kits}
+
+- **Settings kit** - account、workspace、AI models、LLM keys、connections、
+  secrets、usage、notifications、changelog、app preferences の標準 tabs。永続設定は
+  Settings に置き、Agent sidebar は文脈上の quick controls と deep links に絞ります。
+- **Collaboration kit** - リアルタイム編集、Yjs docs、presence、agent presence、live
+  cursors、remote selections、recent edit highlights、共有 undo/redo。詳しくは
+  [Real-Time Collaboration](/docs/real-time-collaboration)。
+- **Sharing kit** - private、workspace、org、public link、invites、roles、
+  expirations、agent-readable access をひとつの権限モデルで扱います。詳しくは
+  [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、共通 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}
+
+1. 永続設定を標準 Settings tabs に集約します。
+2. collaboration、presence、agent presence、undo/redo、real-time editing を共有
+   adapters の後ろに揃えます。
+3. navigation、commands、recents、favorites、folders、tags、archive、trash を共有
+   primitives に移します。
+4. 共有可能なすべての resource を同じ permissions と agent-readable access モデルに登録します。
+5. collaborative resource に activity、comments、review、restore、audit の一貫した体験を持たせます。
+6. notifications、approvals、run status、traces、evals、feedback を統一します。

package/docs/content/locales/ja-JP/sharing.mdx

@@ -93,9 +93,10 @@ description: "フレームワークに組み込まれた Google ドキュメン
 - **スライド** — デッキ
 - **デザイン** — デザインとアセット
 - **クリップ** — 画面録画 (Loom スタイル)
+- **Plan** — visual plans and PR recaps
 - **フォーム** — フォーム定義
 - **カレンダー** — イベントと予約リンク
-- **Analytics** — ダッシュボード (展開中 — 分析テンプレートの `AGENTS.md` を参照)
+- **Analytics** — 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) を参照)、配線の共有は短くなります。スキーマへの 2 つの追加:

package/docs/content/locales/ko-KR/agent-native-toolkit.mdx

@@ -0,0 +1,63 @@
+---
+title: "Agent-Native 툴킷"
+description: "협업, 설정, 공유, 탐색, presence, 기록, 설정 준비, Agent UX를 위한 재사용 가능한 키트."
+---
+
+# Agent-Native 툴킷
+
+Agent-Native 앱은 workspace 공통 기능을 매번 다시 만들면 안 됩니다. 앱은 도메인 모델,
+도메인 action, 제품별 화면을 소유합니다. Framework와 `@agent-native/toolkit`은 모든 앱이
+상속해야 하는 재사용 가능한 표면을 소유합니다: 협업, 공유, 설정, 탐색, 정리, 설정 준비,
+Agent UX, 기록, 운영 가시성입니다.
+
+사용자는 공유, 키 연결, Agent의 공동 편집, 설정 위치, 변경 내역을 앱마다 새로 배우지 않아야 합니다.
+
+## 툴킷 계약 {#toolkit-contract}
+
+다음에 해당하면 동작을 toolkit으로 옮깁니다.
+
+- **Workspace 전체** - 모든 앱에서 같은 방식으로 동작해야 합니다.
+- **Agent-visible** - Agent가 actions, instructions, application state를 통해 같은 기능을 써야 합니다.
+- **Governed** - 권한, audit, secrets, org policy, billing, sharing rules가 적용됩니다.
+- **Repeated** - 두 앱 이상이 비슷한 UI나 로직을 이미 만들었습니다.
+- **Not domain-specific** - 앱은 resource 이름과 action을 제공하지만 interaction pattern은 일반적입니다.
+
+도메인 모델이나 앱 고유 workflow에 깊게 묶인 동작은 app-local로 둡니다.
+
+## 재사용 가능한 키트 {#reusable-kits}
+
+- **Settings kit** - account, workspace, AI models, LLM keys, connections,
+  secrets, usage, notifications, changelog, app preferences의 표준 tabs입니다. 지속 설정은
+  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를 하나의 권한 모델로 다룹니다. 자세한 내용은
+  [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}
+
+1. 지속 설정을 표준 Settings tabs로 통합합니다.
+2. collaboration, presence, agent presence, undo/redo, real-time editing을 공유 adapters 뒤로 정규화합니다.
+3. navigation, commands, recents, favorites, folders, tags, archive, trash를 공유 primitives로 이동합니다.
+4. 모든 공유 가능한 resource를 같은 permissions와 agent-readable access 모델에 등록합니다.
+5. collaborative resource마다 activity, comments, review, restore, audit 경험을 일관되게 만듭니다.
+6. notifications, approvals, run status, traces, evals, feedback을 통합합니다.

package/docs/content/locales/ko-KR/sharing.mdx

@@ -93,9 +93,10 @@ Google 문서도구처럼 보이고 작동합니다. 동일한 공유 버튼,
 - **슬라이드** — 자료
 - **디자인** — 디자인 및 자산
 - **클립** — 화면 녹화(Loom 스타일)
+- **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/docs/content/locales/pt-BR/agent-native-toolkit.mdx

@@ -0,0 +1,77 @@
+---
+title: "Toolkit do Agent-Native"
+description: "Kits reutilizáveis para colaboração, configurações, compartilhamento, navegação, presença, histórico, setup e UX do agente."
+---
+
+# Toolkit do Agent-Native
+
+Apps Agent-Native não devem reconstruir a infraestrutura comum do workspace.
+Apps são donas dos modelos de domínio, ações de domínio e telas específicas do
+produto. O framework e `@agent-native/toolkit` são donos das superfícies
+reutilizáveis que toda app deve herdar: colaboração, compartilhamento,
+configurações, navegação, organização, setup, UX do agente, histórico e
+visibilidade operacional.
+
+O objetivo é que usuários aprendam uma única forma de compartilhar, conectar
+chaves, ver o agente editando junto, encontrar configurações e entender o que
+mudou.
+
+## Contrato do toolkit {#toolkit-contract}
+
+Mova comportamento para o toolkit quando ele for:
+
+- **Do workspace** - usuários esperam o mesmo comportamento em todas as apps.
+- **Visível ao agente** - o agente precisa da mesma capacidade por ações,
+  instruções ou estado da aplicação.
+- **Governado** - permissões, auditoria, secrets, política da org, cobrança ou
+  regras de compartilhamento se aplicam.
+- **Repetido** - duas apps já criaram UI ou lógica parecida.
+- **Não específico de domínio** - a app fornece nomes e ações de recursos, mas o
+  padrão de interação é genérico.
+
+Mantenha local quando o comportamento depender do modelo de domínio ou de um
+fluxo específico da app.
+
+## Kits reutilizáveis {#reusable-kits}
+
+- **Settings kit** - abas padrão para conta, workspace, modelos de AI, chaves
+  LLM, conexões, secrets, uso, notificações, changelog e preferências da app.
+  Configuração durável fica em Settings; a sidebar do agente mantém controles
+  contextuais e deep links.
+- **Collaboration kit** - edição em tempo real, documentos Yjs, presença,
+  presença do agente, cursores, seleções remotas, destaques de edição e
+  undo/redo compartilhado. Veja
+  [Real-Time Collaboration](/docs/real-time-collaboration).
+- **Sharing kit** - um modelo de privacidade e permissões para privado,
+  workspace, org, link público, convites, roles, expiração e acesso legível pelo
+  agente. Veja [Sharing & Privacy](/docs/sharing).
+- **Navigation and command kit** - app shell, navegação, breadcrumbs, app
+  switcher, command palette, recursos recentes, fixados e busca.
+- **Organization kit** - pastas, tags, favoritos, arquivo, lixeira, ownership,
+  membros e metadados comuns.
+- **Setup and connections kit** - chaves API, OAuth, conexões, prontidão de
+  modelos, secrets ausentes e onboarding declarativo. Veja
+  [Workspace Connections](/docs/workspace-connections).
+- **Agent UX kit** - sidebar, composer, contexto preparado, menções, voz,
+  aprovação humana, UI generativa, progresso e estado visível ao agente.
+- **History and recovery kit** - audit log, activity feed, version history,
+  checkpoints, undo, redo, restore e proof-of-done. Veja
+  [Audit Log](/docs/audit-log).
+- **Comments and review kit** - comentários ancorados, pins, menções, pedidos de
+  review, threads resolvidas e follow-ups do agente.
+- **Workflow and observability kit** - notificações, aprovações, background
+  runs, jobs recorrentes, traces, evals, feedback e timelines. Veja
+  [Observability](/docs/observability).
+
+## Ordem de implementação {#implementation-order}
+
+1. Consolidar configuração durável em abas padrão de Settings.
+2. Normalizar colaboração, presença, presença do agente, undo/redo e edição em
+   tempo real por adapters compartilhados.
+3. Mover navegação, comandos, recentes, favoritos, pastas, tags, arquivo e
+   lixeira para primitivas compartilhadas.
+4. Registrar todo recurso compartilhável no mesmo modelo de permissões e acesso
+   legível pelo agente.
+5. Dar a cada recurso colaborativo uma história consistente de atividade,
+   comentários, review, restore e auditoria.
+6. Unificar notificações, aprovações, status de runs, traces, evals e feedback.

package/docs/content/locales/pt-BR/sharing.mdx

@@ -93,9 +93,10 @@ Todo modelo que armazena trabalhos de autoria do usuário usa esse modelo. Concr
 - **Apresentações** — apresentações
 - **Design** — designs e recursos
 - **Clipes** — gravações de tela (estilo Loom)
+- **Plan** — visual plans and PR recaps
 - **Formulários** — definições de formulário
 - **Calendário** — links para eventos e reservas
-- **Analytics** — painéis (lançamento — veja o modelo de análise `AGENTS.md`)
+- **Analytics** — dashboards, saved analyses, and tokenized session replays
 - **Extensões** — miniaplicativos em sandbox (consulte [Extensions](/docs/extensions#sharing))
 
 Cada um deles usa o mesmo auxiliar de esquema `ownableColumns()`, a mesma ação `share-resource` e o mesmo `<ShareButton>` UI. Mude de um modelo para outro e a caixa de diálogo de compartilhamento parecerá idêntica.
@@ -136,15 +137,22 @@ Para listas, coloque um `<VisibilityBadge visibility={row.visibility} />` ao lad
 
 A estrutura monta automaticamente esses actions em cada modelo — o agente os chama como ferramentas e o UI os chama por meio de `useActionQuery` / `useActionMutation`:
 
-| Ação                      | O que faz                                                                                                                |
-| ------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
-| `share-resource`          | Conceda acesso a um usuário ou organização em uma função específica. `notify` opcional controla notificações por e-mail. |
-| `unshare-resource`        | Revogar o acesso de um usuário ou organização.                                                                           |
-| `list-resource-shares`    | Mostrar a visibilidade atual e todas as concessões explícitas.                                                           |
-| `set-resource-visibility` | Mude para `private`, `org` ou `public`.                                                                                  |
+| Ação                         | O que faz                                                                                                                |
+| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
+| `share-resource`             | Conceda acesso a um usuário ou organização em uma função específica. `notify` opcional controla notificações por e-mail. |
+| `unshare-resource`           | Revogar o acesso de um usuário ou organização.                                                                           |
+| `list-resource-shares`       | Mostrar a visibilidade atual e todas as concessões explícitas.                                                           |
+| `set-resource-visibility`    | Mude para `private`, `org` ou `public`.                                                                                  |
+| `create-agent-resource-link` | Mint a temporary read-only `agent_access` URL for a registered agent-readable resource.                                  |
 
 Diga ao agente "compartilhe este design com a equipe de marketing como editores" e ele chamará `share-resource` no mesmo endpoint que UI usa. O resultado aparece na caixa de diálogo de compartilhamento na próxima renderização.
 
+## 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`.
+
 ## Construindo-o em um novo modelo {#building}
 
 Se você estiver criando um modelo (consulte [Creating Templates](/docs/creating-templates)), o compartilhamento de conexão será curto. Duas adições ao seu esquema:

package/docs/content/locales/zh-CN/agent-native-toolkit.mdx

@@ -0,0 +1,61 @@
+---
+title: "Agent-Native 工具包"
+description: "用于协作、设置、共享、导航、在线状态、历史、配置和 Agent UX 的可复用套件。"
+---
+
+# Agent-Native 工具包
+
+Agent-Native 应用不应该重复搭建 workspace 的通用能力。应用负责自己的领域模型、领域
+actions 和产品视图。Framework 和 `@agent-native/toolkit` 负责每个应用都应该继承的可复用
+产品表面：协作、共享、设置、导航、组织、配置、Agent UX、历史和运营可见性。
+
+用户应该只学习一种共享方式、一种连接密钥的方式、一种看到 Agent 一起编辑的方式、一处设置入口，
+以及一种理解变更的方式。
+
+## 工具包契约 {#toolkit-contract}
+
+当行为符合以下条件时，应移动到 toolkit：
+
+- **Workspace 级别** - 用户期望所有应用都一样。
+- **Agent 可见** - Agent 需要通过 actions、instructions 或 application state 使用同一能力。
+- **受治理** - 权限、audit、secrets、组织策略、billing 或共享规则会参与。
+- **重复出现** - 两个应用已经构建了类似 UI 或逻辑。
+- **非领域专属** - 应用提供资源名称和 actions，但交互模式是通用的。
+
+如果行为绑定领域模型、专属 workflow 或应用自己的心智模型，就保持 app-local。
+
+## 可复用套件 {#reusable-kits}
+
+- **Settings kit** - account、workspace、AI models、LLM keys、connections、secrets、
+  usage、notifications、changelog 和 app preferences 的标准 tabs。持久配置放在 Settings；
+  Agent sidebar 只保留上下文 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。参见 [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}
+
+1. 将持久配置合并到标准 Settings tabs。
+2. 用共享 adapters 统一 collaboration、presence、agent presence、undo/redo 和 real-time editing。
+3. 将 navigation、commands、recents、favorites、folders、tags、archive 和 trash 移入共享 primitives。
+4. 让所有可共享 resource 注册到同一 permissions 和 agent-readable access 模型。
+5. 为每个 collaborative resource 提供一致的 activity、comments、review、restore 和 audit 体验。
+6. 统一 notifications、approvals、run status、traces、evals 和 feedback。

package/docs/content/locales/zh-CN/sharing.mdx

@@ -93,9 +93,10 @@ description: "Google Docs 风格的共享，内置于框架中。每个用户创
 - **幻灯片** — 幻灯片
 - **设计** — 设计和资产
 - **剪辑** — 屏幕录制（Loom 风格）
+- **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)），则共享接线会很短。您的架构中添加了两项内容：