@agent-native/core 0.99.3 → 0.100.1

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 (382) hide show
  1. package/corpus/README.md +2 -2
  2. package/corpus/core/CHANGELOG.md +21 -0
  3. package/corpus/core/docs/content/agent-surfaces.mdx +43 -0
  4. package/corpus/core/docs/content/external-agents.mdx +11 -0
  5. package/corpus/core/docs/content/locales/ar-SA/agent-surfaces.mdx +30 -0
  6. package/corpus/core/docs/content/locales/ar-SA/external-agents.mdx +9 -0
  7. package/corpus/core/docs/content/locales/de-DE/agent-surfaces.mdx +34 -0
  8. package/corpus/core/docs/content/locales/de-DE/external-agents.mdx +10 -0
  9. package/corpus/core/docs/content/locales/es-ES/agent-surfaces.mdx +34 -0
  10. package/corpus/core/docs/content/locales/es-ES/external-agents.mdx +10 -0
  11. package/corpus/core/docs/content/locales/fr-FR/agent-surfaces.mdx +34 -0
  12. package/corpus/core/docs/content/locales/fr-FR/external-agents.mdx +11 -0
  13. package/corpus/core/docs/content/locales/hi-IN/agent-surfaces.mdx +31 -0
  14. package/corpus/core/docs/content/locales/hi-IN/external-agents.mdx +9 -0
  15. package/corpus/core/docs/content/locales/ja-JP/agent-surfaces.mdx +32 -0
  16. package/corpus/core/docs/content/locales/ja-JP/external-agents.mdx +10 -0
  17. package/corpus/core/docs/content/locales/ko-KR/agent-surfaces.mdx +32 -0
  18. package/corpus/core/docs/content/locales/ko-KR/external-agents.mdx +9 -0
  19. package/corpus/core/docs/content/locales/pt-BR/agent-surfaces.mdx +33 -0
  20. package/corpus/core/docs/content/locales/pt-BR/external-agents.mdx +10 -0
  21. package/corpus/core/docs/content/locales/zh-CN/agent-surfaces.mdx +29 -0
  22. package/corpus/core/docs/content/locales/zh-CN/external-agents.mdx +8 -0
  23. package/corpus/core/docs/content/locales/zh-TW/agent-surfaces.mdx +29 -0
  24. package/corpus/core/docs/content/locales/zh-TW/external-agents.mdx +8 -0
  25. package/corpus/core/package.json +1 -1
  26. package/corpus/core/src/agent/context-xray/actions/context-evict.ts +11 -0
  27. package/corpus/core/src/agent/context-xray/actions/context-pin.ts +11 -0
  28. package/corpus/core/src/agent/context-xray/actions/context-preview-get.ts +134 -0
  29. package/corpus/core/src/agent/context-xray/actions/context-restore.ts +11 -0
  30. package/corpus/core/src/agent/context-xray/actions/errors.ts +20 -0
  31. package/corpus/core/src/agent/context-xray/manifest.ts +106 -7
  32. package/corpus/core/src/agent/engine/context-directives-transform.ts +5 -1
  33. package/corpus/core/src/agent/production-agent.ts +100 -38
  34. package/corpus/core/src/agent/run-loop-with-resume.ts +7 -2
  35. package/corpus/core/src/client/AgentPanel.tsx +35 -8
  36. package/corpus/core/src/client/agent-page/AgentContextTab.tsx +501 -0
  37. package/corpus/core/src/client/agent-page/AgentJobsTab.tsx +370 -0
  38. package/corpus/core/src/client/agent-page/AgentTabsPage.tsx +1084 -0
  39. package/corpus/core/src/client/agent-page/types.ts +18 -0
  40. package/corpus/core/src/client/agent-page/use-jobs.ts +150 -0
  41. package/corpus/core/src/client/context-xray/ContextMeter.tsx +22 -5
  42. package/corpus/core/src/client/context-xray/ContextTreemap.tsx +16 -1
  43. package/corpus/core/src/client/context-xray/ContextXRayPanel.tsx +168 -3
  44. package/corpus/core/src/client/context-xray/format.ts +6 -0
  45. package/corpus/core/src/client/index.ts +6 -0
  46. package/corpus/core/src/client/resources/ResourcesPanel.tsx +51 -23
  47. package/corpus/core/src/client/settings/AutomationsSection.tsx +407 -387
  48. package/corpus/core/src/jobs/actions/list-recurring-jobs.ts +105 -0
  49. package/corpus/core/src/jobs/actions/manage-recurring-job.ts +85 -0
  50. package/corpus/core/src/jobs/tools.ts +1 -1
  51. package/corpus/core/src/localization/default-messages.ts +110 -0
  52. package/corpus/core/src/mcp/build-server.ts +1 -0
  53. package/corpus/core/src/mcp/connect-route.ts +62 -65
  54. package/corpus/core/src/server/action-discovery.ts +23 -0
  55. package/corpus/core/src/server/agent-chat/prompt-resources.ts +174 -2
  56. package/corpus/core/src/server/agent-chat-plugin.ts +175 -2
  57. package/corpus/core/src/server/auth.ts +1 -7
  58. package/corpus/core/src/server/google-oauth.ts +1 -7
  59. package/corpus/core/src/server/workspace-oauth.ts +31 -0
  60. package/corpus/core/src/shared/context-xray.ts +84 -1
  61. package/corpus/core/src/shared/mcp-connect-content.ts +130 -0
  62. package/corpus/core/src/templates/default/app/routes/_index.tsx +11 -0
  63. package/corpus/core/src/templates/default/app/routes/agent.tsx +33 -0
  64. package/corpus/core/src/templates/workspace-core/.agents/skills/agent-native-toolkit/SKILL.md +6 -0
  65. package/corpus/core/src/templates/workspace-core/.agents/skills/agent-page/SKILL.md +59 -0
  66. package/corpus/core/src/templates/workspace-core/.agents/skills/context-xray/SKILL.md +25 -0
  67. package/corpus/core/src/templates/workspace-core/.agents/skills/external-agents/SKILL.md +7 -0
  68. package/corpus/core/src/templates/workspace-core/.agents/skills/recurring-jobs/SKILL.md +9 -0
  69. package/corpus/core/src/triggers/actions/list-automations.ts +99 -0
  70. package/corpus/core/src/triggers/actions/manage-automation.ts +78 -0
  71. package/corpus/templates/analytics/actions/data-source-status.ts +33 -15
  72. package/corpus/templates/analytics/actions/query-agent-native-analytics.ts +1 -1
  73. package/corpus/templates/analytics/app/components/dashboard/SqlChart.tsx +149 -24
  74. package/corpus/templates/analytics/app/components/layout/CommandPalette.tsx +17 -0
  75. package/corpus/templates/analytics/app/components/layout/Header.tsx +1 -0
  76. package/corpus/templates/analytics/app/components/layout/Layout.tsx +1 -0
  77. package/corpus/templates/analytics/app/components/layout/Sidebar.tsx +8 -0
  78. package/corpus/templates/analytics/app/i18n/zh-TW.ts +1 -0
  79. package/corpus/templates/analytics/app/i18n-data.ts +1 -0
  80. package/corpus/templates/analytics/app/routes/agent.tsx +5 -0
  81. package/corpus/templates/analytics/changelog/2026-07-13-a-full-agent-page-now-brings-context-files-connections-jobs-.md +6 -0
  82. package/corpus/templates/analytics/changelog/2026-07-13-analytics-answers-can-use-built-in-first-party-event-data.md +6 -0
  83. package/corpus/templates/analytics/changelog/2026-07-13-chart-legends-can-filter-to-one-series-or-hide-a-series-on-h.md +6 -0
  84. package/corpus/templates/analytics/changelog/2026-07-13-gpt-5-6-luna-answers-now-recover-normally-instead-of-showing.md +6 -0
  85. package/corpus/templates/analytics/server/plugins/agent-chat.ts +11 -2
  86. package/corpus/templates/assets/app/components/layout/Header.tsx +1 -0
  87. package/corpus/templates/assets/app/components/layout/Layout.tsx +1 -0
  88. package/corpus/templates/assets/app/components/layout/Sidebar.tsx +2 -0
  89. package/corpus/templates/assets/app/routes/agent.tsx +5 -0
  90. package/corpus/templates/assets/changelog/2026-07-13-a-full-agent-page-now-brings-context-files-connections-jobs-.md +6 -0
  91. package/corpus/templates/brain/app/components/layout/Layout.tsx +1 -0
  92. package/corpus/templates/brain/app/components/layout/Sidebar.tsx +4 -1
  93. package/corpus/templates/brain/app/lib/brain.ts +11 -0
  94. package/corpus/templates/brain/app/root.tsx +15 -1
  95. package/corpus/templates/brain/app/routes/agent.tsx +11 -0
  96. package/corpus/templates/brain/changelog/2026-07-13-a-full-agent-page-now-brings-context-files-connections-jobs-.md +6 -0
  97. package/corpus/templates/calendar/AGENTS.md +9 -0
  98. package/corpus/templates/calendar/actions/list-events.ts +659 -44
  99. package/corpus/templates/calendar/app/components/layout/AppLayout.tsx +1 -0
  100. package/corpus/templates/calendar/app/components/layout/Sidebar.tsx +2 -0
  101. package/corpus/templates/calendar/app/root.tsx +17 -1
  102. package/corpus/templates/calendar/app/routes/_app.agent.tsx +25 -0
  103. package/corpus/templates/calendar/changelog/2026-07-13-a-full-agent-page-now-brings-context-files-connections-jobs-.md +6 -0
  104. package/corpus/templates/calendar/changelog/2026-07-13-calendar-inventory-reads-report-source-coverage.md +6 -0
  105. package/corpus/templates/calendar/server/lib/calendar-connector-catalog.ts +8 -0
  106. package/corpus/templates/calendar/server/lib/google-calendar.ts +173 -51
  107. package/corpus/templates/calendar/server/lib/ical-fetcher.ts +13 -2
  108. package/corpus/templates/calendar/server/plugins/agent-chat.ts +5 -3
  109. package/corpus/templates/calendar/shared/api.ts +2 -0
  110. package/corpus/templates/chat/app/components/layout/Header.tsx +1 -0
  111. package/corpus/templates/chat/app/components/layout/Layout.tsx +1 -0
  112. package/corpus/templates/chat/app/components/layout/Sidebar.tsx +7 -0
  113. package/corpus/templates/chat/app/hooks/use-navigation-state.ts +3 -0
  114. package/corpus/templates/chat/app/root.tsx +24 -2
  115. package/corpus/templates/chat/app/routes/agent.tsx +15 -0
  116. package/corpus/templates/chat/changelog/2026-07-13-a-full-agent-page-now-brings-context-files-connections-jobs-.md +6 -0
  117. package/corpus/templates/clips/app/components/library/library-layout.tsx +8 -0
  118. package/corpus/templates/clips/app/i18n/ar-SA.ts +2 -0
  119. package/corpus/templates/clips/app/i18n/de-DE.ts +2 -0
  120. package/corpus/templates/clips/app/i18n/en-US.ts +2 -0
  121. package/corpus/templates/clips/app/i18n/es-ES.ts +2 -0
  122. package/corpus/templates/clips/app/i18n/fr-FR.ts +2 -0
  123. package/corpus/templates/clips/app/i18n/hi-IN.ts +2 -0
  124. package/corpus/templates/clips/app/i18n/ja-JP.ts +2 -0
  125. package/corpus/templates/clips/app/i18n/ko-KR.ts +2 -0
  126. package/corpus/templates/clips/app/i18n/pt-BR.ts +2 -0
  127. package/corpus/templates/clips/app/i18n/zh-CN.ts +2 -0
  128. package/corpus/templates/clips/app/i18n/zh-TW.ts +2 -0
  129. package/corpus/templates/clips/app/root.tsx +7 -1
  130. package/corpus/templates/clips/app/routes/_app.agent.tsx +15 -0
  131. package/corpus/templates/clips/changelog/2026-07-13-new-agent-page-see-and-manage-your-agent-s-context-files-con.md +6 -0
  132. package/corpus/templates/content/app/components/layout/Layout.tsx +1 -0
  133. package/corpus/templates/content/app/components/sidebar/DocumentSidebar.tsx +36 -0
  134. package/corpus/templates/content/app/i18n/zh-TW.ts +2 -0
  135. package/corpus/templates/content/app/i18n-data.ts +44 -6
  136. package/corpus/templates/content/app/root.tsx +8 -0
  137. package/corpus/templates/content/app/routes/_app.agent.tsx +15 -0
  138. package/corpus/templates/content/changelog/2026-07-13-new-agent-page-see-and-manage-your-agent-s-context-files-con.md +6 -0
  139. package/corpus/templates/design/app/components/layout/Layout.tsx +1 -0
  140. package/corpus/templates/design/app/components/layout/Sidebar.tsx +2 -0
  141. package/corpus/templates/design/app/i18n/zh-TW.ts +2 -0
  142. package/corpus/templates/design/app/i18n-data.ts +20 -0
  143. package/corpus/templates/design/app/root.tsx +7 -1
  144. package/corpus/templates/design/app/routes/agent.tsx +15 -0
  145. package/corpus/templates/design/changelog/2026-07-13-new-agent-page-see-and-manage-your-agent-s-context-files-con.md +6 -0
  146. package/corpus/templates/dispatch/app/dispatch-extensions.tsx +10 -1
  147. package/corpus/templates/dispatch/app/i18n/zh-TW.ts +2 -0
  148. package/corpus/templates/dispatch/app/i18n-data.ts +20 -0
  149. package/corpus/templates/dispatch/app/root.tsx +7 -2
  150. package/corpus/templates/dispatch/app/routes/agent.tsx +18 -0
  151. package/corpus/templates/dispatch/changelog/2026-07-13-new-agent-page-see-and-manage-your-agent-s-context-files-con.md +6 -0
  152. package/corpus/templates/forms/app/components/layout/Layout.tsx +1 -0
  153. package/corpus/templates/forms/app/components/layout/Sidebar.tsx +35 -0
  154. package/corpus/templates/forms/app/i18n/ar-SA.ts +2 -0
  155. package/corpus/templates/forms/app/i18n/de-DE.ts +2 -0
  156. package/corpus/templates/forms/app/i18n/en-US.ts +2 -0
  157. package/corpus/templates/forms/app/i18n/es-ES.ts +2 -0
  158. package/corpus/templates/forms/app/i18n/fr-FR.ts +2 -0
  159. package/corpus/templates/forms/app/i18n/hi-IN.ts +2 -0
  160. package/corpus/templates/forms/app/i18n/ja-JP.ts +2 -0
  161. package/corpus/templates/forms/app/i18n/ko-KR.ts +2 -0
  162. package/corpus/templates/forms/app/i18n/pt-BR.ts +2 -0
  163. package/corpus/templates/forms/app/i18n/zh-CN.ts +2 -0
  164. package/corpus/templates/forms/app/i18n/zh-TW.ts +2 -0
  165. package/corpus/templates/forms/app/root.tsx +6 -1
  166. package/corpus/templates/forms/app/routes/_app.agent.tsx +15 -0
  167. package/corpus/templates/forms/changelog/2026-07-13-new-agent-page-see-and-manage-your-agent-s-context-files-con.md +6 -0
  168. package/corpus/templates/macros/app/components/layout/AppLayout.tsx +14 -2
  169. package/corpus/templates/macros/app/components/layout/Header.tsx +1 -0
  170. package/corpus/templates/macros/app/root.tsx +17 -2
  171. package/corpus/templates/macros/app/routes/agent.tsx +15 -0
  172. package/corpus/templates/macros/changelog/2026-07-13-new-agent-page-see-and-manage-your-agent-s-context-files-con.md +6 -0
  173. package/corpus/templates/mail/AGENTS.md +12 -0
  174. package/corpus/templates/mail/actions/list-emails.ts +486 -4
  175. package/corpus/templates/mail/app/components/layout/AppLayout.tsx +42 -0
  176. package/corpus/templates/mail/app/components/layout/CommandPalette.tsx +6 -0
  177. package/corpus/templates/mail/app/routes/agent.tsx +15 -0
  178. package/corpus/templates/mail/changelog/2026-07-13-coverage-aware-connected-inbox-inventory.md +6 -0
  179. package/corpus/templates/mail/changelog/2026-07-13-new-agent-page-see-and-manage-your-agent-s-context-files-con.md +6 -0
  180. package/corpus/templates/mail/server/db/schema.ts +17 -0
  181. package/corpus/templates/mail/server/lib/google-auth.ts +33 -5
  182. package/corpus/templates/mail/server/lib/inventory-cursor.ts +406 -0
  183. package/corpus/templates/mail/server/lib/list-inbox-emails.ts +21 -2
  184. package/corpus/templates/mail/server/lib/mail-connector-catalog.ts +8 -0
  185. package/corpus/templates/mail/server/plugins/agent-chat.ts +4 -9
  186. package/corpus/templates/mail/server/plugins/db.ts +20 -0
  187. package/corpus/templates/plan/app/components/layout/Header.tsx +1 -0
  188. package/corpus/templates/plan/app/components/layout/Layout.tsx +1 -0
  189. package/corpus/templates/plan/app/components/layout/Sidebar.tsx +2 -0
  190. package/corpus/templates/plan/app/root.tsx +8 -0
  191. package/corpus/templates/plan/app/routes/agent.tsx +15 -0
  192. package/corpus/templates/plan/changelog/2026-07-13-new-agent-page-see-and-manage-your-agent-s-context-files-con.md +6 -0
  193. package/corpus/templates/slides/app/components/layout/Header.tsx +1 -0
  194. package/corpus/templates/slides/app/components/layout/Layout.tsx +1 -0
  195. package/corpus/templates/slides/app/components/layout/Sidebar.tsx +2 -0
  196. package/corpus/templates/slides/app/root.tsx +10 -1
  197. package/corpus/templates/slides/app/routes/agent.tsx +15 -0
  198. package/corpus/templates/slides/changelog/2026-07-13-new-agent-page-see-and-manage-your-agent-s-context-files-con.md +6 -0
  199. package/dist/agent/context-xray/actions/context-evict.js +5 -2
  200. package/dist/agent/context-xray/actions/context-evict.js.map +1 -1
  201. package/dist/agent/context-xray/actions/context-pin.js +5 -2
  202. package/dist/agent/context-xray/actions/context-pin.js.map +1 -1
  203. package/dist/agent/context-xray/actions/context-preview-get.d.ts +17 -0
  204. package/dist/agent/context-xray/actions/context-preview-get.d.ts.map +1 -0
  205. package/dist/agent/context-xray/actions/context-preview-get.js +94 -0
  206. package/dist/agent/context-xray/actions/context-preview-get.js.map +1 -0
  207. package/dist/agent/context-xray/actions/context-restore.js +5 -2
  208. package/dist/agent/context-xray/actions/context-restore.js.map +1 -1
  209. package/dist/agent/context-xray/actions/errors.d.ts +3 -0
  210. package/dist/agent/context-xray/actions/errors.d.ts.map +1 -1
  211. package/dist/agent/context-xray/actions/errors.js +6 -0
  212. package/dist/agent/context-xray/actions/errors.js.map +1 -1
  213. package/dist/agent/context-xray/manifest.d.ts +18 -1
  214. package/dist/agent/context-xray/manifest.d.ts.map +1 -1
  215. package/dist/agent/context-xray/manifest.js +68 -6
  216. package/dist/agent/context-xray/manifest.js.map +1 -1
  217. package/dist/agent/engine/context-directives-transform.d.ts +2 -0
  218. package/dist/agent/engine/context-directives-transform.d.ts.map +1 -1
  219. package/dist/agent/engine/context-directives-transform.js +2 -1
  220. package/dist/agent/engine/context-directives-transform.js.map +1 -1
  221. package/dist/agent/production-agent.d.ts +15 -0
  222. package/dist/agent/production-agent.d.ts.map +1 -1
  223. package/dist/agent/production-agent.js +74 -36
  224. package/dist/agent/production-agent.js.map +1 -1
  225. package/dist/agent/run-loop-with-resume.d.ts.map +1 -1
  226. package/dist/agent/run-loop-with-resume.js +6 -3
  227. package/dist/agent/run-loop-with-resume.js.map +1 -1
  228. package/dist/client/AgentPanel.d.ts +5 -1
  229. package/dist/client/AgentPanel.d.ts.map +1 -1
  230. package/dist/client/AgentPanel.js +9 -11
  231. package/dist/client/AgentPanel.js.map +1 -1
  232. package/dist/client/agent-page/AgentContextTab.d.ts +5 -0
  233. package/dist/client/agent-page/AgentContextTab.d.ts.map +1 -0
  234. package/dist/client/agent-page/AgentContextTab.js +202 -0
  235. package/dist/client/agent-page/AgentContextTab.js.map +1 -0
  236. package/dist/client/agent-page/AgentJobsTab.d.ts +3 -0
  237. package/dist/client/agent-page/AgentJobsTab.d.ts.map +1 -0
  238. package/dist/client/agent-page/AgentJobsTab.js +98 -0
  239. package/dist/client/agent-page/AgentJobsTab.js.map +1 -0
  240. package/dist/client/agent-page/AgentTabsPage.d.ts +20 -0
  241. package/dist/client/agent-page/AgentTabsPage.d.ts.map +1 -0
  242. package/dist/client/agent-page/AgentTabsPage.js +420 -0
  243. package/dist/client/agent-page/AgentTabsPage.js.map +1 -0
  244. package/dist/client/agent-page/types.d.ts +17 -0
  245. package/dist/client/agent-page/types.d.ts.map +1 -0
  246. package/dist/client/agent-page/types.js +9 -0
  247. package/dist/client/agent-page/types.js.map +1 -0
  248. package/dist/client/agent-page/use-jobs.d.ts +61 -0
  249. package/dist/client/agent-page/use-jobs.d.ts.map +1 -0
  250. package/dist/client/agent-page/use-jobs.js +71 -0
  251. package/dist/client/agent-page/use-jobs.js.map +1 -0
  252. package/dist/client/context-xray/ContextMeter.d.ts +3 -1
  253. package/dist/client/context-xray/ContextMeter.d.ts.map +1 -1
  254. package/dist/client/context-xray/ContextMeter.js +14 -5
  255. package/dist/client/context-xray/ContextMeter.js.map +1 -1
  256. package/dist/client/context-xray/ContextTreemap.d.ts +3 -2
  257. package/dist/client/context-xray/ContextTreemap.d.ts.map +1 -1
  258. package/dist/client/context-xray/ContextTreemap.js +9 -1
  259. package/dist/client/context-xray/ContextTreemap.js.map +1 -1
  260. package/dist/client/context-xray/ContextXRayPanel.d.ts.map +1 -1
  261. package/dist/client/context-xray/ContextXRayPanel.js +95 -20
  262. package/dist/client/context-xray/ContextXRayPanel.js.map +1 -1
  263. package/dist/client/context-xray/format.d.ts.map +1 -1
  264. package/dist/client/context-xray/format.js +12 -0
  265. package/dist/client/context-xray/format.js.map +1 -1
  266. package/dist/client/index.d.ts +3 -0
  267. package/dist/client/index.d.ts.map +1 -1
  268. package/dist/client/index.js +1 -0
  269. package/dist/client/index.js.map +1 -1
  270. package/dist/client/resources/ResourcesPanel.d.ts +9 -1
  271. package/dist/client/resources/ResourcesPanel.d.ts.map +1 -1
  272. package/dist/client/resources/ResourcesPanel.js +26 -10
  273. package/dist/client/resources/ResourcesPanel.js.map +1 -1
  274. package/dist/client/settings/AutomationsSection.d.ts +9 -0
  275. package/dist/client/settings/AutomationsSection.d.ts.map +1 -1
  276. package/dist/client/settings/AutomationsSection.js +128 -147
  277. package/dist/client/settings/AutomationsSection.js.map +1 -1
  278. package/dist/collab/routes.d.ts +1 -1
  279. package/dist/collab/struct-routes.d.ts +1 -1
  280. package/dist/file-upload/actions/upload-image.d.ts +1 -1
  281. package/dist/jobs/actions/list-recurring-jobs.d.ts +21 -0
  282. package/dist/jobs/actions/list-recurring-jobs.d.ts.map +1 -0
  283. package/dist/jobs/actions/list-recurring-jobs.js +74 -0
  284. package/dist/jobs/actions/list-recurring-jobs.js.map +1 -0
  285. package/dist/jobs/actions/manage-recurring-job.d.ts +18 -0
  286. package/dist/jobs/actions/manage-recurring-job.d.ts.map +1 -0
  287. package/dist/jobs/actions/manage-recurring-job.js +68 -0
  288. package/dist/jobs/actions/manage-recurring-job.js.map +1 -0
  289. package/dist/jobs/tools.d.ts +13 -0
  290. package/dist/jobs/tools.d.ts.map +1 -1
  291. package/dist/jobs/tools.js +1 -1
  292. package/dist/jobs/tools.js.map +1 -1
  293. package/dist/localization/default-messages.d.ts +96 -0
  294. package/dist/localization/default-messages.d.ts.map +1 -1
  295. package/dist/localization/default-messages.js +96 -0
  296. package/dist/localization/default-messages.js.map +1 -1
  297. package/dist/mcp/build-server.d.ts.map +1 -1
  298. package/dist/mcp/build-server.js +1 -0
  299. package/dist/mcp/build-server.js.map +1 -1
  300. package/dist/mcp/connect-route.d.ts.map +1 -1
  301. package/dist/mcp/connect-route.js +44 -59
  302. package/dist/mcp/connect-route.js.map +1 -1
  303. package/dist/notifications/routes.d.ts +1 -1
  304. package/dist/observability/routes.d.ts +5 -5
  305. package/dist/progress/routes.d.ts +1 -1
  306. package/dist/resources/handlers.d.ts +3 -3
  307. package/dist/secrets/routes.d.ts +9 -9
  308. package/dist/server/action-discovery.d.ts.map +1 -1
  309. package/dist/server/action-discovery.js +23 -0
  310. package/dist/server/action-discovery.js.map +1 -1
  311. package/dist/server/agent-chat/prompt-resources.d.ts +14 -0
  312. package/dist/server/agent-chat/prompt-resources.d.ts.map +1 -1
  313. package/dist/server/agent-chat/prompt-resources.js +139 -2
  314. package/dist/server/agent-chat/prompt-resources.js.map +1 -1
  315. package/dist/server/agent-chat-plugin.d.ts +1 -0
  316. package/dist/server/agent-chat-plugin.d.ts.map +1 -1
  317. package/dist/server/agent-chat-plugin.js +136 -3
  318. package/dist/server/agent-chat-plugin.js.map +1 -1
  319. package/dist/server/agent-engine-api-key-route.d.ts +1 -1
  320. package/dist/server/auth.d.ts.map +1 -1
  321. package/dist/server/auth.js +1 -4
  322. package/dist/server/auth.js.map +1 -1
  323. package/dist/server/google-oauth.d.ts.map +1 -1
  324. package/dist/server/google-oauth.js +1 -4
  325. package/dist/server/google-oauth.js.map +1 -1
  326. package/dist/server/workspace-oauth.d.ts +11 -0
  327. package/dist/server/workspace-oauth.d.ts.map +1 -0
  328. package/dist/server/workspace-oauth.js +25 -0
  329. package/dist/server/workspace-oauth.js.map +1 -0
  330. package/dist/shared/context-xray.d.ts +45 -1
  331. package/dist/shared/context-xray.d.ts.map +1 -1
  332. package/dist/shared/context-xray.js +12 -0
  333. package/dist/shared/context-xray.js.map +1 -1
  334. package/dist/shared/mcp-connect-content.d.ts +37 -0
  335. package/dist/shared/mcp-connect-content.d.ts.map +1 -0
  336. package/dist/shared/mcp-connect-content.js +92 -0
  337. package/dist/shared/mcp-connect-content.js.map +1 -0
  338. package/dist/templates/default/app/routes/_index.tsx +11 -0
  339. package/dist/templates/default/app/routes/agent.tsx +33 -0
  340. package/dist/templates/workspace-core/.agents/skills/agent-native-toolkit/SKILL.md +6 -0
  341. package/dist/templates/workspace-core/.agents/skills/agent-page/SKILL.md +59 -0
  342. package/dist/templates/workspace-core/.agents/skills/context-xray/SKILL.md +25 -0
  343. package/dist/templates/workspace-core/.agents/skills/external-agents/SKILL.md +7 -0
  344. package/dist/templates/workspace-core/.agents/skills/recurring-jobs/SKILL.md +9 -0
  345. package/dist/triggers/actions/list-automations.d.ts +24 -0
  346. package/dist/triggers/actions/list-automations.d.ts.map +1 -0
  347. package/dist/triggers/actions/list-automations.js +72 -0
  348. package/dist/triggers/actions/list-automations.js.map +1 -0
  349. package/dist/triggers/actions/manage-automation.d.ts +18 -0
  350. package/dist/triggers/actions/manage-automation.d.ts.map +1 -0
  351. package/dist/triggers/actions/manage-automation.js +60 -0
  352. package/dist/triggers/actions/manage-automation.js.map +1 -0
  353. package/docs/content/agent-surfaces.mdx +43 -0
  354. package/docs/content/external-agents.mdx +11 -0
  355. package/docs/content/locales/ar-SA/agent-surfaces.mdx +30 -0
  356. package/docs/content/locales/ar-SA/external-agents.mdx +9 -0
  357. package/docs/content/locales/de-DE/agent-surfaces.mdx +34 -0
  358. package/docs/content/locales/de-DE/external-agents.mdx +10 -0
  359. package/docs/content/locales/es-ES/agent-surfaces.mdx +34 -0
  360. package/docs/content/locales/es-ES/external-agents.mdx +10 -0
  361. package/docs/content/locales/fr-FR/agent-surfaces.mdx +34 -0
  362. package/docs/content/locales/fr-FR/external-agents.mdx +11 -0
  363. package/docs/content/locales/hi-IN/agent-surfaces.mdx +31 -0
  364. package/docs/content/locales/hi-IN/external-agents.mdx +9 -0
  365. package/docs/content/locales/ja-JP/agent-surfaces.mdx +32 -0
  366. package/docs/content/locales/ja-JP/external-agents.mdx +10 -0
  367. package/docs/content/locales/ko-KR/agent-surfaces.mdx +32 -0
  368. package/docs/content/locales/ko-KR/external-agents.mdx +9 -0
  369. package/docs/content/locales/pt-BR/agent-surfaces.mdx +33 -0
  370. package/docs/content/locales/pt-BR/external-agents.mdx +10 -0
  371. package/docs/content/locales/zh-CN/agent-surfaces.mdx +29 -0
  372. package/docs/content/locales/zh-CN/external-agents.mdx +8 -0
  373. package/docs/content/locales/zh-TW/agent-surfaces.mdx +29 -0
  374. package/docs/content/locales/zh-TW/external-agents.mdx +8 -0
  375. package/package.json +1 -1
  376. package/src/templates/default/app/routes/_index.tsx +11 -0
  377. package/src/templates/default/app/routes/agent.tsx +33 -0
  378. package/src/templates/workspace-core/.agents/skills/agent-native-toolkit/SKILL.md +6 -0
  379. package/src/templates/workspace-core/.agents/skills/agent-page/SKILL.md +59 -0
  380. package/src/templates/workspace-core/.agents/skills/context-xray/SKILL.md +25 -0
  381. package/src/templates/workspace-core/.agents/skills/external-agents/SKILL.md +7 -0
  382. package/src/templates/workspace-core/.agents/skills/recurring-jobs/SKILL.md +9 -0
