@agent-native/core 0.102.1 → 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 (295) hide show
  1. package/corpus/README.md +2 -2
  2. package/corpus/core/CHANGELOG.md +15 -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/client/AgentPanel.tsx +7 -0
  31. package/corpus/core/src/client/AssistantChat.tsx +7 -0
  32. package/corpus/core/src/client/agent-chat-adapter.ts +7 -1
  33. package/corpus/core/src/client/chat/message-components.tsx +17 -3
  34. package/corpus/core/src/client/composer/ComposerPlusMenu.tsx +96 -6
  35. package/corpus/core/src/client/composer/asset-picker-url.ts +80 -0
  36. package/corpus/core/src/client/error-format.ts +24 -0
  37. package/corpus/core/src/client/resources/McpIntegrationDialog.tsx +8 -1
  38. package/corpus/core/src/local-artifacts/index.ts +65 -0
  39. package/corpus/templates/assets/app/components/library/GenerationPresetsPanel.tsx +325 -0
  40. package/corpus/templates/assets/app/hooks/use-navigation-state.ts +12 -0
  41. package/corpus/templates/assets/app/i18n/zh-TW.ts +21 -0
  42. package/corpus/templates/assets/app/i18n-data.ts +215 -0
  43. package/corpus/templates/assets/app/routes/brand-kits.$id.tsx +19 -479
  44. package/corpus/templates/assets/app/routes/brand-kits.$id_.presets.$presetId.tsx +1 -1
  45. package/corpus/templates/assets/app/routes/brand-kits.$id_.settings.tsx +446 -0
  46. package/corpus/templates/assets/app/routes/library.tsx +69 -0
  47. package/corpus/templates/assets/changelog/2026-07-15-fixed-top-level-image-picker-selections-returning-to-the-com.md +6 -0
  48. package/corpus/templates/clips/actions/disconnect-calendar.ts +57 -9
  49. package/corpus/templates/clips/actions/generate-workflow.ts +102 -59
  50. package/corpus/templates/clips/actions/get-recording-player-data.ts +64 -1
  51. package/corpus/templates/clips/actions/regenerate-summary.ts +7 -0
  52. package/corpus/templates/clips/actions/regenerate-title.ts +29 -11
  53. package/corpus/templates/clips/app/components/editor/editor-layout.tsx +34 -13
  54. package/corpus/templates/clips/app/components/editor/thumbnail-picker.tsx +87 -9
  55. package/corpus/templates/clips/app/components/editor/trim-handles.tsx +15 -0
  56. package/corpus/templates/clips/app/components/editor/waveform.tsx +21 -8
  57. package/corpus/templates/clips/app/components/library/folder-tree.tsx +52 -0
  58. package/corpus/templates/clips/app/components/player/settings-panel.tsx +116 -58
  59. package/corpus/templates/clips/app/components/player/share-dialog.tsx +43 -37
  60. package/corpus/templates/clips/app/components/player/video-player.tsx +50 -2
  61. package/corpus/templates/clips/app/components/recorder/microphone-visualizer.tsx +22 -3
  62. package/corpus/templates/clips/app/i18n/ar-SA.ts +5 -2
  63. package/corpus/templates/clips/app/i18n/de-DE.ts +6 -2
  64. package/corpus/templates/clips/app/i18n/en-US.ts +5 -2
  65. package/corpus/templates/clips/app/i18n/es-ES.ts +6 -2
  66. package/corpus/templates/clips/app/i18n/fr-FR.ts +5 -2
  67. package/corpus/templates/clips/app/i18n/hi-IN.ts +5 -2
  68. package/corpus/templates/clips/app/i18n/ja-JP.ts +6 -1
  69. package/corpus/templates/clips/app/i18n/ko-KR.ts +5 -2
  70. package/corpus/templates/clips/app/i18n/pt-BR.ts +6 -2
  71. package/corpus/templates/clips/app/i18n/zh-CN.ts +5 -2
  72. package/corpus/templates/clips/app/i18n/zh-TW.ts +5 -2
  73. package/corpus/templates/clips/app/lib/timestamp-mapping.ts +14 -0
  74. package/corpus/templates/clips/app/routes/_app.library._index.tsx +1 -2
  75. package/corpus/templates/clips/app/routes/_index.tsx +1 -2
  76. package/corpus/templates/clips/app/routes/r.$recordingId.tsx +98 -32
  77. package/corpus/templates/clips/app/routes/share.$shareId.tsx +4 -1
  78. package/corpus/templates/clips/changelog/2026-07-15-ai-workflow-generation-now-stays-visible-avoids-duplicate-re.md +6 -0
  79. package/corpus/templates/clips/changelog/2026-07-15-clip-playback-and-cta-controls-remain-interactive-through-ed.md +6 -0
  80. package/corpus/templates/clips/changelog/2026-07-15-clip-titles-no-longer-describe-the-product-as-a-loom-alterna.md +6 -0
  81. package/corpus/templates/clips/changelog/2026-07-15-description-regeneration-now-opens-the-agent-chat-so-progres.md +6 -0
  82. package/corpus/templates/clips/changelog/2026-07-15-direct-recording-urls-now-respect-share-link-and-password-ac.md +6 -0
  83. package/corpus/templates/clips/changelog/2026-07-15-disconnecting-a-calendar-now-clears-unrecorded-synced-meetin.md +6 -0
  84. package/corpus/templates/clips/changelog/2026-07-15-folders-now-expose-rename-and-delete-actions-directly-in-the.md +6 -0
  85. package/corpus/templates/clips/changelog/2026-07-15-recording-pages-now-explain-sign-in-access-and-avoid-showing.md +6 -0
  86. package/corpus/templates/clips/changelog/2026-07-15-the-clips-extension-quick-actions-toolbar-can-be-moved-out-o.md +6 -0
  87. package/corpus/templates/clips/changelog/2026-07-15-the-editor-now-skips-cut-sections-during-preview-and-keeps-t.md +6 -0
  88. package/corpus/templates/clips/changelog/2026-07-15-thumbnail-capture-now-updates-previews-while-scrubbing-and-l.md +6 -0
  89. package/corpus/templates/clips/changelog/2026-07-15-windows-permission-links-open-the-matching-settings-page.md +6 -0
  90. package/corpus/templates/clips/chrome-extension/src/content-script.ts +117 -2
  91. package/corpus/templates/clips/chrome-extension/src/overlay.ts +27 -0
  92. package/corpus/templates/clips/desktop/src-tauri/tauri.conf.json +1 -1
  93. package/corpus/templates/clips/server/lib/calendar-event-meetings.ts +139 -101
  94. package/corpus/templates/clips/server/lib/recording-page-access.ts +35 -0
  95. package/corpus/templates/clips/server/lib/share-password.ts +6 -3
  96. package/corpus/templates/content/.agents/skills/content/SKILL.md +26 -39
  97. package/corpus/templates/content/AGENTS.md +25 -30
  98. package/corpus/templates/content/actions/_builder-docs-client.ts +23 -0
  99. package/corpus/templates/content/actions/_content-database-source-adapters.ts +21 -3
  100. package/corpus/templates/content/actions/_content-files.ts +338 -0
  101. package/corpus/templates/content/actions/_content-space-access.ts +135 -0
  102. package/corpus/templates/content/actions/_content-spaces.ts +640 -0
  103. package/corpus/templates/content/actions/_database-source-utils.ts +90 -7
  104. package/corpus/templates/content/actions/_database-utils.ts +7 -1
  105. package/corpus/templates/content/actions/_local-file-documents.ts +0 -9
  106. package/corpus/templates/content/actions/_local-folder-source.ts +53 -0
  107. package/corpus/templates/content/actions/_property-utils.ts +9 -4
  108. package/corpus/templates/content/actions/add-database-item.ts +108 -65
  109. package/corpus/templates/content/actions/backfill-content-files.ts +22 -0
  110. package/corpus/templates/content/actions/connect-local-folder-source.ts +221 -0
  111. package/corpus/templates/content/actions/create-content-database.ts +129 -3
  112. package/corpus/templates/content/actions/create-document.ts +65 -55
  113. package/corpus/templates/content/actions/create-inline-content-database.ts +6 -1
  114. package/corpus/templates/content/actions/delete-content-database.ts +3 -0
  115. package/corpus/templates/content/actions/delete-document.ts +7 -11
  116. package/corpus/templates/content/actions/disconnect-local-folder-source.ts +175 -0
  117. package/corpus/templates/content/actions/duplicate-database-item.ts +10 -0
  118. package/corpus/templates/content/actions/duplicate-database-items.ts +13 -0
  119. package/corpus/templates/content/actions/edit-document.ts +2 -28
  120. package/corpus/templates/content/actions/ensure-content-spaces.ts +26 -0
  121. package/corpus/templates/content/actions/export-content-source.ts +47 -9
  122. package/corpus/templates/content/actions/get-document.ts +0 -14
  123. package/corpus/templates/content/actions/import-content-source.ts +43 -3
  124. package/corpus/templates/content/actions/list-content-spaces.ts +103 -0
  125. package/corpus/templates/content/actions/list-documents.ts +12 -9
  126. package/corpus/templates/content/actions/move-document.ts +3 -14
  127. package/corpus/templates/content/actions/pull-document.ts +0 -23
  128. package/corpus/templates/content/actions/remove-local-file-source.ts +50 -29
  129. package/corpus/templates/content/actions/resolve-local-folder-conflict.ts +442 -0
  130. package/corpus/templates/content/actions/reveal-local-source-file.ts +6 -17
  131. package/corpus/templates/content/actions/search-documents.ts +0 -34
  132. package/corpus/templates/content/actions/share-local-file-document.ts +25 -1
  133. package/corpus/templates/content/actions/submit-content-database-form.ts +12 -0
  134. package/corpus/templates/content/actions/sync-local-folder-source.ts +731 -0
  135. package/corpus/templates/content/actions/sync-manifest-local-folder-source.ts +123 -0
  136. package/corpus/templates/content/actions/update-content-database-view.ts +10 -1
  137. package/corpus/templates/content/actions/update-document.ts +0 -15
  138. package/corpus/templates/content/actions/view-screen.ts +2 -50
  139. package/corpus/templates/content/app/components/editor/SlashCommandMenu.tsx +76 -62
  140. package/corpus/templates/content/app/components/editor/database/DatabaseView.tsx +70 -22
  141. package/corpus/templates/content/app/components/editor/database/grouping.ts +2 -1
  142. package/corpus/templates/content/app/components/editor/database/settings.tsx +23 -20
  143. package/corpus/templates/content/app/components/editor/database/shared.tsx +2 -0
  144. package/corpus/templates/content/app/components/editor/database/sidebar.tsx +330 -0
  145. package/corpus/templates/content/app/components/editor/database/types.ts +1 -0
  146. package/corpus/templates/content/app/components/editor/database/view-config.ts +3 -1
  147. package/corpus/templates/content/app/components/layout/Layout.tsx +25 -1
  148. package/corpus/templates/content/app/components/sidebar/DocumentSidebar.tsx +209 -113
  149. package/corpus/templates/content/app/components/sidebar/select-content-space.ts +31 -0
  150. package/corpus/templates/content/app/hooks/use-content-database.ts +16 -0
  151. package/corpus/templates/content/app/hooks/use-content-spaces.ts +39 -0
  152. package/corpus/templates/content/app/i18n/zh-TW.ts +11 -0
  153. package/corpus/templates/content/app/i18n-data.ts +75 -0
  154. package/corpus/templates/content/app/routes/_app.local-files.tsx +174 -65
  155. package/corpus/templates/content/changelog/2026-07-16-content-callouts-can-now-be-reviewed-and-published-to-builder.md +6 -0
  156. package/corpus/templates/content/changelog/2026-07-16-heading-5-and-heading-6-are-available-from-the-editor-slash-.md +6 -0
  157. package/corpus/templates/content/changelog/2026-07-16-organize-every-workspace-through-a-customizable-files-databa.md +6 -0
  158. package/corpus/templates/content/parity/matrix.md +2 -1
  159. package/corpus/templates/content/parity/matrix.ts +37 -1
  160. package/corpus/templates/content/scripts/dev-database.mjs +7 -5
  161. package/corpus/templates/content/server/db/schema.ts +113 -40
  162. package/corpus/templates/content/server/lib/document-context.ts +15 -1
  163. package/corpus/templates/content/server/lib/notion-sync.ts +6 -0
  164. package/corpus/templates/content/server/plugins/db.ts +153 -0
  165. package/corpus/templates/content/shared/api.ts +17 -3
  166. package/corpus/templates/content/shared/builder-mdx.ts +163 -16
  167. package/corpus/templates/design/.agents/skills/design-templates/SKILL.md +59 -0
  168. package/corpus/templates/design/AGENTS.md +6 -1
  169. package/corpus/templates/design/actions/create-design-from-template.ts +19 -7
  170. package/corpus/templates/design/actions/list-design-templates.ts +69 -21
  171. package/corpus/templates/design/actions/navigate.ts +2 -2
  172. package/corpus/templates/design/actions/view-screen.ts +15 -2
  173. package/corpus/templates/design/agent-native.app-skill.json +5 -0
  174. package/corpus/templates/design/app/components/design/design-canvas/external-preview.ts +7 -3
  175. package/corpus/templates/design/app/components/editor/PromptDialog.tsx +281 -56
  176. package/corpus/templates/design/app/components/templates/TemplatePreview.tsx +14 -2
  177. package/corpus/templates/design/app/hooks/use-navigation-state.ts +3 -2
  178. package/corpus/templates/design/app/i18n/zh-TW.ts +3 -3
  179. package/corpus/templates/design/app/i18n-data.ts +21 -2
  180. package/corpus/templates/design/app/i18n-template-feature.ts +218 -10
  181. package/corpus/templates/design/app/pages/Index.tsx +195 -24
  182. package/corpus/templates/design/app/pages/Templates.tsx +144 -55
  183. package/corpus/templates/design/app/pages/design-editor/generation-prompt-directives.ts +12 -1
  184. package/corpus/templates/design/changelog/2026-07-14-templates-now-appear-in-the-new-design-picker-with-previews-.md +6 -0
  185. package/corpus/templates/design/changelog/2026-07-15-prototype-print-and-download-buttons-now-work-in-preview.md +6 -0
  186. package/corpus/templates/design/changelog/2026-07-15-templates-now-open-immediately-after-copying-even-while-the-.md +6 -0
  187. package/corpus/templates/design/server/plugins/agent-chat.ts +1 -1
  188. package/corpus/templates/mail/AGENTS.md +23 -18
  189. package/corpus/templates/mail/actions/bulk-archive.ts +32 -28
  190. package/corpus/templates/mail/actions/mark-read.ts +131 -20
  191. package/corpus/templates/mail/actions/mark-thread-read.ts +1 -1
  192. package/corpus/templates/mail/actions/move-email.ts +30 -24
  193. package/corpus/templates/mail/actions/send-email.ts +73 -68
  194. package/corpus/templates/mail/changelog/2026-07-15-unread-inbox-cleanup-now-completes-reliably.md +6 -0
  195. package/corpus/templates/mail/server/handlers/emails.ts +218 -209
  196. package/corpus/templates/mail/server/lib/bulk-mark-read.ts +30 -0
  197. package/corpus/templates/mail/server/lib/email-state.ts +198 -113
  198. package/corpus/templates/mail/server/lib/google-auth.ts +218 -25
  199. package/corpus/templates/mail/server/lib/jobs.ts +69 -74
  200. package/corpus/templates/mail/server/lib/local-email-store.ts +265 -0
  201. package/corpus/templates/mail/server/plugins/agent-chat.ts +6 -0
  202. package/corpus/templates/slides/actions/extract-pdf.ts +1 -1
  203. package/corpus/templates/slides/actions/import-file.ts +4 -1
  204. package/corpus/templates/slides/app/components/editor/ImageGenPanel.tsx +1 -1
  205. package/corpus/templates/slides/app/components/editor/ImageSearchPanel.tsx +9 -12
  206. package/corpus/templates/slides/app/components/editor/SlideEditor.tsx +29 -21
  207. package/corpus/templates/slides/app/i18n/ar-SA.ts +1 -0
  208. package/corpus/templates/slides/app/i18n/de-DE.ts +1 -0
  209. package/corpus/templates/slides/app/i18n/en-US.ts +1 -0
  210. package/corpus/templates/slides/app/i18n/es-ES.ts +1 -0
  211. package/corpus/templates/slides/app/i18n/fr-FR.ts +1 -0
  212. package/corpus/templates/slides/app/i18n/hi-IN.ts +1 -0
  213. package/corpus/templates/slides/app/i18n/ja-JP.ts +1 -0
  214. package/corpus/templates/slides/app/i18n/ko-KR.ts +1 -0
  215. package/corpus/templates/slides/app/i18n/pt-BR.ts +1 -0
  216. package/corpus/templates/slides/app/i18n/zh-CN.ts +1 -0
  217. package/corpus/templates/slides/app/i18n/zh-TW.ts +1 -0
  218. package/corpus/templates/slides/changelog/2026-07-15-image-search-and-generation-controls-now-use-the-registered-.md +6 -0
  219. package/corpus/templates/slides/changelog/2026-07-15-pdf-deck-references-can-be-imported-for-slide-inspiration-ag.md +6 -0
  220. package/corpus/templates/slides/changelog/2026-07-15-stable-style-inspector-dock.md +6 -0
  221. package/dist/cli/content-local.d.ts +1 -0
  222. package/dist/cli/content-local.d.ts.map +1 -1
  223. package/dist/cli/content-local.js +75 -17
  224. package/dist/cli/content-local.js.map +1 -1
  225. package/dist/cli/index.js +2 -2
  226. package/dist/cli/index.js.map +1 -1
  227. package/dist/cli/skills-content/content-skill.d.ts +1 -1
  228. package/dist/cli/skills-content/content-skill.d.ts.map +1 -1
  229. package/dist/cli/skills-content/content-skill.js +36 -25
  230. package/dist/cli/skills-content/content-skill.js.map +1 -1
  231. package/dist/cli/skills.d.ts.map +1 -1
  232. package/dist/cli/skills.js +47 -14
  233. package/dist/cli/skills.js.map +1 -1
  234. package/dist/client/AgentPanel.d.ts.map +1 -1
  235. package/dist/client/AgentPanel.js +5 -0
  236. package/dist/client/AgentPanel.js.map +1 -1
  237. package/dist/client/AssistantChat.d.ts.map +1 -1
  238. package/dist/client/AssistantChat.js +7 -0
  239. package/dist/client/AssistantChat.js.map +1 -1
  240. package/dist/client/agent-chat-adapter.d.ts.map +1 -1
  241. package/dist/client/agent-chat-adapter.js +8 -1
  242. package/dist/client/agent-chat-adapter.js.map +1 -1
  243. package/dist/client/chat/message-components.d.ts +4 -0
  244. package/dist/client/chat/message-components.d.ts.map +1 -1
  245. package/dist/client/chat/message-components.js +10 -3
  246. package/dist/client/chat/message-components.js.map +1 -1
  247. package/dist/client/composer/ComposerPlusMenu.d.ts.map +1 -1
  248. package/dist/client/composer/ComposerPlusMenu.js +58 -6
  249. package/dist/client/composer/ComposerPlusMenu.js.map +1 -1
  250. package/dist/client/composer/asset-picker-url.d.ts +16 -0
  251. package/dist/client/composer/asset-picker-url.d.ts.map +1 -0
  252. package/dist/client/composer/asset-picker-url.js +64 -0
  253. package/dist/client/composer/asset-picker-url.js.map +1 -0
  254. package/dist/client/error-format.d.ts.map +1 -1
  255. package/dist/client/error-format.js +17 -0
  256. package/dist/client/error-format.js.map +1 -1
  257. package/dist/client/resources/McpIntegrationDialog.d.ts.map +1 -1
  258. package/dist/client/resources/McpIntegrationDialog.js +6 -1
  259. package/dist/client/resources/McpIntegrationDialog.js.map +1 -1
  260. package/dist/collab/awareness.d.ts +2 -2
  261. package/dist/collab/awareness.d.ts.map +1 -1
  262. package/dist/collab/struct-routes.d.ts +1 -1
  263. package/dist/local-artifacts/index.d.ts +10 -0
  264. package/dist/local-artifacts/index.d.ts.map +1 -1
  265. package/dist/local-artifacts/index.js +39 -0
  266. package/dist/local-artifacts/index.js.map +1 -1
  267. package/dist/notifications/routes.d.ts +1 -1
  268. package/dist/provider-api/corpus-jobs.d.ts +2 -2
  269. package/dist/resources/handlers.d.ts +3 -3
  270. package/dist/server/agent-engine-api-key-route.d.ts +1 -1
  271. package/dist/server/transcribe-voice.d.ts +1 -1
  272. package/docs/content/local-file-mode.mdx +99 -489
  273. package/docs/content/locales/ar-SA/local-file-mode.mdx +35 -490
  274. package/docs/content/locales/ar-SA/template-content.mdx +10 -24
  275. package/docs/content/locales/de-DE/local-file-mode.mdx +37 -491
  276. package/docs/content/locales/de-DE/template-content.mdx +10 -24
  277. package/docs/content/locales/es-ES/local-file-mode.mdx +35 -493
  278. package/docs/content/locales/es-ES/template-content.mdx +10 -24
  279. package/docs/content/locales/fr-FR/local-file-mode.mdx +38 -491
  280. package/docs/content/locales/fr-FR/template-content.mdx +10 -24
  281. package/docs/content/locales/hi-IN/local-file-mode.mdx +33 -492
  282. package/docs/content/locales/hi-IN/template-content.mdx +10 -24
  283. package/docs/content/locales/ja-JP/local-file-mode.mdx +36 -492
  284. package/docs/content/locales/ja-JP/template-content.mdx +10 -24
  285. package/docs/content/locales/ko-KR/local-file-mode.mdx +35 -490
  286. package/docs/content/locales/ko-KR/template-content.mdx +10 -24
  287. package/docs/content/locales/pt-BR/local-file-mode.mdx +35 -493
  288. package/docs/content/locales/pt-BR/template-content.mdx +10 -24
  289. package/docs/content/locales/zh-CN/local-file-mode.mdx +31 -489
  290. package/docs/content/locales/zh-CN/template-content.mdx +9 -24
  291. package/docs/content/locales/zh-TW/local-file-mode.mdx +31 -489
  292. package/docs/content/locales/zh-TW/template-content.mdx +9 -24
  293. package/docs/content/template-content.mdx +26 -42
  294. package/package.json +1 -1
  295. package/corpus/templates/assets/app/components/library/EditLibraryDialog.tsx +0 -126
