@agent-native/core 0.98.17 → 0.99.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 (583) hide show
  1. package/corpus/README.md +2 -2
  2. package/corpus/core/CHANGELOG.md +25 -0
  3. package/corpus/core/docs/content/actions.mdx +1 -1
  4. package/corpus/core/docs/content/authentication.mdx +1 -1
  5. package/corpus/core/docs/content/dispatch.mdx +3 -3
  6. package/corpus/core/docs/content/external-agents.mdx +30 -19
  7. package/corpus/core/docs/content/locales/ar-SA/actions.mdx +1 -1
  8. package/corpus/core/docs/content/locales/ar-SA/authentication.mdx +1 -1
  9. package/corpus/core/docs/content/locales/ar-SA/dispatch.mdx +3 -3
  10. package/corpus/core/docs/content/locales/ar-SA/external-agents.mdx +23 -19
  11. package/corpus/core/docs/content/locales/ar-SA/mcp-clients.mdx +31 -3
  12. package/corpus/core/docs/content/locales/ar-SA/mcp-protocol.mdx +29 -15
  13. package/corpus/core/docs/content/locales/ar-SA/plan-plugin.mdx +3 -3
  14. package/corpus/core/docs/content/locales/ar-SA/server.mdx +2 -2
  15. package/corpus/core/docs/content/locales/ar-SA/skills-guide.mdx +1 -1
  16. package/corpus/core/docs/content/locales/ar-SA/template-assets.mdx +1 -1
  17. package/corpus/core/docs/content/locales/ar-SA/template-dispatch.mdx +2 -2
  18. package/corpus/core/docs/content/locales/ar-SA/template-plan.mdx +3 -3
  19. package/corpus/core/docs/content/locales/de-DE/actions.mdx +1 -1
  20. package/corpus/core/docs/content/locales/de-DE/authentication.mdx +1 -1
  21. package/corpus/core/docs/content/locales/de-DE/dispatch.mdx +3 -3
  22. package/corpus/core/docs/content/locales/de-DE/external-agents.mdx +23 -19
  23. package/corpus/core/docs/content/locales/de-DE/mcp-clients.mdx +37 -3
  24. package/corpus/core/docs/content/locales/de-DE/mcp-protocol.mdx +29 -15
  25. package/corpus/core/docs/content/locales/de-DE/plan-plugin.mdx +3 -3
  26. package/corpus/core/docs/content/locales/de-DE/server.mdx +2 -2
  27. package/corpus/core/docs/content/locales/de-DE/skills-guide.mdx +1 -1
  28. package/corpus/core/docs/content/locales/de-DE/template-assets.mdx +1 -1
  29. package/corpus/core/docs/content/locales/de-DE/template-dispatch.mdx +2 -2
  30. package/corpus/core/docs/content/locales/de-DE/template-plan.mdx +3 -3
  31. package/corpus/core/docs/content/locales/es-ES/actions.mdx +1 -1
  32. package/corpus/core/docs/content/locales/es-ES/authentication.mdx +1 -1
  33. package/corpus/core/docs/content/locales/es-ES/dispatch.mdx +3 -3
  34. package/corpus/core/docs/content/locales/es-ES/external-agents.mdx +32 -19
  35. package/corpus/core/docs/content/locales/es-ES/mcp-clients.mdx +17 -3
  36. package/corpus/core/docs/content/locales/es-ES/mcp-protocol.mdx +38 -15
  37. package/corpus/core/docs/content/locales/es-ES/plan-plugin.mdx +3 -3
  38. package/corpus/core/docs/content/locales/es-ES/server.mdx +2 -2
  39. package/corpus/core/docs/content/locales/es-ES/skills-guide.mdx +1 -1
  40. package/corpus/core/docs/content/locales/es-ES/template-assets.mdx +1 -1
  41. package/corpus/core/docs/content/locales/es-ES/template-dispatch.mdx +2 -2
  42. package/corpus/core/docs/content/locales/es-ES/template-plan.mdx +3 -3
  43. package/corpus/core/docs/content/locales/fr-FR/actions.mdx +1 -1
  44. package/corpus/core/docs/content/locales/fr-FR/authentication.mdx +1 -1
  45. package/corpus/core/docs/content/locales/fr-FR/dispatch.mdx +3 -3
  46. package/corpus/core/docs/content/locales/fr-FR/external-agents.mdx +23 -19
  47. package/corpus/core/docs/content/locales/fr-FR/mcp-clients.mdx +17 -3
  48. package/corpus/core/docs/content/locales/fr-FR/mcp-protocol.mdx +29 -15
  49. package/corpus/core/docs/content/locales/fr-FR/plan-plugin.mdx +3 -3
  50. package/corpus/core/docs/content/locales/fr-FR/server.mdx +2 -2
  51. package/corpus/core/docs/content/locales/fr-FR/skills-guide.mdx +1 -1
  52. package/corpus/core/docs/content/locales/fr-FR/template-assets.mdx +1 -1
  53. package/corpus/core/docs/content/locales/fr-FR/template-dispatch.mdx +2 -2
  54. package/corpus/core/docs/content/locales/fr-FR/template-plan.mdx +3 -3
  55. package/corpus/core/docs/content/locales/hi-IN/actions.mdx +1 -1
  56. package/corpus/core/docs/content/locales/hi-IN/authentication.mdx +1 -1
  57. package/corpus/core/docs/content/locales/hi-IN/dispatch.mdx +3 -3
  58. package/corpus/core/docs/content/locales/hi-IN/external-agents.mdx +31 -19
  59. package/corpus/core/docs/content/locales/hi-IN/mcp-clients.mdx +17 -3
  60. package/corpus/core/docs/content/locales/hi-IN/mcp-protocol.mdx +36 -15
  61. package/corpus/core/docs/content/locales/hi-IN/plan-plugin.mdx +3 -3
  62. package/corpus/core/docs/content/locales/hi-IN/server.mdx +2 -2
  63. package/corpus/core/docs/content/locales/hi-IN/skills-guide.mdx +1 -1
  64. package/corpus/core/docs/content/locales/hi-IN/template-assets.mdx +1 -1
  65. package/corpus/core/docs/content/locales/hi-IN/template-dispatch.mdx +2 -2
  66. package/corpus/core/docs/content/locales/hi-IN/template-plan.mdx +3 -3
  67. package/corpus/core/docs/content/locales/ja-JP/actions.mdx +1 -1
  68. package/corpus/core/docs/content/locales/ja-JP/authentication.mdx +1 -1
  69. package/corpus/core/docs/content/locales/ja-JP/dispatch.mdx +3 -3
  70. package/corpus/core/docs/content/locales/ja-JP/external-agents.mdx +23 -19
  71. package/corpus/core/docs/content/locales/ja-JP/mcp-clients.mdx +34 -3
  72. package/corpus/core/docs/content/locales/ja-JP/mcp-protocol.mdx +29 -15
  73. package/corpus/core/docs/content/locales/ja-JP/plan-plugin.mdx +3 -3
  74. package/corpus/core/docs/content/locales/ja-JP/server.mdx +2 -2
  75. package/corpus/core/docs/content/locales/ja-JP/skills-guide.mdx +1 -1
  76. package/corpus/core/docs/content/locales/ja-JP/template-assets.mdx +1 -1
  77. package/corpus/core/docs/content/locales/ja-JP/template-dispatch.mdx +2 -2
  78. package/corpus/core/docs/content/locales/ja-JP/template-plan.mdx +3 -3
  79. package/corpus/core/docs/content/locales/ko-KR/actions.mdx +1 -1
  80. package/corpus/core/docs/content/locales/ko-KR/authentication.mdx +1 -1
  81. package/corpus/core/docs/content/locales/ko-KR/dispatch.mdx +3 -3
  82. package/corpus/core/docs/content/locales/ko-KR/external-agents.mdx +30 -19
  83. package/corpus/core/docs/content/locales/ko-KR/mcp-clients.mdx +33 -3
  84. package/corpus/core/docs/content/locales/ko-KR/mcp-protocol.mdx +36 -15
  85. package/corpus/core/docs/content/locales/ko-KR/plan-plugin.mdx +3 -3
  86. package/corpus/core/docs/content/locales/ko-KR/server.mdx +2 -2
  87. package/corpus/core/docs/content/locales/ko-KR/skills-guide.mdx +1 -1
  88. package/corpus/core/docs/content/locales/ko-KR/template-assets.mdx +1 -1
  89. package/corpus/core/docs/content/locales/ko-KR/template-dispatch.mdx +2 -2
  90. package/corpus/core/docs/content/locales/ko-KR/template-plan.mdx +3 -3
  91. package/corpus/core/docs/content/locales/pt-BR/actions.mdx +1 -1
  92. package/corpus/core/docs/content/locales/pt-BR/authentication.mdx +1 -1
  93. package/corpus/core/docs/content/locales/pt-BR/dispatch.mdx +3 -3
  94. package/corpus/core/docs/content/locales/pt-BR/external-agents.mdx +32 -19
  95. package/corpus/core/docs/content/locales/pt-BR/mcp-clients.mdx +34 -3
  96. package/corpus/core/docs/content/locales/pt-BR/mcp-protocol.mdx +32 -15
  97. package/corpus/core/docs/content/locales/pt-BR/plan-plugin.mdx +3 -3
  98. package/corpus/core/docs/content/locales/pt-BR/server.mdx +2 -2
  99. package/corpus/core/docs/content/locales/pt-BR/skills-guide.mdx +1 -1
  100. package/corpus/core/docs/content/locales/pt-BR/template-assets.mdx +1 -1
  101. package/corpus/core/docs/content/locales/pt-BR/template-dispatch.mdx +2 -2
  102. package/corpus/core/docs/content/locales/pt-BR/template-plan.mdx +3 -3
  103. package/corpus/core/docs/content/locales/zh-CN/actions.mdx +1 -1
  104. package/corpus/core/docs/content/locales/zh-CN/authentication.mdx +1 -1
  105. package/corpus/core/docs/content/locales/zh-CN/dispatch.mdx +3 -3
  106. package/corpus/core/docs/content/locales/zh-CN/external-agents.mdx +23 -19
  107. package/corpus/core/docs/content/locales/zh-CN/mcp-clients.mdx +28 -3
  108. package/corpus/core/docs/content/locales/zh-CN/mcp-protocol.mdx +29 -15
  109. package/corpus/core/docs/content/locales/zh-CN/plan-plugin.mdx +3 -3
  110. package/corpus/core/docs/content/locales/zh-CN/server.mdx +2 -2
  111. package/corpus/core/docs/content/locales/zh-CN/skills-guide.mdx +1 -1
  112. package/corpus/core/docs/content/locales/zh-CN/template-assets.mdx +1 -1
  113. package/corpus/core/docs/content/locales/zh-CN/template-dispatch.mdx +2 -2
  114. package/corpus/core/docs/content/locales/zh-CN/template-plan.mdx +3 -3
  115. package/corpus/core/docs/content/locales/zh-TW/actions.mdx +1 -1
  116. package/corpus/core/docs/content/locales/zh-TW/authentication.mdx +1 -1
  117. package/corpus/core/docs/content/locales/zh-TW/dispatch.mdx +3 -3
  118. package/corpus/core/docs/content/locales/zh-TW/external-agents.mdx +23 -19
  119. package/corpus/core/docs/content/locales/zh-TW/mcp-clients.mdx +28 -3
  120. package/corpus/core/docs/content/locales/zh-TW/mcp-protocol.mdx +30 -15
  121. package/corpus/core/docs/content/locales/zh-TW/plan-plugin.mdx +3 -3
  122. package/corpus/core/docs/content/locales/zh-TW/server.mdx +2 -2
  123. package/corpus/core/docs/content/locales/zh-TW/skills-guide.mdx +1 -1
  124. package/corpus/core/docs/content/locales/zh-TW/template-assets.mdx +1 -1
  125. package/corpus/core/docs/content/locales/zh-TW/template-dispatch.mdx +2 -2
  126. package/corpus/core/docs/content/locales/zh-TW/template-plan.mdx +3 -3
  127. package/corpus/core/docs/content/mcp-clients.mdx +31 -4
  128. package/corpus/core/docs/content/mcp-protocol.mdx +35 -15
  129. package/corpus/core/docs/content/plan-plugin.mdx +3 -3
  130. package/corpus/core/docs/content/server.mdx +2 -2
  131. package/corpus/core/docs/content/skills-guide.mdx +1 -1
  132. package/corpus/core/docs/content/template-assets.mdx +1 -1
  133. package/corpus/core/docs/content/template-dispatch.mdx +2 -2
  134. package/corpus/core/docs/content/template-plan.mdx +3 -3
  135. package/corpus/core/package.json +1 -1
  136. package/corpus/core/src/a2a/client.ts +3 -0
  137. package/corpus/core/src/a2a/handlers.ts +95 -7
  138. package/corpus/core/src/agent/production-agent.ts +21 -0
  139. package/corpus/core/src/cli/connect.ts +50 -24
  140. package/corpus/core/src/cli/mcp-config-writers.ts +10 -0
  141. package/corpus/core/src/cli/mcp.ts +5 -5
  142. package/corpus/core/src/cli/pr-visual-recap-workflow.ts +1 -1
  143. package/corpus/core/src/cli/skills-content/assets-skill.ts +1 -1
  144. package/corpus/core/src/cli/skills-content/design-exploration-skill.ts +1 -1
  145. package/corpus/core/src/cli/skills-content/help.ts +1 -1
  146. package/corpus/core/src/cli/skills-content/plan-setup-auth.ts +1 -1
  147. package/corpus/core/src/cli/skills-content/visual-plan-skill.ts +1 -1
  148. package/corpus/core/src/cli/skills-content/visual-recap-skill.ts +2 -2
  149. package/corpus/core/src/cli/skills.ts +23 -12
  150. package/corpus/core/src/client/analytics.ts +13 -0
  151. package/corpus/core/src/client/resources/McpIntegrationDialog.tsx +5 -0
  152. package/corpus/core/src/client/resources/mcp-integration-catalog.ts +17 -0
  153. package/corpus/core/src/embedding/agent.ts +8 -6
  154. package/corpus/core/src/localization/default-messages.ts +7 -0
  155. package/corpus/core/src/mcp/ask-app-inline-tasks.ts +125 -0
  156. package/corpus/core/src/mcp/build-server.ts +65 -3
  157. package/corpus/core/src/mcp/builtin-tools.ts +186 -22
  158. package/corpus/core/src/mcp/connect-route.ts +17 -14
  159. package/corpus/core/src/mcp/oauth-route.ts +38 -13
  160. package/corpus/core/src/mcp/route-paths.ts +34 -0
  161. package/corpus/core/src/mcp/server.ts +21 -10
  162. package/corpus/core/src/mcp/stdio.ts +34 -16
  163. package/corpus/core/src/mcp/workspace-resolve.ts +2 -1
  164. package/corpus/core/src/mcp-client/manager.ts +5 -3
  165. package/corpus/core/src/mcp-client/remote-store.ts +10 -10
  166. package/corpus/core/src/server/agent-chat/action-filters-a2a.ts +13 -0
  167. package/corpus/core/src/server/agent-chat-plugin.ts +42 -9
  168. package/corpus/core/src/server/agent-teams.ts +17 -0
  169. package/corpus/core/src/server/auth.ts +22 -6
  170. package/corpus/core/src/server/core-routes-plugin.ts +30 -24
  171. package/corpus/core/src/server/csrf.ts +17 -0
  172. package/corpus/core/src/server/framework-request-handler.ts +8 -2
  173. package/corpus/core/src/server/google-oauth.ts +12 -2
  174. package/corpus/core/src/server/http-response-telemetry.ts +6 -1
  175. package/corpus/core/src/server/recap-image-route.ts +3 -3
  176. package/corpus/core/src/server/security-headers.ts +7 -1
  177. package/corpus/core/src/server/ssr-handler.ts +2 -0
  178. package/corpus/core/src/shared/cache-control.ts +6 -4
  179. package/corpus/core/src/templates/default/.agents/skills/security/SKILL.md +10 -0
  180. package/corpus/core/src/templates/workspace-core/.agents/skills/authentication/SKILL.md +15 -6
  181. package/corpus/core/src/templates/workspace-core/.agents/skills/external-agents/SKILL.md +16 -10
  182. package/corpus/core/src/templates/workspace-core/.agents/skills/performance/SKILL.md +20 -1
  183. package/corpus/core/src/templates/workspace-core/.agents/skills/security/SKILL.md +10 -0
  184. package/corpus/templates/analytics/.agents/skills/security/SKILL.md +10 -0
  185. package/corpus/templates/analytics/app/assets/replay-cursor.svg +17 -0
  186. package/corpus/templates/analytics/app/components/dashboard/SqlChart.tsx +4 -3
  187. package/corpus/templates/analytics/app/global.css +71 -4
  188. package/corpus/templates/analytics/app/pages/adhoc/sql-dashboard/DashboardFilterBar.tsx +32 -4
  189. package/corpus/templates/analytics/app/pages/monitoring/errors/IssueDetail.tsx +1 -1
  190. package/corpus/templates/analytics/app/pages/sessions/SessionDetailPage.tsx +49 -11
  191. package/corpus/templates/analytics/app/pages/sessions/SessionsPage.tsx +4 -6
  192. package/corpus/templates/analytics/changelog/2026-07-13-all-time-dashboard-filters-no-longer-send-invalid-dates-to-b.md +6 -0
  193. package/corpus/templates/analytics/changelog/2026-07-13-daily-dashboard-emails-recover-more-reliably-from-serverless.md +6 -0
  194. package/corpus/templates/analytics/changelog/2026-07-13-error-issue-titles-wrap-instead-of-overflowing.md +6 -0
  195. package/corpus/templates/analytics/changelog/2026-07-13-saving-a-new-dashboard-view-no-longer-fails-with-a-server-er.md +6 -0
  196. package/corpus/templates/analytics/changelog/2026-07-13-session-replay-cursors-stay-hidden-until-their-first-recorde.md +6 -0
  197. package/corpus/templates/analytics/changelog/2026-07-13-session-replay-links-now-support-cmd-click-and-middle-click-.md +6 -0
  198. package/corpus/templates/analytics/changelog/2026-07-13-session-replays-keep-a-visible-mac-style-cursor-over-the-vis.md +6 -0
  199. package/corpus/templates/analytics/server/jobs/dashboard-report.ts +21 -2
  200. package/corpus/templates/analytics/server/lib/dashboard-report-subscriptions.ts +57 -1
  201. package/corpus/templates/analytics/server/lib/dashboard-report.ts +266 -28
  202. package/corpus/templates/analytics/server/lib/dashboards-store.ts +43 -4
  203. package/corpus/templates/analytics/server/lib/error-capture.ts +24 -5
  204. package/corpus/templates/analytics/server/plugins/agent-chat.ts +5 -0
  205. package/corpus/templates/analytics/server/routes/[...page].get.ts +0 -2
  206. package/corpus/templates/assets/.agents/skills/security/SKILL.md +10 -0
  207. package/corpus/templates/assets/agent-native.app-skill.json +1 -1
  208. package/corpus/templates/brain/.agents/skills/security/SKILL.md +10 -0
  209. package/corpus/templates/calendar/.agents/skills/security/SKILL.md +10 -0
  210. package/corpus/templates/calendar/AGENTS.md +2 -1
  211. package/corpus/templates/calendar/app/components/calendar/EventDetailPopover.tsx +0 -19
  212. package/corpus/templates/calendar/app/lib/attendee-local-time.ts +14 -5
  213. package/corpus/templates/calendar/changelog/2026-07-13-your-local-time-now-follows-your-browser-timezone-and-event-.md +6 -0
  214. package/corpus/templates/chat/.agents/skills/security/SKILL.md +10 -0
  215. package/corpus/templates/clips/.agents/skills/recording/SKILL.md +7 -2
  216. package/corpus/templates/clips/.agents/skills/security/SKILL.md +10 -0
  217. package/corpus/templates/clips/AGENTS.md +7 -0
  218. package/corpus/templates/clips/actions/list-meetings.ts +19 -4
  219. package/corpus/templates/clips/actions/start-meeting-recording.ts +7 -1
  220. package/corpus/templates/clips/app/components/library/recording-card.tsx +27 -26
  221. package/corpus/templates/clips/app/components/library/space-card.tsx +4 -6
  222. package/corpus/templates/clips/app/components/meetings/transcript-bubbles.tsx +75 -78
  223. package/corpus/templates/clips/app/components/recorder/confetti-canvas.tsx +18 -1
  224. package/corpus/templates/clips/app/components/recorder/recorder-engine.ts +6 -12
  225. package/corpus/templates/clips/app/components/recorder/recording-toolbar.tsx +19 -2
  226. package/corpus/templates/clips/app/lib/camera-composite.ts +70 -10
  227. package/corpus/templates/clips/app/routes/_app.meetings.$meetingId.tsx +1 -1
  228. package/corpus/templates/clips/app/routes/record.tsx +5 -25
  229. package/corpus/templates/clips/changelog/2026-07-13-clips-desktop-now-requires-macos-13-for-native-capture.md +6 -0
  230. package/corpus/templates/clips/changelog/2026-07-13-clips-hide-solo-meeting-reminders.md +6 -0
  231. package/corpus/templates/clips/changelog/2026-07-13-clips-now-removes-duplicate-mic-and-system-transcript-turns-.md +6 -0
  232. package/corpus/templates/clips/changelog/2026-07-13-desktop-recordings-run-cooler-and-quieter-live-transcription.md +6 -0
  233. package/corpus/templates/clips/changelog/2026-07-13-meeting-recordings-now-stop-after-a-calendar-meeting-ends-an.md +6 -0
  234. package/corpus/templates/clips/changelog/2026-07-13-meeting-transcripts-now-use-a-clean-agent-chat-style-reading.md +6 -0
  235. package/corpus/templates/clips/changelog/2026-07-13-screen-recordings-use-less-processing-power-during-longer-ca.md +6 -0
  236. package/corpus/templates/clips/chrome-extension/src/background.ts +5 -3
  237. package/corpus/templates/clips/chrome-extension/src/offscreen.ts +17 -14
  238. package/corpus/templates/clips/chrome-extension/src/overlay.ts +8 -2
  239. package/corpus/templates/clips/desktop/README.md +3 -0
  240. package/corpus/templates/clips/desktop/src/hooks/useMeetingTranscription.ts +9 -0
  241. package/corpus/templates/clips/desktop/src/lib/recorder.ts +8 -2
  242. package/corpus/templates/clips/desktop/src/lib/silence-events.ts +1 -0
  243. package/corpus/templates/clips/desktop/src/lib/transcription-capture.ts +5 -0
  244. package/corpus/templates/clips/desktop/src/lib/transcription-engine.ts +134 -5
  245. package/corpus/templates/clips/desktop/src/lib/upload-video-stream.ts +28 -0
  246. package/corpus/templates/clips/desktop/src/overlays/flow-bar.tsx +10 -3
  247. package/corpus/templates/clips/desktop/src/overlays/meeting-notification.tsx +42 -9
  248. package/corpus/templates/clips/desktop/src/overlays/recording-pill.tsx +10 -2
  249. package/corpus/templates/clips/desktop/src-tauri/Cargo.toml +6 -1
  250. package/corpus/templates/clips/desktop/src-tauri/src/notifications.rs +77 -1
  251. package/corpus/templates/clips/desktop/src-tauri/src/silence_detector.rs +104 -25
  252. package/corpus/templates/clips/desktop/src-tauri/src/system_audio.rs +4 -0
  253. package/corpus/templates/clips/desktop/src-tauri/src/whisper_speech.rs +287 -32
  254. package/corpus/templates/clips/desktop/src-tauri/tauri.conf.json +1 -1
  255. package/corpus/templates/clips/server/lib/calendar-event-classification.ts +28 -0
  256. package/corpus/templates/clips/server/routes/[...page].get.ts +1 -59
  257. package/corpus/templates/clips/shared/recording-capture.ts +37 -0
  258. package/corpus/templates/content/.agents/skills/security/SKILL.md +10 -0
  259. package/corpus/templates/content/agent-native.app-skill.json +1 -1
  260. package/corpus/templates/content/app/components/sidebar/DocumentSidebar.tsx +18 -16
  261. package/corpus/templates/content/server/routes/[...page].get.ts +1 -15
  262. package/corpus/templates/design/.agents/skills/security/SKILL.md +10 -0
  263. package/corpus/templates/design/actions/connect-assets-mcp.ts +1 -1
  264. package/corpus/templates/design/agent-native.app-skill.json +1 -1
  265. package/corpus/templates/design/app/components/design/DesignCanvas.tsx +88 -12
  266. package/corpus/templates/design/app/components/design/MultiScreenCanvas.tsx +1 -0
  267. package/corpus/templates/design/app/components/design/bridge/editor-chrome.bridge.ts +4 -1
  268. package/corpus/templates/design/changelog/2026-07-13-adding-shapes-preserves-canvas-background.md +6 -0
  269. package/corpus/templates/design/changelog/2026-07-13-clicking-quickly-between-overlapping-elements-no-longer-bounc.md +6 -0
  270. package/corpus/templates/design/server/plugins/assets-mcp.ts +1 -1
  271. package/corpus/templates/design/server/routes/[...page].get.ts +0 -2
  272. package/corpus/templates/dispatch/.agents/skills/security/SKILL.md +10 -0
  273. package/corpus/templates/forms/.agents/skills/security/SKILL.md +10 -0
  274. package/corpus/templates/macros/.agents/skills/security/SKILL.md +10 -0
  275. package/corpus/templates/mail/.agents/skills/security/SKILL.md +10 -0
  276. package/corpus/templates/plan/.agents/skills/security/SKILL.md +10 -0
  277. package/corpus/templates/plan/.agents/skills/visual-plan/SKILL.md +1 -1
  278. package/corpus/templates/plan/.agents/skills/visual-recap/SKILL.md +2 -2
  279. package/corpus/templates/plan/agent-native.app-skill.json +1 -1
  280. package/corpus/templates/plan/app/lib/plan-local-bridge.ts +6 -1
  281. package/corpus/templates/plan/app/pages/PlansPage.tsx +15 -6
  282. package/corpus/templates/plan/changelog/2026-07-13-fixed-local-plan-previews-continuously-flickering-while-revi.md +6 -0
  283. package/corpus/templates/plan/server/routes/[...page].get.ts +0 -2
  284. package/corpus/templates/slides/.agents/skills/security/SKILL.md +10 -0
  285. package/dist/a2a/client.d.ts +2 -0
  286. package/dist/a2a/client.d.ts.map +1 -1
  287. package/dist/a2a/client.js +2 -0
  288. package/dist/a2a/client.js.map +1 -1
  289. package/dist/a2a/handlers.d.ts.map +1 -1
  290. package/dist/a2a/handlers.js +84 -7
  291. package/dist/a2a/handlers.js.map +1 -1
  292. package/dist/agent/production-agent.d.ts +9 -0
  293. package/dist/agent/production-agent.d.ts.map +1 -1
  294. package/dist/agent/production-agent.js +12 -0
  295. package/dist/agent/production-agent.js.map +1 -1
  296. package/dist/cli/connect.d.ts +2 -2
  297. package/dist/cli/connect.d.ts.map +1 -1
  298. package/dist/cli/connect.js +45 -23
  299. package/dist/cli/connect.js.map +1 -1
  300. package/dist/cli/mcp-config-writers.d.ts.map +1 -1
  301. package/dist/cli/mcp-config-writers.js +7 -0
  302. package/dist/cli/mcp-config-writers.js.map +1 -1
  303. package/dist/cli/mcp.js +5 -3
  304. package/dist/cli/mcp.js.map +1 -1
  305. package/dist/cli/pr-visual-recap-workflow.d.ts +1 -1
  306. package/dist/cli/pr-visual-recap-workflow.d.ts.map +1 -1
  307. package/dist/cli/pr-visual-recap-workflow.js +1 -1
  308. package/dist/cli/pr-visual-recap-workflow.js.map +1 -1
  309. package/dist/cli/skills-content/assets-skill.d.ts +1 -1
  310. package/dist/cli/skills-content/assets-skill.d.ts.map +1 -1
  311. package/dist/cli/skills-content/assets-skill.js +1 -1
  312. package/dist/cli/skills-content/assets-skill.js.map +1 -1
  313. package/dist/cli/skills-content/design-exploration-skill.d.ts +1 -1
  314. package/dist/cli/skills-content/design-exploration-skill.d.ts.map +1 -1
  315. package/dist/cli/skills-content/design-exploration-skill.js +1 -1
  316. package/dist/cli/skills-content/design-exploration-skill.js.map +1 -1
  317. package/dist/cli/skills-content/help.d.ts +1 -1
  318. package/dist/cli/skills-content/help.d.ts.map +1 -1
  319. package/dist/cli/skills-content/help.js +1 -1
  320. package/dist/cli/skills-content/help.js.map +1 -1
  321. package/dist/cli/skills-content/plan-setup-auth.d.ts +1 -1
  322. package/dist/cli/skills-content/plan-setup-auth.d.ts.map +1 -1
  323. package/dist/cli/skills-content/plan-setup-auth.js +1 -1
  324. package/dist/cli/skills-content/plan-setup-auth.js.map +1 -1
  325. package/dist/cli/skills-content/visual-plan-skill.d.ts +1 -1
  326. package/dist/cli/skills-content/visual-plan-skill.d.ts.map +1 -1
  327. package/dist/cli/skills-content/visual-plan-skill.js +1 -1
  328. package/dist/cli/skills-content/visual-plan-skill.js.map +1 -1
  329. package/dist/cli/skills-content/visual-recap-skill.d.ts +1 -1
  330. package/dist/cli/skills-content/visual-recap-skill.d.ts.map +1 -1
  331. package/dist/cli/skills-content/visual-recap-skill.js +2 -2
  332. package/dist/cli/skills-content/visual-recap-skill.js.map +1 -1
  333. package/dist/cli/skills.d.ts.map +1 -1
  334. package/dist/cli/skills.js +16 -12
  335. package/dist/cli/skills.js.map +1 -1
  336. package/dist/client/analytics.d.ts.map +1 -1
  337. package/dist/client/analytics.js +11 -0
  338. package/dist/client/analytics.js.map +1 -1
  339. package/dist/client/resources/McpIntegrationDialog.d.ts.map +1 -1
  340. package/dist/client/resources/McpIntegrationDialog.js +1 -1
  341. package/dist/client/resources/McpIntegrationDialog.js.map +1 -1
  342. package/dist/client/resources/mcp-integration-catalog.d.ts +1 -0
  343. package/dist/client/resources/mcp-integration-catalog.d.ts.map +1 -1
  344. package/dist/client/resources/mcp-integration-catalog.js +14 -0
  345. package/dist/client/resources/mcp-integration-catalog.js.map +1 -1
  346. package/dist/collab/awareness.d.ts +2 -2
  347. package/dist/collab/awareness.d.ts.map +1 -1
  348. package/dist/collab/routes.d.ts +1 -1
  349. package/dist/collab/struct-routes.d.ts +1 -1
  350. package/dist/embedding/agent.d.ts.map +1 -1
  351. package/dist/embedding/agent.js +6 -7
  352. package/dist/embedding/agent.js.map +1 -1
  353. package/dist/localization/default-messages.d.ts +5 -0
  354. package/dist/localization/default-messages.d.ts.map +1 -1
  355. package/dist/localization/default-messages.js +5 -0
  356. package/dist/localization/default-messages.js.map +1 -1
  357. package/dist/mcp/ask-app-inline-tasks.d.ts +47 -0
  358. package/dist/mcp/ask-app-inline-tasks.d.ts.map +1 -0
  359. package/dist/mcp/ask-app-inline-tasks.js +87 -0
  360. package/dist/mcp/ask-app-inline-tasks.js.map +1 -0
  361. package/dist/mcp/build-server.d.ts.map +1 -1
  362. package/dist/mcp/build-server.js +56 -3
  363. package/dist/mcp/build-server.js.map +1 -1
  364. package/dist/mcp/builtin-tools.d.ts.map +1 -1
  365. package/dist/mcp/builtin-tools.js +141 -21
  366. package/dist/mcp/builtin-tools.js.map +1 -1
  367. package/dist/mcp/connect-route.d.ts +12 -10
  368. package/dist/mcp/connect-route.d.ts.map +1 -1
  369. package/dist/mcp/connect-route.js +17 -14
  370. package/dist/mcp/connect-route.js.map +1 -1
  371. package/dist/mcp/oauth-route.d.ts +1 -1
  372. package/dist/mcp/oauth-route.d.ts.map +1 -1
  373. package/dist/mcp/oauth-route.js +30 -13
  374. package/dist/mcp/oauth-route.js.map +1 -1
  375. package/dist/mcp/route-paths.d.ts +13 -0
  376. package/dist/mcp/route-paths.d.ts.map +1 -0
  377. package/dist/mcp/route-paths.js +27 -0
  378. package/dist/mcp/route-paths.js.map +1 -0
  379. package/dist/mcp/server.d.ts +2 -1
  380. package/dist/mcp/server.d.ts.map +1 -1
  381. package/dist/mcp/server.js +14 -6
  382. package/dist/mcp/server.js.map +1 -1
  383. package/dist/mcp/stdio.d.ts +7 -6
  384. package/dist/mcp/stdio.d.ts.map +1 -1
  385. package/dist/mcp/stdio.js +27 -15
  386. package/dist/mcp/stdio.js.map +1 -1
  387. package/dist/mcp/workspace-resolve.d.ts +2 -1
  388. package/dist/mcp/workspace-resolve.d.ts.map +1 -1
  389. package/dist/mcp/workspace-resolve.js +2 -1
  390. package/dist/mcp/workspace-resolve.js.map +1 -1
  391. package/dist/mcp-client/manager.js +6 -3
  392. package/dist/mcp-client/manager.js.map +1 -1
  393. package/dist/mcp-client/remote-store.js +5 -7
  394. package/dist/mcp-client/remote-store.js.map +1 -1
  395. package/dist/notifications/routes.d.ts +3 -3
  396. package/dist/progress/routes.d.ts +1 -1
  397. package/dist/provider-api/corpus-jobs.d.ts +2 -2
  398. package/dist/resources/handlers.d.ts +2 -2
  399. package/dist/server/agent-chat/action-filters-a2a.d.ts.map +1 -1
  400. package/dist/server/agent-chat/action-filters-a2a.js +11 -1
  401. package/dist/server/agent-chat/action-filters-a2a.js.map +1 -1
  402. package/dist/server/agent-chat-plugin.d.ts.map +1 -1
  403. package/dist/server/agent-chat-plugin.js +43 -11
  404. package/dist/server/agent-chat-plugin.js.map +1 -1
  405. package/dist/server/agent-engine-api-key-route.d.ts +1 -1
  406. package/dist/server/agent-teams.d.ts.map +1 -1
  407. package/dist/server/agent-teams.js +15 -1
  408. package/dist/server/agent-teams.js.map +1 -1
  409. package/dist/server/auth.d.ts.map +1 -1
  410. package/dist/server/auth.js +16 -6
  411. package/dist/server/auth.js.map +1 -1
  412. package/dist/server/core-routes-plugin.d.ts +4 -3
  413. package/dist/server/core-routes-plugin.d.ts.map +1 -1
  414. package/dist/server/core-routes-plugin.js +20 -15
  415. package/dist/server/core-routes-plugin.js.map +1 -1
  416. package/dist/server/csrf.d.ts.map +1 -1
  417. package/dist/server/csrf.js +11 -0
  418. package/dist/server/csrf.js.map +1 -1
  419. package/dist/server/framework-request-handler.d.ts.map +1 -1
  420. package/dist/server/framework-request-handler.js +8 -2
  421. package/dist/server/framework-request-handler.js.map +1 -1
  422. package/dist/server/google-oauth.d.ts +2 -0
  423. package/dist/server/google-oauth.d.ts.map +1 -1
  424. package/dist/server/google-oauth.js +11 -2
  425. package/dist/server/google-oauth.js.map +1 -1
  426. package/dist/server/http-response-telemetry.d.ts.map +1 -1
  427. package/dist/server/http-response-telemetry.js +4 -1
  428. package/dist/server/http-response-telemetry.js.map +1 -1
  429. package/dist/server/recap-image-route.js +3 -3
  430. package/dist/server/recap-image-route.js.map +1 -1
  431. package/dist/server/security-headers.d.ts.map +1 -1
  432. package/dist/server/security-headers.js +4 -1
  433. package/dist/server/security-headers.js.map +1 -1
  434. package/dist/server/ssr-handler.d.ts.map +1 -1
  435. package/dist/server/ssr-handler.js +3 -1
  436. package/dist/server/ssr-handler.js.map +1 -1
  437. package/dist/shared/cache-control.d.ts +7 -6
  438. package/dist/shared/cache-control.d.ts.map +1 -1
  439. package/dist/shared/cache-control.js +4 -3
  440. package/dist/shared/cache-control.js.map +1 -1
  441. package/dist/templates/default/.agents/skills/security/SKILL.md +10 -0
  442. package/dist/templates/workspace-core/.agents/skills/authentication/SKILL.md +15 -6
  443. package/dist/templates/workspace-core/.agents/skills/external-agents/SKILL.md +16 -10
  444. package/dist/templates/workspace-core/.agents/skills/performance/SKILL.md +20 -1
  445. package/dist/templates/workspace-core/.agents/skills/security/SKILL.md +10 -0
  446. package/docs/content/actions.mdx +1 -1
  447. package/docs/content/authentication.mdx +1 -1
  448. package/docs/content/dispatch.mdx +3 -3
  449. package/docs/content/external-agents.mdx +30 -19
  450. package/docs/content/locales/ar-SA/actions.mdx +1 -1
  451. package/docs/content/locales/ar-SA/authentication.mdx +1 -1
  452. package/docs/content/locales/ar-SA/dispatch.mdx +3 -3
  453. package/docs/content/locales/ar-SA/external-agents.mdx +23 -19
  454. package/docs/content/locales/ar-SA/mcp-clients.mdx +31 -3
  455. package/docs/content/locales/ar-SA/mcp-protocol.mdx +29 -15
  456. package/docs/content/locales/ar-SA/plan-plugin.mdx +3 -3
  457. package/docs/content/locales/ar-SA/server.mdx +2 -2
  458. package/docs/content/locales/ar-SA/skills-guide.mdx +1 -1
  459. package/docs/content/locales/ar-SA/template-assets.mdx +1 -1
  460. package/docs/content/locales/ar-SA/template-dispatch.mdx +2 -2
  461. package/docs/content/locales/ar-SA/template-plan.mdx +3 -3
  462. package/docs/content/locales/de-DE/actions.mdx +1 -1
  463. package/docs/content/locales/de-DE/authentication.mdx +1 -1
  464. package/docs/content/locales/de-DE/dispatch.mdx +3 -3
  465. package/docs/content/locales/de-DE/external-agents.mdx +23 -19
  466. package/docs/content/locales/de-DE/mcp-clients.mdx +37 -3
  467. package/docs/content/locales/de-DE/mcp-protocol.mdx +29 -15
  468. package/docs/content/locales/de-DE/plan-plugin.mdx +3 -3
  469. package/docs/content/locales/de-DE/server.mdx +2 -2
  470. package/docs/content/locales/de-DE/skills-guide.mdx +1 -1
  471. package/docs/content/locales/de-DE/template-assets.mdx +1 -1
  472. package/docs/content/locales/de-DE/template-dispatch.mdx +2 -2
  473. package/docs/content/locales/de-DE/template-plan.mdx +3 -3
  474. package/docs/content/locales/es-ES/actions.mdx +1 -1
  475. package/docs/content/locales/es-ES/authentication.mdx +1 -1
  476. package/docs/content/locales/es-ES/dispatch.mdx +3 -3
  477. package/docs/content/locales/es-ES/external-agents.mdx +32 -19
  478. package/docs/content/locales/es-ES/mcp-clients.mdx +17 -3
  479. package/docs/content/locales/es-ES/mcp-protocol.mdx +38 -15
  480. package/docs/content/locales/es-ES/plan-plugin.mdx +3 -3
  481. package/docs/content/locales/es-ES/server.mdx +2 -2
  482. package/docs/content/locales/es-ES/skills-guide.mdx +1 -1
  483. package/docs/content/locales/es-ES/template-assets.mdx +1 -1
  484. package/docs/content/locales/es-ES/template-dispatch.mdx +2 -2
  485. package/docs/content/locales/es-ES/template-plan.mdx +3 -3
  486. package/docs/content/locales/fr-FR/actions.mdx +1 -1
  487. package/docs/content/locales/fr-FR/authentication.mdx +1 -1
  488. package/docs/content/locales/fr-FR/dispatch.mdx +3 -3
  489. package/docs/content/locales/fr-FR/external-agents.mdx +23 -19
  490. package/docs/content/locales/fr-FR/mcp-clients.mdx +17 -3
  491. package/docs/content/locales/fr-FR/mcp-protocol.mdx +29 -15
  492. package/docs/content/locales/fr-FR/plan-plugin.mdx +3 -3
  493. package/docs/content/locales/fr-FR/server.mdx +2 -2
  494. package/docs/content/locales/fr-FR/skills-guide.mdx +1 -1
  495. package/docs/content/locales/fr-FR/template-assets.mdx +1 -1
  496. package/docs/content/locales/fr-FR/template-dispatch.mdx +2 -2
  497. package/docs/content/locales/fr-FR/template-plan.mdx +3 -3
  498. package/docs/content/locales/hi-IN/actions.mdx +1 -1
  499. package/docs/content/locales/hi-IN/authentication.mdx +1 -1
  500. package/docs/content/locales/hi-IN/dispatch.mdx +3 -3
  501. package/docs/content/locales/hi-IN/external-agents.mdx +31 -19
  502. package/docs/content/locales/hi-IN/mcp-clients.mdx +17 -3
  503. package/docs/content/locales/hi-IN/mcp-protocol.mdx +36 -15
  504. package/docs/content/locales/hi-IN/plan-plugin.mdx +3 -3
  505. package/docs/content/locales/hi-IN/server.mdx +2 -2
  506. package/docs/content/locales/hi-IN/skills-guide.mdx +1 -1
  507. package/docs/content/locales/hi-IN/template-assets.mdx +1 -1
  508. package/docs/content/locales/hi-IN/template-dispatch.mdx +2 -2
  509. package/docs/content/locales/hi-IN/template-plan.mdx +3 -3
  510. package/docs/content/locales/ja-JP/actions.mdx +1 -1
  511. package/docs/content/locales/ja-JP/authentication.mdx +1 -1
  512. package/docs/content/locales/ja-JP/dispatch.mdx +3 -3
  513. package/docs/content/locales/ja-JP/external-agents.mdx +23 -19
  514. package/docs/content/locales/ja-JP/mcp-clients.mdx +34 -3
  515. package/docs/content/locales/ja-JP/mcp-protocol.mdx +29 -15
  516. package/docs/content/locales/ja-JP/plan-plugin.mdx +3 -3
  517. package/docs/content/locales/ja-JP/server.mdx +2 -2
  518. package/docs/content/locales/ja-JP/skills-guide.mdx +1 -1
  519. package/docs/content/locales/ja-JP/template-assets.mdx +1 -1
  520. package/docs/content/locales/ja-JP/template-dispatch.mdx +2 -2
  521. package/docs/content/locales/ja-JP/template-plan.mdx +3 -3
  522. package/docs/content/locales/ko-KR/actions.mdx +1 -1
  523. package/docs/content/locales/ko-KR/authentication.mdx +1 -1
  524. package/docs/content/locales/ko-KR/dispatch.mdx +3 -3
  525. package/docs/content/locales/ko-KR/external-agents.mdx +30 -19
  526. package/docs/content/locales/ko-KR/mcp-clients.mdx +33 -3
  527. package/docs/content/locales/ko-KR/mcp-protocol.mdx +36 -15
  528. package/docs/content/locales/ko-KR/plan-plugin.mdx +3 -3
  529. package/docs/content/locales/ko-KR/server.mdx +2 -2
  530. package/docs/content/locales/ko-KR/skills-guide.mdx +1 -1
  531. package/docs/content/locales/ko-KR/template-assets.mdx +1 -1
  532. package/docs/content/locales/ko-KR/template-dispatch.mdx +2 -2
  533. package/docs/content/locales/ko-KR/template-plan.mdx +3 -3
  534. package/docs/content/locales/pt-BR/actions.mdx +1 -1
  535. package/docs/content/locales/pt-BR/authentication.mdx +1 -1
  536. package/docs/content/locales/pt-BR/dispatch.mdx +3 -3
  537. package/docs/content/locales/pt-BR/external-agents.mdx +32 -19
  538. package/docs/content/locales/pt-BR/mcp-clients.mdx +34 -3
  539. package/docs/content/locales/pt-BR/mcp-protocol.mdx +32 -15
  540. package/docs/content/locales/pt-BR/plan-plugin.mdx +3 -3
  541. package/docs/content/locales/pt-BR/server.mdx +2 -2
  542. package/docs/content/locales/pt-BR/skills-guide.mdx +1 -1
  543. package/docs/content/locales/pt-BR/template-assets.mdx +1 -1
  544. package/docs/content/locales/pt-BR/template-dispatch.mdx +2 -2
  545. package/docs/content/locales/pt-BR/template-plan.mdx +3 -3
  546. package/docs/content/locales/zh-CN/actions.mdx +1 -1
  547. package/docs/content/locales/zh-CN/authentication.mdx +1 -1
  548. package/docs/content/locales/zh-CN/dispatch.mdx +3 -3
  549. package/docs/content/locales/zh-CN/external-agents.mdx +23 -19
  550. package/docs/content/locales/zh-CN/mcp-clients.mdx +28 -3
  551. package/docs/content/locales/zh-CN/mcp-protocol.mdx +29 -15
  552. package/docs/content/locales/zh-CN/plan-plugin.mdx +3 -3
  553. package/docs/content/locales/zh-CN/server.mdx +2 -2
  554. package/docs/content/locales/zh-CN/skills-guide.mdx +1 -1
  555. package/docs/content/locales/zh-CN/template-assets.mdx +1 -1
  556. package/docs/content/locales/zh-CN/template-dispatch.mdx +2 -2
  557. package/docs/content/locales/zh-CN/template-plan.mdx +3 -3
  558. package/docs/content/locales/zh-TW/actions.mdx +1 -1
  559. package/docs/content/locales/zh-TW/authentication.mdx +1 -1
  560. package/docs/content/locales/zh-TW/dispatch.mdx +3 -3
  561. package/docs/content/locales/zh-TW/external-agents.mdx +23 -19
  562. package/docs/content/locales/zh-TW/mcp-clients.mdx +28 -3
  563. package/docs/content/locales/zh-TW/mcp-protocol.mdx +30 -15
  564. package/docs/content/locales/zh-TW/plan-plugin.mdx +3 -3
  565. package/docs/content/locales/zh-TW/server.mdx +2 -2
  566. package/docs/content/locales/zh-TW/skills-guide.mdx +1 -1
  567. package/docs/content/locales/zh-TW/template-assets.mdx +1 -1
  568. package/docs/content/locales/zh-TW/template-dispatch.mdx +2 -2
  569. package/docs/content/locales/zh-TW/template-plan.mdx +3 -3
  570. package/docs/content/mcp-clients.mdx +31 -4
  571. package/docs/content/mcp-protocol.mdx +35 -15
  572. package/docs/content/plan-plugin.mdx +3 -3
  573. package/docs/content/server.mdx +2 -2
  574. package/docs/content/skills-guide.mdx +1 -1
  575. package/docs/content/template-assets.mdx +1 -1
  576. package/docs/content/template-dispatch.mdx +2 -2
  577. package/docs/content/template-plan.mdx +3 -3
  578. package/package.json +2 -2
  579. package/src/templates/default/.agents/skills/security/SKILL.md +10 -0
  580. package/src/templates/workspace-core/.agents/skills/authentication/SKILL.md +15 -6
  581. package/src/templates/workspace-core/.agents/skills/external-agents/SKILL.md +16 -10
  582. package/src/templates/workspace-core/.agents/skills/performance/SKILL.md +20 -1
  583. package/src/templates/workspace-core/.agents/skills/security/SKILL.md +10 -0