@@ -117,6 +117,15 @@ https://<your-app>.agent-native.com/mcp
117
117
  `https://&lt;app&gt;/mcp/connect` مع URL القابل للنسخ و
118
118
  علامات التبويب الخاصة بالمضيف لـ Claude، وChatGPT، والمؤشر، وClaude Code، وCodex، وغيرها.
119
119
 
120
+ ### علامة التبويب Access داخل التطبيق {#access-tab}
121
+
122
+ تعرض التطبيقات التي تستخدم `AgentTabsPage` تدفق الاتصال نفسه في علامة تبويب
123
+ **Access**. وهي تعرض عنوان MCP، وبطاقة وكيل A2A عند توفرها، وتعليمات إعداد
124
+ Claude وChatGPT وCursor وClaude Code وCodex والعملاء الآخرين. استخدمها كنقطة
125
+ البداية داخل التطبيق، ثم افتح `/mcp/connect` للتدفق الكامل والرمز الاحتياطي.
126
+ هذه واجهة لإعداد الاتصال وليست وحدة تحكم عامة بالوصول؛ لا توفر علامة التبويب
127
+ بعد واجهة لإدارة المنح أو النطاقات أو الإلغاء.
128
+
120
129
  ### Claude وChatGPT OAuth {#oauth}
121
130
 