@@ -1,525 +1,66 @@
1
1
  ---
2
- title: "स्थानीय फ़ाइल मोड"
3
- description: "सच्चाई के स्रोत के रूप में स्थानीय Markdown, MDX और अन्य रेपो फ़ाइलों के साथ एजेंट-मूल ऐप्स चलाएं - जिसमें कस्टम घटकों के साथ ओब्सीडियन-शैली MDX दस्तावेज़ शामिल हैं।"
2
+ title: "लोकल फ़ोल्डर स्रोत"
3
+ description: "Markdown और MDX फ़ोल्डर को डेटाबेस-समर्थित Content स्पेस से जोड़ें।"
4
4
  ---
5
5
 
6
- # स्थानीय फ़ाइल मोड
6
+ # लोकल फ़ोल्डर स्रोत
7
7
 
8
- स्थानीय फ़ाइल मोड एक एजेंट-मूल ऐप को उसकी सामान्य UI और क्रिया सतह संलग्न करने देता है
9
- सीधे रेपो या कार्यक्षेत्र में फ़ाइलों तक। ऐप अभी भी होस्ट किया हुआ लगता है
10
- उत्पाद, लेकिन इसके सूची दृश्य, संपादक और एजेंट उपकरण स्थानीय फ़ाइलें पढ़ते और लिखते हैं
11
- SQL-समर्थित ऐप रिकॉर्ड के बजाय।
8
+ Content में अब एक ही डेटा मॉडल है: हर पेज SQL में रहता है, किसी **स्पेस** से
9
+ जुड़ा होता है और उस स्पेस के सिस्टम **Files** डेटाबेस का आइटम होता है। लोकल
10
+ फ़ोल्डर Files से जुड़ा स्रोत है, ऐप का दूसरा मोड नहीं। `AGENT_NATIVE_MODE`
11
+ स्विच अब नहीं है।
12
12
 