@@ -22,7 +22,7 @@ MCP AI टूल को बाहरी क्षमताओं से जो
22
22
 
23
23
  मुख्य अवधारणाएँ:
24
24
 
25
- - **ऑटो-माउंटेड** - प्रत्येक ऐप को मुफ्त में `/_agent-native/mcp` मिलता है, किसी सेटअप की आवश्यकता नहीं है
25
+ - **ऑटो-माउंटेड** - प्रत्येक ऐप को मुफ्त में `/mcp` मिलता है, किसी सेटअप की आवश्यकता नहीं है
26
26
  - **स्ट्रीम करने योग्य HTTP** - मानक HTTP (POST + SSE) की तुलना में आधुनिक MCP परिवहन का उपयोग करता है
27
27
  - **वही actions** - बिल्कुल वही एक्शन रजिस्ट्री जो एजेंट चैट और A2A को शक्ति प्रदान करती है
28
28
  - **`ask-agent` टूल** - एक मेटा-टूल जो जटिल कार्यों के लिए पूर्ण एजेंट लूप को सौंपता है
@@ -41,7 +41,7 @@ MCP AI टूल को बाहरी क्षमताओं से जो
41
41
  </div>
42
42
  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
43
43
  <div class="diagram-panel">
44
- <span class="diagram-pill accent">POST /_agent-native/mcp</span
44
+ <span class="diagram-pill accent">POST /mcp</span
45
45
  ><small class="diagram-muted">Streamable HTTP</small
