@agent-native/core 0.102.2 → 0.103.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (206) hide show
  1. package/corpus/README.md +1 -1
  2. package/corpus/core/CHANGELOG.md +6 -0
  3. package/corpus/core/docs/content/local-file-mode.mdx +99 -489
  4. package/corpus/core/docs/content/locales/ar-SA/local-file-mode.mdx +35 -490
  5. package/corpus/core/docs/content/locales/ar-SA/template-content.mdx +10 -24
  6. package/corpus/core/docs/content/locales/de-DE/local-file-mode.mdx +37 -491
  7. package/corpus/core/docs/content/locales/de-DE/template-content.mdx +10 -24
  8. package/corpus/core/docs/content/locales/es-ES/local-file-mode.mdx +35 -493
  9. package/corpus/core/docs/content/locales/es-ES/template-content.mdx +10 -24
  10. package/corpus/core/docs/content/locales/fr-FR/local-file-mode.mdx +38 -491
  11. package/corpus/core/docs/content/locales/fr-FR/template-content.mdx +10 -24
  12. package/corpus/core/docs/content/locales/hi-IN/local-file-mode.mdx +33 -492
  13. package/corpus/core/docs/content/locales/hi-IN/template-content.mdx +10 -24
  14. package/corpus/core/docs/content/locales/ja-JP/local-file-mode.mdx +36 -492
  15. package/corpus/core/docs/content/locales/ja-JP/template-content.mdx +10 -24
  16. package/corpus/core/docs/content/locales/ko-KR/local-file-mode.mdx +35 -490
  17. package/corpus/core/docs/content/locales/ko-KR/template-content.mdx +10 -24
  18. package/corpus/core/docs/content/locales/pt-BR/local-file-mode.mdx +35 -493
  19. package/corpus/core/docs/content/locales/pt-BR/template-content.mdx +10 -24
  20. package/corpus/core/docs/content/locales/zh-CN/local-file-mode.mdx +31 -489
  21. package/corpus/core/docs/content/locales/zh-CN/template-content.mdx +9 -24
  22. package/corpus/core/docs/content/locales/zh-TW/local-file-mode.mdx +31 -489
  23. package/corpus/core/docs/content/locales/zh-TW/template-content.mdx +9 -24
  24. package/corpus/core/docs/content/template-content.mdx +26 -42
  25. package/corpus/core/package.json +1 -1
  26. package/corpus/core/src/cli/content-local.ts +86 -18
  27. package/corpus/core/src/cli/index.ts +2 -2
  28. package/corpus/core/src/cli/skills-content/content-skill.ts +36 -25
  29. package/corpus/core/src/cli/skills.ts +47 -13
  30. package/corpus/core/src/local-artifacts/index.ts +65 -0
  31. package/corpus/templates/assets/app/components/library/GenerationPresetsPanel.tsx +325 -0
  32. package/corpus/templates/assets/app/hooks/use-navigation-state.ts +12 -0
  33. package/corpus/templates/assets/app/i18n/zh-TW.ts +21 -0
  34. package/corpus/templates/assets/app/i18n-data.ts +215 -0
  35. package/corpus/templates/assets/app/routes/brand-kits.$id.tsx +19 -479
  36. package/corpus/templates/assets/app/routes/brand-kits.$id_.presets.$presetId.tsx +1 -1
  37. package/corpus/templates/assets/app/routes/brand-kits.$id_.settings.tsx +446 -0
  38. package/corpus/templates/clips/app/components/editor/editor-layout.tsx +12 -2
  39. package/corpus/templates/clips/app/components/player/settings-panel.tsx +30 -12
  40. package/corpus/templates/clips/app/components/player/video-player.tsx +5 -1
  41. package/corpus/templates/clips/app/components/recorder/microphone-visualizer.tsx +22 -3
  42. package/corpus/templates/clips/app/i18n/ar-SA.ts +3 -2
  43. package/corpus/templates/clips/app/i18n/de-DE.ts +4 -2
  44. package/corpus/templates/clips/app/i18n/en-US.ts +3 -2
  45. package/corpus/templates/clips/app/i18n/es-ES.ts +4 -2
  46. package/corpus/templates/clips/app/i18n/fr-FR.ts +3 -2
  47. package/corpus/templates/clips/app/i18n/hi-IN.ts +3 -2
  48. package/corpus/templates/clips/app/i18n/ja-JP.ts +4 -1
  49. package/corpus/templates/clips/app/i18n/ko-KR.ts +3 -2
  50. package/corpus/templates/clips/app/i18n/pt-BR.ts +4 -2
  51. package/corpus/templates/clips/app/i18n/zh-CN.ts +3 -2
  52. package/corpus/templates/clips/app/i18n/zh-TW.ts +3 -2
  53. package/corpus/templates/clips/app/routes/r.$recordingId.tsx +27 -1
  54. package/corpus/templates/clips/server/lib/share-password.ts +6 -3
  55. package/corpus/templates/content/.agents/skills/content/SKILL.md +26 -39
  56. package/corpus/templates/content/AGENTS.md +25 -30
  57. package/corpus/templates/content/actions/_builder-docs-client.ts +23 -0
  58. package/corpus/templates/content/actions/_content-database-source-adapters.ts +21 -3
  59. package/corpus/templates/content/actions/_content-files.ts +338 -0
  60. package/corpus/templates/content/actions/_content-space-access.ts +135 -0
  61. package/corpus/templates/content/actions/_content-spaces.ts +640 -0
  62. package/corpus/templates/content/actions/_database-source-utils.ts +90 -7
  63. package/corpus/templates/content/actions/_database-utils.ts +7 -1
  64. package/corpus/templates/content/actions/_local-file-documents.ts +0 -9
  65. package/corpus/templates/content/actions/_local-folder-source.ts +53 -0
  66. package/corpus/templates/content/actions/_property-utils.ts +9 -4
  67. package/corpus/templates/content/actions/add-database-item.ts +108 -65
  68. package/corpus/templates/content/actions/backfill-content-files.ts +22 -0
  69. package/corpus/templates/content/actions/connect-local-folder-source.ts +221 -0
  70. package/corpus/templates/content/actions/create-content-database.ts +129 -3
  71. package/corpus/templates/content/actions/create-document.ts +65 -55
  72. package/corpus/templates/content/actions/create-inline-content-database.ts +6 -1
  73. package/corpus/templates/content/actions/delete-content-database.ts +3 -0
  74. package/corpus/templates/content/actions/delete-document.ts +7 -11
  75. package/corpus/templates/content/actions/disconnect-local-folder-source.ts +175 -0
  76. package/corpus/templates/content/actions/duplicate-database-item.ts +10 -0
  77. package/corpus/templates/content/actions/duplicate-database-items.ts +13 -0
  78. package/corpus/templates/content/actions/edit-document.ts +2 -28
  79. package/corpus/templates/content/actions/ensure-content-spaces.ts +26 -0
  80. package/corpus/templates/content/actions/export-content-source.ts +47 -9
  81. package/corpus/templates/content/actions/get-document.ts +0 -14
  82. package/corpus/templates/content/actions/import-content-source.ts +43 -3
  83. package/corpus/templates/content/actions/list-content-spaces.ts +103 -0
  84. package/corpus/templates/content/actions/list-documents.ts +12 -9
  85. package/corpus/templates/content/actions/move-document.ts +3 -14
  86. package/corpus/templates/content/actions/pull-document.ts +0 -23
  87. package/corpus/templates/content/actions/remove-local-file-source.ts +50 -29
  88. package/corpus/templates/content/actions/resolve-local-folder-conflict.ts +442 -0
  89. package/corpus/templates/content/actions/reveal-local-source-file.ts +6 -17
  90. package/corpus/templates/content/actions/search-documents.ts +0 -34
  91. package/corpus/templates/content/actions/share-local-file-document.ts +25 -1
  92. package/corpus/templates/content/actions/submit-content-database-form.ts +12 -0
  93. package/corpus/templates/content/actions/sync-local-folder-source.ts +731 -0
  94. package/corpus/templates/content/actions/sync-manifest-local-folder-source.ts +123 -0
  95. package/corpus/templates/content/actions/update-content-database-view.ts +10 -1
  96. package/corpus/templates/content/actions/update-document.ts +0 -15
  97. package/corpus/templates/content/actions/view-screen.ts +2 -50
  98. package/corpus/templates/content/app/components/editor/SlashCommandMenu.tsx +76 -62
  99. package/corpus/templates/content/app/components/editor/database/DatabaseView.tsx +70 -22
  100. package/corpus/templates/content/app/components/editor/database/grouping.ts +2 -1
  101. package/corpus/templates/content/app/components/editor/database/settings.tsx +23 -20
  102. package/corpus/templates/content/app/components/editor/database/shared.tsx +2 -0
  103. package/corpus/templates/content/app/components/editor/database/sidebar.tsx +330 -0
  104. package/corpus/templates/content/app/components/editor/database/types.ts +1 -0
  105. package/corpus/templates/content/app/components/editor/database/view-config.ts +3 -1
  106. package/corpus/templates/content/app/components/layout/Layout.tsx +25 -1
  107. package/corpus/templates/content/app/components/sidebar/DocumentSidebar.tsx +209 -113
  108. package/corpus/templates/content/app/components/sidebar/select-content-space.ts +31 -0
  109. package/corpus/templates/content/app/hooks/use-content-database.ts +16 -0
  110. package/corpus/templates/content/app/hooks/use-content-spaces.ts +39 -0
  111. package/corpus/templates/content/app/i18n/zh-TW.ts +11 -0
  112. package/corpus/templates/content/app/i18n-data.ts +75 -0
  113. package/corpus/templates/content/app/routes/_app.local-files.tsx +174 -65
  114. package/corpus/templates/content/changelog/2026-07-16-content-callouts-can-now-be-reviewed-and-published-to-builder.md +6 -0
  115. package/corpus/templates/content/changelog/2026-07-16-heading-5-and-heading-6-are-available-from-the-editor-slash-.md +6 -0
  116. package/corpus/templates/content/changelog/2026-07-16-organize-every-workspace-through-a-customizable-files-databa.md +6 -0
  117. package/corpus/templates/content/parity/matrix.md +2 -1
  118. package/corpus/templates/content/parity/matrix.ts +37 -1
  119. package/corpus/templates/content/scripts/dev-database.mjs +7 -5
  120. package/corpus/templates/content/server/db/schema.ts +113 -40
  121. package/corpus/templates/content/server/lib/document-context.ts +15 -1
  122. package/corpus/templates/content/server/lib/notion-sync.ts +6 -0
  123. package/corpus/templates/content/server/plugins/db.ts +153 -0
  124. package/corpus/templates/content/shared/api.ts +17 -3
  125. package/corpus/templates/content/shared/builder-mdx.ts +163 -16
  126. package/corpus/templates/design/.agents/skills/design-templates/SKILL.md +59 -0
  127. package/corpus/templates/design/AGENTS.md +6 -1
  128. package/corpus/templates/design/actions/create-design-from-template.ts +19 -7
  129. package/corpus/templates/design/actions/list-design-templates.ts +69 -21
  130. package/corpus/templates/design/actions/navigate.ts +2 -2
  131. package/corpus/templates/design/actions/view-screen.ts +15 -2
  132. package/corpus/templates/design/agent-native.app-skill.json +5 -0
  133. package/corpus/templates/design/app/components/editor/PromptDialog.tsx +281 -56
  134. package/corpus/templates/design/app/components/templates/TemplatePreview.tsx +14 -2
  135. package/corpus/templates/design/app/hooks/use-navigation-state.ts +3 -2
  136. package/corpus/templates/design/app/i18n/zh-TW.ts +3 -3
  137. package/corpus/templates/design/app/i18n-data.ts +21 -2
  138. package/corpus/templates/design/app/i18n-template-feature.ts +218 -10
  139. package/corpus/templates/design/app/pages/Index.tsx +195 -24
  140. package/corpus/templates/design/app/pages/Templates.tsx +144 -55
  141. package/corpus/templates/design/app/pages/design-editor/generation-prompt-directives.ts +12 -1
  142. package/corpus/templates/design/changelog/2026-07-14-templates-now-appear-in-the-new-design-picker-with-previews-.md +6 -0
  143. package/corpus/templates/design/changelog/2026-07-15-templates-now-open-immediately-after-copying-even-while-the-.md +6 -0
  144. package/corpus/templates/design/server/plugins/agent-chat.ts +1 -1
  145. package/corpus/templates/mail/AGENTS.md +23 -18
  146. package/corpus/templates/mail/actions/bulk-archive.ts +32 -28
  147. package/corpus/templates/mail/actions/mark-read.ts +131 -20
  148. package/corpus/templates/mail/actions/mark-thread-read.ts +1 -1
  149. package/corpus/templates/mail/actions/move-email.ts +30 -24
  150. package/corpus/templates/mail/actions/send-email.ts +73 -68
  151. package/corpus/templates/mail/changelog/2026-07-15-unread-inbox-cleanup-now-completes-reliably.md +6 -0
  152. package/corpus/templates/mail/server/handlers/emails.ts +218 -209
  153. package/corpus/templates/mail/server/lib/bulk-mark-read.ts +30 -0
  154. package/corpus/templates/mail/server/lib/email-state.ts +198 -113
  155. package/corpus/templates/mail/server/lib/google-auth.ts +218 -25
  156. package/corpus/templates/mail/server/lib/jobs.ts +69 -74
  157. package/corpus/templates/mail/server/lib/local-email-store.ts +265 -0
  158. package/corpus/templates/mail/server/plugins/agent-chat.ts +6 -0
  159. package/dist/cli/content-local.d.ts +1 -0
  160. package/dist/cli/content-local.d.ts.map +1 -1
  161. package/dist/cli/content-local.js +75 -17
  162. package/dist/cli/content-local.js.map +1 -1
  163. package/dist/cli/index.js +2 -2
  164. package/dist/cli/index.js.map +1 -1
  165. package/dist/cli/skills-content/content-skill.d.ts +1 -1
  166. package/dist/cli/skills-content/content-skill.d.ts.map +1 -1
  167. package/dist/cli/skills-content/content-skill.js +36 -25
  168. package/dist/cli/skills-content/content-skill.js.map +1 -1
  169. package/dist/cli/skills.d.ts.map +1 -1
  170. package/dist/cli/skills.js +47 -14
  171. package/dist/cli/skills.js.map +1 -1
  172. package/dist/collab/awareness.d.ts +2 -2
  173. package/dist/collab/awareness.d.ts.map +1 -1
  174. package/dist/collab/struct-routes.d.ts +1 -1
  175. package/dist/local-artifacts/index.d.ts +10 -0
  176. package/dist/local-artifacts/index.d.ts.map +1 -1
  177. package/dist/local-artifacts/index.js +39 -0
  178. package/dist/local-artifacts/index.js.map +1 -1
  179. package/dist/notifications/routes.d.ts +1 -1
  180. package/dist/observability/routes.d.ts +5 -5
  181. package/dist/resources/handlers.d.ts +1 -1
  182. package/dist/secrets/routes.d.ts +9 -9
  183. package/docs/content/local-file-mode.mdx +99 -489
  184. package/docs/content/locales/ar-SA/local-file-mode.mdx +35 -490
  185. package/docs/content/locales/ar-SA/template-content.mdx +10 -24
  186. package/docs/content/locales/de-DE/local-file-mode.mdx +37 -491
  187. package/docs/content/locales/de-DE/template-content.mdx +10 -24
  188. package/docs/content/locales/es-ES/local-file-mode.mdx +35 -493
  189. package/docs/content/locales/es-ES/template-content.mdx +10 -24
  190. package/docs/content/locales/fr-FR/local-file-mode.mdx +38 -491
  191. package/docs/content/locales/fr-FR/template-content.mdx +10 -24
  192. package/docs/content/locales/hi-IN/local-file-mode.mdx +33 -492
  193. package/docs/content/locales/hi-IN/template-content.mdx +10 -24
  194. package/docs/content/locales/ja-JP/local-file-mode.mdx +36 -492
  195. package/docs/content/locales/ja-JP/template-content.mdx +10 -24
  196. package/docs/content/locales/ko-KR/local-file-mode.mdx +35 -490
  197. package/docs/content/locales/ko-KR/template-content.mdx +10 -24
  198. package/docs/content/locales/pt-BR/local-file-mode.mdx +35 -493
  199. package/docs/content/locales/pt-BR/template-content.mdx +10 -24
  200. package/docs/content/locales/zh-CN/local-file-mode.mdx +31 -489
  201. package/docs/content/locales/zh-CN/template-content.mdx +9 -24
  202. package/docs/content/locales/zh-TW/local-file-mode.mdx +31 -489
  203. package/docs/content/locales/zh-TW/template-content.mdx +9 -24
  204. package/docs/content/template-content.mdx +26 -42
  205. package/package.json +1 -1
  206. package/corpus/templates/assets/app/components/library/EditLibraryDialog.tsx +0 -126