13
- पहला कार्यान्वयन सामग्री टेम्पलेट में है: बायां साइडबार है
14
- स्थानीय `.md` और `.mdx` फ़ाइलों से भरा हुआ, एक पृष्ठ का चयन करने से मानक खुल जाता है
15
- सामग्री संपादक, और बचत चयनित फ़ाइल पर वापस लिखता है। वही फ़ाइलें
16
- Codex, Claude कोड, Agent-Native साइडबार एजेंट या सामान्य द्वारा भी संपादित किया जा सकता है
17
- संपादक.
13
+ हर उपयोगकर्ता का निजी स्पेस, हर उपलब्ध संगठन का संगठन स्पेस और दिखाई देने वाले
14
+ स्पेस चुनने के लिए निजी **Workspaces** कैटलॉग होता है। Files एक सामान्य Content
15
+ डेटाबेस है; उसके गुण, फ़िल्टर, क्रम, समूह और सहेजे गए व्यू साइडबार भी बना सकते हैं।
18
16
 
19
- सामग्री के लिए, यह उत्पाद को MDX के लिए ओपन-सोर्स ओब्सीडियन जैसा महसूस कराता है:
20
- आपके दस्तावेज़ फ़ाइलों के रूप में रहते हैं, जबकि ऐप एक विज़ुअल संपादक, एजेंट actions जोड़ता है,
21
- साझा करने योग्य प्रतियां, और समृद्ध इंटरैक्टिव MDX घटक।
17
+ ## फ़ोल्डर जोड़ें
22
18
 
