@agent-native/core 0.109.2 → 0.109.4

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 (334) hide show
  1. package/corpus/README.md +2 -2
  2. package/corpus/core/CHANGELOG.md +16 -0
  3. package/corpus/core/docs/content/agent-native-toolkit.mdx +46 -13
  4. package/corpus/core/docs/content/locales/ar-SA/agent-native-toolkit.mdx +79 -55
  5. package/corpus/core/docs/content/locales/ar-SA/toolkit-capability-packages.mdx +21 -0
  6. package/corpus/core/docs/content/locales/ar-SA/toolkit-context-knowledge.mdx +12 -0
  7. package/corpus/core/docs/content/locales/ar-SA/toolkit-editors-canvases.mdx +17 -0
  8. package/corpus/core/docs/content/locales/de-DE/agent-native-toolkit.mdx +82 -54
  9. package/corpus/core/docs/content/locales/de-DE/toolkit-capability-packages.mdx +21 -0
  10. package/corpus/core/docs/content/locales/de-DE/toolkit-context-knowledge.mdx +12 -0
  11. package/corpus/core/docs/content/locales/de-DE/toolkit-editors-canvases.mdx +17 -0
  12. package/corpus/core/docs/content/locales/es-ES/agent-native-toolkit.mdx +81 -52
  13. package/corpus/core/docs/content/locales/es-ES/toolkit-capability-packages.mdx +21 -0
  14. package/corpus/core/docs/content/locales/es-ES/toolkit-context-knowledge.mdx +12 -0
  15. package/corpus/core/docs/content/locales/es-ES/toolkit-editors-canvases.mdx +21 -0
  16. package/corpus/core/docs/content/locales/fr-FR/agent-native-toolkit.mdx +84 -54
  17. package/corpus/core/docs/content/locales/fr-FR/toolkit-capability-packages.mdx +21 -0
  18. package/corpus/core/docs/content/locales/fr-FR/toolkit-context-knowledge.mdx +12 -0
  19. package/corpus/core/docs/content/locales/fr-FR/toolkit-editors-canvases.mdx +21 -0
  20. package/corpus/core/docs/content/locales/hi-IN/agent-native-toolkit.mdx +69 -62
  21. package/corpus/core/docs/content/locales/hi-IN/toolkit-capability-packages.mdx +21 -0
  22. package/corpus/core/docs/content/locales/hi-IN/toolkit-context-knowledge.mdx +12 -0
  23. package/corpus/core/docs/content/locales/hi-IN/toolkit-editors-canvases.mdx +17 -0
  24. package/corpus/core/docs/content/locales/ja-JP/agent-native-toolkit.mdx +69 -62
  25. package/corpus/core/docs/content/locales/ja-JP/toolkit-capability-packages.mdx +21 -0
  26. package/corpus/core/docs/content/locales/ja-JP/toolkit-context-knowledge.mdx +12 -0
  27. package/corpus/core/docs/content/locales/ja-JP/toolkit-editors-canvases.mdx +17 -0
  28. package/corpus/core/docs/content/locales/ko-KR/agent-native-toolkit.mdx +69 -62
  29. package/corpus/core/docs/content/locales/ko-KR/toolkit-capability-packages.mdx +21 -0
  30. package/corpus/core/docs/content/locales/ko-KR/toolkit-context-knowledge.mdx +12 -0
  31. package/corpus/core/docs/content/locales/ko-KR/toolkit-editors-canvases.mdx +17 -0
  32. package/corpus/core/docs/content/locales/pt-BR/agent-native-toolkit.mdx +82 -54
  33. package/corpus/core/docs/content/locales/pt-BR/toolkit-capability-packages.mdx +21 -0
  34. package/corpus/core/docs/content/locales/pt-BR/toolkit-context-knowledge.mdx +12 -0
  35. package/corpus/core/docs/content/locales/pt-BR/toolkit-editors-canvases.mdx +17 -0
  36. package/corpus/core/docs/content/locales/zh-CN/agent-native-toolkit.mdx +69 -62
  37. package/corpus/core/docs/content/locales/zh-CN/toolkit-capability-packages.mdx +21 -0
  38. package/corpus/core/docs/content/locales/zh-CN/toolkit-context-knowledge.mdx +12 -0
  39. package/corpus/core/docs/content/locales/zh-CN/toolkit-editors-canvases.mdx +17 -0
  40. package/corpus/core/docs/content/locales/zh-TW/agent-native-toolkit.mdx +69 -62
  41. package/corpus/core/docs/content/locales/zh-TW/toolkit-capability-packages.mdx +21 -0
  42. package/corpus/core/docs/content/locales/zh-TW/toolkit-context-knowledge.mdx +12 -0
  43. package/corpus/core/docs/content/locales/zh-TW/toolkit-editors-canvases.mdx +17 -0
  44. package/corpus/core/docs/content/toolkit-capability-packages.mdx +52 -0
  45. package/corpus/core/docs/content/toolkit-context-knowledge.mdx +46 -0
  46. package/corpus/core/docs/content/toolkit-editors-canvases.mdx +55 -0
  47. package/corpus/core/package.json +35 -34
  48. package/corpus/core/src/cli/create.ts +57 -15
  49. package/corpus/core/src/cli/package-lifecycle.ts +2 -0
  50. package/corpus/core/src/cli/skills-content/visual-plan-skill.ts +2 -0
  51. package/corpus/core/src/client/context-xray/ContextMeter.tsx +31 -111
  52. package/corpus/core/src/client/context-xray/ContextSegmentRow.tsx +8 -111
  53. package/corpus/core/src/client/context-xray/ContextTreemap.tsx +6 -111
  54. package/corpus/core/src/client/context-xray/ContextXRayPanel.tsx +31 -391
  55. package/corpus/core/src/client/context-xray/SegmentProvenancePopover.tsx +4 -52
  56. package/corpus/core/src/client/context-xray/format.ts +0 -33
  57. package/corpus/core/src/client/require-session.tsx +19 -3
  58. package/corpus/core/src/client/rich-markdown-editor/index.ts +42 -57
  59. package/corpus/core/src/client/rich-markdown-editor/uploadEditorImage.ts +2 -1
  60. package/corpus/core/src/client/use-action.ts +145 -2
  61. package/corpus/core/src/client/use-session.ts +79 -48
  62. package/corpus/core/src/client/visual-style-controls.tsx +1 -1088
  63. package/corpus/core/src/collab/agent-identity.ts +5 -22
  64. package/corpus/core/src/collab/client.ts +1 -53
  65. package/corpus/core/src/db/client.ts +13 -7
  66. package/corpus/core/src/db/create-get-db.ts +20 -13
  67. package/corpus/core/src/db/request-telemetry.ts +154 -0
  68. package/corpus/core/src/integrations/index.ts +1 -0
  69. package/corpus/core/src/integrations/plugin.ts +9 -3
  70. package/corpus/core/src/integrations/remote-push-delivery-job.ts +48 -0
  71. package/corpus/core/src/integrations/remote-push-delivery.ts +370 -0
  72. package/corpus/core/src/integrations/remote-push-store.ts +275 -26
  73. package/corpus/core/src/server/better-auth-instance.ts +11 -3
  74. package/corpus/core/src/server/core-routes-plugin.ts +36 -14
  75. package/corpus/core/src/server/framework-request-handler.ts +11 -1
  76. package/corpus/core/src/server/http-response-telemetry.ts +233 -31
  77. package/corpus/core/src/styles/rich-markdown-editor.css +1 -510
  78. package/corpus/core/src/templates/workspace-core/.agents/skills/tracking/SKILL.md +19 -0
  79. package/corpus/core/src/testing.ts +1 -1
  80. package/corpus/core/src/vite/client.ts +3 -0
  81. package/corpus/templates/clips/actions/finalize-recording.ts +3 -1
  82. package/corpus/templates/clips/actions/set-mobile-capture-state.ts +4 -1
  83. package/corpus/templates/clips/app/components/library/library-layout.tsx +1 -6
  84. package/corpus/templates/clips/changelog/2026-07-18-new-recording-is-now-emphasized-as-the-primary-action-in-the.md +6 -0
  85. package/corpus/templates/clips/changelog/2026-07-18-recordings-now-remain-safely-recoverable-until-the-stored-me.md +6 -0
  86. package/corpus/templates/content/app/components/editor/VisualEditor.tsx +5 -3
  87. package/corpus/templates/content/app/components/editor/extensions/DragHandle.tsx +4 -4
  88. package/corpus/templates/content/package.json +25 -25
  89. package/corpus/templates/design/app/components/design/TweaksPanel.tsx +2 -1
  90. package/corpus/templates/design/package.json +1 -1
  91. package/corpus/templates/mail/package.json +9 -9
  92. package/corpus/templates/plan/.agents/skills/visual-plan/SKILL.md +2 -0
  93. package/corpus/templates/plan/app/components/editor/PlanDocumentEditor.tsx +8 -8
  94. package/corpus/templates/plan/app/components/editor/planSlashCommands.ts +6 -6
  95. package/corpus/templates/plan/app/components/plan/PlanImageNode.tsx +4 -7
  96. package/corpus/templates/plan/app/components/plan/PlanMarkdownEditor.tsx +6 -4
  97. package/corpus/templates/plan/app/components/plan/PlanVisualSurface.tsx +1 -1
  98. package/corpus/templates/plan/changelog/2026-07-18-visual-plans-now-open-on-wireframes-by-default-when-a-protot.md +6 -0
  99. package/corpus/templates/plan/package.json +3 -3
  100. package/corpus/templates/slides/app/components/editor/SlideStyleInspector.tsx +2 -2
  101. package/corpus/templates/slides/app/components/editor/TweaksPanel.tsx +2 -2
  102. package/corpus/templates/slides/package.json +13 -13
  103. package/corpus/templates/tasks/AGENTS.md +3 -0
  104. package/corpus/templates/tasks/actions/render-task-list-inline.ts +202 -0
  105. package/corpus/templates/tasks/changelog/2026-07-18-task-lists-can-now-appear-as-interactive-widgets-inline-in-c.md +6 -0
  106. package/corpus/templates/tasks/docs/features/f8-chat.mdx +2 -0
  107. package/corpus/templates/tasks/server/plugins/agent-chat.ts +2 -0
  108. package/dist/catalog.json +39 -1
  109. package/dist/cli/create.d.ts +10 -1
  110. package/dist/cli/create.d.ts.map +1 -1
  111. package/dist/cli/create.js +49 -16
  112. package/dist/cli/create.js.map +1 -1
  113. package/dist/cli/package-lifecycle.d.ts.map +1 -1
  114. package/dist/cli/package-lifecycle.js +2 -0
  115. package/dist/cli/package-lifecycle.js.map +1 -1
  116. package/dist/cli/skills-content/visual-plan-skill.d.ts +1 -1
  117. package/dist/cli/skills-content/visual-plan-skill.d.ts.map +1 -1
  118. package/dist/cli/skills-content/visual-plan-skill.js +2 -0
  119. package/dist/cli/skills-content/visual-plan-skill.js.map +1 -1
  120. package/dist/client/context-xray/ContextMeter.d.ts.map +1 -1
  121. package/dist/client/context-xray/ContextMeter.js +8 -23
  122. package/dist/client/context-xray/ContextMeter.js.map +1 -1
  123. package/dist/client/context-xray/ContextSegmentRow.d.ts.map +1 -1
  124. package/dist/client/context-xray/ContextSegmentRow.js +3 -19
  125. package/dist/client/context-xray/ContextSegmentRow.js.map +1 -1
  126. package/dist/client/context-xray/ContextTreemap.d.ts.map +1 -1
  127. package/dist/client/context-xray/ContextTreemap.js +3 -54
  128. package/dist/client/context-xray/ContextTreemap.js.map +1 -1
  129. package/dist/client/context-xray/ContextXRayPanel.d.ts.map +1 -1
  130. package/dist/client/context-xray/ContextXRayPanel.js +21 -163
  131. package/dist/client/context-xray/ContextXRayPanel.js.map +1 -1
  132. package/dist/client/context-xray/SegmentProvenancePopover.d.ts.map +1 -1
  133. package/dist/client/context-xray/SegmentProvenancePopover.js +3 -4
  134. package/dist/client/context-xray/SegmentProvenancePopover.js.map +1 -1
  135. package/dist/client/context-xray/format.d.ts +0 -4
  136. package/dist/client/context-xray/format.d.ts.map +1 -1
  137. package/dist/client/context-xray/format.js +0 -49
  138. package/dist/client/context-xray/format.js.map +1 -1
  139. package/dist/client/require-session.d.ts.map +1 -1
  140. package/dist/client/require-session.js +6 -3
  141. package/dist/client/require-session.js.map +1 -1
  142. package/dist/client/rich-markdown-editor/index.d.ts +1 -12
  143. package/dist/client/rich-markdown-editor/index.d.ts.map +1 -1
  144. package/dist/client/rich-markdown-editor/index.js +1 -12
  145. package/dist/client/rich-markdown-editor/index.js.map +1 -1
  146. package/dist/client/rich-markdown-editor/uploadEditorImage.d.ts +1 -1
  147. package/dist/client/rich-markdown-editor/uploadEditorImage.d.ts.map +1 -1
  148. package/dist/client/rich-markdown-editor/uploadEditorImage.js.map +1 -1
  149. package/dist/client/use-action.d.ts.map +1 -1
  150. package/dist/client/use-action.js +117 -1
  151. package/dist/client/use-action.js.map +1 -1
  152. package/dist/client/use-session.d.ts.map +1 -1
  153. package/dist/client/use-session.js +72 -50
  154. package/dist/client/use-session.js.map +1 -1
  155. package/dist/client/visual-style-controls.d.ts +1 -89
  156. package/dist/client/visual-style-controls.d.ts.map +1 -1
  157. package/dist/client/visual-style-controls.js +1 -498
  158. package/dist/client/visual-style-controls.js.map +1 -1
  159. package/dist/collab/agent-identity.d.ts +1 -14
  160. package/dist/collab/agent-identity.d.ts.map +1 -1
  161. package/dist/collab/agent-identity.js +1 -13
  162. package/dist/collab/agent-identity.js.map +1 -1
  163. package/dist/collab/awareness.d.ts +2 -2
  164. package/dist/collab/awareness.d.ts.map +1 -1
  165. package/dist/collab/client.d.ts +1 -19
  166. package/dist/collab/client.d.ts.map +1 -1
  167. package/dist/collab/client.js +1 -53
  168. package/dist/collab/client.js.map +1 -1
  169. package/dist/collab/struct-routes.d.ts +1 -1
  170. package/dist/db/client.d.ts.map +1 -1
  171. package/dist/db/client.js +7 -1
  172. package/dist/db/client.js.map +1 -1
  173. package/dist/db/create-get-db.d.ts +3 -6
  174. package/dist/db/create-get-db.d.ts.map +1 -1
  175. package/dist/db/create-get-db.js +9 -2
  176. package/dist/db/create-get-db.js.map +1 -1
  177. package/dist/db/request-telemetry.d.ts +23 -0
  178. package/dist/db/request-telemetry.d.ts.map +1 -0
  179. package/dist/db/request-telemetry.js +95 -0
  180. package/dist/db/request-telemetry.js.map +1 -0
  181. package/dist/integrations/index.d.ts +1 -0
  182. package/dist/integrations/index.d.ts.map +1 -1
  183. package/dist/integrations/index.js +1 -0
  184. package/dist/integrations/index.js.map +1 -1
  185. package/dist/integrations/plugin.d.ts.map +1 -1
  186. package/dist/integrations/plugin.js +8 -3
  187. package/dist/integrations/plugin.js.map +1 -1
  188. package/dist/integrations/remote-push-delivery-job.d.ts +4 -0
  189. package/dist/integrations/remote-push-delivery-job.d.ts.map +1 -0
  190. package/dist/integrations/remote-push-delivery-job.js +44 -0
  191. package/dist/integrations/remote-push-delivery-job.js.map +1 -0
  192. package/dist/integrations/remote-push-delivery.d.ts +11 -0
  193. package/dist/integrations/remote-push-delivery.d.ts.map +1 -0
  194. package/dist/integrations/remote-push-delivery.js +265 -0
  195. package/dist/integrations/remote-push-delivery.js.map +1 -0
  196. package/dist/integrations/remote-push-store.d.ts +33 -0
  197. package/dist/integrations/remote-push-store.d.ts.map +1 -1
  198. package/dist/integrations/remote-push-store.js +195 -26
  199. package/dist/integrations/remote-push-store.js.map +1 -1
  200. package/dist/notifications/routes.d.ts +3 -3
  201. package/dist/progress/routes.d.ts +1 -1
  202. package/dist/provider-api/corpus-jobs.d.ts +2 -2
  203. package/dist/resources/handlers.d.ts +3 -3
  204. package/dist/secrets/routes.d.ts +9 -9
  205. package/dist/server/agent-engine-api-key-route.d.ts +1 -1
  206. package/dist/server/better-auth-instance.js +7 -3
  207. package/dist/server/better-auth-instance.js.map +1 -1
  208. package/dist/server/core-routes-plugin.d.ts +8 -0
  209. package/dist/server/core-routes-plugin.d.ts.map +1 -1
  210. package/dist/server/core-routes-plugin.js +23 -8
  211. package/dist/server/core-routes-plugin.js.map +1 -1
  212. package/dist/server/framework-request-handler.d.ts.map +1 -1
  213. package/dist/server/framework-request-handler.js +9 -1
  214. package/dist/server/framework-request-handler.js.map +1 -1
  215. package/dist/server/http-response-telemetry.d.ts +3 -2
  216. package/dist/server/http-response-telemetry.d.ts.map +1 -1
  217. package/dist/server/http-response-telemetry.js +160 -27
  218. package/dist/server/http-response-telemetry.js.map +1 -1
  219. package/dist/server/transcribe-voice.d.ts +1 -1
  220. package/dist/styles/rich-markdown-editor.css +1 -510
  221. package/dist/templates/workspace-core/.agents/skills/tracking/SKILL.md +19 -0
  222. package/dist/testing.d.ts +1 -1
  223. package/dist/testing.d.ts.map +1 -1
  224. package/dist/testing.js +1 -1
  225. package/dist/testing.js.map +1 -1
  226. package/dist/vite/client.d.ts.map +1 -1
  227. package/dist/vite/client.js +3 -0
  228. package/dist/vite/client.js.map +1 -1
  229. package/docs/content/agent-native-toolkit.mdx +46 -13
  230. package/docs/content/locales/ar-SA/agent-native-toolkit.mdx +79 -55
  231. package/docs/content/locales/ar-SA/toolkit-capability-packages.mdx +21 -0
  232. package/docs/content/locales/ar-SA/toolkit-context-knowledge.mdx +12 -0
  233. package/docs/content/locales/ar-SA/toolkit-editors-canvases.mdx +17 -0
  234. package/docs/content/locales/de-DE/agent-native-toolkit.mdx +82 -54
  235. package/docs/content/locales/de-DE/toolkit-capability-packages.mdx +21 -0
  236. package/docs/content/locales/de-DE/toolkit-context-knowledge.mdx +12 -0
  237. package/docs/content/locales/de-DE/toolkit-editors-canvases.mdx +17 -0
  238. package/docs/content/locales/es-ES/agent-native-toolkit.mdx +81 -52
  239. package/docs/content/locales/es-ES/toolkit-capability-packages.mdx +21 -0
  240. package/docs/content/locales/es-ES/toolkit-context-knowledge.mdx +12 -0
  241. package/docs/content/locales/es-ES/toolkit-editors-canvases.mdx +21 -0
  242. package/docs/content/locales/fr-FR/agent-native-toolkit.mdx +84 -54
  243. package/docs/content/locales/fr-FR/toolkit-capability-packages.mdx +21 -0
  244. package/docs/content/locales/fr-FR/toolkit-context-knowledge.mdx +12 -0
  245. package/docs/content/locales/fr-FR/toolkit-editors-canvases.mdx +21 -0
  246. package/docs/content/locales/hi-IN/agent-native-toolkit.mdx +69 -62
  247. package/docs/content/locales/hi-IN/toolkit-capability-packages.mdx +21 -0
  248. package/docs/content/locales/hi-IN/toolkit-context-knowledge.mdx +12 -0
  249. package/docs/content/locales/hi-IN/toolkit-editors-canvases.mdx +17 -0
  250. package/docs/content/locales/ja-JP/agent-native-toolkit.mdx +69 -62
  251. package/docs/content/locales/ja-JP/toolkit-capability-packages.mdx +21 -0
  252. package/docs/content/locales/ja-JP/toolkit-context-knowledge.mdx +12 -0
  253. package/docs/content/locales/ja-JP/toolkit-editors-canvases.mdx +17 -0
  254. package/docs/content/locales/ko-KR/agent-native-toolkit.mdx +69 -62
  255. package/docs/content/locales/ko-KR/toolkit-capability-packages.mdx +21 -0
  256. package/docs/content/locales/ko-KR/toolkit-context-knowledge.mdx +12 -0
  257. package/docs/content/locales/ko-KR/toolkit-editors-canvases.mdx +17 -0
  258. package/docs/content/locales/pt-BR/agent-native-toolkit.mdx +82 -54
  259. package/docs/content/locales/pt-BR/toolkit-capability-packages.mdx +21 -0
  260. package/docs/content/locales/pt-BR/toolkit-context-knowledge.mdx +12 -0
  261. package/docs/content/locales/pt-BR/toolkit-editors-canvases.mdx +17 -0
  262. package/docs/content/locales/zh-CN/agent-native-toolkit.mdx +69 -62
  263. package/docs/content/locales/zh-CN/toolkit-capability-packages.mdx +21 -0
  264. package/docs/content/locales/zh-CN/toolkit-context-knowledge.mdx +12 -0
  265. package/docs/content/locales/zh-CN/toolkit-editors-canvases.mdx +17 -0
  266. package/docs/content/locales/zh-TW/agent-native-toolkit.mdx +69 -62
  267. package/docs/content/locales/zh-TW/toolkit-capability-packages.mdx +21 -0
  268. package/docs/content/locales/zh-TW/toolkit-context-knowledge.mdx +12 -0
  269. package/docs/content/locales/zh-TW/toolkit-editors-canvases.mdx +17 -0
  270. package/docs/content/toolkit-capability-packages.mdx +52 -0
  271. package/docs/content/toolkit-context-knowledge.mdx +46 -0
  272. package/docs/content/toolkit-editors-canvases.mdx +55 -0
  273. package/package.json +27 -26
  274. package/src/templates/workspace-core/.agents/skills/tracking/SKILL.md +19 -0
  275. package/corpus/core/src/client/rich-markdown-editor/BubbleToolbar.tsx +0 -253
  276. package/corpus/core/src/client/rich-markdown-editor/CodeBlockNode.tsx +0 -258
  277. package/corpus/core/src/client/rich-markdown-editor/DragHandle.ts +0 -1437
  278. package/corpus/core/src/client/rich-markdown-editor/ImageExtension.ts +0 -306
  279. package/corpus/core/src/client/rich-markdown-editor/RichMarkdownEditor.tsx +0 -80
  280. package/corpus/core/src/client/rich-markdown-editor/RunId.ts +0 -61
  281. package/corpus/core/src/client/rich-markdown-editor/SharedRichEditor.tsx +0 -321
  282. package/corpus/core/src/client/rich-markdown-editor/SlashCommandMenu.tsx +0 -310
  283. package/corpus/core/src/client/rich-markdown-editor/extensions.ts +0 -402
  284. package/corpus/core/src/client/rich-markdown-editor/gfmDoc.ts +0 -92
  285. package/corpus/core/src/client/rich-markdown-editor/surgical-apply.ts +0 -192
  286. package/corpus/core/src/client/rich-markdown-editor/useCollabReconcile.ts +0 -590
  287. package/dist/client/rich-markdown-editor/BubbleToolbar.d.ts +0 -37
  288. package/dist/client/rich-markdown-editor/BubbleToolbar.d.ts.map +0 -1
  289. package/dist/client/rich-markdown-editor/BubbleToolbar.js +0 -171
  290. package/dist/client/rich-markdown-editor/BubbleToolbar.js.map +0 -1
  291. package/dist/client/rich-markdown-editor/CodeBlockNode.d.ts +0 -49
  292. package/dist/client/rich-markdown-editor/CodeBlockNode.d.ts.map +0 -1
  293. package/dist/client/rich-markdown-editor/CodeBlockNode.js +0 -127
  294. package/dist/client/rich-markdown-editor/CodeBlockNode.js.map +0 -1
  295. package/dist/client/rich-markdown-editor/DragHandle.d.ts +0 -97
  296. package/dist/client/rich-markdown-editor/DragHandle.d.ts.map +0 -1
  297. package/dist/client/rich-markdown-editor/DragHandle.js +0 -1066
  298. package/dist/client/rich-markdown-editor/DragHandle.js.map +0 -1
  299. package/dist/client/rich-markdown-editor/ImageExtension.d.ts +0 -63
  300. package/dist/client/rich-markdown-editor/ImageExtension.d.ts.map +0 -1
  301. package/dist/client/rich-markdown-editor/ImageExtension.js +0 -243
  302. package/dist/client/rich-markdown-editor/ImageExtension.js.map +0 -1
  303. package/dist/client/rich-markdown-editor/RichMarkdownEditor.d.ts +0 -51
  304. package/dist/client/rich-markdown-editor/RichMarkdownEditor.d.ts.map +0 -1
  305. package/dist/client/rich-markdown-editor/RichMarkdownEditor.js +0 -37
  306. package/dist/client/rich-markdown-editor/RichMarkdownEditor.js.map +0 -1
  307. package/dist/client/rich-markdown-editor/RunId.d.ts +0 -28
  308. package/dist/client/rich-markdown-editor/RunId.d.ts.map +0 -1
  309. package/dist/client/rich-markdown-editor/RunId.js +0 -60
  310. package/dist/client/rich-markdown-editor/RunId.js.map +0 -1
  311. package/dist/client/rich-markdown-editor/SharedRichEditor.d.ts +0 -110
  312. package/dist/client/rich-markdown-editor/SharedRichEditor.d.ts.map +0 -1
  313. package/dist/client/rich-markdown-editor/SharedRichEditor.js +0 -144
  314. package/dist/client/rich-markdown-editor/SharedRichEditor.js.map +0 -1
  315. package/dist/client/rich-markdown-editor/SlashCommandMenu.d.ts +0 -41
  316. package/dist/client/rich-markdown-editor/SlashCommandMenu.d.ts.map +0 -1
  317. package/dist/client/rich-markdown-editor/SlashCommandMenu.js +0 -221
  318. package/dist/client/rich-markdown-editor/SlashCommandMenu.js.map +0 -1
  319. package/dist/client/rich-markdown-editor/extensions.d.ts +0 -178
  320. package/dist/client/rich-markdown-editor/extensions.d.ts.map +0 -1
  321. package/dist/client/rich-markdown-editor/extensions.js +0 -224
  322. package/dist/client/rich-markdown-editor/extensions.js.map +0 -1
  323. package/dist/client/rich-markdown-editor/gfmDoc.d.ts +0 -24
  324. package/dist/client/rich-markdown-editor/gfmDoc.d.ts.map +0 -1
  325. package/dist/client/rich-markdown-editor/gfmDoc.js +0 -83
  326. package/dist/client/rich-markdown-editor/gfmDoc.js.map +0 -1
  327. package/dist/client/rich-markdown-editor/surgical-apply.d.ts +0 -66
  328. package/dist/client/rich-markdown-editor/surgical-apply.d.ts.map +0 -1
  329. package/dist/client/rich-markdown-editor/surgical-apply.js +0 -147
  330. package/dist/client/rich-markdown-editor/surgical-apply.js.map +0 -1
  331. package/dist/client/rich-markdown-editor/useCollabReconcile.d.ts +0 -110
  332. package/dist/client/rich-markdown-editor/useCollabReconcile.d.ts.map +0 -1
  333. package/dist/client/rich-markdown-editor/useCollabReconcile.js +0 -441
  334. package/dist/client/rich-markdown-editor/useCollabReconcile.js.map +0 -1