@@ -1,525 +1,69 @@
1
1
  ---
2
- title: "ローカル ファイル モード"
3
- description: "ローカルの Markdown、MDX、およびその他のリポジトリ ファイルを信頼できるソースとして使用して、エージェント ネイティブ アプリを実行します。これには、カスタム コンポーネントを含む Obsidian スタイルの MDX ドキュメントが含まれます。"
2
+ title: "ローカルフォルダーソース"
3
+ description: "Markdown / MDX フォルダーを、データベースで管理される Content スペースへ接続します。"
4
4
  ---
5
5
 
6
- # ローカル ファイル モード
6
+ # ローカルフォルダーソース
7
7
 
8
- ローカル ファイル モードにより、エージェント ネイティブ アプリは通常の UI とアクション サーフェスをアタッチできます
9
- リポジトリまたはワークスペース内のファイルに直接。アプリは依然としてホストされているように感じます
10
- 製品ですが、そのリスト ビュー、エディタ、エージェント ツールはローカル ファイルの読み取りと書き込みを行います
11
- SQL がサポートするアプリ レコードの代わり。
8
+ Content のデータモデルは 1 つです。すべてのページは SQL に保存され、
9
+ **スペース**に属し、そのスペースのシステムデータベース **Files** の項目に
10
+ なります。ローカルフォルダーは Files に接続するソースであり、別のアプリ
11
+ モードではありません。`AGENT_NATIVE_MODE` 切り替えは廃止されました。
12
12
 