122
131
  Claude / Claude سطح المكتب: أضف موصلًا مخصصًا، والصق MCP URL، وانقر على
@@ -6,6 +6,40 @@ search: "Headless Agent Rich Chat, vollständige App BYO Agent Runtime AgentChat
6
6
 
7
7
  # Agentenoberflächen
8
8
 
9
+ ## Vollständiger Agent-Arbeitsbereich {#agent-page}
10
+
11
+ Wenn eine vollständige Anwendung einen dauerhaften Ort zum Prüfen und
12
+ Konfigurieren ihres Agents braucht, binde `AgentTabsPage` unter `/agent` ein.
13
+ Füge die Route zur App-Navigation hinzu und übergib `agentPageHref="/agent"` an
14
+ `AgentSidebar`, damit die Modi Resources und Settings auf die vollständige
15
+ Seite verweisen können, ohne diese Abläufe zu duplizieren.
16
+
17
+ ```tsx filename="app/routes/agent.tsx"
18
+ import { AgentTabsPage } from "@agent-native/core/client";
19
+
20
+ export default function AgentRoute() {
21
+ return <AgentTabsPage />;
22
+ }
23
+ ```
24
+
25
+ Die gemeinsame Seite bietet derzeit fünf Tabs:
26
+
27
+ - **Context** — Bereichsvorschau, Tokenbudget, geordnete Systemabschnitte mit Herkunft und Governance, Listen-/Treemap-Ansicht und der aktuelle Live-Thread-Snapshot.
28
+ - **Files** — verwendet `ResourcesPanel` für persönliche oder organisationsweite Ressourcen wieder.
29
+ - **Connections** — MCP-Serververwaltung und A2A-Liste entfernter Agents: was der Agent dieser App aufrufen kann.
30
+ - **Jobs** — wiederkehrende Jobs und Automatisierungen mit den vorhandenen Abläufen zum Pausieren/Fortsetzen, für Details und zum Löschen. Automatisierungen sind derzeit persönlich.
31
+ - **Access** — MCP-URL, eine A2A-Agent-Card wenn verfügbar, und gemeinsame Einrichtungsanleitungen; die vollständige Verbindung und den Token-Fallback gibt es unter `/mcp/connect`.
32
+
33
+ Der Umschalter **Personal / Organization** gibt den Tabs ihren Bereich.
34
+ Mitglieder können Organisationsdaten einsehen; die Organisationsverwaltung
35
+ bleibt dort, wo die gehostete Komponente diese Grenze durchsetzt, auf
36
+ Inhaber/Administratoren beschränkt. Das Ziel
37
+ sind prüfbarer, zuordenbarer und steuerbarer Kontext sowie eine klare Trennung
38
+ zwischen Fähigkeit und Zugriff. Die Seite ist eine dünne Hülle um vorhandene
39
+ Komponenten, Actions und Zugriffskontrollen, keine neue Admin-Konsole. Grants,
40
+ Bereichsänderung, Widerruf und Verlauf der Provenienz pro Iteration sind hier
41
+ noch nicht verfügbar.
42
+
9
43
  Agent-Native ist bewusst zusammensetzbar. Sie können den Agenten ohne großen Aufwand verwenden UI,