46
46
  ><small class="diagram-muted"
47
47
  >initialize &rarr; tools/list &rarr; tools/call</small
@@ -94,7 +94,7 @@ MCP AI टूल को बाहरी क्षमताओं से जो
94
94
  | **के लिए सर्वोत्तम** | बाहरी उपकरण आपके ऐप को कॉल कर रहे हैं | एजेंट-टू-एजेंट संचार |
95
95
  | **प्रोटोकॉल** | MCP स्ट्रीम करने योग्य HTTP | JSON-RPC 2.0 |
96
96
  | **उपकरण खोज** | `tools/list` | `/.well-known/agent-card.json` पर एजेंट कार्ड |
97
- | **समापनबिंदु** | `/_agent-native/mcp` | `/_agent-native/a2a` |
97
+ | **समापनबिंदु** | `/mcp` | `/_agent-native/a2a` |
98
98
  | **समर्थित** | Claude, ChatGPT, Claude कोड, कर्सर, Codex, कोवर्क, और अन्य MCP होस्ट | अन्य एजेंट-मूल ऐप्स |
99
99
  | **निष्पादन** | डायरेक्ट टूल कॉल (कोई अतिरिक्त LLM नहीं) | पूर्ण एजेंट लूप (LLM तर्क) |
100
100
 