13
- 最初の実装はコンテンツ テンプレート内にあります。左側のサイドバーは
14
- ローカルの `.md` および `.mdx` ファイルから設定され、ページを選択すると標準ファイルが開きます
15
- コンテンツ エディター、および保存すると、選択したファイルに書き戻されます。同じファイルは
16
- Codex、Claude コード、Agent-Native サイドバー エージェント、または通常のエージェントでも編集できます
17
- 編集者。
13
+ ユーザーには個人スペース、アクセス可能な組織には組織スペースがあり、個人の
14
+ **Workspaces** カタログが表示対象を決めます。Files は通常の Content
15
+ データベースなので、プロパティ、フィルター、並べ替え、グループ、保存ビューを
16
+ サイドバー表示にも利用できます。
18
17
 
19
- コンテンツに関しては、これにより製品が MDX のオープンソース Obsidian のように感じられます:
20
- ドキュメントはファイルとして保存されますが、アプリにはビジュアル エディター、エージェント actions が追加されます。
21
- 共有可能なコピー、および豊富なインタラクティブな MDX コンポーネント。
18
+ ## フォルダーを接続する
22
19
 
23
- リポジトリ優先のワークフローが必要な場合は、ローカル ファイル モードを使用します。
20
+ ブラウザーまたは Agent Native Desktop でフォルダーを選び、既存スペースへ
21
+ 接続するか、専用の非公開スペースを作成します。SQL に保存されるのは不透明な
22
+ 接続 ID、相対パス、ハッシュ、ソースメタデータのみです。絶対パス、ブラウザー
23
+ ハンドル、ファイル本文は保存されません。
24
24
 