23
- जब आप रेपो-प्रथम वर्कफ़्लो चाहते हैं तो स्थानीय फ़ाइल मोड का उपयोग करें:
19
+ ब्राउज़र या Agent Native Desktop से फ़ोल्डर चुनकर उसे मौजूदा स्पेस में जोड़ें,
20
+ या उसका निजी स्पेस बनाएँ। SQL में केवल अपारदर्शी कनेक्शन ID, सापेक्ष पथ, hash और
21
+ स्रोत मेटाडेटा रहता है—absolute path, browser handle या फ़ाइल का मूल body नहीं।
24
22
 
25
- - `docs/*.mdx` के साथ एक डॉक्स रेपो
26
- - `blog/*.mdx` के साथ एक ब्लॉग
27
- - `resources/*.md` में पोजिशनिंग, मैसेजिंग या टीम नोट्स जैसे संसाधन
28
- - एक समृद्ध MDX संपादक के साथ एक व्यक्तिगत ओब्सीडियन-शैली ज्ञान का आधार
29
- - ऐसे दस्तावेज़ जिन्हें स्थानीय React कोड से उत्पन्न इंटरैक्टिव कस्टम MDX ब्लॉक की आवश्यकता होती है
30
- - ऐप कलाकृतियाँ जिनका निरीक्षण करना और पैच करना कोडिंग एजेंटों के लिए आसान होना चाहिए
23
+ नीतियाँ `database_primary`, `source_primary` और `reviewed_bidirectional` हैं।
24
+ Sync फ़ाइलों को सामान्य SQL पेज बनाता है। दोनों तरफ एक साथ बदलाव होने पर किसी
25
+ को overwrite करने के बजाय समीक्षा योग्य बदलाव बनता है। Disconnect करने पर पेज
26
+ और लोकल फ़ाइलें बनी रहती हैं।
31
27
 