@@ -105,7 +105,7 @@ MCP AI टूल को बाहरी क्षमताओं से जो
105
105
  अनुशंसित एक-कमांड सेटअप के लिए, [External Agents](/docs/external-agents) का उपयोग करें। यदि आप OAuth-सक्षम क्लाइंट के लिए MCP कॉन्फिगरेशन को हाथ से लिख रहे हैं, तो अपने ऐप को बिना किसी स्थिर हेडर के रिमोट MCP सर्वर के रूप में जोड़ें:
106
106
 
107
107
  ```bash
108
- claude mcp add --transport http mail https://mail.example.com/_agent-native/mcp
108
+ claude mcp add --transport http mail https://mail.example.com/mcp
109
109
  ```
110
110
 
111
111
  या `.mcp.json` (प्रोजेक्ट स्कोप) या `~/.claude.json` (यूजर स्कोप) में हाथ से प्रविष्टि लिखें:
@@ -116,7 +116,7 @@ claude mcp add --transport http mail https://mail.example.com/_agent-native/mcp
116
116
  "mcpServers": {
117
117
  "mail": {
118
118
  "type": "http",
119
- "url": "https://mail.example.com/_agent-native/mcp",
119
+ "url": "https://mail.example.com/mcp",
120
120
  },
121
121
  },