25
- - `docs/*.mdx` のドキュメント リポジトリ
26
- - `blog/*.mdx` のブログ
27
- - `resources/*.md` のポジショニング、メッセージング、チームメモなどのリソース
28
- - より豊富な MDX エディターを備えた個人用の Obsidian スタイルのナレッジ ベース
29
- - ローカルの React コードから生成されたインタラクティブなカスタム MDX ブロックを必要とするドキュメント
30
- - コーディング エージェントが簡単に検査してパッチを適用できるアプリ アーティファクト
25
+ ポリシーは `database_primary`、`source_primary`、
26
+ `reviewed_bidirectional` です。同期はファイルを通常の SQL ページとして
27
+ 実体化します。両側が同時に変わった場合は上書きせず、レビュー対象の変更を
28
+ 作成します。切断してもページとローカルファイルは残ります。
31
29
 
32
- ホストされたコラボレーション アプリのエクスペリエンスが必要な場合は、データベース モードを使用します。
33
- マルチユーザー共有、SQL による権限、コメント、バージョン履歴、および
34
- ローカル ファイル システムにアクセスしない運用ホスティング。
35
-
36
- ## メンタルモデル
37
-
38
- 2 つの信頼できる情報源モードがあります:
39
-
40
- | モード | 真実の源 | こんな人に最適 |
41
- | ------------------------ | --------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
42
- | データベースモード | SQL 行から Drizzle | ホストされているアプリ、コラボレーション、共有、コメント、バージョン履歴 |
43
- | ローカル ファイル モード | `agent-native.json` によって宣言されたリポジトリ ファイル | ローカル/開発ワークフロー、Git レビュー、コーディング エージェント編集、ファイルネイティブ コンテンツ |
44
-
45
- UI とエージェント actions は、両方のモードで同じ形状のままである必要があります。コンテンツ
46
- エディターは引き続きドキュメントを編集します。違いは、それらの文書が解決されるかどうかです
47
- SQL 行またはローカル ファイルへ。
48
-
49
- <Diagram id="doc-block-8zsefu" title={"同じ行動、2 つの真実の情報源"} summary={"UI とエージェントは、両方のモードで同じアクションを呼び出します。アクション層は、各呼び出しが SQL 行またはリポジトリ ファイルのどちらに解決されるかを決定します。"}>
50
-
51
- ```html
52
- <div class="diagram-mode">
53
- <div class="diagram-col entry">
54
- <div class="diagram-node">コンテンツUI</div>
55
- <div class="diagram-node">
56
- エージェント + actions<br /><small class="diagram-muted"
57
- >list/get/update-document</small
58
- >
59
- </div>
60
- </div>
61
- <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
62
- <div class="diagram-row resolve">
63
- <div class="diagram-panel" data-rough>
64
- <span class="diagram-pill accent">データベースモード</span
65
- ><small class="diagram-muted">SQL rows via Drizzle</small
66
- ><small class="diagram-muted">ホスト版 · 共有 · コメント · 履歴</small>
67
- </div>
68
- <div class="diagram-panel" data-rough>
69
- <span class="diagram-pill ok">Local File Mode</span
70
- ><small class="diagram-muted">repo files via agent-native.json</small
71
- ><small class="diagram-muted"
72
- >Gitレビュー · コーディングエージェント編集</small
73
- >
74
- </div>
75
- </div>
76
- </div>
77
- ```
78
-
79
- ```css
80
- .diagram-mode {
81
- display: flex;
82
- align-items: center;
83
- gap: 14px;
84
- flex-wrap: wrap;
85
- }
86
- .diagram-mode .diagram-col {
87
- display: flex;
88
- flex-direction: column;
89
- gap: 10px;
90
- }
91
- .diagram-mode .diagram-arrow {
92
- font-size: 22px;
93
- line-height: 1;
94
- }
95
- .diagram-mode .resolve {
96
- display: flex;
97
- gap: 12px;
98
- flex-wrap: wrap;
99
- }
100
- .diagram-mode .diagram-panel {
101
- display: flex;
102
- flex-direction: column;
103
- gap: 4px;
104
- padding: 12px 14px;
105
- }
106
- ```
107
-
108
- </Diagram>
109
-
110
- ## リポジトリの例
111
-
112
- コンテンツ ワークスペースは次のように小さくすることができます:
113
-
114
- <FileTree
115
- id="doc-block-13rjk6f"
116
- title={"Content workspace の repo"}
117
- entries={[
118
- {
119
- path: "agent-native.json",
120
- note: "どのフォルダがコンテンツルートで、その種類は何かを宣言",
121
- },
122
- {
123
- path: "docs/",
124
- note: "コンテンツルート: サイドバーにページとして表示",
125
- },
126
- {
127
- path: "docs/getting-started.mdx",
128
- },
129
- {
130
- path: "docs/guides/custom-components.mdx",
131
- },
132
- {
133
- path: "blog/",
134
- note: "コンテンツルート",
135
- },
136
- {
137
- path: "blog/launch-post.mdx",
138
- },
139
- {
140
- path: "resources/",
141
- note: "コンテンツルート",
142
- },
143
- {
144
- path: "resources/messaging/positioning.md",
145
- },
146
- {
147
- path: "components/",
148
- note: "コンテンツルートではない: MDX が import できる preview コンポーネントライブラリ",
149
- },
150
- {
151
- path: "components/FrameworkTabs.tsx",
152
- },
153
- {
154
- path: "components/Callout.tsx",
155
- },
156
- {
157
- path: "extensions/",
158
- note: "コンテンツルートではない: ローカル extension ライブラリ(sandboxed widgets)",
159
- },
160
- {
161
- path: "extensions/doc-status/extension.json",
162
- },
163
- {
164
- path: "extensions/doc-status/index.html",
165
- },
166
- ]}
167
- />
168
-
169
- ローカル ファイル モードでは、コンテンツ サイドバーに `docs/`、`blog/`、および
170
- `resources/` ツリーをページとして表示します。 `docs/getting-started.mdx` を選択すると、
171
- ファイル。 UI で編集すると
172
- `docs/getting-started.mdx`.
173
-
174
- `components/` はコンテンツ ルートではありません。 MDX
175
- ファイルはインポートまたは参照できます。エディターは単純なローカル MDX コンポーネントをレンダリングできます
176
- コンテンツ アプリ全体を複製したりフォークしたりする必要はありません。
177
-
178
- `extensions/` もコンテンツ ルートではありません。これはローカル拡張ライブラリです:
179
- ソースをアプリ スロットに保持したままアプリ スロットでレンダリングできる小さなサンドボックス ウィジェット
180
- リポジトリ。
181
-
182
- ## コンテンツをリポジトリにインストールする
183
-
184
- 既存のドキュメント、ブログ、または MDX ワークスペースの場合は、コンテンツ ローカル ファイルをインストールします
185
- スキル:
30
+ ## リポジトリから起動
186
31
 