@@ -0,0 +1,17 @@
1
+ ---
2
+ title: "Editor und Arbeitsflächen"
3
+ description: "Wählen Sie wiederverwendbare Oberflächen, ohne Core-Kompatibilität, Template-Muster und Toolkit-Primitiven zu verwechseln."
4
+ ---
5
+
6
+ # Editor und Arbeitsflächen
7
+
8
+ Editoren und Arbeitsflächen sind verwandte Oberflächen, kein einzelnes Leitfeature.
9
+
10
+ | Oberfläche | Aktuelle Zuständigkeit |
11
+ | ------------------- | ----------------------------------------------------------------------------- |
12
+ | Rich Editor | Toolkit, mit Kompatibilitäts-Re-Exports aus Core. |
13
+ | Blöcke | In dieser Phase Core. |
14
+ | Design | Template-Muster mit `design-tweaks`, kein vollständiger Plug-and-play-Editor. |
15
+ | Canvas-Präsentation | Toolkit- oder App-Komposition. |
16
+
17
+ Importieren Sie den Editor aus `@agent-native/toolkit/editor`. Die alten Core-Pfade bleiben als Kompatibilitäts-Re-Exports erhalten. Schemata, Befehle und Persistenz bleiben in der App. Blöcke bleiben in Core, werden aber hier dokumentiert, weil der Toolkit-Bereich der Katalog für wiederverwendbare UI ist.
@@ -1,21 +1,25 @@
1
1
  ---