122
122
  }
@@ -135,12 +135,12 @@ Claude Code calls: draft-email(to: "john@example.com", subject: "Q3 Report", bod
135
135
  कोई भी MCP क्लाइंट जो स्ट्रीम करने योग्य HTTP ट्रांसपोर्ट का समर्थन करता है, कनेक्ट हो सकता है। अंतिमबिंदु है:
136
136
 
137
137
  ```
138
- POST https://your-app.example.com/_agent-native/mcp
138
+ POST https://your-app.example.com/mcp
139
139
  ```
140
140
 
141
141
  सर्वर मानक MCP हैंडशेक का समर्थन करता है: `initialize` → `initialized` → `tools/list` → `tools/call`।
142
142
 
143
- <Endpoint id="doc-block-1eenree" title={"MCP समापन बिंदु"} summary={"ऑटो-माउंटेड स्ट्रीमेबल HTTP एंडपॉइंट प्रत्येक एजेंट-नेटिव ऐप को उजागर करता है।"} method="POST" path="/_agent-native/mcp" summary={"MCP स्ट्रीम करने योग्य HTTP समापन बिंदु"} auth="Standard remote MCP OAuth (Bearer access token), connect-minted JWT, or static ACCESS_TOKEN/ACCESS_TOKENS" params={[
143
+ <Endpoint id="doc-block-1eenree" title={"MCP समापन बिंदु"} summary={"ऑटो-माउंटेड स्ट्रीमेबल HTTP एंडपॉइंट प्रत्येक एजेंट-नेटिव ऐप को उजागर करता है।"} method="POST" path="/mcp" summary={"MCP स्ट्रीम करने योग्य HTTP समापन बिंदु"} auth="Standard remote MCP OAuth (Bearer access token), connect-minted JWT, or static ACCESS_TOKEN/ACCESS_TOKENS" params={[
144
144
  {
145
145
  "name": "Authorization",
146
146
  "in": "header",
@@ -204,18 +204,39 @@ Auto-mounted on every app. Speaks the standard MCP handshake (`initialize` → `
204
204
 
205
205
  व्यक्तिगत एक्शन टूल के अलावा, प्रत्येक MCP सर्वर में एक `ask-agent` मेटा-टूल शामिल होता है। यह ऐप के AI एजेंट को एक प्राकृतिक भाषा में संदेश भेजता है और प्रतिक्रिया देता है।
206
206
 
207
+ होस्ट किए गए MCP अनुरोध एक सीमित इनलाइन प्रतीक्षा का उपयोग करते हैं ताकि एक लंबा
208
+ एजेंट लूप किसी क्लाइंट या गेटवे टाइमआउट तक एक `tools/call` को खुला न रखे।
209
+ वैकल्पिक `async` तर्क स्थायी टास्क शुरू करता है और तुरंत लौट आता है; इसके बिना,
210
+ सर्वर एक त्वरित समापन के लिए संक्षेप में प्रतीक्षा करता है और फिर अधिक काम बाकी
211
+ रहने पर एक टास्क हैंडल लौटाता है। होस्ट की गई प्रतीक्षा 25 सेकंड तक सीमित है।
212
+
207
213
  जटिल कार्यों के लिए `ask-agent` का उपयोग करें जो एजेंट के तर्क और संदर्भ से लाभान्वित हों:
208
214
 
209
215
  ```json
210
216
  {
211
217
  "name": "ask-agent",
212
218
  "arguments": {
213
- "message": "Draft a follow-up email to the Q3 planning thread with John, summarizing the action items we discussed"
219
+ "message": "Draft a follow-up email to the Q3 planning thread with John, summarizing the action items we discussed",
220
+ "async": true
221
+ }
222
+ }
223
+ ```
224
+
225
+ एजेंट इंटरैक्टिव चैट के समान लूप चलाता है - यह कई टूल को कॉल कर सकता है, संदर्भ के बारे में तर्क कर सकता है और एक विचारशील प्रतिक्रिया दे सकता है। एक टास्क जो पूरा नहीं हुआ है वह `taskId`, `status`, `pollAfterMs` वाला JSON लौटाता है, और:
226
+
227
+ ```json
228
+ {
229
+ "poll": {
230
+ "tool": "ask_app_status",
231
+ "arguments": { "app": "mail", "taskId": "task_123" }
214
232
  }
215
233
  }
216
234
  ```
217
235
 
218
- एजेंट इंटरैक्टिव चैट के समान लूप चलाता है - यह कई टूल को कॉल कर सकता है, संदर्भ के बारे में तर्क कर सकता है और एक विचारशील प्रतिक्रिया दे सकता है।
236
+ टास्क के अंतिम स्थिति तक पहुंचने तक उन्हीं तर्कों के साथ `ask_app_status` को
237
+ कॉल करें। डिस्पैच का ऐप-स्वामित्व वाला `ask_app` उसी स्थायी टास्क और स्थिति
238
+ अनुबंध का उपयोग करता है, जिसमें चयनित-ऐप अनुदान की जांच सबमिशन और पोलिंग दोनों
239
+ पर की जाती है।
219
240
 
220
241
  ## प्रमाणीकरण {#authentication}
221
242
 
@@ -233,7 +254,7 @@ MCP एंडपॉइंट मानक रिमोट MCP OAuth प्लस
233
254
  OAuth-सक्षम MCP होस्ट के लिए, बिना किसी स्थिर हेडर के रिमोट सर्वर URL को कॉन्फ़िगर करें:
234
255
 
235
256
  ```bash
236
- claude mcp add --transport http agent-native https://dispatch.agent-native.com/_agent-native/mcp
257
+ claude mcp add --transport http agent-native https://dispatch.agent-native.com/mcp
237
258
  ```
238
259
 
239
260
  पहला अप्रमाणित MCP अनुरोध प्राप्त होता है:
@@ -249,9 +270,9 @@ WWW-Authenticate: Bearer resource_metadata="https://dispatch.agent-native.com/.w
249
270
  | ----------------------------------------- | ---------------------------------- |
250
271
  | `/.well-known/oauth-protected-resource` | RFC 9728 संरक्षित-संसाधन मेटाडेटा |
251
272
  | `/.well-known/oauth-authorization-server` | OAuth प्राधिकरण सर्वर मेटाडेटा |
252
- | `/_agent-native/mcp/oauth/register` | डायनामिक पब्लिक-क्लाइंट पंजीकरण |
253
- | `/_agent-native/mcp/oauth/authorize` | ब्राउज़र प्राधिकरण + सहमति |
254
- | `/_agent-native/mcp/oauth/token` | प्राधिकरण-कोड और ताज़ा-टोकन अनुदान |
273
+ | `/mcp/oauth/register` | डायनामिक पब्लिक-क्लाइंट पंजीकरण |
274
+ | `/mcp/oauth/authorize` | ब्राउज़र प्राधिकरण + सहमति |
275
+ | `/mcp/oauth/token` | प्राधिकरण-कोड और ताज़ा-टोकन अनुदान |
255
276
 
256
277
  <Diagram id="doc-block-1gzntim" title={"OAuth खोज प्रवाह"} summary={"401 खोज, पंजीकरण और PKCE अधिकृत → टोकन एक्सचेंज को शुरू करता है। बियरर टोकन ऑडियंस-बाउंड और स्कोप्ड है।"}>
257
278
 
@@ -351,7 +372,7 @@ export default defineNitroPlugin(async (nitro) => {
351
372
  आपके पास `analytics.example.com` पर एक तैनात एनालिटिक्स ऐप है। Claude कोड से:
352
373
 
353
374
  ```bash
354
- claude mcp add --transport http analytics https://analytics.example.com/_agent-native/mcp
375
+ claude mcp add --transport http analytics https://analytics.example.com/mcp
355
376
  ```
356
377
 
357
378
  या इसे `.mcp.json` में हाथ से जोड़ें:
@@ -362,7 +383,7 @@ claude mcp add --transport http analytics https://analytics.example.com/_agent-n
362
383
  "mcpServers": {
363
384
  "analytics": {
364
385
  "type": "http",
365
- "url": "https://analytics.example.com/_agent-native/mcp",
386
+ "url": "https://analytics.example.com/mcp",
366
387
  },
367
388
  },
368
389
  }
@@ -12,7 +12,7 @@ Agent-Native **Plan** app एक installable bundle के रूप में
12
12
  एक इंस्टॉल आपको देता है:
13
13
 
14
14
  - **तीन skills** — `/visual-plan` (canonical entry point), `/visual-recap`, और `/visualize-repo`।
15
- - **प्लान MCP कनेक्टर** - `https://plan.agent-native.com` (MCP एंडपॉइंट `https://plan.agent-native.com/_agent-native/mcp`, सर्वर नाम `plan`) पर होस्ट किए गए ऐप के खिलाफ पंजीकृत है।
15
+ - **प्लान MCP कनेक्टर** - `https://plan.agent-native.com` (MCP एंडपॉइंट `https://plan.agent-native.com/mcp`, सर्वर नाम `plan`) पर होस्ट किए गए ऐप के खिलाफ पंजीकृत है।
16
16
 
17
17
  <Diagram id="doc-block-gdfyxv" title={"तीन मार्ग, एक बंडल"} summary={"Universal CLI, Claude Code प्लगइन, और Codex प्लगइन सभी वही Plan skills और hosted Plan connector install करते हैं।"}>
18
18
 
@@ -43,7 +43,7 @@ Agent-Native **Plan** app एक installable bundle के रूप में
43
43
  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
44
44
  <div class="diagram-box">
45
45
  Plan MCP connector<br /><small class="diagram-muted"
46
- >plan.agent-native.com/_agent-native/mcp</small
46
+ >plan.agent-native.com/mcp</small
47
47
  >
48
48
  </div>
49
49
  </div>
@@ -251,7 +251,7 @@ codex plugin add agent-native-visual-plans@agent-native-apps
251
251
  codex mcp login plan # OAuth ब्राउज़र में
252
252
  ```
253
253
 
254
- इंस्टॉल करने के बाद, **एक नया Codex थ्रेड शुरू करें** ताकि skills और MCP टूल सत्र में लोड हो जाएं। प्लगइन एक URL-केवल कनेक्टर (`[mcp_servers.plan]` → `https://plan.agent-native.com/_agent-native/mcp`) शिप करता है; `codex mcp login plan` OAuth प्रवाह चलाता है। उपरोक्त सार्वभौमिक CLI मार्ग Codex (`npx @agent-native/core@latest skills add visual-plan --client codex`) के लिए भी काम करता है यदि आप एक कमांड पसंद करते हैं जो एक साथ स्थापित और प्रमाणित करता है, या जब आप स्थानीय-फ़ाइलें या स्वयं-होस्टेड मोड चाहते हैं।
254
+ इंस्टॉल करने के बाद, **एक नया Codex थ्रेड शुरू करें** ताकि skills और MCP टूल सत्र में लोड हो जाएं। प्लगइन एक URL-केवल कनेक्टर (`[mcp_servers.plan]` → `https://plan.agent-native.com/mcp`) शिप करता है; `codex mcp login plan` OAuth प्रवाह चलाता है। उपरोक्त सार्वभौमिक CLI मार्ग Codex (`npx @agent-native/core@latest skills add visual-plan --client codex`) के लिए भी काम करता है यदि आप एक कमांड पसंद करते हैं जो एक साथ स्थापित और प्रमाणित करता है, या जब आप स्थानीय-फ़ाइलें या स्वयं-होस्टेड मोड चाहते हैं।
255
255
 
256
256
  > **पुराने इंस्टॉल:** यदि आपके कॉन्फिगरेशन में अभी भी URL पर इंगित करने वाली `agent-native-plans` प्रविष्टि है, तो Codex के लिए `npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex` चला रहा है, या आपके लक्ष्य `--client` के साथ एक ही कमांड चल रहा है, इसे कैनोनिकल `plan` नाम में समेकित करता है।
257
257
 
@@ -265,7 +265,7 @@ export default runMigrations(
265
265
  | `/_agent-native/extensions/*` | रनटाइम एक्सटेंशन और एक्सटेंशन प्रॉक्सी (विरासत उपनाम: `/_agent-native/tools/*`) |
266
266
  | `/_agent-native/integrations/*` | मैसेजिंग/वेबहुक एकीकरण |
267
267
  | `/_agent-native/a2a` | एजेंट-से-एजेंट JSON-RPC |
268
- | `/_agent-native/mcp` | MCP समापन बिंदु |
268
+ | `/mcp` | MCP समापन बिंदु |
269
269
  | `/_agent-native/onboarding/*` | सेटअप चेकलिस्ट |
270
270
  | `/_agent-native/observability/*` | निशान, फीडबैक, मूल्यांकन, प्रयोग |
271
271
  | `/_agent-native/file-upload` | फ़ाइल अपलोड प्रदाता समापन बिंदु |
@@ -461,4 +461,4 @@ const handler = createProductionAgentHandler({
461
461
  - [**Database**](/docs/database) — `getDb()`/`schema` पैटर्न जिसे कस्टम रूट और actions दोनों आयात करते हैं
462
462
  - [**Security**](/docs/security#access-guards) — `accessFilter`/`assertAccess` और पूरा डेटा-स्कोपिंग मॉडल
463
463
  - [**Messaging**](/docs/messaging) — इनबाउंड webhook के लिए मानक इंटीग्रेशन क्यू पैटर्न
464
- - [**MCP Protocol**](/docs/mcp-protocol) — `/_agent-native/mcp` endpoint जिसे यह सर्वर अपने आप माउंट करता है
464
+ - [**MCP Protocol**](/docs/mcp-protocol) — `/mcp` endpoint जिसे यह सर्वर अपने आप माउंट करता है
@@ -313,7 +313,7 @@ scope: dev
313
313
  "id": "assets",
314
314
  "hosted": {
315
315
  "url": "https://assets.agent-native.com",
316
- "mcpUrl": "https://assets.agent-native.com/_agent-native/mcp"
316
+ "mcpUrl": "https://assets.agent-native.com/mcp"
317
317
  },
318
318
  "mcp": { "serverName": "agent-native-assets" },
319
319
  "skills": [
@@ -491,7 +491,7 @@ Codex, Claude कोड और Claude डेस्कटॉप कोड को
491
491
  ### डेवलपर: ऐप कौशल वितरित करें
492
492
 
493
493
  एसेट ऐप स्किल में ऐप आईडी `assets` और होस्ट किया गया MCP URL है
494
- `https://assets.agent-native.com/_agent-native/mcp`.
494
+ `https://assets.agent-native.com/mcp`.
495
495
 
496
496
  ```bash
497
497
  # सबसे आसान होस्ट किया गया इंस्टॉल: निर्यातित कौशल निर्देश प्लस MCP कनेक्टर।
@@ -123,7 +123,7 @@ description: "डिस्पैच कार्यक्षेत्र नि
123
123
  कच्चे रहस्यों की नकल किए बिना पहुंच भेजना। ऐप-विशिष्ट स्रोत
124
124
  कॉन्फ़िगरेशन उस ऐप में रहता है जो प्रदाता का उपयोग करता है।
125
125
  - **एक MCP कनेक्टर को उजागर करें।** जोड़ें
126
- `https://dispatch.agent-native.com/_agent-native/mcp` में Claude, ChatGPT,
126
+ `https://dispatch.agent-native.com/mcp` में Claude, ChatGPT,
127
127
  Codex, कर्सर, या कोई अन्य MCP होस्ट, फिर चुनें कि कौन सा कार्यक्षेत्र ऐप्स
128
128
  कनेक्टर डिस्पैच के **एजेंट** पेज से पहुंच सकता है। सीधे ऐप URL
129
129
  केवल तभी जब उस होस्ट को एक ऐप से अलग किया जाना चाहिए।
@@ -304,7 +304,7 @@ _यह हुड के तहत कैसे काम करता है (
304
304
  ]}
305
305
  />
306
306
 
307
- - **MCP हब मोड।** डिस्पैच अभी भी वर्कस्पेस के [MCP hub](/docs/mcp-clients#hub) के रूप में कार्य कर सकता है, इसलिए वर्कस्पेस में हर दूसरा ऐप समान ऑर्ग-स्कोप MCP सर्वर सूची खींचता है। अलग से, डिस्पैच का अपना `/_agent-native/mcp` एंडपॉइंट Claude, ChatGPT और अन्य होस्ट के लिए अनुशंसित बाहरी MCP कनेक्टर है, जिसे कई वर्कस्पेस ऐप्स तक पहुंचना चाहिए।
307
+ - **MCP हब मोड।** डिस्पैच अभी भी वर्कस्पेस के [MCP hub](/docs/mcp-clients#hub) के रूप में कार्य कर सकता है, इसलिए वर्कस्पेस में हर दूसरा ऐप समान ऑर्ग-स्कोप MCP सर्वर सूची खींचता है। अलग से, डिस्पैच का अपना `/mcp` एंडपॉइंट Claude, ChatGPT और अन्य होस्ट के लिए अनुशंसित बाहरी MCP कनेक्टर है, जिसे कई वर्कस्पेस ऐप्स तक पहुंचना चाहिए।
308
308
 
309
309
  ## सपने {#dreams}
310
310
 
@@ -114,7 +114,7 @@ npx @agent-native/core@latest skills add visual-plan
114
114
 
115
115
  यदि आप चैट-आधारित होस्ट का उपयोग कर रहे हैं जो सीधे MCP कनेक्टर URLs स्वीकार करता है
116
116
  (CLI-कॉन्फ़िगर क्लाइंट के बजाय), होस्ट किए गए प्लान कनेक्टर को यहां कनेक्ट करें
117
- `https://plan.agent-native.com/_agent-native/mcp` - क्लाइंट-विशिष्ट सेटअप के लिए [MCP Clients](/docs/mcp-clients) देखें।
117
+ `https://plan.agent-native.com/mcp` - क्लाइंट-विशिष्ट सेटअप के लिए [MCP Clients](/docs/mcp-clients) देखें।
118
118
 
119
119
  प्रमाणीकरण सेटअप पर एक बार का ब्राउज़र साइन-इन है - यह इरादा है, और यह
120
120
  वह है जो एजेंट को अपने द्वारा बनाई गई योजनाओं को जारी रखने और साझा करने देता है। क्या बात है
@@ -253,7 +253,7 @@ vscode://builder.agent-native/open?url=<encoded-plan-url>
253
253
  क्रॉस-डिवाइस या टीम समीक्षा) के लिए साइन इन करना आवश्यक है। Google साइन-इन तब दिखाई देता है जब
254
254
  मानक Google OAuth env संस्करण कॉन्फ़िगर किए गए हैं।
255
255
 
256
- होस्ट किया गया प्लान कनेक्टर `https://plan.agent-native.com/_agent-native/mcp` पर रहता है।
256
+ होस्ट किया गया प्लान कनेक्टर `https://plan.agent-native.com/mcp` पर रहता है।
257
257
  कौशल फ़ाइलों में कभी भी साझा रहस्य न डालें।
258
258
 
259
259
  ## स्थानीय-फ़ाइलें गोपनीयता मोड {#local-files}
@@ -452,7 +452,7 @@ pnpm dev
452
452
  होस्टेड ऐप-समर्थित कौशल का उपयोग करता है:
453
453
 
454
454
  - ऐप: `https://plan.agent-native.com`
455
- - MCP: `https://plan.agent-native.com/_agent-native/mcp`
455
+ - MCP: `https://plan.agent-native.com/mcp`
456
456
 
457
457
  स्थानीय टेम्पलेट तब उपयोगी होता है जब आप स्वयं योजनाएँ विकसित कर रहे हों, स्थानीय दृढ़ता का परीक्षण कर रहे हों, या पूरी तरह से स्व-होस्टेड समीक्षा सतह चला रहे हों।
458
458
 
@@ -540,7 +540,7 @@ JSON 入力は、エージェントおよび複雑なオブジェクトに推奨
540
540
 
541
541
  ## MCP 上で公開 {#mcp}
542
542
 
543
- MCP を有効にすると、actions はフレームワークの MCP サーバー (`/_agent-native/mcp`) に表示されます。すべての呼び出し元は、デフォルトでコンパクトなカタログ (アプリ向けの組み込みとテンプレートで宣言されたアプリ actions) を取得します。また、`tool-search` は常に存在するため、他のツールはオンデマンドでアクセスできます。完全なアクション サーフェスは明示的なオプトイン (`--full-catalog` トークンまたは `AGENT_NATIVE_MCP_FULL_CATALOG=1`) でのみ提供され、`publicAgent.expose` はパブリック サーフェスへの安全な読み取り/取り込みツールを選択します。カタログ層、認証、および `mcpApp` リソースの詳細については、「[MCP Protocol](/docs/mcp-protocol)」を参照してください。
543
+ MCP を有効にすると、actions はフレームワークの MCP サーバー (`/mcp`) に表示されます。すべての呼び出し元は、デフォルトでコンパクトなカタログ (アプリ向けの組み込みとテンプレートで宣言されたアプリ actions) を取得します。また、`tool-search` は常に存在するため、他のツールはオンデマンドでアクセスできます。完全なアクション サーフェスは明示的なオプトイン (`--full-catalog` トークンまたは `AGENT_NATIVE_MCP_FULL_CATALOG=1`) でのみ提供され、`publicAgent.expose` はパブリック サーフェスへの安全な読み取り/取り込みツールを選択します。カタログ層、認証、および `mcpApp` リソースの詳細については、「[MCP Protocol](/docs/mcp-protocol)」を参照してください。
544
544
 
545
545
  UI 対応の MCP ホストの場合、アクションは `mcpApp` フィールド (および一致する `link`) を介してオプションの MCP アプリ リソースを宣言できるため、対応するホストは結果をインラインでレンダリングします。 `link` と `mcpApp` が同じルートを指す必要がある場合、`embedRoute()` は 1 つの純粋なパス ビルダーから両方を構築します。
546
546
 
@@ -219,7 +219,7 @@ ACCESS_TOKENS=token1,token2,token3
219
219
  すべてのアプリの MCP エンドポイントは、標準の保護された MCP リソースとして機能できます。 OAuth 対応クライアントは、リモート MCP URL のみで構成できます:
220
220
 
221
221
  ```text
222
- https://mail.agent-native.com/_agent-native/mcp
222
+ https://mail.agent-native.com/mcp
223
223
  ```
224
224
 
225
225
  認証されていない MCP リクエストは、`/.well-known/oauth-protected-resource` を指す `WWW-Authenticate` チャレンジを返します。次に、クライアントはアプリの OAuth メタデータを検出し、パブリック クライアントを動的に登録し、アプリの認証ページを開き、アクセス トークンとリフレッシュ トークンのために認証コードを PKCE と交換します。
@@ -113,16 +113,16 @@ Dispatch は、ワークスペース内の他のアプリを A2A ピアとして
113
113
 
114
114
  ### 統合 MCP ゲートウェイ
115
115
 
116
- ディスパッチは、外部エージェントの単一の MCP コネクタにすることができます。Claude、ChatGPT、Codex、または Cursor に `https://dispatch.agent-native.com/_agent-native/mcp` を 1 回追加すると、アプリごとに 1 つのコネクタではなく、付与されたすべてのワークスペース アプリに 1 つの承認が到達します。完全な接続フロー、アプリ許可、OAuth、およびインライン MCP アプリ プレビューについては、[External Agents](/docs/external-agents) を参照してください。
116
+ ディスパッチは、外部エージェントの単一の MCP コネクタにすることができます。Claude、ChatGPT、Codex、または Cursor に `https://dispatch.agent-native.com/mcp` を 1 回追加すると、アプリごとに 1 つのコネクタではなく、付与されたすべてのワークスペース アプリに 1 つの承認が到達します。完全な接続フロー、アプリ許可、OAuth、およびインライン MCP アプリ プレビューについては、[External Agents](/docs/external-agents) を参照してください。
117
117
 
118
- <Endpoint id="doc-block-1hsfyib" method="POST" path="/_agent-native/mcp" summary={"統合 MCP ゲートウェイ エンドポイント"} auth="Standard remote MCP OAuth, handled by the framework. The granted-app set scopes which workspace apps the connector can reach." responses={[
118
+ <Endpoint id="doc-block-1hsfyib" method="POST" path="/mcp" summary={"統合 MCP ゲートウェイ エンドポイント"} auth="Standard remote MCP OAuth, handled by the framework. The granted-app set scopes which workspace apps the connector can reach." responses={[
119
119
  {
120
120
  "status": "200",
121
121
  "description": "MCP JSON-RPC response — tools, resources, and MCP App UI resources aggregated across granted workspace apps."
122
122
  }
123
123
  ]}>
124
124
 
125
- The single MCP connector URL external agents add (e.g. `https://dispatch.agent-native.com/_agent-native/mcp`). One authorization here reaches every **granted** workspace app instead of wiring one connector per app. App grants, OAuth, and inline MCP App previews are covered in [External Agents](/docs/external-agents).
125
+ The single MCP connector URL external agents add (e.g. `https://dispatch.agent-native.com/mcp`). One authorization here reaches every **granted** workspace app instead of wiring one connector per app. App grants, OAuth, and inline MCP App previews are covered in [External Agents](/docs/external-agents).
126
126
 
127
127
  </Endpoint>
128
128
 
@@ -98,7 +98,7 @@ Agent-Native を使用するホストにリモート MCP コネクタを 1 つ
98
98
  ワークスペースまたはクロスアプリ作業の場合は、Dispatch を使用します。
99
99
 
100
100
  ```text
101
- https://dispatch.agent-native.com/_agent-native/mcp
101
+ https://dispatch.agent-native.com/mcp
102
102
  ```
103
103
 
104
104
  Dispatch は、メール、カレンダー、分析、脳、そしてあなたの
@@ -109,12 +109,12 @@ Dispatch は、メール、カレンダー、分析、脳、そしてあなた
109
109
  意図的に分離された 1 つのアプリの場合、そのアプリを直接使用します。
110
110
 
111
111
  ```text
112
- https://mail.agent-native.com/_agent-native/mcp
113
- https://<your-app>.agent-native.com/_agent-native/mcp
112
+ https://mail.agent-native.com/mcp
113
+ https://<your-app>.agent-native.com/mcp
114
114
  ```
115
115
 
116
116
  ホストされているすべてのアプリには、ヘルパー ページもあります
117
- `https://&lt;app&gt;/_agent-native/mcp/connect` とコピー可能な URL および
117
+ `https://&lt;app&gt;/mcp/connect` とコピー可能な URL および
118
118
  Claude、ChatGPT、カーソル、Claude コード、Codex、その他のホスト固有のタブ。
119
119
 
120
120
  ### Claude および ChatGPT OAuth {#oauth}
@@ -237,7 +237,7 @@ npx @agent-native/core@latest connect https://mail.agent-native.com
237
237
  npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex
238
238
  ```
239
239
 
240
- `reconnect` は、指定されたホストおよび選択されたクライアント (コネクタ名に関係なく、URL で一致) について、URL が `/_agent-native/mcp` で終わる MCP 構成エントリを検索し、インストールされている skills に手を触れたり、完全なインストール フローを再実行したりすることなく、認証マテリアルを更新または置換します。ベースアプリ URL (例: `https://plan.agent-native.com`) を渡します — `/_agent-native/mcp` サフィックスが推測されます。認証とツールの読み込みはクライアントごとに行われるため、後でそのクライアントを再起動/再読み込みします。 Codex は、新しくロードされたツールが表示される前に、新しいセッションが必要です。
240
+ `reconnect` は、指定されたホストおよび選択されたクライアント (コネクタ名に関係なく、URL で一致) について、URL が `/mcp` で終わる MCP 構成エントリを検索し、インストールされている skills に手を触れたり、完全なインストール フローを再実行したりすることなく、認証マテリアルを更新または置換します。ベースアプリ URL (例: `https://plan.agent-native.com`) を渡します — `/mcp` サフィックスが推測されます。認証とツールの読み込みはクライアントごとに行われるため、後でそのクライアントを再起動/再読み込みします。 Codex は、新しくロードされたツールが表示される前に、新しいセッションが必要です。
241
241
 
242
242
  Claude コードでは、同等の UI パスは次のとおりです: `/mcp` を実行し、関連するコネクタに対して **認証** (または **再接続**) を選択します。
243
243
 
@@ -245,7 +245,7 @@ Claude コードでは、同等の UI パスは次のとおりです: `/mcp` を
245
245
 
246
246
  ### ページのフォールバック接続 {#connect-page-fallback}
247
247
 
248
- リモート OAuth URL を直接追加できない MCP クライアントの場合は、ブラウザでアプリを開いて、**接続** アフォーダンス (`https://&lt;app&gt;/_agent-native/mcp/connect` で提供) を使用します。ログインした状態で、**接続 / 認証** をクリックします。このページでは、検出されたエージェントを構成するワンクリックのディープ リンク、またはすぐに貼り付けられる `.mcp.json` ブロックのいずれかを提供します。
248
+ リモート OAuth URL を直接追加できない MCP クライアントの場合は、ブラウザでアプリを開いて、**接続** アフォーダンス (`https://&lt;app&gt;/mcp/connect` で提供) を使用します。ログインした状態で、**接続 / 認証** をクリックします。このページでは、検出されたエージェントを構成するワンクリックのディープ リンク、またはすぐに貼り付けられる `.mcp.json` ブロックのいずれかを提供します。
249
249
 
250
250
  ```jsonc
251
251
  // .mcp.json
@@ -253,7 +253,7 @@ Claude コードでは、同等の UI パスは次のとおりです: `/mcp` を
253
253
  "mcpServers": {
254
254
  "mail": {
255
255
  "type": "http",
256
- "url": "https://mail.agent-native.com/_agent-native/mcp",
256
+ "url": "https://mail.agent-native.com/mcp",
257
257
  "headers": { "Authorization": "Bearer <minted-token>" },
258
258
  },
259
259
  },
@@ -270,13 +270,13 @@ Claude コードでは、同等の UI パスは次のとおりです: `/mcp` を
270
270
 
271
271
  ```bash
272
272
  claude mcp add --transport http agent-native \
273
- https://dispatch.agent-native.com/_agent-native/mcp
273
+ https://dispatch.agent-native.com/mcp
274
274
  ```
275
275
 
276
276
  これは、`npx @agent-native/core@latest connect https://dispatch.agent-native.com --client claude-code` があなたのために書くのと同じ URL 専用のエントリです。次に、Claude コードで `/mcp` を実行し、**認証** を選択します。クライアントは、MCP サーバーの `401 WWW-Authenticate` チャレンジから認証を検出し、`/.well-known/oauth-protected-resource` と `/.well-known/oauth-authorization-server` を取得し、パブリック OAuth クライアントを動的に登録し、アプリの認証ページを開き、結果のトークンを安全に保存します。 ChatGPT 開発者モード コネクタは同じサーバー URL を使用します。
277
277
 
278
278
  ```text
279
- https://dispatch.agent-native.com/_agent-native/mcp
279
+ https://dispatch.agent-native.com/mcp
280
280
  ```
281
281
 
282
282
  OAuth フローは、リフレッシュ トークン ローテーションを伴う認証コード + PKCE です。アクセス トークンは、正確な MCP リソース URL にオーディエンス バインドされ、署名されたユーザー/組織 ID を保持するため、ツール呼び出し、`resources/read`、および MCP アプリ iframe で開始された `tools/call` はすべて、既存の接続ミント JWT パスと同じ `runWithRequestContext` テナント スコープを通じて実行されます。 iframe は生の OAuth トークンを受信しません。ホストは、認証された MCP 接続を通じて通話を仲介します。
@@ -500,13 +500,13 @@ ChatGPT/Claude スタイルの OAuth アプリ ホストの場合、検出サー
500
500
 
501
501
  アクションごとのツールに加えて、MCP サーバーは安定した動詞セットを公開するため、外部エージェントはアプリごとのアクション名を推測することなく予測可能な表面を持ちます。
502
502
 
503
- | ツール | 副作用 | 返品 |
504
- | -------------------------------------------------- | ------------------- | --------------------------------------------------------------------------------------------------------------------------- |
505
- | `list_apps` | なし | ワークスペース アプリ + その URL / 実行状態 |
506
- | `open_app({ app, view?, path?, params?, embed? })` | なし | ディープリンクまたは同一発信元ルート。 `embed: true` は、サポートされている場合、アプリ全体をインラインでレンダリングします |
507
- | `ask_app({ app, message })` | エージェント ループ | 自然言語タスクをそのアプリのアプリ内エージェント (`ask-agent` に委任) にルーティングします |
508
- | `create_workspace_app({ name, template })` | 足場 | ワークスペース パス経由で起動された新しいアプリと、実行中の URL + ディープ リンク |
509
- | `list_templates` | なし | 許可リストに登録されたテンプレートのみ |
503
+ | ツール | 副作用 | 返品 |
504
+ | -------------------------------------------------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
505
+ | `list_apps` | なし | ワークスペース アプリ + その URL / 実行状態 |
506
+ | `open_app({ app, view?, path?, params?, embed? })` | なし | ディープリンクまたは同一発信元ルート。 `embed: true` は、サポートされている場合、アプリ全体をインラインでレンダリングします |
507
+ | `ask_app({ app, message, async?, maxWaitMs? })` | エージェント ループ | 自然言語タスクをそのアプリのアプリ内エージェントにルーティングします。長時間の処理では、`ask_app_status` でポーリングするための永続的な `taskId` を返します |
508
+ | `create_workspace_app({ name, template })` | 足場 | ワークスペース パス経由で起動された新しいアプリと、実行中の URL + ディープ リンク |
509
+ | `list_templates` | なし | 許可リストに登録されたテンプレートのみ |
510
510
 
511
511
  `create_workspace_app` は、許可リストに登録されていないテンプレートを拒否します。`packages/shared-app-config/templates.ts` のパブリック テンプレートの許可リストは権限があり、CI で保護されています。外部エージェントがそれを広げることはできません。同じ名前のテンプレート アクションは、組み込みをオーバーライドします (コアよりテンプレートが優先されます)。 `MCPConfig.builtinCrossAppTools: false` でセット全体を無効にします。
512
512
 
@@ -514,6 +514,10 @@ ChatGPT/Claude スタイルの OAuth アプリ ホストの場合、検出サー
514
514
 
515
515
  高速 ChatGPT/Claude ハンドオフの場合、理想的なパスは直接パスです。アーティファクトを作成または開くアクションを呼び出してから、MCP アプリにルートを起動させます。 Mail リクエストは `manage_draft` を呼び出し、実際の作成ルートをレンダリングする必要があります。ダッシュボード リクエストでは、`open_app({ path, embed: true })` を呼び出すか、`mcpApp` を使用してダッシュボード アクションを呼び出し、完全な Analytics ルートをレンダリングする必要があります。カレンダー、フォーム、コンテンツ、スライド、デザイン、クリップは、下書き/作成/検索 actions と同じパターンに従う必要があります。 `list_apps` は、モデルが許可されたアプリの中から選択する必要がある場合に便利です。広範な `resources/list`、フルカタログ検出、または `ask_app` 委任は、明らかな UI ハンドオフの通常のルートであってはなりません。
516
516
 
517
+ ### 長時間実行されるエージェント リクエスト
518
+
519
+ MCP ホストとゲートウェイは、単一の長いツール呼び出しタイムアウトを共有していません。5 分の上限を課すものもあれば、設定可能なものもあります。10 分間ブロックする `tools/call` を前提に外部エージェント連携を設計しないでください。 `ask-agent` と `ask_app` はホストされている処理をすぐに確認応答し、インライン待機が期限切れになると永続的な `taskId` を返します。返された `app` と `taskId` を使用して `ask_app_status` でポーリングしてください。結果にはホストにとって扱いやすい間隔として `pollAfterMs` が含まれます。タスクは最初のレスポンスがタイムアウトする前に作成されている必要があるため、長い呼び出しの後にのみ返されるポーリング URL は信頼できる復旧手段ではありません。
520
+
517
521
  ### アプリごとのツアー {#tour}
518
522
 
519
523
  ナビゲート可能なリソースを生成またはリストする許可リストに登録されたすべてのテンプレートには `link` ビルダーが同梱されており、取り込みが多いテンプレートには GET + `publicAgent` アクションが同梱されているため、接続されたエージェントはライブ状態を取得できます。
@@ -677,7 +681,7 @@ npx @agent-native/core@latest mcp install --client claude-code|claude-code-cli|c
677
681
  - **cowork** — `~/.cowork/mcp.json` 内の同じ Claude コード JSON 形状。
678
682
  - **codex** — `~/.codex/config.toml` 内の `[mcp_servers.<name>]` ブロック。
679
683
 
680
- このエントリは `npx @agent-native/core@latest mcp serve --app <id>` を実行します。これはデフォルトで、実行中のローカル アプリの `/_agent-native/mcp` への **シン stdio プロキシ**です。そのため、ライブ アクション レジストリ、HMR、および正しいディープ リンクが唯一の信頼できる情報源のままになります。代わりに `--standalone` を渡して、インプロセスでレジストリを構築します。 `npx @agent-native/core@latest mcp install` がホストされたオリジン (ワークスペース `.env` 内の非ローカルホスト `APP_URL` / `BETTER_AUTH_URL` / `AGENT_NATIVE_MCP_URL`) を検出すると、stdio エントリの代わりに、`Bearer` JWT を持つ `<origin>/_agent-native/mcp` を指す `http` クライアント エントリを書き込みます。
684
+ このエントリは `npx @agent-native/core@latest mcp serve --app <id>` を実行します。これはデフォルトで、実行中のローカル アプリの `/mcp` への **シン stdio プロキシ**です。そのため、ライブ アクション レジストリ、HMR、および正しいディープ リンクが唯一の信頼できる情報源のままになります。代わりに `--standalone` を渡して、インプロセスでレジストリを構築します。 `npx @agent-native/core@latest mcp install` がホストされたオリジン (ワークスペース `.env` 内の非ローカルホスト `APP_URL` / `BETTER_AUTH_URL` / `AGENT_NATIVE_MCP_URL`) を検出すると、stdio エントリの代わりに、`Bearer` JWT を持つ `<origin>/mcp` を指す `http` クライアント エントリを書き込みます。
681
685
 
682
686
  コンパニオンサブコマンド:
683
687
 
@@ -701,7 +705,7 @@ npx @agent-native/core@latest mcp install --client claude-code|claude-code-cli|c
701
705
  "mcpServers": {
702
706
  "analytics": {
703
707
  "type": "http",
704
- "url": "https://analytics.agent-native.com/_agent-native/mcp",
708
+ "url": "https://analytics.agent-native.com/mcp",
705
709
  "headers": { "Authorization": "Bearer <ACCESS_TOKEN-or-JWT>" },
706
710
  },
707
711
  },
@@ -743,7 +747,7 @@ npx @agent-native/core@latest connect prod --apps mail,calendar,analytics --clie
743
747
  フォールバック ホスト型 `connect` フローは、展開の共有秘密をコピーしません。代わりに:
744
748
 
745
749
  - ログインしたブラウザ セッションは、**ユーザーごとのスコープ指定された取り消し可能な** トークン (呼び出し元の `sub` + `org_domain` および一意の `jti` を保持する `A2A_SECRET` 署名付き JWT) を生成するため、すべてのツールの実行は `runWithRequestContext` を介してテナント スコープのままになります。
746
- - 既存の `/_agent-native/mcp` エンドポイントは、他のベアラーと同様にそのトークンを受け入れます ([MCP Protocol](/docs/mcp-protocol) を参照)。新しいエンドポイントや新しいトランスポートはありません。
750
+ - 既存の `/mcp` エンドポイントは、他のベアラーと同様にそのトークンを受け入れます ([MCP Protocol](/docs/mcp-protocol) を参照)。新しいエンドポイントや新しいトランスポートはありません。
747
751
  - 同じ接続ページには、作成したすべてのトークンがリストされ、`jti` によってそれらのトークンを**取り消す**ことができます。それらを個人用アクセス トークンのように扱います。エージェント クライアントごとに 1 つ、マシンが廃止されると取り消されます。
748
752
  - エージェントが返すディープリンクには特権状態はありません。レコードに焦点を当てた `navigate` 書き込みは常に **ブラウザ** セッションにスコープされ、エージェントのトークンにはスコープされません。そのため、リンクをターミナルまたはチャット記録に安全に貼り付けることができます。
749
753
 
@@ -246,6 +246,35 @@ MCP ツールはノード ランタイムでのみ有効になります — Clou
246
246
 
247
247
  MCP (モデル コンテキスト プロトコル) サーバーは、Zapier、Cloudflare、Composio、または会社の内部ツールへの接続など、エージェントに新しい機能を提供します。接続すると、エージェントはこれらのツールを組み込みツールと同じように使用できるようになります。
248
248
 
249
+ プリセット ID は `context7`、`sentry`、`notion`、`semgrep`、`linear`、
250
+ `atlassian`、`supabase`、`neon`、`stripe` です。
251
+
252
+ ### Atlassian / Jira
253
+
254
+ Atlassian プリセットは、Atlassian Rovo MCP の OAuth 2.1 エンドポイント
255
+ `https://mcp.atlassian.com/v1/mcp/authv2` を使用し、Jira と Confluence の
256
+ ツールを提供します。Jira チケットの作成には、Jira への書き込みを許可する
257
+ Atlassian 権限が必要です。ユーザーがアクセスできるのは、引き続き自身の
258
+ Atlassian アカウントで許可されたプロジェクトとコンテンツだけです。
259
+
260
+ Atlassian の組織管理者は、OAuth クライアントの接続を許可するかどうかを
261
+ 管理できます。接続する前に、管理者がアプリの実際の HTTPS オリジンを
262
+ **Atlassian Administration → Rovo → Rovo MCP server → Domains** の
263
+ 信頼済みドメイン一覧に追加し、**Permissions** で必要な **Read**、
264
+ **Write**、**Search** 権限を有効にする必要がある場合があります。
265
+ ドメインには Agent-Native アプリが実行されるホストを指定してください。
266
+ 実際のオリジンでない限り、別のデプロイに `https://builder.io/**` を
267
+ コピーしないでください。Atlassian の [Rovo MCP セットアップガイド](https://developer.atlassian.com/cloud/rovo-mcp/guides/getting-started/)
268
+ と [管理者向け制御](https://support.atlassian.com/security-and-access-policies/docs/control-atlassian-rovo-mcp-server-settings/)も参照してください。
269
+
270
+ カタログには、エンドポイントとセットアップ手順が用意されています。
271
+ 汎用設定フォームにはエンドポイントとオプションの暗号化ヘッダーが保存されますが、
272
+ Atlassian の対話型 OAuth 同意フローの代わりにはなりません。Atlassian が
273
+ 対話型 OAuth を要求する場合は、OAuth 対応の MCP クライアントまたはランタイムを
274
+ 使用してください。プロバイダーまたはランタイムが静的ベアラー トークンに
275
+ 対応している場合は、承認済みのシークレット管理手順に従い、プロンプトや
276
+ コミット対象の設定にトークンを貼り付けないでください。
277
+
249
278
  ### リモート MCP サーバーに接続する方法
250
279
 
251
280
  1. **サーバー名** — 独自の参照用の短いラベル (例: "zapier"、"slack-tools")。
@@ -264,7 +293,7 @@ MCP (モデル コンテキスト プロトコル) サーバーは、Zapier、Cl
264
293
 
265
294
  実行中の MCP マネージャーにホットリロードを追加および削除します。プロセスの再起動やサーバーの再起動はありません。新しい `mcp__<scope>-<name>__*` ツールは次のメッセージでエージェントに表示され、`tool-search` 経由で検索できます。
266
295
 
267
- HTTPS URL はどこでも受け入れられます。プレーン `http://` は、開発中に `localhost` に対してのみ許可されます。オプションの認証は、リクエストごとに `Authorization: Bearer …` 経由で送信されるベアラー トークンとして入力されます。
296
+ HTTPS URL はどこでも受け入れられます。プレーン `http://` は、開発中に `localhost` に対してのみ許可されます。オプションの認証は、リクエストごとに `Authorization: Bearer …` 経由で送信されるベアラー トークンとして入力されます。Atlassian Rovo MCP を含む OAuth 専用プロバイダーでは、静的ヘッダーではなく、プロバイダーの OAuth フローを使用する必要があります。
268
297
 
269
298
  内部では、これらのサーバーはキー `u:<email>:mcp-servers-remote` (個人) または `o:<orgId>:mcp-servers-remote` (チーム) の下でフレームワークの `settings` テーブルに保存され、起動時に `mcp.config.json` とマージされます。
270
299
 
@@ -293,7 +322,9 @@ Dispatch は従来のハブであり、すでにアプリ間で調整されて
293
322
  <div class="diagram-panel center" data-rough>
294
323
  <span class="diagram-pill accent">Dispatch hub</span
295
324
  ><small class="diagram-muted">組織スコープのMCPサーバー</small
296
- ><small class="diagram-muted"><code>GET /mcp/hub/servers</code></small>
325
+ ><small class="diagram-muted"
326
+ ><code>GET /_agent-native/mcp/hub/servers</code></small
327
+ >
297
328
  </div>
298
329
  <div class="diagram-col arrows">
299
330
  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
@@ -455,7 +486,7 @@ Reports which configured servers connected, the total live tool count, the merge
455
486
 
456
487
  個々の MCP サーバーの障害によってエージェントがダウンすることはありません:
457
488
 
458
- - `command` の設定が間違っている → サーバーはスキップされ、そのエラーは `errors.<server-id>` の下の `/mcp/status` に表示され、他のすべてのサーバーは引き続き動作します。
489
+ - `command` の設定が間違っている → サーバーはスキップされ、そのエラーは `errors.<server-id>` の下の `/_agent-native/mcp/status` に表示され、他のすべてのサーバーは引き続き動作します。
459
490
  - MCP SDK が `node_modules` にありません → すべての MCP 機能が警告とともにスキップされます。エージェント チャットは、MCP ツールを使用しなくても機能し続けます。
460
491
  - エッジ ランタイムで実行 → MCP クライアントは何もしません。
461
492