10
44
  Verwenden Sie UI ohne die integrierte Agent-Laufzeit oder verwenden Sie beide zusammen als Vollversion
11
45
  Anwendung.
@@ -117,6 +117,16 @@ Jede gehostete App verfügt auch über eine Hilfsseite unter
117
117
  `https://&lt;app&gt;/mcp/connect` mit dem kopierbaren URL und
118
118
  hostspezifische Registerkarten für Claude, ChatGPT, Cursor, Claude-Code, Codex und Andere.
119
119
 
120
+ ### Der In-App-Tab Access {#access-tab}
121
+
122
+ Apps, die `AgentTabsPage` einbinden, stellen denselben Verbindungsablauf im Tab
123
+ **Access** bereit. Er zeigt die MCP-URL, bei Verfügbarkeit eine A2A-Agent-Card
124
+ und die gemeinsamen Einrichtungsanleitungen für Claude, ChatGPT, Cursor, Claude
125
+ Code, Codex und andere Clients. Beginnen Sie dort und öffnen Sie `/mcp/connect`
126
+ für den vollständigen Ablauf und den Token-Fallback. Dies ist eine Oberfläche
127
+ für die Verbindungseinrichtung, keine allgemeine Zugriffskonsole; Grants,
128
+ Bereichsänderung und Widerruf werden in diesem Tab noch nicht verwaltet.
129
+
120
130
  ### Claude und ChatGPT OAuth {#oauth}