2
- title: "Toolkits"
3
- description: "Battle-tested reusable building blocks for high-quality agentic applications: collaboration, sharing, settings, teams, setup, navigation, resources, agent UX, history, comments, and observability."
2
+ title: "Toolkit"
3
+ description: "Un catálogo equilibrado de bases reutilizables, editores y lienzos, contexto de agentes, gobernanza, chrome del espacio de trabajo, operaciones y módulos de capacidad de Toolkit."
4
4
  ---
5
5
 
6
6
  <!-- i18n-docs-ignore -->
7
7
 
8
- # Toolkits
8
+ # Toolkit
9
9
 
10
- Toolkits are reusable, battle-tested building blocks for high-quality agentic
11
- applications. They turn the hard product work that repeats across apps into
12
- standard surfaces: realtime collaboration between humans and agents, sharing
13
- with humans and agents, settings, teams, setup, resources, history, review, and
14
- observability.
10
+ Toolkit es la estantería de bloques reutilizables y probados para aplicaciones
11
+ agénticas de alta calidad. Convierte el trabajo de producto que se repite entre
12
+ apps en superficies estándar, sin poner un patrón de aplicación en el centro del
13
+ catálogo.
14
+
15
+ Esta sección es el único lugar para descubrir UI reutilizable al crear apps. Una
16
+ superficie pertenece a estos documentos porque es reutilizable, incluso si hoy
17
+ la implementa Core o una plantilla. Las etiquetas de propiedad y las rutas de
18
+ importación hacen explícito ese límite sin dispersar la guía por el sitio.
15
19
 