32
- जब आप होस्टेड सहयोगी ऐप अनुभव चाहते हैं तो डेटाबेस मोड का उपयोग करें:
33
- बहु-उपयोगकर्ता साझाकरण, SQL-समर्थित अनुमतियाँ, टिप्पणियाँ, संस्करण इतिहास, और
34
- स्थानीय फ़ाइल सिस्टम पहुंच के बिना उत्पादन होस्टिंग।
35
-
36
- ## मानसिक मॉडल
37
-
38
- सत्य के स्रोत के दो तरीके हैं:
39
-
40
- | मोड | सत्य का स्रोत | के लिए सर्वश्रेष्ठ |
41
- | ----------------- | --------------------------------------------- | ---------------------------------------------------------------------------- |
42
- | डेटाबेस मोड | SQL पंक्तियाँ Drizzle तक | होस्टेड ऐप्स, सहयोग, साझाकरण, टिप्पणियाँ, संस्करण इतिहास |
43
- | स्थानीय फ़ाइल मोड | रेपो फ़ाइलें `agent-native.json` द्वारा घोषित | स्थानीय/डेवलप वर्कफ़्लो, Git समीक्षा, कोडिंग-एजेंट संपादन, फ़ाइल-मूल सामग्री |
44
-
45
- UI और एजेंट actions को दोनों मोड में एक ही आकार में रहना चाहिए। एक सामग्री
46
- संपादक अभी भी दस्तावेज़ों का संपादन करता है; अंतर यह है कि क्या वे दस्तावेज़ हल हो जाते हैं
47
- SQL पंक्तियों या स्थानीय फ़ाइलों तक।
48
-
49
- <Diagram id="doc-block-n52rso" title={"समान कार्य, सत्य के दो स्रोत"} summary={"यूआई और एजेंट दोनों मोड में समान क्रियाएं कहते हैं। कार्रवाई परत यह तय करती है कि प्रत्येक कॉल 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"
67
- >होस्टेड · साझाकरण · टिप्पणियां · इतिहास</small
68
- >
69
- </div>
70
- <div class="diagram-panel" data-rough>
71
- <span class="diagram-pill ok">Local File Mode</span
72
- ><small class="diagram-muted">repo files via agent-native.json</small
73
- ><small class="diagram-muted">Git समीक्षा · कोडिंग-एजेंट संपादन</small>
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-5gt15y"
116
- title={"एक Content workspace repo"}
117
- entries={[
118
- {
119
- path: "agent-native.json",
120
- note: "कौन से folders content roots हैं और उनके kinds घोषित करता है",
121
- },
122
- {
123
- path: "docs/",
124
- note: "content root: sidebar में pages के रूप में दिखता है",
125
- },
126
- {
127
- path: "docs/getting-started.mdx",
128
- },
129
- {
130
- path: "docs/guides/custom-components.mdx",
131
- },
132
- {
133
- path: "blog/",
134
- note: "content root folder",
135
- },
136
- {
137
- path: "blog/launch-post.mdx",
138
- },
139
- {
140
- path: "resources/",
141
- note: "content root folder",
142
- },
143
- {
144
- path: "resources/messaging/positioning.md",
145
- },
146
- {
147
- path: "components/",
148
- note: "content root नहीं: preview component library जिसे MDX import कर सकता है",
149
- },
150
- {
151
- path: "components/FrameworkTabs.tsx",
152
- },
153
- {
154
- path: "components/Callout.tsx",
155
- },
156
- {
157
- path: "extensions/",
158
- note: "content root नहीं: local extension library (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
- कौशल:
28
+ ## Repository से शुरू करें
186
29
 
187
30
  ```bash
188
- npx @agent-native/core@latest skills add content --mode local-files --scope project
31
+ npx @agent-native/core@latest content .
189
32
  ```
190
33
 
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
- ## कॉन्फ़िगरेशन
34
+ यह सामान्य database-backed Content शुरू करता है, फ़ोल्डर को स्रोत के रूप में
35
+ दर्ज करता है और कनेक्शन स्क्रीन खोलता है। कोई mode environment variable नहीं लगता।
208
36
 
209
- `agent-native.json` को रेपो या वर्कस्पेस रूट में जोड़ें:
37
+ ## Configuration
210
38
 
211
39
  ```json
212
40
  {
213
41
  "version": 1,
214
42
  "apps": {
215
43
  "content": {
216
- "mode": "local-files",
217
44
  "roots": [
218
45
  {
219
46
  "name": "Docs",
220
47
  "path": "docs",
221
48
  "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"]
49
+ "extensions": [".md", ".mdx"],
50
+ "source": {
51
+ "type": "local-folder",
52
+ "connectionId": "local-folder:<opaque-id>",
53
+ "truthPolicy": "source_primary"
54
+ }
235
55
  }
236
56
  ],
237
57
  "components": "components",
238
- "extensions": "extensions",
239
- "hide": ["**/_*.md", "**/_*.mdx"]
58
+ "extensions": "extensions"
240
59
  }
241
60
  }
242
61
  }
243
62
  ```
244
63
 
245
- आप `AGENT_NATIVE_MODE=local-files` या
246
- `AGENT_NATIVE_DATA_MODE=local-files`; मेनिफेस्ट को प्राथमिकता दी जाती है क्योंकि यह
247
- फ़ोल्डर अनुबंध को रेपो में ही दस्तावेज़ित करता है।
248
-
249
- ## सामग्री फ़ाइल स्वरूप
250
-
251
- सामग्री Markdown और MDX पढ़ती है। फ्रंटमैटर पेज मेटाडेटा रखता है, और बॉडी
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
- कंटेंट डेव सर्वर पास्कलकेस नाम के एक्सपोर्ट और पास्कलकेस डिफ़ॉल्ट का पता लगाता है
351
- `components/` के अंतर्गत `.tsx`, `.jsx`, `.ts`, और `.js` फ़ाइलों से निर्यात। वे
352
- घटक संपादक के अंदर प्रस्तुत होते हैं और नीचे स्लैश मेनू में दिखाई देते हैं
353
- **स्थानीय घटक**. स्लैश प्रविष्टि एक न्यूनतम टैग बनाती है जैसे
354
- `<ImpactCounter />`; आवश्यकता पड़ने पर MDX स्रोत में प्रॉप्स जोड़ें।
355
-
356
- घटक निष्पादन जानबूझकर एक स्थानीय-डेव/डेस्कटॉप ब्रिज क्षमता है, नहीं
357
- सादा होस्ट किया गया ब्राउज़र फ़ोल्डर एक्सेस। यदि आप `content.agent-native.com` खोलते हैं,
358
- **स्थानीय फ़ाइलें** चुनें, और Chrome में एक फ़ोल्डर चुनें, ऐप पढ़ और लिख सकता है
359
- ब्राउज़र फ़ाइल सिस्टम एक्सेस API के माध्यम से `.md` और `.mdx` फ़ाइलें, लेकिन
360
- क्रोम Vite को संकलित करने के लिए एक पूर्ण फ़ोल्डर पथ को उजागर नहीं करता है
361
- `components/*.tsx`. कस्टम React घटकों का पूर्वावलोकन और हॉट रीलोड करने के लिए, चलाएँ
362
- स्थानीय रूप से सामग्री या Agent Native डेस्कटॉप का उपयोग करें ताकि विश्वसनीय स्थानीय ब्रिज का उपयोग किया जा सके
363
- चुने गए कार्यक्षेत्र को स्थानीय सामग्री विकास सर्वर के साथ पंजीकृत करें। उस मोड में,
364
- मौजूदा घटक फ़ाइलों में संपादन Vite के माध्यम से हॉट रीलोड, और जोड़ना
365
- घटक फ़ाइलों को हटाने से घटक रजिस्ट्री और स्लैश मेनू पुनः लोड होता है।
366
-
367
- एजेंट उन पंजीकृत घटक फ़ाइलों के साथ भी काम कर सकते हैं। उपयोग करें
368
- `list-local-component-files` पंजीकृत कार्यक्षेत्र आईडी खोजने के लिए, फिर
369
- `.tsx`, `.jsx`, `.ts`, या बनाने या अपडेट करने के लिए `write-local-component-file`
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
- शाब्दिक प्रॉप्स के साथ सरल घटक टैग इनलाइन पूर्वावलोकन कर सकते हैं:
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` वही अल्पाइन/Tailwind एक्सटेंशन बॉडी फॉर्मेट है जिसका उपयोग सामान्य लोग करते हैं
434
- डेटाबेस-समर्थित एक्सटेंशन। जब कंटेंट ऐप एक स्थानीय एक्सटेंशन देखता है तो
435
- `content.sidebar.bottom` घोषित करता है, यह उस एक्सटेंशन को नीचे प्रस्तुत करता है
436
- the Content sidebar. The host passes `window.slotContext` with the selected
437
- दस्तावेज़ आईडी, शीर्षक, स्रोत मेटाडेटा, और क्या सामग्री स्थानीय फ़ाइल मोड में है।
438
-
439
- स्थानीय एक्सटेंशन का पूर्वावलोकन ऐप द्वारा किया जाता है लेकिन फ़ाइलों के रूप में संपादित किया जाता है। एक्सटेंशन
440
- सूची उन्हें स्थानीय फ़ाइल बैज के साथ दिखाती है, और पूर्ण-पृष्ठ व्यूअर वापस इंगित करता है
441
- प्रविष्टि फ़ाइल. SQL-समर्थित एक्सटेंशन actions जैसे अपडेट, डिलीट, शेयर और
442
- इतिहास लागू नहीं होता; इसके लिए अपने संपादक, Codex, Claude कोड, या Git इतिहास का उपयोग करें
443
- स्रोत परिवर्तन।
444
-
445
- v1 के लिए, स्थानीय एक्सटेंशन जानबूझकर रूढ़िवादी हैं:
446
-
447
- - वे अपनी छोटी रनटाइम स्थिति के लिए `extensionData` का उपयोग कर सकते हैं
448
- - वे केवल `extension.json` में सूचीबद्ध `appAction`s को कॉल कर सकते हैं
449
- - कच्चे SQL सहायक और बाहरी `extensionFetch` अक्षम हैं
450
- - स्लॉट लक्ष्य `extension.json` में घोषित किए गए हैं, SQL के माध्यम से स्थापित नहीं किए गए हैं
451
-
452
- यह स्थानीय कार्यस्थानों को बिना किसी अनुमति के ओब्सीडियन जैसी प्लगइन सतह देता है
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
- सामग्री में दो भिन्न फ़ाइल वर्कफ़्लो हैं:
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
- actions जोड़ें जो CMS से सामग्री को स्थानीय MDX फ़ाइलों में खींचता है या चयनित पुश करता है
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-समर्थित साझाकरण का उपयोग करें।
64
+ Migration में `mode: "local-files"` और `AGENT_NATIVE_MODE=local-files` हटाएँ,
65
+ roots रखें और `source` जोड़ें। Frontmatter ID rename या move पर पेज की पहचान
66
+ बचाता है। लोकल components और extensions trusted local bridge से ही लोड होते हैं।
@@ -93,9 +93,8 @@ description: "MDX के लिए ओपन-सोर्स ओब्सीड
93
93
  - **पेड़ों को एक पेड़ में व्यवस्थित करें** - असीमित रूप से घोंसला बनाएं, पुन: व्यवस्थित करने के लिए खींचें, पसंदीदा पृष्ठ जिनका आप अक्सर उपयोग करते हैं।
94
94
  - **सभी चीज़ों में खोजें** शीर्षकों और सामग्री में पूर्ण-पाठ खोज के साथ।
95
95
  - **ओब्सीडियन की तरह स्थानीय Markdown/MDX फ़ाइलों को संपादित करें।** `/local-files` दृश्य का उपयोग करें
96
- अपने कार्यक्षेत्र को फ़ाइलों में निर्यात करने के लिए, उन्हें अपने टूल में संपादित करें, पूर्वावलोकन करें
97
- परिवर्तन करें, और उन्हें वापस आयात करें। स्थानीय फ़ाइल मोड में, सामग्री सीधे
98
- चयनित `.md` या `.mdx` फ़ाइल।
96
+ फ़ोल्डर को Files से जोड़ें, अपने टूल में संपादित और sync करें, और SQL ऐप में
97
+ टकराव की समीक्षा करें।
99
98
  - **समृद्ध इंटरैक्टिव कस्टम ब्लॉक उत्पन्न करें।** स्थानीय React घटकों को पंजीकृत करें,
100
99
  उन्हें MDX के रूप में डालें, और एजेंट को घटक फ़ाइलें बनाने या अपडेट करने दें
101
100
  आपके दस्तावेज़.
@@ -138,32 +137,19 @@ description: "MDX के लिए ओपन-सोर्स ओब्सीड
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-संचालित के साथ ओब्सीडियन-शैली की व्यक्तिगत सामग्री
148
- घटक; जब आप होस्टेड सहयोग चाहते हैं तो डेटाबेस मोड पर वापस जाएँ और
149
- SQL-backed sharing. See [Local File Mode](/docs/local-file-mode) for the
150
- स्टैंडअलोन रेपो लेआउट, कॉन्फ़िगरेशन, कस्टम MDX घटक, स्थानीय
151
- `extensions/` विजेट, और उत्पादन सुरक्षा गाइड।
140
+ लोकल फ़ोल्डर अब सभी पेजों जैसा SQL मॉडल उपयोग करते हैं। हर पेज किसी स्पेस और
141
+ उसके Files डेटाबेस में रहता है; फ़ोल्डर उसका source adapter है। नीतियों, टकराव,
142
+ MDX components और पुराने मोड से migration के लिए
143
+ [लोकल फ़ोल्डर स्रोत](/docs/local-file-mode) देखें।
152
144
 
153
- सामग्री स्थानीय-फ़ाइल कौशल को मौजूदा रेपो में स्थापित करने के लिए:
145
+ मौजूदा repository में 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 सामान्य database-backed Content शुरू करता है, फ़ोल्डर स्रोत दर्ज करता है और
152
+ बिना mode environment variable के कनेक्शन स्क्रीन खोलता है।
167
153
 
168
154
  ## डेवलपर्स के लिए
169
155