121
131
 
122
132
  Claude / Claude Desktop: Fügen Sie einen benutzerdefinierten Connector hinzu, fügen Sie MCP URL ein und klicken Sie auf
@@ -6,6 +6,40 @@ search: "aplicación completa de chat enriquecido de agente sin cabeza BYO tiemp
6
6
 
7
7
  # Superficies de agentes
8
8
 
9
+ ## Espacio de trabajo completo del agente {#agent-page}
10
+
11
+ Cuando una aplicación completa necesita un lugar permanente para inspeccionar y
12
+ configurar su agente, monta `AgentTabsPage` en `/agent`. Añade la ruta a la
13
+ navegación de la aplicación y pasa `agentPageHref="/agent"` a `AgentSidebar` para
14
+ que los modos Resources y Settings enlacen a la página completa sin duplicar
15
+ estos flujos.
16
+
17
+ ```tsx filename="app/routes/agent.tsx"
18
+ import { AgentTabsPage } from "@agent-native/core/client";
19
+
20
+ export default function AgentRoute() {
21
+ return <AgentTabsPage />;
22
+ }
23
+ ```
24
+
25
+ La página compartida ofrece actualmente cinco pestañas:
26
+
27
+ - **Context** — vista previa del ámbito, presupuesto de tokens, secciones de sistema ordenadas con procedencia y gobierno, vista de lista/treemap y la instantánea del hilo activo más reciente.
28
+ - **Files** — vuelve a alojar `ResourcesPanel` para recursos personales o de la organización.
29
+ - **Connections** — gestión de servidores MCP y lista de agentes remotos A2A: lo que puede llamar el agente de esta aplicación.
30
+ - **Jobs** — trabajos recurrentes y automatizaciones con los flujos existentes de pausar/reanudar, detalles y borrar. Las automatizaciones son personales por ahora.
31
+ - **Access** — URL de MCP, tarjeta de agente A2A cuando existe y guías de configuración compartidas; el flujo completo y el token alternativo están en `/mcp/connect`.
32
+
33
+ El selector **Personal / Organization** proporciona el ámbito a las pestañas.
34
+ Los miembros pueden inspeccionar los datos de la organización, mientras que su
35
+ administración sigue restringida a propietarios/administradores donde el
36
+ componente alojado impone ese límite. El
37
+ objetivo es que el contexto sea inspeccionable, atribuible y gobernable, y
38
+ separar capacidad de acceso. La página es una capa fina sobre componentes,
39
+ acciones y comprobaciones existentes, no una nueva consola de administración.
40
+ Todavía no ofrece interfaz para grants, edición de ámbitos, revocación ni
41
+ historial de procedencia por iteración.
42
+
9
43
  Agent-Native es deliberadamente componible. Puedes utilizar el agente sin mucho UI,
10
44
  use el UI sin el tiempo de ejecución del agente integrado, o use ambos juntos como un completo
11
45
  solicitud.
@@ -117,6 +117,16 @@ Cada aplicación alojada también tiene una página de ayuda en
117
117
  `https://&lt;app&gt;/mcp/connect` con el URL copiable y
118
118
  pestañas específicas del host para Claude, ChatGPT, Cursor, Código Claude, Codex y Otros.
119
119
 
120
+ ### Pestaña Access dentro de la aplicación {#access-tab}
121
+
122
+ Las aplicaciones que montan `AgentTabsPage` ofrecen el mismo flujo de conexión
123
+ en la pestaña **Access**. Muestra la URL de MCP, una tarjeta del agente A2A si
124
+ está disponible y las guías compartidas para Claude, ChatGPT, Cursor, Claude
125
+ Code, Codex y otros clientes. Úsala como punto de partida dentro de la app y
126
+ abre `/mcp/connect` para el flujo completo y el token alternativo. Es una
127
+ interfaz de configuración de conexión, no una consola general de acceso: la
128
+ pestaña todavía no gestiona grants, edición de ámbitos ni revocación.
129
+
120
130
  ### Claude y ChatGPT OAuth {#oauth}
121
131
 
122
132
  Escritorio Claude / Claude: agregue un conector personalizado, pegue el MCP URL, haga clic
@@ -6,6 +6,40 @@ search: "Application complète de chat enrichi d'agent sans tête BYO runtime d'
6
6
 
7
7
  # Surfaces des agents
8
8
 
9
+ ## Espace de travail Agent complet {#agent-page}
10
+
11
+ Lorsqu'une application complète a besoin d'un endroit durable pour inspecter et
12
+ configurer son agent, montez `AgentTabsPage` sur `/agent`. Ajoutez la route à la
13
+ navigation de l'application et passez `agentPageHref="/agent"` à
14
+ `AgentSidebar` afin que les modes Resources et Settings puissent ouvrir la page
15
+ complète sans dupliquer ces flux.
16
+
17
+ ```tsx filename="app/routes/agent.tsx"
18
+ import { AgentTabsPage } from "@agent-native/core/client";
19
+
20
+ export default function AgentRoute() {
21
+ return <AgentTabsPage />;
22
+ }
23
+ ```
24
+
25
+ La page partagée propose actuellement cinq onglets :
26
+
27
+ - **Context** — aperçu du périmètre, budget de tokens, sections système ordonnées avec provenance et gouvernance, vue liste/treemap et dernière capture du fil actif.
28
+ - **Files** — réutilise `ResourcesPanel` pour les ressources personnelles ou de l'organisation.
29
+ - **Connections** — gestion des serveurs MCP et liste des agents distants A2A : ce que l'agent de l'application peut appeler.
30
+ - **Jobs** — tâches récurrentes et automatisations avec les flux existants de pause/reprise, détails et suppression. Les automatisations sont personnelles pour le moment.
31
+ - **Access** — URL MCP, fiche d'agent A2A si disponible et guides de configuration partagés ; le flux complet et le repli par jeton sont disponibles sur `/mcp/connect`.
32
+
33
+ Le sélecteur **Personal / Organization** fournit le périmètre aux onglets. Les
34
+ membres peuvent inspecter les données de l'organisation, tandis que sa gestion
35
+ reste réservée aux propriétaires/administrateurs là où le composant hébergé
36
+ applique cette limite. Le
37
+ but est de rendre le contexte inspectable, attribuable et gouvernable, tout en
38
+ séparant capacité et accès. La page est une fine enveloppe autour des
39
+ composants, actions et contrôles existants, pas une nouvelle console
40
+ d'administration. Elle ne fournit pas encore d'interface pour les grants, la
41
+ modification du périmètre, la révocation ou l'historique de provenance par itération.
42
+
9
43
  Agent-Native est délibérément composable. Vous pouvez utiliser l'agent sans trop dépenser UI,
10
44
  utilisez le UI sans le runtime d'agent intégré, ou utilisez les deux ensemble comme un ensemble complet
11
45
  application.
@@ -117,6 +117,17 @@ Chaque application hébergée dispose également d'une page d'aide à l'adresse
117
117
  `https://&lt;app&gt;/mcp/connect` avec le URL copiable et
118
118
  Onglets spécifiques à l'hôte pour Claude, ChatGPT, Cursor, Claude Code, Codex et autres.
119
119
 
120
+ ### L'onglet Access dans l'application {#access-tab}
121
+
122
+ Les applications qui montent `AgentTabsPage` proposent le même flux de connexion
123
+ dans l'onglet **Access**. Il affiche l'URL MCP, une fiche d'agent A2A si elle est
124
+ disponible et les guides de configuration communs pour Claude, ChatGPT, Cursor,
125
+ Claude Code, Codex et les autres clients. Utilisez-le comme point de départ dans
126
+ l'application, puis ouvrez `/mcp/connect` pour le flux complet et le repli par
127
+ jeton. Il s'agit d'une interface de configuration, pas d'une console générale
128
+ d'accès : l'onglet ne gère pas encore les grants, la modification du périmètre
129
+ ou la révocation.
130
+
120
131
  ### Claude et ChatGPT OAuth {#oauth}