16
20
  Each kit packages the UI patterns, action contracts, app-state expectations,
17
21
  access boundaries, and agent-visible behavior that users expect to work
18
- consistently. Apps still own their domain model and visual identity; toolkits
22
+ consistently. Apps still own their domain model and visual identity; Toolkit
19
23
  make the common product systems feel complete from the first version instead of
20
24
  being rebuilt in slightly different ways every time.
21
25
 
@@ -28,23 +32,24 @@ being rebuilt in slightly different ways every time.
28
32
  />
29
33
  </WireframeBlock>
30
34
 
31
- <Diagram id="doc-block-toolkits-boundary" title="How kits fit" summary={"The framework runtime supplies durable guarantees. Toolkits turn those guarantees into reusable product systems. Apps add domain-specific data, routes, and visual identity."}>
35
+ <Diagram id="doc-block-toolkits-boundary" title="Cómo encajan los kits" summary={"El runtime del framework ofrece garantías duraderas. Toolkit las convierte en sistemas de producto reutilizables. Las apps añaden datos de dominio, rutas e identidad visual."}>
32
36
 
33
37
  ```html
34
38
  <div class="diagram-row">
35
39
  <div class="diagram-card">
36
40
  <span class="diagram-pill accent">Runtime</span><br />
37
- actions, SQL, auth, app state, access checks, realtime transport
41
+ acciones, SQL, autenticación, estado de app, controles de acceso, transporte
42
+ en tiempo real
38
43
  </div>
39
44
  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
40
45
  <div class="diagram-card">
41
- <span class="diagram-pill accent">Toolkits</span><br />
42
- collaboration, sharing, setup, review, history, observability
46
+ <span class="diagram-pill accent">Toolkit</span><br />
47
+ colaboración, compartir, configuración, revisión, historial, observabilidad
43
48
  </div>
44
49
  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
45
50
  <div class="diagram-card">
46
51
  <span class="diagram-pill accent">Apps</span><br />
47
- domain schema, routes, actions, branding, specialized workflows
52
+ esquema de dominio, rutas, acciones, marca, flujos especializados
48
53
  </div>
49
54
  </div>
50
55
  ```