187
32
  ```bash
188
- npx @agent-native/core@latest skills add content --mode local-files --scope project
33
+ npx @agent-native/core@latest content .
189
34
  ```
190
35
 
191
- これにより、`content` スキルがリポジトリのエージェント スキル フォルダにコピーされ、書き込まれます
192
- または、コンテンツのデフォルトで `agent-native.json` を更新します。
193
-
194
- - ワークスペース レベルの `mode: "local-files"`
195
- - `apps.content.mode: "local-files"`
196
- - `docs/`、`blog/`、`content/`、および `resources/` のコンテンツ ルート
197
- - ローカル MDX コンポーネントの `components/`
198
- - ローカル拡張ウィジェット用の `extensions/`
199
-
200
- インストールされたスキルは、コーディング エージェントにコンテンツ actions を使用するよう指示します
201
- (`list-documents`, `get-document`, `edit-document`, `update-document`,
202
- `share-local-file-document`、およびコンポーネント ファイル actions) (ローカル コンテンツ アプリの場合)
203
- または Agent Native デスクトップ ブリッジがそれらを公開します。橋が稼働していない場合、スキル
204
- フロントマター、インポート、JSX を保持しながら、安全な直接リポジトリ編集にフォールバックします。
205
- そして不明な MDX。
206
-
207
- ## 構成
36
+ 通常のデータベース版 Content が起動し、フォルダーをソースとして登録して接続
37
+ 画面を開きます。モード用環境変数は設定しません。
208
38
 
209
- `agent-native.json` をリポジトリまたはワークスペースのルートに追加します。
39
+ ## 設定
210
40
 
211
41
  ```json
212
42
  {
213
43
  "version": 1,
214
44
  "apps": {
215
45
  "content": {
216
- "mode": "local-files",
217
46
  "roots": [
218
47
  {
219
48
  "name": "Docs",
220
49
  "path": "docs",
221
50
  "kind": "docs",
222
- "extensions": [".md", ".mdx"]
223
- },
224
- {
225
- "name": "Blog",
226
- "path": "blog",
227
- "kind": "blog",
228
- "extensions": [".md", ".mdx"]
229
- },
230
- {
231
- "name": "Resources",
232
- "path": "resources",
233
- "kind": "resources",
234
- "extensions": [".md", ".mdx"]
51
+ "extensions": [".md", ".mdx"],
52
+ "source": {
53
+ "type": "local-folder",
54
+ "connectionId": "local-folder:<opaque-id>",
55
+ "truthPolicy": "source_primary"
56
+ }
235
57
  }
236
58
  ],
237
59
  "components": "components",
238
- "extensions": "extensions",
239
- "hide": ["**/_*.md", "**/_*.mdx"]
60
+ "extensions": "extensions"
240
61
  }
241
62
  }
242
63
  }
243
64
  ```
244
65
 