121
132
 
122
133
  Claude / Claude Desktop : ajoutez un connecteur personnalisé, collez le MCP URL, cliquez
@@ -6,6 +6,37 @@ search: "हेडलेस एजेंट रिच चैट पूर्ण
6
6
 
7
7
  # एजेंट सतहें
8
8
 
9
+ ## पूरा Agent कार्यक्षेत्र {#agent-page}
10
+
11
+ जब किसी पूर्ण ऐप को अपने एजेंट को देखने और कॉन्फ़िगर करने के लिए स्थायी स्थान
12
+ चाहिए, तो `/agent` पर `AgentTabsPage` माउंट करें। ऐप नेविगेशन में यह रूट जोड़ें
13
+ और `AgentSidebar` को `agentPageHref="/agent"` दें, ताकि Resources और Settings
14
+ मोड इन प्रवाहों को दोहराए बिना पूरे पेज पर जा सकें।
15
+
16
+ ```tsx filename="app/routes/agent.tsx"
17
+ import { AgentTabsPage } from "@agent-native/core/client";
18
+
19
+ export default function AgentRoute() {
20
+ return <AgentTabsPage />;
21
+ }
22
+ ```
23
+
24
+ साझा पेज में अभी पाँच टैब हैं:
25
+
26
+ - **Context** — स्कोप प्रीव्यू, टोकन बजट, provenance और governance के साथ क्रमबद्ध सिस्टम सेक्शन, सूची/treemap दृश्य और नवीनतम live-thread snapshot।
27
+ - **Files** — व्यक्तिगत या संगठन संसाधनों के लिए मौजूदा `ResourcesPanel` को फिर से उपयोग करता है।
28
+ - **Connections** — MCP सर्वर प्रबंधन और A2A remote-agent सूची: यह ऐप का एजेंट क्या बुला सकता है।
29
+ - **Jobs** — मौजूदा pause/resume, विवरण और delete प्रवाहों के साथ scoped recurring jobs और automations। Automations अभी केवल व्यक्तिगत हैं।
30
+ - **Access** — MCP URL, उपलब्ध होने पर A2A agent card और साझा client setup guides; पूरा flow और token fallback `/mcp/connect` पर है।
31
+
32
+ **Personal / Organization** टॉगल टैब का scope तय करता है। सदस्य संगठन का डेटा
33
+ देख सकते हैं, जबकि जहाँ होस्ट किया गया component यह सीमा लागू करता है वहाँ
34
+ संगठन प्रबंधन केवल मालिकों/व्यवस्थापकों तक सीमित रहता है। लक्ष्य context को
35
+ inspectable, attributable और governable बनाना तथा capability को access से अलग
36
+ रखना है। यह पेज मौजूदा components, actions और access checks की पतली shell है,
37
+ नई admin console नहीं। Grants, scope editing, revocation या per-iteration
38
+ provenance history की UI अभी उपलब्ध नहीं है।
39
+
9
40
  Agent-Native जानबूझकर रचना योग्य है। आप एजेंट का उपयोग बहुत अधिक UI के बिना कर सकते हैं,
10
41
  अंतर्निहित एजेंट रनटाइम के बिना UI का उपयोग करें, या दोनों को पूर्ण रूप में एक साथ उपयोग करें
11
42
  आवेदन.
@@ -117,6 +117,15 @@ https://<your-app>.agent-native.com/mcp
117
117
  `https://&lt;app&gt;/mcp/connect` प्रतिलिपि योग्य URL और
118
118
  Claude, ChatGPT, कर्सर, Claude कोड, Codex और अन्य के लिए होस्ट-विशिष्ट टैब।
119
119
 
120
+ ### ऐप के अंदर Access टैब {#access-tab}
121
+
122
+ `AgentTabsPage` माउंट करने वाले ऐप **Access** टैब में यही कनेक्शन फ्लो देते हैं।
123
+ यह MCP URL, उपलब्ध होने पर A2A agent card और Claude, ChatGPT, Cursor, Claude
124
+ Code, Codex तथा अन्य clients के साझा setup guides दिखाता है। इसे ऐप के अंदर
125
+ शुरुआत के रूप में उपयोग करें और पूरे flow तथा token fallback के लिए
126
+ `/mcp/connect` खोलें। यह connection setup UI है, सामान्य access console नहीं;
127
+ टैब अभी grants, scope editing या revocation को manage नहीं करता।
128
+
120
129
  ### Claude और ChatGPT OAuth {#oauth}
121
130
 
122
131
  Claude / Claude डेस्कटॉप: एक कस्टम कनेक्टर जोड़ें, MCP URL पेस्ट करें, क्लिक करें
@@ -6,6 +6,38 @@ search: "ヘッドレス エージェント リッチ チャット フル アプ
6
6
 
7
7
  # エージェント サーフェス
8
8
 
9
+ ## フルページの Agent ワークスペース {#agent-page}
10
+
11
+ 完全なアプリケーションでエージェントを確認・設定する常設の場所が必要な
12
+ 場合は、`/agent` に `AgentTabsPage` をマウントします。アプリのナビゲーション
13
+ にこのルートを追加し、`AgentSidebar` に `agentPageHref="/agent"` を渡すと、
14
+ Resources と Settings から同じフローを重複させずにフルページへ移動できます。
15
+
16
+ ```tsx filename="app/routes/agent.tsx"
17
+ import { AgentTabsPage } from "@agent-native/core/client";
18
+
19
+ export default function AgentRoute() {
20
+ return <AgentTabsPage />;
21
+ }
22
+ ```
23
+
24
+ 共有ページには現在、5 つのタブがあります。
25
+
26
+ - **Context** — スコープのプレビュー、トークン予算、provenance・governance・source で整理された順序付きシステムセクション、リスト/treemap 表示、最新の live thread スナップショット。
27
+ - **Files** — 個人または組織のリソース用に既存の `ResourcesPanel` を再ホストします。
28
+ - **Connections** — MCP サーバー管理と A2A リモートエージェント一覧。アプリのエージェントが呼び出せるものを示します。
29
+ - **Jobs** — 既存の一時停止/再開、詳細、削除フローを備えたスコープ別の定期ジョブと自動化。自動化は現在個人用です。
30
+ - **Access** — MCP URL、利用可能なら A2A エージェントカード、共通のクライアント設定ガイドを表示します。完全な接続フローとトークンのフォールバックは `/mcp/connect` にあります。
31
+
32
+ ページの **Personal / Organization** 切り替えが各タブのスコープを指定します。
33
+ メンバーは組織データを確認できますが、ホストされたコンポーネントがその境界を
34
+ 適用する箇所では、組織管理は所有者/管理者に制限されます。
35
+ 目的はコンテキストを inspectable・attributable・governable にし、capability と
36
+ access を分離することです。このページは既存のコンポーネント、アクション、
37
+ アクセスチェックを再利用する薄いシェルであり、新しい管理コンソールでは
38
+ ありません。grants、スコープ編集、revoke、反復ごとの provenance 履歴の UI は
39
+ まだ提供していません。
40
+
9
41
  Agent-Native は意図的に構成可能です。 UI をあまり必要とせずにエージェントを使用できます。
10
42
  組み込みエージェント ランタイムなしで UI を使用するか、両方を完全なものとして一緒に使用します
11
43
  アプリケーション。
@@ -117,6 +117,16 @@ https://<your-app>.agent-native.com/mcp
117
117
  `https://&lt;app&gt;/mcp/connect` とコピー可能な URL および
118
118
  Claude、ChatGPT、カーソル、Claude コード、Codex、その他のホスト固有のタブ。
119
119
 
120
+ ### アプリ内の Access タブ {#access-tab}
121
+
122
+ `AgentTabsPage` をマウントするアプリでは、同じ接続フローを **Access** タブ
123
+ から利用できます。MCP URL、利用可能な場合は A2A エージェント カード、Claude、
124
+ ChatGPT、Cursor、Claude Code、Codex、その他のクライアント向けの共通設定ガイドを
125
+ 表示します。アプリ内の開始点として使い、完全なフローとトークンのフォールバック
126
+ には `/mcp/connect` を開きます。これは接続設定 UI であり、一般的なアクセス管理
127
+ コンソールではありません。grants、スコープ編集、revoke はこのタブではまだ管理
128
+ できません。
129
+
120
130
  ### Claude および ChatGPT OAuth {#oauth}
121
131
 
122
132
  Claude / Claude デスクトップ: カスタム コネクタを追加し、MCP URL を貼り付け、クリックします
@@ -6,6 +6,38 @@ search: "헤드리스 에이전트 리치 채팅 전체 앱 BYO 에이전트 런
6
6
 
7
7
  # 에이전트 표면
8
8
 