@@ -68,45 +73,69 @@ being rebuilt in slightly different ways every time.
68
73
 
69
74
  </Diagram>
70
75
 
71
- ## The Kits {#the-kits}
76
+ ## Catálogo {#catalog}
77
+
78
+ | Área | Empieza aquí | Qué cubre |
79
+ | --------------------------------- | ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
80
+ | Fundamentos | [Primitivas de UI](/docs/toolkit-ui) | Controles, hooks, adaptadores de app y puntos de integración de shell compartidos. |
81
+ | Editores y lienzos | [Editores y lienzos](/docs/toolkit-editors-canvases) | Edición enriquecida, bloques estructurados, controles de lienzo y patrones de Design. |
82
+ | Experiencia y contexto del agente | [Contexto y conocimiento](/docs/toolkit-context-knowledge) | Context X-Ray, recursos, conocimiento, contexto del compositor y estado visible para el agente. |
83
+ | Colaboración y gobernanza | [Colaboración](/docs/toolkit-collaboration) | Compartir, presencia, revisión, historial, auditoría y límites de organización. |
84
+ | Chrome del espacio de trabajo | [Chrome de app](/docs/toolkit-settings) | Ajustes, equipos, configuración, navegación, recursos y UX de agente. |
85
+ | Operaciones | [Observabilidad](/docs/toolkit-observability) | Uso, feedback, replay, diagnóstico y visibilidad operativa. |
86
+ | Módulos de capacidad de Toolkit | [Paquetes de capacidad](/docs/toolkit-capability-packages) | Paquetes de dominio instalados bajo demanda y sus manifiestos de ciclo de vida. |
87
+
88
+ ## Kits de producto {#product-kits}
72
89
 
73
- | Kit | Use it for |
90
+ | Kit | Úsalo para |
74
91
  | -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
75
- | [Sharing](/docs/toolkit-sharing) | Ownable resources, share dialogs, visibility badges, share actions, public/private/org access. |
76
- | [Collaboration](/docs/toolkit-collaboration) | Realtime editing, presence, live cursors, recent-edit highlights, collaborative undo. |
77
- | [Settings](/docs/toolkit-settings) | Standard settings pages and tabs so app settings and agent/provider settings live in one predictable place. |
78
- | [Org & Team](/docs/toolkit-org-team) | Team pages, org switching, invites, org domains, roles, and app switching. |
79
- | [Setup & Connections](/docs/toolkit-setup-connections) | Onboarding, secrets, workspace connections, OAuth/provider readiness, and Builder connect. |
80
- | [Command & Navigation](/docs/toolkit-command-navigation) | Command menu, deep links, standard app routes, sidebar and shell patterns. |
81
- | [Resources](/docs/toolkit-resources) | Resource trees, editors, file picker/search, attachments, and local file mode. |
82
- | [Agent UX](/docs/toolkit-agent-ux) | Composer, model picker, context chips, approvals, run recovery, and the runs tray. |
83
- | [History](/docs/toolkit-history) | Version history, audit logs, undo/redo, restore, and "what changed" surfaces. |
84
- | [Comments & Review](/docs/toolkit-comments-review) | Inline comments, annotations, mentions, resolved threads, review status. |
85
- | [Observability](/docs/toolkit-observability) | Usage, spend, feedback, replay, errors, and run diagnostics. |
86
-
87
- ## Implementation Boundary {#implementation-boundary}
88
-
89
- Kits are product surfaces first. Some pieces are runtime-backed
92
+ | [Sharing](/docs/toolkit-sharing) | Recursos propios, diálogos y acciones de compartir, insignias de visibilidad y acceso público/privado/org. |
93
+ | [Collaboration](/docs/toolkit-collaboration) | Edición en tiempo real, presencia, cursores en vivo, cambios recientes y deshacer colaborativo. |
94
+ | [Settings](/docs/toolkit-settings) | Páginas y pestañas estándar para ajustes de la app y del agente/proveedor en un lugar predecible. |
95
+ | [Org & Team](/docs/toolkit-org-team) | Páginas de equipo, cambio de organización, invitaciones, dominios, roles y cambio de app. |
96
+ | [Setup & Connections](/docs/toolkit-setup-connections) | Incorporación, secretos, conexiones de espacio de trabajo, OAuth/preparación de proveedor y Builder. |
97
+ | [Command & Navigation](/docs/toolkit-command-navigation) | Menú de comandos, enlaces profundos, rutas estándar, patrones de barra lateral y shell. |
98
+ | [Resources](/docs/toolkit-resources) | Árboles y editores de recursos, selector/búsqueda de archivos, adjuntos y modo de archivo local. |
99
+ | [Agent UX](/docs/toolkit-agent-ux) | Compositor, selector de modelo, chips de contexto, aprobaciones, recuperación y bandeja de ejecuciones. |
100
+ | [History](/docs/toolkit-history) | Recursos versionados, acciones de instantánea, historial, auditoría, deshacer/rehacer, restaurar y cambios. |
101
+ | [Comments & Review](/docs/toolkit-comments-review) | Recursos revisables, comentarios, colas de feedback, hilos, menciones, resolución y estado de revisión. |
102
+ | [Observability](/docs/toolkit-observability) | Uso, gasto, feedback, replay, errores y diagnósticos de ejecución. |
103
+
104
+ ## Madurez y propiedad de paquetes {#package-maturity-and-ownership}
105
+
106
+ - El editor enriquecido es propiedad de **Toolkit**; los imports existentes de Core siguen siendo reexportaciones de compatibilidad ligeras durante la migración.
107
+ - Design es un **patrón de plantilla** con `design-tweaks` reutilizables, no un editor ni lienzo completo listo para usar.
108
+ - Blocks y el motor Context X-Ray siguen siendo propiedad de **Core** en esta fase; la presentación reutilizable de Context X-Ray es de Toolkit.
109
+ - Creative Context, Scheduling y Pinpoint son **módulos de capacidad de Toolkit** instalados bajo demanda; conservan paquetes npm y manifiestos de ciclo de vida separados. Dispatch sigue siendo un producto separado.
110
+
111
+ ## Límite de implementación {#implementation-boundary}
112
+
113
+ Los kits son primero superficies de producto. Algunas piezas usan el runtime
90
114
  (`@agent-native/core`), some are presentation primitives