245
- `AGENT_NATIVE_MODE=local-files` または
246
- `AGENT_NATIVE_DATA_MODE=local-files`;マニフェストが優先されるのは、
247
- リポジトリ自体のフォルダー コントラクトを文書化します。
248
-
249
- ## コンテンツ ファイル形式
250
-
251
- コンテンツは Markdown および MDX を読み取ります。 Frontmatter はページのメタデータを保持し、本文は
252
- 編集可能なドキュメント:
253
-
254
- ```mdx
255
- ---
256
- title: "はじめに"
257
- icon: "sparkles"
258
- isFavorite: true
259
- updatedAt: "2026-06-12T20:00:00.000Z"
260
- ---
261
-
262
- # はじめに
263
-
264
- Use <FrameworkTabs value="react" /> to show framework-specific code.
265
- ```
266
-
267
- タイトルは、存在する場合は `title` フロントマターから取得され、それ以外の場合は、
268
- ファイル名。エディターは、まだ視覚的に編集できない MDX ソースを保持します。そのため
269
- コーディング エージェントと通常のテキスト エディタは安全な避難口のままです。
270
-
271
- ## カスタム MDX コンポーネント
272
-
273
- コンテンツは、構成された `components` フォルダーからローカル コンポーネントをプレビューできます。
274
- これは、タブ、コールアウト、パッケージなどのドキュメント スタイルの MDX コンポーネントを対象としています
275
- スニペット、またはフレームワーク固有のコード ブロックをインストールします。
276
-
277
- たとえば、コンテンツの隣にインタラクティブ コンポーネントを追加します。
278
-
279
- ```tsx
280
- // components/ImpactCounter.tsx
281
- import { useState } from "react";
282
-
283
- export function ImpactCounter({
284
- label = "points",
285
- accent = "blue",
286
- featured = false,
287
- }: {
288
- label?: string;
289
- accent?: "blue" | "green" | "purple";
290
- featured?: boolean;
291
- }) {
292
- const [count, setCount] = useState(3);
293
- const accentClass =
294
- accent === "green"
295
- ? "border-green-300 bg-green-50"
296
- : accent === "purple"
297
- ? "border-purple-300 bg-purple-50"
298
- : "border-blue-300 bg-blue-50";
299
-
300
- return (
301
- <div className={`rounded-md border p-4 ${accentClass}`}>
302
- <div className="text-sm text-muted-foreground">Launch impact</div>
303
- <div className="mt-1 text-3xl font-semibold">
304
- {count} {label}
305
- </div>
306
- {featured ? <div className="mt-1 text-sm">Featured metric</div> : null}
307
- <button
308
- type="button"
309
- className="mt-3 rounded border px-3 py-1 text-sm"
310
- onClick={() => setCount((value) => value + 1)}
311
- >
312
- Add point
313
- </button>
314
- </div>
315
- );
316
- }
317
-
318
- export const ImpactCounterInputs = {
319
- label: {
320
- type: "string",
321
- label: "Metric label",
322
- default: "points",
323
- },
324
- accent: {
325
- type: "select",
326
- label: "Accent",
327
- options: ["blue", "green", "purple"],
328
- default: "blue",
329
- },
330
- featured: {
331
- type: "boolean",
332
- label: "Featured",
333
- default: false,
334
- },
335
- };
336
- ```
337
-
338
- 次に、ローカルの MDX ファイルからそれを使用します。
339
-
340
- ```mdx
341
- ---
342
- title: "起動ノート"
343
- ---
344
-
345
- # 起動ノート
346
-
347
- <ImpactCounter label="wins" />
348
- ```
349
-
350
- Content dev サーバーは、PascalCase という名前のエクスポートと PascalCase のデフォルトを検出します
351
- は、`.tsx`、`.jsx`、`.ts`、および `.js` ファイルから `components/` の下にエクスポートします。それら
352
- コンポーネントはエディタ内でレンダリングされ、
353
- **ローカルコンポーネント**。スラッシュを挿入すると、
354
- `<ImpactCounter />`;必要に応じて、MDX ソースにプロパティを追加します。
355
-
356
- コンポーネントの実行は、意図的にローカル開発/デスクトップ ブリッジ機能ではなく、
357
- プレーン ホスト ブラウザー フォルダー アクセス。 `content.agent-native.com` を開くと、
358
- **ローカル ファイル** を選択し、Chrome でフォルダーを選択します。アプリが読み書きできる
359
- `.md` および `.mdx` ファイルは、ブラウザ ファイル システム アクセス API を介してアクセスされますが、
360
- Chrome は、Vite をコンパイルするための絶対フォルダー パスを公開しません
361
- `components/*.tsx`。カスタム React コンポーネントをプレビューしてホット リロードするには、
362
- コンテンツをローカルに保存するか、信頼できるローカル ブリッジができるように Agent Native デスクトップを使用します
363
- 選択したワークスペースをローカルのコンテンツ開発サーバーに登録します。そのモードでは、
364
- Vite を介して既存のコンポーネント ファイルを編集し、ホット リロードし、または追加します。
365
- コンポーネント ファイルを削除すると、コンポーネント レジストリとスラッシュ メニューが再ロードされます。
366
-
367
- エージェントは、登録されたコンポーネント ファイルを操作することもできます。使用
368
- `list-local-component-files` で登録されたワークスペース ID を検索し、
369
- `write-local-component-file` は、`.tsx`、`.jsx`、`.ts` を作成または更新します。
370
- ワークスペースの `components/` フォルダーにある `.js` ファイル。 MDX ファイルは
371
- コンポーネントの使用法に関する信頼できる情報源。コンポーネント ファイルは通常のリポジトリのままです
372
- Git でレビューされたソース ファイル。
373
-
374
- コンポーネントが入力メタデータをエクスポートする場合、エディターでコンポーネントを選択する
375
- は、コンポーネントの右上隅に編集ボタンを表示します。サポートされている入力タイプ
376
- は、`string`、`textarea`、`number`、`boolean`、および `select` です。フォームには
377
- は MDX タグに戻るため、ローカル ファイルが信頼できる情報源のままになります。
378
- メタデータは `ComponentNameInputs`、`ComponentNameConfig.inputs` としてエクスポートできます
379
- `Component.inputs`、または `agentNative.inputs`。
380
-
381
- リテラル props を含む単純なコンポーネント タグはインラインでプレビューできます。
382
-
383
- ```mdx
384
- <FrameworkTabs value="react" />
385
-
386
- <Callout tone="warning">
387
-
388
- This setting affects production deploys.
389
-
390
- </Callout>
391
- ```
392
-
393
- 複雑な JSX 式はソースに保存されます。編集者が安全に作業できない場合
394
- コンポーネント プロップをプレビューしても、警告のプレースホルダーが表示されません。
395
- サイレントにデータを削除します。
396
-
397
- ## ローカル ファイルの共有
398
-
399
- 他のユーザーはパスを読み取ることができないため、ローカル ファイルは直接共有されません
400
- あなたのマシン。コンテンツ ツールバーの [共有] ボタンは、
401
- 選択したファイルのデータベースにバックアップされたコピー。そのコピーに移動して、
402
- 通常の共有ポップオーバー。元のローカル ファイルはローカル ファイルの下に残ります。
403
- データベース コピーは、ローカル ファイル モードの共有コピーの下に表示され、
404
- 標準ドキュメント共有モデル。
405
-
406
- ## ローカル内線番号
407
-
408
- ローカル ファイル モードでは、設定されたファイルからリポジトリにバックアップされた拡張機能をロードすることもできます。
409
- `extensions` フォルダー。各拡張子は、`extension.json`
410
- マニフェストと HTML エントリ ファイル:
411
-
412
- ```text
413
- extensions/
414
- doc-status/
415
- extension.json
416
- index.html
417
- ```
418
-
419
- ```json
420
- {
421
- "id": "doc-status",
422
- "name": "Doc Status",
423
- "description": "Shows metadata for the selected Content file.",
424
- "entry": "index.html",
425
- "slots": ["content.sidebar.bottom"],
426
- "permissions": {
427
- "appActions": ["list-documents"],
428
- "extensionData": true
429
- }
430
- }
431
- ```
432
-
433
- `index.html` は、通常で使用されるのと同じ Alpine/Tailwind 拡張本体形式です
434
- データベースベースの拡張機能。コンテンツ アプリがローカル拡張機能を認識すると、
435
- `content.sidebar.bottom` を宣言すると、
436
- the Content sidebar. The host passes `window.slotContext` with the selected
437
- ドキュメント ID、タイトル、ソース メタデータ、コンテンツがローカル ファイル モードかどうか。
438
-
439
- ローカル拡張子はアプリによってプレビューされますが、ファイルとして編集されます。拡張機能
440
- リストにはローカル ファイル バッジが表示され、フルページ ビューアは に戻ります
441
- エントリファイル。 SQL でサポートされる拡張機能 actions (更新、削除、共有、
442
- 履歴は適用されません。エディタ、Codex、Claude コード、または Git 履歴を使用してください。
443
- ソースの変更。
444
-
445
- v1 の場合、ローカル拡張機能は意図的に保守的です:
446
-
447
- - 独自の小さな実行時状態に `extensionData` を使用できます
448
- - `extension.json` にリストされている `appAction` のみを呼び出すことができます
449
- - 生の SQL ヘルパーと外部 `extensionFetch` は無効になります
450
- - スロット ターゲットは `extension.json` で宣言されており、SQL を通じてインストールされていません
451
-
452
- これにより、ローカル ワークスペースに Obsidian のようなプラグイン サーフェスが提供されます。
453
- 任意のリポジトリ ファイルは、データベースベースの拡張機能のすべての機能を継承します。
454
-
455
- ## アプリでの使用方法
456
-
457
- ローカル ファイル モードは、フレームワークのローカル アーティファクト ヘルパーを通じて実装されます。
458
- アプリは、所有するアーティファクト タイプのルートを宣言し、読み取りと書き込みを行います
459
- UI とエージェントがすでに使用している同じアクション サーフェスを介して。
460
-
461
- コンテンツの場合、それは次のことを意味します:
462
-
463
- - `list-documents` には、構成された `.md` および `.mdx` ファイルがリストされます。
464
- - `get-document` は、選択されたローカル ファイルを読み取ります。
465
- - `update-document` は、選択されたローカル ファイルを書き込みます。
466
- - `create-document` は、選択したフォルダーに新しいローカル `.mdx` ファイルを作成します。
467
- - `delete-document` はローカル ファイルを削除します。
468
- - 検索は、設定されたローカル ファイル全体で実行されます。
469
-
470
- コンテンツ UI からのローカル ファイル ページの移動、名前変更、並べ替えはできません
471
- はまだサポートされています。これらの操作はワークスペースまたはコーディング エージェントを使用して実行します。
472
- コンテンツ サイドバーには、結果のファイル ツリーが反映されます。
473
-
474
- これにより、エージェント契約がシンプルになります。エージェントはコンテンツ actions を使用し続けることができます。
475
- これらの actions は、ターゲットが SQL ベースであるかファイルベースであるかを決定します。
476
-
477
- 他のアプリも時間の経過とともに同じパターンを採用する可能性があります。スライド アプリではマッピングが可能
478
- `slides/*.mdx` をデッキに、計画アプリは `plans/*` を計画ドキュメントにマッピングでき、
479
- ダッシュボード アプリでは、`dashboards/*.mdx` をダッシュボードにマッピングできます。アプリ固有のもの
480
- フォルダは、同じローカル アーティファクト コントラクトの上に階層化された規則です。
481
-
482
- ## ローカル ファイルとエクスポート/インポート
483
-
484
- コンテンツには 2 つの異なるファイル ワークフローがあります:
485
-
486
- | ワークフロー | 何が起こるか |
487
- | -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
488
- | `/local-files` エクスポート/インポート | データベース モードは依然として信頼できる情報源です。ファイルは、エクスポート、編集、プレビュー、インポートするための明示的な同期面です。 |
489
- | ローカル ファイル モード | ファイルは真実の情報源です。コンテンツ サイドバーとエディタはローカル ファイルで直接動作します。 |
490
-
491
- ホストされたワークスペースでファイルを時折確認したい場合は、エクスポート/インポートを使用します。
492
- リポジトリ自体がワークスペースである場合は、ローカル ファイル モードを使用します。
493
-
494
- ## 歴史とコラボレーション
495
-
496
- ローカル ファイル モードはファイルネイティブの履歴に基づいています:
497
-
498
- - 重要な変更を Git にコミットする
499
- - プル リクエストをレビューに使用する
500
- - コーディング エージェントが同じファイルを直接編集できるようにする
501
- - 通常のファイルの差分を使用して変更を理解する
502
-
503
- データベース モードは、引き続きホスト型コラボレーション機能に適しています。
504
- 共有、コメント、SQL によるバージョン履歴、ライブ マルチユーザー編集。
505
-
506
- プロバイダー同期は、どちらのモードの上にも重ねることができます。たとえば、ドキュメント リポジトリでは、
507
- CMS からローカル MDX ファイルにコンテンツをプルする actions を追加するか、選択したものをプッシュします
508
- ローカル ファイルを CMS に戻します。
509
-
510
- ## 生産の安全性
511
-
512
- ローカル ファイル モードでは、アプリ actions に構成されたワークスペースへの直接書き込みアクセスが許可されます
513
- ファイル。これは、ローカル開発および信頼できるシングルテナント ファイルに適しています
514
- ブリッジですが、これはデフォルトの実稼働セキュリティ モデルではありません。
515
-
516
- `NODE_ENV=production` の場合、フレームワークは、次の操作を行わない限り `local-files` モードを拒否します。
517
- セット:
518
-
519
- ```bash
520
- AGENT_NATIVE_ALLOW_LOCAL_FILES_IN_PRODUCTION=true
521
- ```
522
-
523
- 誰もが使用できる信頼できるシングルテナント展開に対してのみ設定してください
524
- アプリは構成されたファイルの読み取りと書き込みを許可されます。通常のホストの場合、
525
- マルチユーザー アプリでは、データベース モードと SQL による共有を使用します。
66
+ 移行時は `mode: "local-files"` と `AGENT_NATIVE_MODE=local-files`
67
+ 削除し、roots を残して `source` を追加します。frontmatter の ID は名前変更や
68
+ 移動でもページ識別を保ちます。ローカルコンポーネントと拡張機能は引き続き信頼
69
+ されたローカルブリッジ経由で読み込まれます。
@@ -93,9 +93,8 @@ description: "オープンソースの Obsidian for MDX: ローカルの Markdow
93
93
  - **ページをツリーに整理** — 無限にネストしたり、ドラッグして並べ替えたり、よく使うお気に入りのページを作成したりできます。
94
94
  - **タイトルやコンテンツ全体の全文検索を使用して、すべてを検索**します。
95
95
  - **Obsidian などのローカル Markdown/MDX ファイルを編集します。** `/local-files` ビューを使用します
96
- ワークスペースをファイルにエクスポートし、独自のツールで編集し、プレビューするには
97
- 変更を加えてインポートし直します。ローカル ファイル モードでは、コンテンツは
98
- 選択した `.md` または `.mdx` ファイル。
96
+ フォルダーを Files に接続し、独自のツールで編集して変更を同期し、
97
+ SQL アプリ内で競合をレビューできます。
99
98
  - **リッチでインタラクティブなカスタム ブロックを生成します。** ローカル React コンポーネントを登録します。
100
99
  それらを MDX として挿入し、エージェントにコンポーネント ファイルを作成または更新させます
101
100
  あなたのドキュメント。
@@ -138,32 +137,19 @@ description: "オープンソースの Obsidian for MDX: ローカルの Markdow
138
137
  コメント、権限、ライブコラボレーション。ローカル フォルダーは明示的です
139
138
  サーフェスを同期します。
140
139
 
141
- コンテンツは、ファイルがソースとなる **ローカル ファイル モード** でも実行できます。
142
- SQL 文書の代わりに真実。 `agent-native.json` をリポジトリに追加し、
143
- `mode: "local-files"`、`docs/`、`blog/` などのルートを構成します
144
- `content/`、および `resources/`。標準のコンテンツ エディタは、
145
- ローカルの `.md`/`.mdx` ファイルから左側のサイドバーを選択し、編集内容をファイルに書き込みます。
146
- 通常のドキュメント actions を通じて選択されたファイル。これをリポジトリファーストのドキュメントに使用します。
147
- ブログ、リソース ライブラリ、または MDX を利用した Obsidian スタイルの個人コンテンツ
148
- コンポーネント;ホスト型コラボレーションが必要な場合は、データベース モードに戻してください。
149
- SQL-backed sharing. See [Local File Mode](/docs/local-file-mode) for the
150
- スタンドアロン リポジトリのレイアウト、構成、カスタム MDX コンポーネント、ローカル
151
- `extensions/` ウィジェット、および本番環境の安全ガイド。
140
+ ローカルフォルダーも、すべてのページと同じ SQL モデルを使います。各ページは
141
+ スペースとその Files データベースに属し、フォルダーはそのソースアダプターです。
142
+ ポリシー、競合、MDX コンポーネント、旧モードからの移行については
143
+ [ローカルフォルダーソース](/docs/local-file-mode) を参照してください。
152
144
 
153
- コンテンツ ローカル ファイル スキルを既存のリポジトリにインストールするには:
145
+ 既存のリポジトリで Content を開くには:
154
146
 
155
147
  ```bash
156
- npx @agent-native/core@latest skills add content --mode local-files --scope project
148
+ npx @agent-native/core@latest content .
157
149
  ```
158
150
 
159
- インストーラーはコーディング エージェントの `content` スキルをコピーし、または
160
- `docs/`、`blog/`、`content/` のコンテンツ ルートで `agent-native.json` を更新します
161
- と `resources/`。ローカル コンテンツ アプリ、Agent Native デスクトップ、または信頼できる場合
162
- ローカル ブリッジが実行中です。エージェントはコンテンツ actions を使用する必要があります。
163
- `list-documents`、`get-document`、`edit-document`、`update-document`、
164
- 生のファイルシステム書き込みの代わりに `share-local-file-document`。そのローカルがなければ
165
- ブリッジ、インストールされたスキルは引き続きエージェントにリポジトリ編集契約を与えます
166
- 安全な Markdown/MDX 編集。
151
+ CLI は通常のデータベース版 Content を起動し、フォルダーソースを登録して、
152
+ モード環境変数を設定せずに接続画面を開きます。
167
153
 
168
154
  ## 開発者向け
169
155