9
+ ## 전체 Agent 작업 공간 {#agent-page}
10
+
11
+ 전체 애플리케이션에서 에이전트를 검사하고 구성할 영구 공간이 필요하면
12
+ `/agent`에 `AgentTabsPage`를 마운트하세요. 앱 탐색에 이 경로를 추가하고
13
+ `AgentSidebar`에 `agentPageHref="/agent"`를 전달하면 Resources 및 Settings
14
+ 모드에서 흐름을 중복하지 않고 전체 페이지로 이동할 수 있습니다.
15
+
16
+ ```tsx filename="app/routes/agent.tsx"
17
+ import { AgentTabsPage } from "@agent-native/core/client";
18
+
19
+ export default function AgentRoute() {
20
+ return <AgentTabsPage />;
21
+ }
22
+ ```
23
+
24
+ 공유 페이지에는 현재 다섯 개의 탭이 있습니다.
25
+
26
+ - **Context** — 범위 미리보기, 토큰 예산, provenance·governance·source별 정렬된 시스템 섹션, 목록/treemap 보기, 최신 live-thread 스냅샷을 보여줍니다.
27
+ - **Files** — 개인 또는 조직 리소스에 기존 `ResourcesPanel`을 다시 호스팅합니다.
28
+ - **Connections** — MCP 서버 관리와 A2A 원격 에이전트 목록을 제공하며, 앱 에이전트가 호출할 수 있는 기능을 보여줍니다.
29
+ - **Jobs** — 기존 일시 중지/재개, 상세, 삭제 흐름을 사용하는 범위별 반복 작업과 자동화입니다. 자동화는 현재 개인용입니다.
30
+ - **Access** — MCP URL, 가능한 경우 A2A 에이전트 카드, 공통 클라이언트 설정 가이드를 보여줍니다. 전체 연결 흐름과 토큰 대체 경로는 `/mcp/connect`에 있습니다.
31
+
32
+ 페이지의 **Personal / Organization** 전환이 각 탭의 범위를 정합니다.
33
+ 구성원은 조직 데이터를 검사할 수 있지만, 호스팅된 컴포넌트가 이 경계를 적용하는
34
+ 곳에서는 조직 관리가 소유자/관리자로 제한됩니다. 목표는
35
+ 컨텍스트를 검사 가능하고 출처를 확인할 수 있으며 거버넌스 가능하게 만들고,
36
+ 기능(capability)과 접근(access)을 분리하는 것입니다. 이 페이지는 기존
37
+ 컴포넌트, 액션, 접근 검사를 재호스트하는 얇은 셸이며 새로운 관리자 콘솔이
38
+ 아닙니다. grants, 범위 편집, 취소 UI와 반복별 provenance 기록은 아직 제공하지
39
+ 않습니다.
40
+
9
41
  Agent-Native는 의도적으로 구성 가능합니다. UI를 많이 사용하지 않고도 에이전트를 사용할 수 있습니다,
10
42
  내장된 에이전트 런타임 없이 UI를 사용하거나 둘 다 전체로 함께 사용
11
43
  신청.
@@ -117,6 +117,15 @@ https://<your-app>.agent-native.com/mcp
117
117
  복사 가능한 URL가 있는 `https://&lt;app&gt;/mcp/connect` 및
118
118
  Claude, ChatGPT, 커서, Claude 코드, Codex 및 기타에 대한 호스트별 탭.
119
119
 
120
+ ### 앱 내 Access 탭 {#access-tab}
121
+
122
+ `AgentTabsPage`를 마운트하는 앱은 **Access** 탭에서 동일한 연결 흐름을
123
+ 제공합니다. MCP URL, 가능한 경우 A2A 에이전트 카드, Claude, ChatGPT, Cursor,
124
+ Claude Code, Codex 및 기타 클라이언트를 위한 공통 설정 가이드를 보여줍니다.
125
+ 앱 안에서 시작점으로 사용하고 전체 흐름과 토큰 대체 경로는 `/mcp/connect`에서
126
+ 여세요. 이 탭은 연결 설정 UI이지 일반 접근 제어 콘솔이 아니며, grants, 범위
127
+ 편집, 취소는 아직 관리하지 않습니다.
128
+
120
129
  ### Claude 및 ChatGPT OAuth {#oauth}
121
130
 
122
131
  Claude / Claude 데스크탑: 사용자 정의 커넥터를 추가하고 MCP URL를 붙여넣고 클릭하세요.
@@ -6,6 +6,39 @@ search: "aplicativo completo de bate-papo rico com agente sem cabeça BYO tempo
6
6
 
7
7
  # Superfícies do agente
8
8
 
9
+ ## Espaço de trabalho completo do Agent {#agent-page}
10
+
11
+ Quando um aplicativo completo precisa de um lugar permanente para inspecionar e
12
+ configurar seu agente, monte `AgentTabsPage` em `/agent`. Adicione a rota à
13
+ navegação do aplicativo e passe `agentPageHref="/agent"` para `AgentSidebar`,
14
+ para que os modos Resources e Settings apontem para a página completa sem
15
+ duplicar esses fluxos.
16
+
17
+ ```tsx filename="app/routes/agent.tsx"
18
+ import { AgentTabsPage } from "@agent-native/core/client";
19
+
20
+ export default function AgentRoute() {
21
+ return <AgentTabsPage />;
22
+ }
23
+ ```
24
+
25
+ A página compartilhada oferece atualmente cinco abas:
26
+
27
+ - **Context** — prévia do escopo, orçamento de tokens, seções de sistema ordenadas por procedência, governança e fonte, visualização em lista/treemap e o snapshot da thread ativa mais recente.
28
+ - **Files** — reutiliza `ResourcesPanel` para recursos pessoais ou da organização.
29
+ - **Connections** — gerenciamento de servidores MCP e lista de agentes remotos A2A: o que o agente deste app pode chamar.
30
+ - **Jobs** — jobs recorrentes e automações com os fluxos existentes de pausar/retomar, detalhes e excluir. As automações são pessoais por enquanto.
31
+ - **Access** — URL MCP, cartão de agente A2A quando disponível e guias compartilhados de configuração; o fluxo completo e o fallback de token ficam em `/mcp/connect`.
32
+
33
+ O seletor **Personal / Organization** fornece o escopo às abas. Os membros
34
+ podem inspecionar os dados da organização, enquanto sua administração continua
35
+ restrita a proprietários/administradores onde o componente hospedado impõe esse
36
+ limite. O objetivo é
37
+ tornar o contexto inspecionável, atribuível e governável, separando capacidade
38
+ de acesso. A página é uma camada fina sobre componentes, ações e verificações de
39
+ acesso existentes, não um novo console administrativo. Ela ainda não oferece UI
40
+ para grants, edição de escopo, revogação ou histórico de procedência por iteração.
41
+
9
42
  Agent-Native é deliberadamente combinável. Você pode usar o agente sem muito UI,
10
43
  use o UI sem o tempo de execução do agente integrado ou use os dois juntos como um pacote completo
11
44
  aplicativo.
@@ -117,6 +117,16 @@ Todo aplicativo hospedado também tem uma página auxiliar em
117
117
  `https://&lt;app&gt;/mcp/connect` com o URL copiável e
118
118
  guias específicas do host para Claude, ChatGPT, Cursor, Código Claude, Codex e Outros.
119
119
 
120
+ ### A aba Access no aplicativo {#access-tab}
121
+
122
+ Os aplicativos que montam `AgentTabsPage` oferecem o mesmo fluxo de conexão na
123
+ aba **Access**. Ela mostra a URL MCP, um cartão de agente A2A quando disponível e
124
+ os guias compartilhados de configuração para Claude, ChatGPT, Cursor, Claude
125
+ Code, Codex e outros clientes. Use-a como ponto de partida dentro do app e abra
126
+ `/mcp/connect` para o fluxo completo e o fallback de token. É uma UI de
127
+ configuração de conexão, não um console geral de acesso: a aba ainda não gerencia
128
+ grants, edição de escopo ou revogação.
129
+
120
130
  ### Claude e ChatGPT OAuth {#oauth}
121
131
 
122
132
  Claude / Claude Desktop: adicione um conector personalizado, cole o MCP URL, clique em
@@ -6,6 +6,35 @@ search: "无头代理丰富聊天完整应用程序 BYO 代理运行时 AgentCha
6
6
 
7
7
  # 特工表面
8
8
 