91
115
  (`@agent-native/toolkit`), and apps usually wrap both through local adapters.
92
- Use the package path that owns the needed behavior, but design the user-facing
93
- settings, collaboration, sharing, team, review, and setup experiences as one
94
- coherent kit instead of exposing package boundaries in the app.
95
-
96
- ## Foundation Pieces {#foundation-pieces}
97
-
98
- - [UI Primitives](/docs/toolkit-ui) cover shared shadcn-style primitives under
99
- `@agent-native/toolkit/ui/*`.
100
- - [App Adapters](/docs/toolkit-ui#app-adapters) show how apps wrap Toolkit pieces
101
- through local `@/components/*` adapters.
102
- - [Shell & Hooks](/docs/toolkit-ui#shell-hooks) cover header actions, mobile hooks,
103
- toasts, and small app-shell helpers.
104
- - [Component API](/docs/components) remains the lower-level reference for the
105
- public React exports.
106
-
107
- ## Design Rule {#design-rule}
108
-
109
- Use a toolkit when the behavior repeats across apps and users expect it to feel
110
- standard: sharing, settings, teams, comments, history, and agent progress should
111
- not be slightly different in every template. Keep domain-specific data,
112
- workflows, labels, and visual styling in the app.
116
+ Usa la ruta del paquete que posee el comportamiento necesario, pero diseña las
117
+ experiencias de ajustes, colaboración, compartir, equipo, revisión y
118
+ configuración como un kit coherente, sin exponer límites de paquetes en la app.
119
+
120
+ ## Piezas fundamentales {#foundation-pieces}
121
+
122
+ - [Primitivas de UI](/docs/toolkit-ui) cubre las primitivas compartidas estilo
123
+ shadcn bajo `@agent-native/toolkit/ui/*`, el patrón de adaptador local de cada
124
+ plantilla y los hooks de shell compartidos.
125
+ - [API de componentes](/docs/components) sigue siendo la referencia de nivel
126
+ inferior para los exports públicos de React.
127
+
128
+ ## Regla de diseño {#design-rule}
129
+
130
+ Usa un kit cuando el comportamiento se repite entre apps y los usuarios esperan
131
+ que sea estándar: compartir, ajustes, equipos, comentarios, historial y
132
+ progreso del agente no deberían variar entre plantillas. Conserva en la app los
133
+ datos, flujos, etiquetas y estilo visual específicos del dominio.
134
+
135
+ ## Próximos pasos
136
+
137
+ - [**Primitivas de UI de Toolkit**](/docs/toolkit-ui) — primitivas compartidas, adaptadores de app y hooks de shell.
138
+ - [**Kit de compartir**](/docs/toolkit-sharing) — un buen primer kit para recursos, diálogos de compartir y visibilidad.
139
+ - [**Crear plantillas**](/docs/creating-templates) — crea una plantilla completa y ve dónde encajan los kits.
140
+ - [**API de componentes**](/docs/components) — la referencia de todos los exports públicos de React.
141
+ - [**Ciclo de vida de paquetes**](/docs/package-lifecycle) — inspecciona, añade y expulsa módulos de capacidad de Toolkit guiados por manifiestos de forma segura.
@@ -0,0 +1,21 @@
1
+ ---
2
+ title: "Paquetes de capacidad"
3
+ description: "Gestiona capacidades de dominio y su ciclo de vida mediante manifiestos sin incorporarlas a Toolkit."
4
+ ---
5
+
6
+ # Paquetes de capacidad
7
+
8
+ Toolkit ofrece bases de producto transversales; los paquetes de capacidad aportan un dominio delimitado, acciones, habilidades y metadatos de ciclo de vida. Scheduling y Creative Context son paquetes de capacidad separados, no kits de Toolkit.
9
+
10
+ `@agent-native/scheduling` participa en el piloto del manifiesto genérico. Consulta la documentación local y el manifiesto de cada paquete para sus puntos de extensión y propiedad.
11
+
12
+ - [Documentación del paquete Scheduling](https://github.com/BuilderIO/agent-native/tree/main/packages/scheduling/docs)
13
+ - [Documentación del paquete Creative Context](https://github.com/BuilderIO/agent-native/tree/main/packages/creative-context/docs)
14
+
15
+ ```bash
16
+ agent-native package inspect @agent-native/scheduling
17
+ agent-native package add @agent-native/scheduling --apply
18
+ agent-native package eject @agent-native/scheduling --apply
19
+ ```
20
+
21
+ Consulta [Ciclo de vida de paquetes](/docs/package-lifecycle) para las reglas de inspección, simulación y expulsión.
@@ -0,0 +1,12 @@
1
+ ---
2
+ title: "Contexto y conocimiento"
3
+ description: "Crea superficies de contexto para agentes respetando las capas de motor, acceso a datos y presentación reutilizable."
4
+ ---
5
+
6
+ # Contexto y conocimiento
7
+
8
+ Core conserva el estado de aplicación, el acceso con alcance y el motor de Context X-Ray. Toolkit proporciona la presentación reutilizable; la app conserva sus registros de dominio, taxonomía y reglas de selección.
9
+
10
+ El motor de Context X-Ray sigue siendo de Core. Usa la presentación de Toolkit para mostrar contexto de forma coherente, pero mantén decisiones de estado y acceso en Core y acciones. [Context awareness](/docs/context-awareness) hace visible para el agente la navegación, selección y objeto enfocado; [Resources](/docs/toolkit-resources) cubre archivos y adjuntos.
11
+
12
+ El contexto nunca sustituye los controles de acceso. Conserva las comprobaciones de recursos y credenciales antes de recuperar conocimiento de proveedores.
@@ -0,0 +1,21 @@
1
+ ---
2
+ title: "Editores y lienzos"
3
+ description: "Elige superficies reutilizables sin confundir compatibilidad de Core, patrones de plantilla y primitivas de Toolkit."
4
+ ---
5
+
6
+ # Editores y lienzos
7
+
8
+ Los editores y lienzos son superficies relacionadas, no una única función principal.
9
+
10
+ | Superficie | Propiedad actual |
11
+ | ---------------------- | -------------------------------------------------------------------------- |
12
+ | Editor enriquecido | Toolkit, con reexportaciones de compatibilidad desde Core. |
13
+ | Bloques | Core en esta fase. |
14
+ | Design | Patrón de plantilla con `design-tweaks`, no un editor instalable completo. |
15
+ | Presentación de lienzo | Composición de Toolkit o de la app. |
16
+
17
+ Importa el editor desde `@agent-native/toolkit/editor`. Las rutas antiguas de Core siguen funcionando como reexportaciones de compatibilidad. Mantén en la app los esquemas, comandos y persistencia. Los bloques siguen en Core, pero se documentan aquí porque la sección Toolkit es el catálogo de UI reutilizable.
18
+
19
+ - [Resumen de Toolkit](/docs/agent-native-toolkit)
20
+ - [Plantilla Design](/docs/template-design)
21
+ - [Colaboración en tiempo real](/docs/real-time-collaboration)
@@ -1,21 +1,24 @@
1
1
  ---
2
- title: "Toolkits"
3
- description: "Battle-tested reusable building blocks for high-quality agentic applications: collaboration, sharing, settings, teams, setup, navigation, resources, agent UX, history, comments, and observability."
2
+ title: "Toolkit"
3
+ description: "Un catalogue équilibré de fondations réutilisables, éditeurs et canevas, contexte d’agent, gouvernance, chrome d’espace de travail, opérations et modules de capacité Toolkit."
4
4
  ---
5
5
 
6
6
  <!-- i18n-docs-ignore -->
7
7
 
8
- # Toolkits
8
+ # Toolkit
9
9
 
10
- Toolkits are reusable, battle-tested building blocks for high-quality agentic
11
- applications. They turn the hard product work that repeats across apps into
12
- standard surfaces: realtime collaboration between humans and agents, sharing
13
- with humans and agents, settings, teams, setup, resources, history, review, and
14
- observability.
10
+ Toolkit est l’étagère de blocs réutilisables et éprouvés pour des applications
11
+ agentiques de qualité. Il transforme le travail produit qui se répète entre les
12
+ apps en surfaces standard, sans placer un modèle d’app au centre du catalogue.
13
+
14
+ Cette section est l’étagère unique de découverte de l’UI réutilisable. Une
15
+ surface y figure parce qu’elle est réutilisable, même si Core ou un template en
16
+ est aujourd’hui propriétaire. Les libellés de propriété et les chemins d’import
17
+ clarifient cette limite sans disperser la documentation dans le site.
15
18
 
16
19
  Each kit packages the UI patterns, action contracts, app-state expectations,
17
20
  access boundaries, and agent-visible behavior that users expect to work
18
- consistently. Apps still own their domain model and visual identity; toolkits
21
+ consistently. Apps still own their domain model and visual identity; Toolkit
19
22
  make the common product systems feel complete from the first version instead of
20
23
  being rebuilt in slightly different ways every time.
21
24
 
@@ -28,23 +31,24 @@ being rebuilt in slightly different ways every time.
28
31
  />
29
32
  </WireframeBlock>
30
33
 
31
- <Diagram id="doc-block-toolkits-boundary" title="How kits fit" summary={"The framework runtime supplies durable guarantees. Toolkits turn those guarantees into reusable product systems. Apps add domain-specific data, routes, and visual identity."}>
34
+ <Diagram id="doc-block-toolkits-boundary" title="Comment les kits s’articulent" summary={"Le runtime du framework fournit des garanties durables. Toolkit les transforme en systèmes de produit réutilisables. Les apps ajoutent données métier, routes et identité visuelle."}>
32
35
 
33
36
  ```html
34
37
  <div class="diagram-row">
35
38
  <div class="diagram-card">
36
39
  <span class="diagram-pill accent">Runtime</span><br />
37
- actions, SQL, auth, app state, access checks, realtime transport
40
+ actions, SQL, authentification, état d’app, contrôles d’accès, transport
41
+ temps réel
38
42
  </div>
39
43
  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
40
44
  <div class="diagram-card">
41
- <span class="diagram-pill accent">Toolkits</span><br />
42
- collaboration, sharing, setup, review, history, observability
45
+ <span class="diagram-pill accent">Toolkit</span><br />
46
+ collaboration, partage, configuration, revue, historique, observabilité
43
47
  </div>
44
48
  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
45
49
  <div class="diagram-card">
46
50
  <span class="diagram-pill accent">Apps</span><br />
47
- domain schema, routes, actions, branding, specialized workflows
51
+ schéma métier, routes, actions, marque, flux spécialisés
48
52
  </div>
49
53
  </div>
50
54
  ```
@@ -68,45 +72,71 @@ being rebuilt in slightly different ways every time.
68
72
 
69
73
  </Diagram>
70
74
 
71
- ## The Kits {#the-kits}
72
-
73
- | Kit | Use it for |
74
- | -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
75
- | [Sharing](/docs/toolkit-sharing) | Ownable resources, share dialogs, visibility badges, share actions, public/private/org access. |
76
- | [Collaboration](/docs/toolkit-collaboration) | Realtime editing, presence, live cursors, recent-edit highlights, collaborative undo. |
77
- | [Settings](/docs/toolkit-settings) | Standard settings pages and tabs so app settings and agent/provider settings live in one predictable place. |
78
- | [Org & Team](/docs/toolkit-org-team) | Team pages, org switching, invites, org domains, roles, and app switching. |
79
- | [Setup & Connections](/docs/toolkit-setup-connections) | Onboarding, secrets, workspace connections, OAuth/provider readiness, and Builder connect. |
80
- | [Command & Navigation](/docs/toolkit-command-navigation) | Command menu, deep links, standard app routes, sidebar and shell patterns. |
81
- | [Resources](/docs/toolkit-resources) | Resource trees, editors, file picker/search, attachments, and local file mode. |
82
- | [Agent UX](/docs/toolkit-agent-ux) | Composer, model picker, context chips, approvals, run recovery, and the runs tray. |
83
- | [History](/docs/toolkit-history) | Version history, audit logs, undo/redo, restore, and "what changed" surfaces. |
84
- | [Comments & Review](/docs/toolkit-comments-review) | Inline comments, annotations, mentions, resolved threads, review status. |
85
- | [Observability](/docs/toolkit-observability) | Usage, spend, feedback, replay, errors, and run diagnostics. |
86
-
87
- ## Implementation Boundary {#implementation-boundary}
88
-
89
- Kits are product surfaces first. Some pieces are runtime-backed
75
+ ## Catalogue {#catalog}
76
+
77
+ | Domaine | Commencer ici | Ce que cela couvre |
78
+ | ------------------------------ | ------------------------------------------------------------ | -------------------------------------------------------------------------------------------- |
79
+ | Fondations | [Primitives UI](/docs/toolkit-ui) | Contrôles, hooks, adaptateurs d’app et points d’intégration de shell partagés. |
80
+ | Éditeurs et canevas | [Éditeurs et canevas](/docs/toolkit-editors-canvases) | Édition riche, blocs structurés, contrôles de canevas et patterns Design. |
81
+ | Expérience et contexte d’agent | [Contexte et connaissances](/docs/toolkit-context-knowledge) | Context X-Ray, ressources, connaissances, contexte du composeur et état visible par l’agent. |
82
+ | Collaboration et gouvernance | [Collaboration](/docs/toolkit-collaboration) | Partage, présence, revue, historique, audit et frontières organisationnelles. |
83
+ | Chrome d’espace de travail | [Chrome d’app](/docs/toolkit-settings) | Réglages, équipes, configuration, navigation, ressources et UX d’agent. |
84
+ | Opérations | [Observabilité](/docs/toolkit-observability) | Usage, feedback, replay, diagnostic et visibilité opérationnelle. |
85
+ | Modules de capacité Toolkit | [Paquets de capacité](/docs/toolkit-capability-packages) | Paquets de domaine installés à la demande et leurs manifests de cycle de vie. |
86
+
87
+ ## Kits produit {#product-kits}
88
+
89
+ | Kit | À utiliser pour |
90
+ | -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
91
+ | [Sharing](/docs/toolkit-sharing) | Ressources possédables, dialogues/actions de partage, badges de visibilité et accès public/privé/org. |
92
+ | [Collaboration](/docs/toolkit-collaboration) | Édition temps réel, présence, curseurs actifs, changements récents et annulation collaborative. |
93
+ | [Settings](/docs/toolkit-settings) | Pages et onglets standard pour les réglages d’app et d’agent/fournisseur au même endroit. |
94
+ | [Org & Team](/docs/toolkit-org-team) | Équipes, changement d’organisation, invitations, domaines, rôles et changement d’app. |
95
+ | [Setup & Connections](/docs/toolkit-setup-connections) | Onboarding, secrets, connexions d’espace, OAuth/préparation fournisseur et Builder connect. |
96
+ | [Command & Navigation](/docs/toolkit-command-navigation) | Menu de commande, liens profonds, routes standard, patterns de barre latérale et de shell. |
97
+ | [Resources](/docs/toolkit-resources) | Arborescences et éditeurs, sélection/recherche de fichiers, pièces jointes et mode fichiers local. |
98
+ | [Agent UX](/docs/toolkit-agent-ux) | Composeur, modèle, puces de contexte, approbations, reprise et tiroir des exécutions. |
99
+ | [History](/docs/toolkit-history) | Ressources versionnées, snapshots, historique, audit, annuler/rétablir, restauration et changements. |
100
+ | [Comments & Review](/docs/toolkit-comments-review) | Ressources révisables, commentaires, feedback, fils, mentions, résolution et statut de revue. |
101
+ | [Observability](/docs/toolkit-observability) | Usage, dépenses, feedback, replay, erreurs et diagnostics d’exécution. |
102
+
103
+ ## Maturité et propriété des paquets {#package-maturity-and-ownership}
104
+
105
+ - L’éditeur riche appartient à **Toolkit** ; les imports Core existants restent de minces réexportations de compatibilité pendant la migration.
106
+ - Design est un **pattern de template** avec des `design-tweaks` réutilisables, et non un éditeur ou canevas complet prêt à l’emploi.
107
+ - Blocks et le moteur Context X-Ray restent détenus par **Core** à cette étape ; la présentation réutilisable de Context X-Ray appartient à Toolkit.
108
+ - Creative Context, Scheduling et Pinpoint sont des **modules de capacité Toolkit** installés à la demande ; ils conservent des paquets npm et manifests de cycle de vie séparés. Dispatch reste un produit distinct.
109
+
110
+ ## Limite d’implémentation {#implementation-boundary}
111
+
112
+ Les kits sont d’abord des surfaces produit. Certaines pièces sont fournies par
113
+ le runtime
90
114
  (`@agent-native/core`), some are presentation primitives
91
115
  (`@agent-native/toolkit`), and apps usually wrap both through local adapters.
92
- Use the package path that owns the needed behavior, but design the user-facing
93
- settings, collaboration, sharing, team, review, and setup experiences as one
94
- coherent kit instead of exposing package boundaries in the app.
95
-
96
- ## Foundation Pieces {#foundation-pieces}
97
-
98
- - [UI Primitives](/docs/toolkit-ui) cover shared shadcn-style primitives under
99
- `@agent-native/toolkit/ui/*`.
100
- - [App Adapters](/docs/toolkit-ui#app-adapters) show how apps wrap Toolkit pieces
101
- through local `@/components/*` adapters.
102
- - [Shell & Hooks](/docs/toolkit-ui#shell-hooks) cover header actions, mobile hooks,
103
- toasts, and small app-shell helpers.
104
- - [Component API](/docs/components) remains the lower-level reference for the
105
- public React exports.
106
-
107
- ## Design Rule {#design-rule}
108
-
109
- Use a toolkit when the behavior repeats across apps and users expect it to feel
110
- standard: sharing, settings, teams, comments, history, and agent progress should
111
- not be slightly different in every template. Keep domain-specific data,
112
- workflows, labels, and visual styling in the app.
116
+ Utilisez le chemin du paquet qui possède le comportement, mais concevez les
117
+ expériences de réglages, collaboration, partage, équipe, revue et configuration
118
+ comme un kit cohérent, sans exposer les limites de paquets dans l’app.
119
+
120
+ ## Pièces fondamentales {#foundation-pieces}
121
+
122
+ - [Primitives UI](/docs/toolkit-ui) couvre les primitives partagées de style
123
+ shadcn sous `@agent-native/toolkit/ui/*`, les adaptateurs locaux et les hooks
124
+ de shell partagés.
125
+ - [API des composants](/docs/components) reste la référence de bas niveau des
126
+ exports React publics.
127
+
128
+ ## Règle de conception {#design-rule}
129
+
130
+ Utilisez un kit lorsque le comportement se répète entre les apps et que les
131
+ utilisateurs attendent une expérience standard : partage, réglages, équipes,
132
+ commentaires, historique et progrès de l’agent ne doivent pas varier d’un
133
+ template à l’autre. Gardez dans l’app les données, flux, libellés et style
134
+ visuel propres au domaine.
135
+
136
+ ## Étapes suivantes
137
+
138
+ - [**Primitives UI Toolkit**](/docs/toolkit-ui) — primitives partagées, adaptateurs d’app et hooks de shell.
139
+ - [**Kit de partage**](/docs/toolkit-sharing) — un bon premier kit pour les ressources, boîtes de partage et la visibilité.
140
+ - [**Créer des templates**](/docs/creating-templates) — créez un template de bout en bout et voyez où les kits s’intègrent.
141
+ - [**API des composants**](/docs/components) — la référence de tous les exports React publics.
142
+ - [**Cycle de vie des paquets**](/docs/package-lifecycle) — inspectez, ajoutez et éjectez les modules de capacité Toolkit pilotés par manifest en sécurité.
@@ -0,0 +1,21 @@
1
+ ---
2
+ title: "Packages de capacité"
3
+ description: "Gérez des capacités métier et leur cycle de vie piloté par manifeste sans les intégrer à Toolkit."
4
+ ---
5
+
6
+ # Packages de capacité
7
+
8
+ Toolkit fournit des fondations produit transversales ; les packages de capacité apportent un domaine borné, des actions, des skills et des métadonnées de cycle de vie. Scheduling et Creative Context restent des packages de capacité séparés, pas des kits Toolkit.
9
+
10
+ `@agent-native/scheduling` participe au pilote de manifeste générique. Consultez la documentation locale et le manifeste de chaque package pour les points d'extension et la propriété.
11
+
12
+ - [Documentation du package Scheduling](https://github.com/BuilderIO/agent-native/tree/main/packages/scheduling/docs)
13
+ - [Documentation du package Creative Context](https://github.com/BuilderIO/agent-native/tree/main/packages/creative-context/docs)
14
+
15
+ ```bash
16
+ agent-native package inspect @agent-native/scheduling
17
+ agent-native package add @agent-native/scheduling --apply
18
+ agent-native package eject @agent-native/scheduling --apply
19
+ ```
20
+
21
+ Consultez [Cycle de vie des packages](/docs/package-lifecycle) pour l'inspection, le mode simulation et l'éjection.
@@ -0,0 +1,12 @@
1
+ ---
2
+ title: "Contexte et connaissances"
3
+ description: "Construisez des surfaces de contexte pour l'agent en respectant les couches moteur, accès aux données et présentation réutilisable."
4
+ ---
5
+
6
+ # Contexte et connaissances
7
+
8
+ Core conserve l'état applicatif, l'accès limité et le moteur Context X-Ray. Toolkit fournit la présentation réutilisable ; l'app conserve ses données de domaine, sa taxonomie et ses règles de sélection.
9
+
10
+ Le moteur Context X-Ray reste dans Core. Utilisez la présentation Toolkit pour afficher un contexte cohérent, mais gardez état et décisions d'accès dans Core et les actions. [Context awareness](/docs/context-awareness) expose navigation, sélection et objet actif à l'agent ; [Resources](/docs/toolkit-resources) couvre fichiers et pièces jointes.
11
+
12
+ Le contexte ne remplace jamais les contrôles d'accès. Préservez les vérifications de ressources et de secrets avant de récupérer des connaissances fournisseur.
@@ -0,0 +1,21 @@
1
+ ---
2
+ title: "Éditeurs et canevas"
3
+ description: "Choisissez des surfaces réutilisables sans confondre compatibilité Core, patrons de modèle et primitives Toolkit."
4
+ ---
5
+
6
+ # Éditeurs et canevas
7
+
8
+ Les éditeurs et canevas sont des surfaces complémentaires, pas une fonctionnalité vedette unique.
9
+
10
+ | Surface | Propriété actuelle |
11
+ | ----------------------- | ------------------------------------------------------------------------------ |
12
+ | Éditeur riche | Toolkit, avec réexportations de compatibilité depuis Core. |
13
+ | Blocs | Core durant cette phase. |
14
+ | Design | Patron de modèle avec `design-tweaks`, pas un éditeur prêt à l'emploi complet. |
15
+ | Présentation de canevas | Composition Toolkit ou application. |
16
+
17
+ Importez l'éditeur depuis `@agent-native/toolkit/editor`. Les anciens chemins Core restent disponibles comme réexportations de compatibilité. Gardez schémas, commandes et persistance dans l'app. Les blocs restent dans Core, mais sont documentés ici car la section Toolkit est le catalogue de l'interface réutilisable.
18
+
19
+ - [Vue d’ensemble Toolkit](/docs/agent-native-toolkit)
20
+ - [Modèle Design](/docs/template-design)
21
+ - [Collaboration temps réel](/docs/real-time-collaboration)