9
+ ## 完整的 Agent 工作区 {#agent-page}
10
+
11
+ 当完整应用需要一个持久位置来检查和配置代理时,请在 `/agent` 挂载
12
+ `AgentTabsPage`。将此路由加入应用导航,并向 `AgentSidebar` 传入
13
+ `agentPageHref="/agent"`,这样 Resources 和 Settings 模式就可以链接到完整
14
+ 页面,而不必重复这些流程。
15
+
16
+ ```tsx filename="app/routes/agent.tsx"
17
+ import { AgentTabsPage } from "@agent-native/core/client";
18
+
19
+ export default function AgentRoute() {
20
+ return <AgentTabsPage />;
21
+ }
22
+ ```
23
+
24
+ 共享页面目前提供五个选项卡:
25
+
26
+ - **Context** — 显示范围预览、令牌预算、按来源/治理/来源引用分组的有序系统部分、列表/treemap 视图和最新实时线程快照。
27
+ - **Files** — 为个人或组织资源重新托管现有的 `ResourcesPanel`。
28
+ - **Connections** — MCP 服务器管理和 A2A 远程代理列表,即此应用的代理可以调用什么。
29
+ - **Jobs** — 使用现有暂停/恢复、详情和删除流程的范围化定期作业与自动化。自动化目前仅属于个人。
30
+ - **Access** — MCP URL、可用时的 A2A 代理卡片以及共享客户端设置指南;完整连接流程和令牌回退位于 `/mcp/connect`。
31
+
32
+ 页面级 **Personal / Organization** 切换器为选项卡提供范围。成员可以检查组织
33
+ 数据;在托管组件实施该边界的地方,组织管理仍仅限所有者/管理员。目标是让上下文
34
+ 可检查、可归因、可治理,并将能力与访问分开。该页面只是对现有组件、操作和
35
+ 访问检查的薄封装,不是新的管理控制台。目前还没有 grants、范围编辑、撤销
36
+ 界面或逐迭代 provenance 历史。
37
+
9
38
  Agent-Native 是故意可组合的。不用太多就可以使用代理UI,
10
39
  在没有内置代理运行时的情况下使用 UI,或者将两者一起用作完整的
11
40
  应用程序。
@@ -117,6 +117,14 @@ https://<your-app>.agent-native.com/mcp
117
117
  `https://&lt;app&gt;/mcp/connect` 与可复制的 URL 和
118
118
  Claude、ChatGPT、光标、Claude 代码、Codex 和其他的主机特定选项卡。
119
119
 
120
+ ### 应用内的 Access 选项卡 {#access-tab}
121
+
122
+ 挂载 `AgentTabsPage` 的应用也会在 **Access** 选项卡中提供相同的连接流程。
123
+ 它显示 MCP URL、可用时的 A2A 代理卡片,以及 Claude、ChatGPT、Cursor、Claude
124
+ Code、Codex 和其他客户端的共享设置指南。可将它作为应用内的起点,并打开
125
+ `/mcp/connect` 查看完整流程和令牌回退。这是连接设置界面,不是通用访问控制
126
+ 台;该选项卡目前还不管理 grants、范围编辑或撤销。
127
+
120
128
  ### Claude 和 ChatGPT OAuth {#oauth}
121
129
 
122
130
  Claude / Claude 桌面:添加自定义连接器,粘贴 MCP URL,点击
@@ -6,6 +6,35 @@ search: "無頭代理豐富聊天完整應用程式 BYO 代理執行時 AgentCha
6
6
 
7
7
  # 代理表面
8
8
 
9
+ ## 完整的 Agent 工作區 {#agent-page}
10
+
11
+ 當完整應用程式需要一個持久位置來檢查和設定代理時,請在 `/agent` 掛載
12
+ `AgentTabsPage`。將此路由加入應用程式導覽,並向 `AgentSidebar` 傳入
13
+ `agentPageHref="/agent"`,這樣 Resources 和 Settings 模式就能連結到完整頁面,
14
+ 而不必重複這些流程。
15
+
16
+ ```tsx filename="app/routes/agent.tsx"
17
+ import { AgentTabsPage } from "@agent-native/core/client";
18
+
19
+ export default function AgentRoute() {
20
+ return <AgentTabsPage />;
21
+ }
22
+ ```
23
+
24
+ 共用頁面目前提供五個分頁:
25
+
26
+ - **Context** — 顯示範圍預覽、權杖預算、按來源/治理/來源參照分組的有序系統區段、清單/treemap 檢視和最新即時執行緒快照。
27
+ - **Files** — 為個人或組織資源重新託管現有的 `ResourcesPanel`。
28
+ - **Connections** — MCP 伺服器管理和 A2A 遠端代理清單,也就是此應用程式的代理可以呼叫什麼。
29
+ - **Jobs** — 使用現有暫停/恢復、詳細資料和刪除流程的範圍化定期工作與自動化。自動化目前僅限個人。
30
+ - **Access** — MCP URL、可用時的 A2A 代理卡片以及共用用戶端設定指南;完整連線流程和權杖備援位於 `/mcp/connect`。
31
+
32
+ 頁面級 **Personal / Organization** 切換器為分頁提供範圍。成員可以檢查組織
33
+ 資料;在託管元件實施該界線的地方,組織管理仍僅限擁有者/管理員。目標是讓內容可
34
+ 檢查、可歸因、可治理,並將能力與存取分開。此頁面只是對現有元件、動作和
35
+ 存取檢查的薄封裝,不是新的管理主控台。目前還沒有 grants、範圍編輯、撤銷
36
+ 介面或逐次迭代的 provenance 歷史。
37
+
9
38
  Agent-Native 是故意可組合的。不用太多就可以使用代理 UI,
10
39
  在沒有內建代理執行時的情況下使用 UI,或者將兩者一起用作完整的
11
40
  應用程式。
@@ -117,6 +117,14 @@ https://<your-app>.agent-native.com/mcp
117
117
  `https://&lt;app&gt;/mcp/connect` 與可複製的 URL 和
118
118
  Claude、ChatGPT、游標、Claude 程式碼、Codex 和其他的主機特定分頁。
119
119
 
120
+ ### 應用程式內的 Access 分頁 {#access-tab}
121
+
122
+ 掛載 `AgentTabsPage` 的應用程式也會在 **Access** 分頁提供相同的連線流程。
123
+ 它會顯示 MCP URL、可用時的 A2A 代理卡片,以及 Claude、ChatGPT、Cursor、Claude
124
+ Code、Codex 和其他用戶端的共用設定指南。可將它作為應用程式內的起點,並開啟
125
+ `/mcp/connect` 查看完整流程和權杖備援。這是連線設定介面,不是通用存取控制台;
126
+ 此分頁目前還不管理 grants、範圍編輯或撤銷。
127
+
120
128
  ### Claude 和 ChatGPT OAuth {#oauth}
121
129
 
122
130
  Claude / Claude 桌面:新增自訂連線器,貼上 MCP URL,點選
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@agent-native/core",
3
- "version": "0.99.3",
3
+ "version": "0.100.1",
4
4
  "description": "Framework for agent-native application development — where AI agents and UI share SQL state, actions, and context",
5
5
  "homepage": "https://github.com/BuilderIO/agent-native#readme",
6
6
  "bugs": {
@@ -74,6 +74,17 @@ export default function IndexPage() {
74
74
  {t("home.settingsDescription")}
75
75
  </p>
76
76
  </Link>
77
+ <Link
78
+ to="/agent"
79
+ className="group rounded-lg border border-border/50 px-4 py-3 hover:bg-accent/50 transition-colors"
80
+ >
81
+ <p className="text-[13px] font-medium text-foreground">
82
+ {t("settings.agentTitle")}
83
+ </p>
84
+ <p className="text-[12px] text-muted-foreground mt-0.5">
85
+ {t("settings.agentDescription")}
86
+ </p>
87
+ </Link>
77
88
  </div>
78
89
  </div>
79
90
  </div>
@@ -0,0 +1,33 @@
1
+ import { AgentTabsPage, useT } from "@agent-native/core/client";
2
+ import { Link } from "react-router";
3
+
4
+ export function meta() {
5
+ return [{ title: "Agent - {{APP_TITLE}}" }];
6
+ }
7
+
8
+ export default function AgentPage() {
9
+ const t = useT();
10
+
11
+ return (
12
+ <main className="min-h-screen bg-background px-6 py-10">
13
+ <div className="mx-auto w-full max-w-5xl space-y-6">
14
+ <div className="space-y-2">
15
+ <Link
16
+ to="/settings"
17
+ className="text-[13px] text-muted-foreground hover:text-foreground"
18
+ >
19
+ {t("settings.title")}
20
+ </Link>
21
+ <h1 className="text-2xl font-semibold tracking-tight text-foreground">
22
+ {t("settings.agentTitle")}
23
+ </h1>
24
+ <p className="text-[14px] leading-relaxed text-muted-foreground">
25
+ {t("settings.agentDescription")}
26
+ </p>
27
+ </div>
28
+
29
+ <AgentTabsPage className="min-h-[640px] rounded-lg border border-border/50" />
30
+ </div>
31
+ </main>
32
+ );
33
+ }
@@ -57,6 +57,12 @@ in the moment of agent use.
57
57
  missing-secret states, OAuth grants, and provider connection health.
58
58
  - **Agent UX kit**: sidebar, composer, staged context, mentions, voice, human
59
59
  approval, generative UI, progress, and screen-state exposure.
60
+ - **Agent page kit**: the full-page `/agent` surface (`AgentTabsPage` from
61
+ `@agent-native/core/client`) with Context, Files, Connections, Jobs, and
62
+ Access tabs plus a Personal/Organization scope toggle. The canonical home
63
+ for context transparency, MCP servers, A2A remote agents, recurring
64
+ jobs/automations, and external-client connect flows. See the `agent-page`
65
+ skill.
60
66
  - **History and recovery kit**: audit log, activity feed, version history,
61
67
  checkpoints, undo, redo, restore, and proof-of-done.
62
68
  - **Comments and review kit**: anchored comments, pins, mentions, review