@agent-native/core 0.100.1 → 0.101.2

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 (387) hide show
  1. package/corpus/README.md +2 -2
  2. package/corpus/core/CHANGELOG.md +73 -0
  3. package/corpus/core/docs/content/locales/ar-SA/pr-visual-recap.mdx +48 -30
  4. package/corpus/core/docs/content/locales/ar-SA/template-plan.mdx +7 -0
  5. package/corpus/core/docs/content/locales/de-DE/pr-visual-recap.mdx +48 -30
  6. package/corpus/core/docs/content/locales/de-DE/template-plan.mdx +7 -0
  7. package/corpus/core/docs/content/locales/es-ES/pr-visual-recap.mdx +48 -30
  8. package/corpus/core/docs/content/locales/es-ES/template-plan.mdx +14 -0
  9. package/corpus/core/docs/content/locales/fr-FR/pr-visual-recap.mdx +48 -30
  10. package/corpus/core/docs/content/locales/fr-FR/template-plan.mdx +7 -0
  11. package/corpus/core/docs/content/locales/hi-IN/pr-visual-recap.mdx +48 -30
  12. package/corpus/core/docs/content/locales/hi-IN/template-plan.mdx +7 -0
  13. package/corpus/core/docs/content/locales/ja-JP/pr-visual-recap.mdx +48 -30
  14. package/corpus/core/docs/content/locales/ja-JP/template-plan.mdx +7 -0
  15. package/corpus/core/docs/content/locales/ko-KR/pr-visual-recap.mdx +48 -30
  16. package/corpus/core/docs/content/locales/ko-KR/template-plan.mdx +7 -0
  17. package/corpus/core/docs/content/locales/pt-BR/pr-visual-recap.mdx +48 -30
  18. package/corpus/core/docs/content/locales/pt-BR/template-plan.mdx +14 -0
  19. package/corpus/core/docs/content/locales/zh-CN/pr-visual-recap.mdx +48 -30
  20. package/corpus/core/docs/content/locales/zh-CN/template-plan.mdx +7 -0
  21. package/corpus/core/docs/content/locales/zh-TW/pr-visual-recap.mdx +48 -30
  22. package/corpus/core/docs/content/locales/zh-TW/template-plan.mdx +7 -0
  23. package/corpus/core/docs/content/pr-visual-recap.mdx +50 -32
  24. package/corpus/core/docs/content/template-plan.mdx +14 -0
  25. package/corpus/core/docs/content/toolkit-comments-review.mdx +16 -2
  26. package/corpus/core/package.json +4 -1
  27. package/corpus/core/src/a2a/index.ts +2 -1
  28. package/corpus/core/src/a2a/server.ts +34 -9
  29. package/corpus/core/src/agent/production-agent.ts +56 -10
  30. package/corpus/core/src/cli/create.ts +47 -19
  31. package/corpus/core/src/cli/pr-visual-recap-workflow.ts +2 -3
  32. package/corpus/core/src/cli/recap.ts +3 -4932
  33. package/corpus/core/src/cli/skills-content/visual-plan-skill.ts +6 -4
  34. package/corpus/core/src/cli/skills-content/visual-recap-skill.ts +7 -1
  35. package/corpus/core/src/client/AgentPanel.tsx +19 -17
  36. package/corpus/core/src/client/AssistantChat.tsx +4 -0
  37. package/corpus/core/src/client/analytics.ts +8 -1
  38. package/corpus/core/src/client/chat/markdown-renderer.tsx +54 -8
  39. package/corpus/core/src/client/chat/message-components.tsx +8 -2
  40. package/corpus/core/src/client/clipboard.ts +28 -1
  41. package/corpus/core/src/client/composer/PromptComposer.tsx +4 -0
  42. package/corpus/core/src/client/composer/TiptapComposer.tsx +30 -3
  43. package/corpus/core/src/client/guided-questions.tsx +4 -0
  44. package/corpus/core/src/client/i18n.tsx +2 -1
  45. package/corpus/core/src/client/index.ts +4 -0
  46. package/corpus/core/src/client/review/ReviewCommentComposer.tsx +108 -0
  47. package/corpus/core/src/client/review/ReviewThreadPanel.tsx +482 -150
  48. package/corpus/core/src/client/review/index.ts +8 -0
  49. package/corpus/core/src/client/review/use-review.ts +35 -1
  50. package/corpus/core/src/client/use-agent-chat-context.ts +3 -2
  51. package/corpus/core/src/integrations/webhook-handler.ts +4 -2
  52. package/corpus/core/src/review/actions/create-review-comment.ts +2 -1
  53. package/corpus/core/src/review/actions/get-review-feedback.ts +6 -11
  54. package/corpus/core/src/review/actions/list-review-comments.ts +38 -4
  55. package/corpus/core/src/review/actions/reply-review-comment.ts +33 -22
  56. package/corpus/core/src/review/actions/resolve-review-thread.ts +29 -2
  57. package/corpus/core/src/review/actions/send-review-thread-to-agent.ts +62 -0
  58. package/corpus/core/src/review/identity.ts +101 -0
  59. package/corpus/core/src/review/index.ts +14 -0
  60. package/corpus/core/src/review/store.ts +315 -8
  61. package/corpus/core/src/review/types.ts +4 -0
  62. package/corpus/core/src/secrets/crypto.ts +98 -47
  63. package/corpus/core/src/secrets/index.ts +2 -1
  64. package/corpus/core/src/secrets/schema.ts +3 -0
  65. package/corpus/core/src/secrets/storage.ts +164 -31
  66. package/corpus/core/src/server/action-discovery.ts +4 -0
  67. package/corpus/core/src/server/action-routes.ts +125 -4
  68. package/corpus/core/src/server/agent-chat/plugin-options.ts +16 -0
  69. package/corpus/core/src/server/agent-chat-plugin.ts +1 -0
  70. package/corpus/core/src/server/index.ts +8 -0
  71. package/corpus/core/src/vite/action-types-plugin.ts +4 -0
  72. package/corpus/templates/analytics/changelog/2026-07-14-daily-dashboard-email-captures-authenticate-with-a-sessi.md +6 -0
  73. package/corpus/templates/analytics/server/lib/dashboard-report.ts +156 -3
  74. package/corpus/templates/assets/app/components/generation/GenerationResults.tsx +402 -142
  75. package/corpus/templates/assets/app/components/layout/Layout.tsx +4 -0
  76. package/corpus/templates/assets/app/hooks/use-navigation-state.ts +3 -1
  77. package/corpus/templates/assets/app/i18n/zh-TW.ts +1 -0
  78. package/corpus/templates/assets/app/i18n-data.ts +1 -0
  79. package/corpus/templates/assets/app/routes/library.tsx +187 -48
  80. package/corpus/templates/assets/changelog/2026-07-13-assets-keeps-the-right-chat-sidebar-closed-when-the-full-pag.md +6 -0
  81. package/corpus/templates/assets/changelog/2026-07-13-merged-the-candidates-panel-into-the-library-as-a-drafts-tab.md +6 -0
  82. package/corpus/templates/chat/app/lib/agent-page.tsx +40 -0
  83. package/corpus/templates/chat/app/routes/agent.tsx +5 -3
  84. package/corpus/templates/chat/changelog/2026-07-14-fixed-chat-template-startup-with-older-core-versions.md +6 -0
  85. package/corpus/templates/clips/.agents/skills/ai-video-tools/SKILL.md +5 -0
  86. package/corpus/templates/clips/AGENTS.md +4 -0
  87. package/corpus/templates/clips/actions/get-feature-flags.ts +30 -0
  88. package/corpus/templates/clips/actions/lib/transcript-preview.ts +48 -0
  89. package/corpus/templates/clips/actions/request-transcript.ts +41 -1
  90. package/corpus/templates/clips/actions/view-screen.ts +5 -9
  91. package/corpus/templates/clips/app/components/library/library-layout.tsx +1 -1
  92. package/corpus/templates/clips/app/components/player/video-player.tsx +39 -1
  93. package/corpus/templates/clips/app/hooks/use-desktop-promo.ts +6 -12
  94. package/corpus/templates/clips/app/hooks/use-mse-video-source.ts +146 -0
  95. package/corpus/templates/clips/app/lib/capture-install-options.ts +21 -0
  96. package/corpus/templates/clips/app/lib/fmp4.ts +271 -0
  97. package/corpus/templates/clips/app/lib/mse-video-loader.ts +585 -0
  98. package/corpus/templates/clips/app/routes/_app.dictate.tsx +0 -4
  99. package/corpus/templates/clips/app/routes/_app.meetings.$meetingId.tsx +5 -13
  100. package/corpus/templates/clips/app/routes/_app.meetings._index.tsx +2 -37
  101. package/corpus/templates/clips/app/routes/download.tsx +3 -2
  102. package/corpus/templates/clips/changelog/2026-07-10-shared-clips-now-start-playing-instantly-instead-of-showing-.md +6 -0
  103. package/corpus/templates/clips/changelog/2026-07-14-clips-now-distinguishes-transcript-previews-from-incomplete-.md +6 -0
  104. package/corpus/templates/clips/changelog/2026-07-14-desktop-app-prompts-stay-hidden-after-you-download-the-insta.md +6 -0
  105. package/corpus/templates/clips/desktop/src/lib/recorder.ts +5 -0
  106. package/corpus/templates/clips/desktop/src/overlays/recording-pill.tsx +10 -0
  107. package/corpus/templates/clips/desktop/src-tauri/src/lib.rs +4 -0
  108. package/corpus/templates/clips/desktop/src-tauri/src/native_screen/custom_capture.rs +2518 -0
  109. package/corpus/templates/clips/desktop/src-tauri/src/native_screen/live_upload.rs +353 -0
  110. package/corpus/templates/clips/desktop/src-tauri/src/native_screen.rs +558 -67
  111. package/corpus/templates/clips/desktop/src-tauri/src/recording_indicator.rs +11 -1
  112. package/corpus/templates/clips/desktop/src-tauri/src/remote_flags.rs +188 -0
  113. package/corpus/templates/clips/desktop/src-tauri/src/whisper_speech.rs +1 -1
  114. package/corpus/templates/clips/server/lib/post-finalize-dispatch.ts +1 -0
  115. package/corpus/templates/clips/server/plugins/agent-chat.ts +5 -0
  116. package/corpus/templates/clips/server/routes/api/_agent-native-background/post-finalize-worker.post.ts +5 -1
  117. package/corpus/templates/clips/shared/feature-flags.ts +41 -0
  118. package/corpus/templates/design/.agents/skills/design-generation/SKILL.md +3 -0
  119. package/corpus/templates/design/.agents/skills/design-review-feedback/SKILL.md +42 -0
  120. package/corpus/templates/design/AGENTS.md +6 -0
  121. package/corpus/templates/design/README.md +1 -0
  122. package/corpus/templates/design/actions/navigate.ts +4 -4
  123. package/corpus/templates/design/actions/view-screen.ts +116 -2
  124. package/corpus/templates/design/agent-native.app-skill.json +5 -0
  125. package/corpus/templates/design/app/components/design/DesignCanvas.tsx +52 -59
  126. package/corpus/templates/design/app/components/design/DesignExtensionsPanel.tsx +13 -9
  127. package/corpus/templates/design/app/components/design/EditPanel.tsx +79 -11
  128. package/corpus/templates/design/app/components/design/LayersPanel.tsx +78 -65
  129. package/corpus/templates/design/app/components/design/ReviewCommentsPanel.tsx +161 -0
  130. package/corpus/templates/design/app/components/design/ReviewStatusControl.tsx +96 -0
  131. package/corpus/templates/design/app/components/design/bridge/hit-test.bridge.ts +166 -0
  132. package/corpus/templates/design/app/components/layout/Layout.tsx +1 -0
  133. package/corpus/templates/design/app/components/visual-editor/ReviewCanvasPins.tsx +1077 -0
  134. package/corpus/templates/design/app/components/visual-editor/index.ts +1 -0
  135. package/corpus/templates/design/app/components/visual-editor/review-canvas-state.ts +42 -0
  136. package/corpus/templates/design/app/hooks/use-design-systems.ts +2 -2
  137. package/corpus/templates/design/app/hooks/use-navigation-state.ts +9 -6
  138. package/corpus/templates/design/app/hooks/use-question-flow.ts +7 -1
  139. package/corpus/templates/design/app/i18n/ar-SA.ts +56 -1
  140. package/corpus/templates/design/app/i18n/de-DE.ts +57 -1
  141. package/corpus/templates/design/app/i18n/en-US.ts +56 -1
  142. package/corpus/templates/design/app/i18n/es-ES.ts +56 -1
  143. package/corpus/templates/design/app/i18n/fr-FR.ts +57 -1
  144. package/corpus/templates/design/app/i18n/hi-IN.ts +56 -1
  145. package/corpus/templates/design/app/i18n/ja-JP.ts +56 -1
  146. package/corpus/templates/design/app/i18n/ko-KR.ts +56 -1
  147. package/corpus/templates/design/app/i18n/pt-BR.ts +57 -1
  148. package/corpus/templates/design/app/i18n/zh-CN.ts +56 -1
  149. package/corpus/templates/design/app/i18n/zh-TW.ts +51 -0
  150. package/corpus/templates/design/app/pages/Present.tsx +172 -14
  151. package/corpus/templates/design/app/pages/design-editor/overview-camera.ts +23 -0
  152. package/corpus/templates/design/app/pages/design-editor/tool-state.ts +10 -0
  153. package/corpus/templates/design/app/pages/present-review-state.ts +18 -0
  154. package/corpus/templates/design/app/public-routes.ts +8 -0
  155. package/corpus/templates/design/app/root.tsx +7 -6
  156. package/corpus/templates/design/changelog/2026-07-13-dragged-design-assets-now-appear-at-the-visible-drop-locatio.md +6 -0
  157. package/corpus/templates/design/changelog/2026-07-13-reviewers-can-pin-comments-on-shared-designs-and-apply-verif.md +6 -0
  158. package/corpus/templates/design/server/plugins/agent-chat.ts +10 -0
  159. package/corpus/templates/design/server/plugins/auth.ts +7 -5
  160. package/corpus/templates/design/server/plugins/review.ts +9 -0
  161. package/corpus/templates/design/shared/review-anchor.ts +83 -0
  162. package/corpus/templates/design/shared/review-summary.ts +25 -0
  163. package/corpus/templates/forms/.agents/skills/form-publishing/SKILL.md +2 -0
  164. package/corpus/templates/forms/AGENTS.md +4 -0
  165. package/corpus/templates/forms/actions/create-form.ts +2 -1
  166. package/corpus/templates/forms/actions/update-form.ts +5 -2
  167. package/corpus/templates/forms/app/i18n/ar-SA.ts +3 -0
  168. package/corpus/templates/forms/app/i18n/de-DE.ts +3 -0
  169. package/corpus/templates/forms/app/i18n/en-US.ts +3 -0
  170. package/corpus/templates/forms/app/i18n/es-ES.ts +3 -0
  171. package/corpus/templates/forms/app/i18n/fr-FR.ts +3 -0
  172. package/corpus/templates/forms/app/i18n/hi-IN.ts +3 -0
  173. package/corpus/templates/forms/app/i18n/ja-JP.ts +3 -0
  174. package/corpus/templates/forms/app/i18n/ko-KR.ts +3 -0
  175. package/corpus/templates/forms/app/i18n/pt-BR.ts +3 -0
  176. package/corpus/templates/forms/app/i18n/zh-CN.ts +3 -0
  177. package/corpus/templates/forms/app/i18n/zh-TW.ts +3 -0
  178. package/corpus/templates/forms/app/pages/FormBuilderPage.tsx +19 -0
  179. package/corpus/templates/forms/changelog/2026-07-14-fixed-the-ask-forms-loading-input-appearing-above-the-welcom.md +6 -0
  180. package/corpus/templates/forms/changelog/2026-07-14-form-social-previews-now-show-the-form-title-description-and.md +6 -0
  181. package/corpus/templates/forms/changelog/2026-07-14-forms-can-email-the-form-owner-when-new-responses-arrive.md +6 -0
  182. package/corpus/templates/forms/server/handlers/submissions.ts +17 -0
  183. package/corpus/templates/forms/server/lib/form-og-image.ts +64 -6
  184. package/corpus/templates/forms/server/lib/public-form-ssr.ts +6 -2
  185. package/corpus/templates/forms/server/lib/response-email.ts +65 -0
  186. package/corpus/templates/forms/server/plugins/agent-chat.ts +1 -0
  187. package/corpus/templates/forms/server/routes/api/forms/og/[...slug]/og.png.get.ts +184 -0
  188. package/corpus/templates/forms/shared/types.ts +2 -0
  189. package/corpus/templates/plan/.agents/skills/visual-plan/SKILL.md +6 -4
  190. package/corpus/templates/plan/.agents/skills/visual-recap/SKILL.md +7 -1
  191. package/dist/a2a/index.d.ts +2 -1
  192. package/dist/a2a/index.d.ts.map +1 -1
  193. package/dist/a2a/index.js +1 -1
  194. package/dist/a2a/index.js.map +1 -1
  195. package/dist/a2a/server.d.ts +25 -0
  196. package/dist/a2a/server.d.ts.map +1 -1
  197. package/dist/a2a/server.js +30 -6
  198. package/dist/a2a/server.js.map +1 -1
  199. package/dist/agent/production-agent.d.ts +2 -0
  200. package/dist/agent/production-agent.d.ts.map +1 -1
  201. package/dist/agent/production-agent.js +37 -12
  202. package/dist/agent/production-agent.js.map +1 -1
  203. package/dist/cli/create.d.ts +5 -3
  204. package/dist/cli/create.d.ts.map +1 -1
  205. package/dist/cli/create.js +44 -19
  206. package/dist/cli/create.js.map +1 -1
  207. package/dist/cli/pr-visual-recap-workflow.d.ts +2 -2
  208. package/dist/cli/pr-visual-recap-workflow.d.ts.map +1 -1
  209. package/dist/cli/pr-visual-recap-workflow.js +2 -2
  210. package/dist/cli/pr-visual-recap-workflow.js.map +1 -1
  211. package/dist/cli/recap.d.ts +3 -562
  212. package/dist/cli/recap.d.ts.map +1 -1
  213. package/dist/cli/recap.js +3 -3875
  214. package/dist/cli/recap.js.map +1 -1
  215. package/dist/cli/skills-content/visual-plan-skill.d.ts +1 -1
  216. package/dist/cli/skills-content/visual-plan-skill.d.ts.map +1 -1
  217. package/dist/cli/skills-content/visual-plan-skill.js +6 -4
  218. package/dist/cli/skills-content/visual-plan-skill.js.map +1 -1
  219. package/dist/cli/skills-content/visual-recap-skill.d.ts +1 -1
  220. package/dist/cli/skills-content/visual-recap-skill.d.ts.map +1 -1
  221. package/dist/cli/skills-content/visual-recap-skill.js +7 -1
  222. package/dist/cli/skills-content/visual-recap-skill.js.map +1 -1
  223. package/dist/client/AgentPanel.d.ts.map +1 -1
  224. package/dist/client/AgentPanel.js +3 -3
  225. package/dist/client/AgentPanel.js.map +1 -1
  226. package/dist/client/AssistantChat.d.ts +2 -0
  227. package/dist/client/AssistantChat.d.ts.map +1 -1
  228. package/dist/client/AssistantChat.js +2 -2
  229. package/dist/client/AssistantChat.js.map +1 -1
  230. package/dist/client/analytics.d.ts +5 -0
  231. package/dist/client/analytics.d.ts.map +1 -1
  232. package/dist/client/analytics.js +3 -1
  233. package/dist/client/analytics.js.map +1 -1
  234. package/dist/client/chat/markdown-renderer.d.ts +1 -0
  235. package/dist/client/chat/markdown-renderer.d.ts.map +1 -1
  236. package/dist/client/chat/markdown-renderer.js +36 -1
  237. package/dist/client/chat/markdown-renderer.js.map +1 -1
  238. package/dist/client/chat/message-components.d.ts.map +1 -1
  239. package/dist/client/chat/message-components.js +5 -2
  240. package/dist/client/chat/message-components.js.map +1 -1
  241. package/dist/client/clipboard.d.ts +3 -1
  242. package/dist/client/clipboard.d.ts.map +1 -1
  243. package/dist/client/clipboard.js +24 -1
  244. package/dist/client/clipboard.js.map +1 -1
  245. package/dist/client/composer/PromptComposer.d.ts +2 -0
  246. package/dist/client/composer/PromptComposer.d.ts.map +1 -1
  247. package/dist/client/composer/PromptComposer.js +2 -2
  248. package/dist/client/composer/PromptComposer.js.map +1 -1
  249. package/dist/client/composer/TiptapComposer.d.ts +3 -1
  250. package/dist/client/composer/TiptapComposer.d.ts.map +1 -1
  251. package/dist/client/composer/TiptapComposer.js +20 -5
  252. package/dist/client/composer/TiptapComposer.js.map +1 -1
  253. package/dist/client/guided-questions.d.ts +3 -1
  254. package/dist/client/guided-questions.d.ts.map +1 -1
  255. package/dist/client/guided-questions.js +2 -1
  256. package/dist/client/guided-questions.js.map +1 -1
  257. package/dist/client/i18n.d.ts.map +1 -1
  258. package/dist/client/i18n.js +3 -1
  259. package/dist/client/i18n.js.map +1 -1
  260. package/dist/client/index.d.ts +1 -1
  261. package/dist/client/index.d.ts.map +1 -1
  262. package/dist/client/index.js +1 -1
  263. package/dist/client/index.js.map +1 -1
  264. package/dist/client/review/ReviewCommentComposer.d.ts +18 -0
  265. package/dist/client/review/ReviewCommentComposer.d.ts.map +1 -0
  266. package/dist/client/review/ReviewCommentComposer.js +30 -0
  267. package/dist/client/review/ReviewCommentComposer.js.map +1 -0
  268. package/dist/client/review/ReviewThreadPanel.d.ts +28 -1
  269. package/dist/client/review/ReviewThreadPanel.d.ts.map +1 -1
  270. package/dist/client/review/ReviewThreadPanel.js +151 -39
  271. package/dist/client/review/ReviewThreadPanel.js.map +1 -1
  272. package/dist/client/review/index.d.ts +3 -2
  273. package/dist/client/review/index.d.ts.map +1 -1
  274. package/dist/client/review/index.js +2 -1
  275. package/dist/client/review/index.js.map +1 -1
  276. package/dist/client/review/use-review.d.ts +23 -0
  277. package/dist/client/review/use-review.d.ts.map +1 -1
  278. package/dist/client/review/use-review.js +3 -0
  279. package/dist/client/review/use-review.js.map +1 -1
  280. package/dist/client/use-agent-chat-context.d.ts +1 -1
  281. package/dist/client/use-agent-chat-context.d.ts.map +1 -1
  282. package/dist/client/use-agent-chat-context.js +4 -2
  283. package/dist/client/use-agent-chat-context.js.map +1 -1
  284. package/dist/collab/awareness.d.ts +2 -2
  285. package/dist/collab/awareness.d.ts.map +1 -1
  286. package/dist/collab/struct-routes.d.ts +1 -1
  287. package/dist/file-upload/actions/upload-image.d.ts +1 -1
  288. package/dist/integrations/webhook-handler.d.ts.map +1 -1
  289. package/dist/integrations/webhook-handler.js +3 -2
  290. package/dist/integrations/webhook-handler.js.map +1 -1
  291. package/dist/notifications/routes.d.ts +3 -3
  292. package/dist/observability/routes.d.ts +5 -5
  293. package/dist/progress/routes.d.ts +1 -1
  294. package/dist/provider-api/corpus-jobs.d.ts +2 -2
  295. package/dist/resources/handlers.d.ts +2 -2
  296. package/dist/review/actions/create-review-comment.js +2 -1
  297. package/dist/review/actions/create-review-comment.js.map +1 -1
  298. package/dist/review/actions/get-review-feedback.js +6 -11
  299. package/dist/review/actions/get-review-feedback.js.map +1 -1
  300. package/dist/review/actions/list-review-comments.d.ts +1 -0
  301. package/dist/review/actions/list-review-comments.js +25 -4
  302. package/dist/review/actions/list-review-comments.js.map +1 -1
  303. package/dist/review/actions/reply-review-comment.js +12 -5
  304. package/dist/review/actions/reply-review-comment.js.map +1 -1
  305. package/dist/review/actions/resolve-review-thread.d.ts +3 -0
  306. package/dist/review/actions/resolve-review-thread.js +20 -3
  307. package/dist/review/actions/resolve-review-thread.js.map +1 -1
  308. package/dist/review/actions/send-review-thread-to-agent.d.ts +17 -0
  309. package/dist/review/actions/send-review-thread-to-agent.d.ts.map +1 -0
  310. package/dist/review/actions/send-review-thread-to-agent.js +49 -0
  311. package/dist/review/actions/send-review-thread-to-agent.js.map +1 -0
  312. package/dist/review/identity.d.ts +6 -0
  313. package/dist/review/identity.d.ts.map +1 -0
  314. package/dist/review/identity.js +68 -0
  315. package/dist/review/identity.js.map +1 -0
  316. package/dist/review/index.d.ts +3 -1
  317. package/dist/review/index.d.ts.map +1 -1
  318. package/dist/review/index.js +2 -1
  319. package/dist/review/index.js.map +1 -1
  320. package/dist/review/store.d.ts +36 -0
  321. package/dist/review/store.d.ts.map +1 -1
  322. package/dist/review/store.js +223 -8
  323. package/dist/review/store.js.map +1 -1
  324. package/dist/review/types.d.ts +4 -0
  325. package/dist/review/types.d.ts.map +1 -1
  326. package/dist/review/types.js.map +1 -1
  327. package/dist/secrets/crypto.d.ts +35 -13
  328. package/dist/secrets/crypto.d.ts.map +1 -1
  329. package/dist/secrets/crypto.js +78 -41
  330. package/dist/secrets/crypto.js.map +1 -1
  331. package/dist/secrets/index.d.ts.map +1 -1
  332. package/dist/secrets/index.js +2 -1
  333. package/dist/secrets/index.js.map +1 -1
  334. package/dist/secrets/routes.d.ts +9 -9
  335. package/dist/secrets/schema.d.ts +20 -1
  336. package/dist/secrets/schema.d.ts.map +1 -1
  337. package/dist/secrets/schema.js +3 -0
  338. package/dist/secrets/schema.js.map +1 -1
  339. package/dist/secrets/storage.d.ts +7 -7
  340. package/dist/secrets/storage.d.ts.map +1 -1
  341. package/dist/secrets/storage.js +121 -30
  342. package/dist/secrets/storage.js.map +1 -1
  343. package/dist/server/action-discovery.d.ts.map +1 -1
  344. package/dist/server/action-discovery.js +4 -0
  345. package/dist/server/action-discovery.js.map +1 -1
  346. package/dist/server/action-routes.d.ts +45 -0
  347. package/dist/server/action-routes.d.ts.map +1 -1
  348. package/dist/server/action-routes.js +71 -5
  349. package/dist/server/action-routes.js.map +1 -1
  350. package/dist/server/agent-chat/plugin-options.d.ts +16 -0
  351. package/dist/server/agent-chat/plugin-options.d.ts.map +1 -1
  352. package/dist/server/agent-chat/plugin-options.js.map +1 -1
  353. package/dist/server/agent-chat-plugin.d.ts.map +1 -1
  354. package/dist/server/agent-chat-plugin.js +1 -0
  355. package/dist/server/agent-chat-plugin.js.map +1 -1
  356. package/dist/server/index.d.ts +3 -1
  357. package/dist/server/index.d.ts.map +1 -1
  358. package/dist/server/index.js +2 -0
  359. package/dist/server/index.js.map +1 -1
  360. package/dist/vite/action-types-plugin.d.ts.map +1 -1
  361. package/dist/vite/action-types-plugin.js +4 -0
  362. package/dist/vite/action-types-plugin.js.map +1 -1
  363. package/docs/content/locales/ar-SA/pr-visual-recap.mdx +48 -30
  364. package/docs/content/locales/ar-SA/template-plan.mdx +7 -0
  365. package/docs/content/locales/de-DE/pr-visual-recap.mdx +48 -30
  366. package/docs/content/locales/de-DE/template-plan.mdx +7 -0
  367. package/docs/content/locales/es-ES/pr-visual-recap.mdx +48 -30
  368. package/docs/content/locales/es-ES/template-plan.mdx +14 -0
  369. package/docs/content/locales/fr-FR/pr-visual-recap.mdx +48 -30
  370. package/docs/content/locales/fr-FR/template-plan.mdx +7 -0
  371. package/docs/content/locales/hi-IN/pr-visual-recap.mdx +48 -30
  372. package/docs/content/locales/hi-IN/template-plan.mdx +7 -0
  373. package/docs/content/locales/ja-JP/pr-visual-recap.mdx +48 -30
  374. package/docs/content/locales/ja-JP/template-plan.mdx +7 -0
  375. package/docs/content/locales/ko-KR/pr-visual-recap.mdx +48 -30
  376. package/docs/content/locales/ko-KR/template-plan.mdx +7 -0
  377. package/docs/content/locales/pt-BR/pr-visual-recap.mdx +48 -30
  378. package/docs/content/locales/pt-BR/template-plan.mdx +14 -0
  379. package/docs/content/locales/zh-CN/pr-visual-recap.mdx +48 -30
  380. package/docs/content/locales/zh-CN/template-plan.mdx +7 -0
  381. package/docs/content/locales/zh-TW/pr-visual-recap.mdx +48 -30
  382. package/docs/content/locales/zh-TW/template-plan.mdx +7 -0
  383. package/docs/content/pr-visual-recap.mdx +50 -32
  384. package/docs/content/template-plan.mdx +14 -0
  385. package/docs/content/toolkit-comments-review.mdx +16 -2
  386. package/package.json +4 -1
  387. package/corpus/templates/forms/server/routes/api/forms/og/[slug]/og.png.get.ts +0 -45
@@ -102,13 +102,13 @@ explicitement à tout moment :
102
102
  npx @agent-native/core@latest skills add visual-plan --with-github-action
103
103
  ```
104
104
 
105
- Cela installe la compétence `visual-plan` (qui inclut la compétence `visual-recap` exécutée par l'action) et écrit `.github/workflows/pr-visual-recap.yml` dans votre dépôt. Le flux de travail appelle **les sous-commandes CLI publiées** via `npx @agent-native/core@latest recap <subcommand>` — notamment `gate`, `collect-diff`, `block-reference`, `scan`, `build-prompt`, `publish`, `shot`, `comment`, `check` et `usage` — afin que rien ne soit copié dans votre dépôt en tant que scripts d'assistance. `setup` et `doctor` sont les assistants interactifs que vous exécutez localement ; `gate` est l'étape de sécurité que le flux de travail exécute avant chaque récapitulatif.
105
+ Cela installe la compétence `visual-plan` (qui inclut la compétence `visual-recap` exécutée par l'action) et écrit `.github/workflows/pr-visual-recap.yml` dans votre dépôt. Le flux de travail appelle **les sous-commandes CLI publiées** via `npx @agent-native/recap-cli@latest recap <subcommand>` — notamment `gate`, `collect-diff`, `block-reference`, `scan`, `build-prompt`, `publish`, `shot`, `comment`, `check` et `usage` — afin que rien ne soit copié dans votre dépôt en tant que scripts d'assistance. `setup` et `doctor` sont les assistants interactifs que vous exécutez localement ; `gate` est l'étape de sécurité que le flux de travail exécute avant chaque récapitulatif.
106
106
 
107
107
  Ensuite, exécutez l'assistant de configuration guidée :
108
108
 
109
109
  ```bash
110
- npx @agent-native/core@latest recap setup
111
- npx @agent-native/core@latest recap doctor
110
+ npx @agent-native/recap-cli@latest recap setup
111
+ npx @agent-native/recap-cli@latest recap doctor
112
112
  ```
113
113
 
114
114
  `recap setup` actualise le flux de travail et utilise `gh` pour définir GitHub Actions
@@ -118,7 +118,7 @@ défini. Les valeurs secrètes sont envoyées à `gh` via stdin, et non via les
118
118
  le fichier de workflow généré et ouvrez un PR pour le voir s'exécuter.
119
119
 
120
120
  Par défaut, le workflow crée son invite d'agent à partir de la dernière version groupée
121
- Conseils `visual-recap` dans `@agent-native/core@latest`, y compris les frères et sœurs
121
+ Conseils `visual-recap` dans `@agent-native/recap-cli@latest`, y compris les frères et sœurs
122
122
  fichiers de référence avec lesquels la compétence est livrée. Si votre dépôt personnalise intentionnellement et
123
123
  épingle son dossier `visual-recap` validé, définit la variable du référentiel
124
124
  `VISUAL_RECAP_SKILL_SOURCE=repo`.
@@ -135,8 +135,8 @@ Par défaut, le workflow s'exécute sur des runners `ubuntu-latest` hébergés p
135
135
  Les guillemets JSON sont obligatoires. Cette valeur sélectionne le runner du job complet `recap`. Pour le configurer pendant l'installation guidée, transmettez la même valeur JSON à `--runs-on`, puis validez le workflow et la disponibilité du runner avec `doctor` :
136
136
 
137
137
  ```bash
138
- npx @agent-native/core@latest recap setup --runs-on '["self-hosted","linux","x64","visual-recap"]'
139
- npx @agent-native/core@latest recap doctor
138
+ npx @agent-native/recap-cli@latest recap setup --runs-on '["self-hosted","linux","x64","visual-recap"]'
139
+ npx @agent-native/recap-cli@latest recap doctor
140
140
  ```
141
141
 
142
142
  Le gate léger utilise séparément `ubuntu-latest`. Les dépôts sans runners hébergés par GitHub peuvent définir `VISUAL_RECAP_GATE_RUNS_ON` sur une seule étiquette en texte brut, sans JSON, ou utiliser `--gate-runs-on visual-recap-gate`. L'étiquette personnalisée ne s'applique qu'aux auteurs `OWNER`, `MEMBER` ou `COLLABORATOR` du même dépôt ; les forks et autres auteurs sont forcés sur `ubuntu-latest` et peuvent rester non planifiés si les runners hébergés sont désactivés. Utilisez un runner dédié et de préférence éphémère : le gate standard n'extrait pas l'arborescence de la PR et évalue la logique du workflow ainsi que les métadonnées de la PR.
@@ -160,12 +160,30 @@ Si la variable n'est pas définie, l'action utilise `claude`.
160
160
 
161
161
  Au-delà du backend, deux variables du référentiel ajustent _comment_ l'agent s'exécute :
162
162
 
163
- - **`VISUAL_RECAP_MODEL`** épingle le modèle transmis au CLI (`--model`) — par exemple `gpt-5.6-sol` pour Codex, ou un identifiant de modèle Claude. Laissez-le non défini pour utiliser le modèle par défaut du CLI.
163
+ - **`VISUAL_RECAP_MODEL`** épingle le modèle transmis au CLI (`--model`) — par exemple `gpt-5.6-luna` pour Codex, un identifiant de modèle Claude, ou `deepseek-chat` pour DeepSeek. Elle est requise pour `openai-compatible`. Pour le backend **Claude**, la laisser non définie utilise désormais par défaut `claude-sonnet-5` ; définissez la variable explicitement pour utiliser un autre modèle Claude, comme le moins cher `claude-haiku-4-5`. Pour le backend **Codex**, la laisser non définie utilise le modèle par défaut du CLI Codex lui-même.
164
164
  - **`VISUAL_RECAP_REASONING`** définit la profondeur du raisonnement : `none`, `minimal`, `low`, `medium`, `high` ou `xhigh`. Cela s'applique au backend Codex ; Le raisonnement de Claude est basé sur un modèle, cette variable y est donc ignorée.
165
165
  - **`VISUAL_RECAP_SKILL_SOURCE`** contrôle la fraîcheur des invites : `auto`/unset utilise les dernières instructions de compétences groupées, tandis que `repo` s'épingle dans le dossier de compétences `visual-recap` local du dépôt validé.
166
166
 
167
167
  Par exemple, pour exécuter le récapitulatif sur Codex avec GPT-5.6 Sol avec un raisonnement élevé, définissez les variables du référentiel `VISUAL_RECAP_AGENT=codex`, `VISUAL_RECAP_MODEL=gpt-5.6-sol` et `VISUAL_RECAP_REASONING=high`.
168
168
 
169
+ ## Coût
170
+
171
+ Chaque exécution du récapitulatif est une session complète d'agent de codage agentique qui lit un véritable diff, et non un résumé calqué sur un modèle bon marché ; son coût dépend donc du modèle choisi et de la fréquence d'exécution :
172
+
173
+ - **Une session complète par poussée de PR.** Le déclencheur par défaut se déclenche sur `synchronize`, donc une PR poussée dix fois exécute l'agent dix fois.
174
+ - **La PR entière à chaque fois**, pas seulement les commits depuis la dernière exécution — le coût augmente avec la taille totale de la PR, pas avec la taille incrémentale du diff.
175
+ - **Entrée de diff plafonnée à environ 600 Ko.** Cela borne le pire cas par exécution, mais les diffs volumineux coûtent tout de même sensiblement plus cher que les petits.
176
+ - **Une nouvelle tentative automatique en cas d'échec**, ce qui peut à peu près doubler le coût d'une exécution qui échoue de manière transitoire.
177
+
178
+ Pour réduire le coût :
179
+
180
+ - **Épinglez un modèle moins cher.** Pour Claude, définissez `VISUAL_RECAP_MODEL=claude-haiku-4-5` pour les dépôts simples ou petits — c'est le niveau Claude le moins cher ; `claude-sonnet-5` (la valeur par défaut) est le niveau équilibré.
181
+ - **Passez à Codex avec un modèle moins cher.** Définissez `VISUAL_RECAP_AGENT=codex` avec `VISUAL_RECAP_MODEL=gpt-5.6-luna` (le niveau GPT-5.6 le moins cher) ou `gpt-5.6-terra` (niveau intermédiaire), et définissez `VISUAL_RECAP_REASONING=low` pour réduire encore la dépense en jetons de raisonnement. La profondeur de raisonnement ne s'applique qu'à Codex.
182
+ - **Pointez vers un fournisseur compatible OpenAI moins cher.** Définissez `VISUAL_RECAP_AGENT=openai-compatible` avec `VISUAL_RECAP_BASE_URL`/`VISUAL_RECAP_MODEL`/`VISUAL_RECAP_API_KEY` ciblant DeepSeek, Kimi ou tout autre point de terminaison compatible OpenAI.
183
+ - **Récapitulez moins souvent.** Modifiez le `on.pull_request.types` du flux de travail installé de `[opened, synchronize, reopened, ready_for_review, closed]` à `[opened, ready_for_review, closed]` afin qu'il ne récapitule que lorsqu'une PR s'ouvre et lorsqu'elle est fusionnée, au lieu de le faire à chaque poussée.
184
+
185
+ Chaque exécution enregistre ce qu'elle a réellement dépensé : l'étape `recap usage` du flux de travail associe l'utilisation de jetons et de coût au plan publié, afin que vous puissiez consulter la dépense réelle par exécution plutôt que de deviner.
186
+
169
187
  ## Secrets et variables
170
188
 
171
189
  Définissez-les dans **Paramètres → Secrets et variables → Actions** de votre référentiel.
@@ -196,11 +214,11 @@ Application Plans.
196
214
 
197
215
  **Solo : un jeton personnel fonctionne toujours.** Fabriquez-le avec `npx @agent-native/core@latest connect`
198
216
  contre votre application Plans. Pour l'application hébergée, ceci écrit également un local
199
- fichier de jeton de publication que `npx @agent-native/core@latest recap setup` peut lire :
217
+ fichier de jeton de publication que `npx @agent-native/recap-cli@latest recap setup` peut lire :
200
218
 
201
219
  ```bash
202
220
  npx @agent-native/core@latest connect https://plan.agent-native.com --client codex
203
- npx @agent-native/core@latest recap setup
221
+ npx @agent-native/recap-cli@latest recap setup
204
222
  ```
205
223
 
206
224
  Si vous préférez une configuration manuelle, collez le jeton dans le secret GitHub. Utilisez un
@@ -209,16 +227,16 @@ vrai jeton.
209
227
 
210
228
  ### Facultatif (uniquement si vous modifiez les valeurs par défaut)
211
229
 
212
- | Secret / variable | Par défaut | Quand vous en avez besoin |
213
- | ------------------------ | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
214
- | `OPENAI_API_KEY` | — | Secret. Configurez-le avec `VISUAL_RECAP_AGENT=codex` pour exécuter le récapitulatif avec Codex à la place. |
215
- | `VISUAL_RECAP_AGENT` | `claude` | Variable. Sélectionne le backend de l'agent de codage (`claude` ou `codex`). |
216
- | `VISUAL_RECAP_MODEL` | valeur par défaut de chaque CLI | Variable. Épingle le modèle - par ex. `gpt-5.6-sol` pour Codex, ou un identifiant de modèle Claude. Unset utilise la valeur par défaut du CLI. |
217
- | `VISUAL_RECAP_REASONING` | valeur par défaut de chaque modèle | Variable. Profondeur de raisonnement : `none`, `minimal`, `low`, `medium`, `high` ou `xhigh`. S'applique au backend Codex. |
218
- | `RECAP_CLI_VERSION` | `latest` | Variable. Épingle la version `@agent-native/core` CLI installée par le flux de travail, par ex. `1.5.0`. Voir [Version pinning](#version-pinning-copy-variant). |
219
- | `PLAN_RECAP_APP_URL` | `https://plan.agent-native.com` | Secret. Uniquement lors de l'auto-hébergement de l'application Plans à une origine différente. |
230
+ | Secret / variable | Par défaut | Quand vous en avez besoin |
231
+ | ------------------------ | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
232
+ | `OPENAI_API_KEY` | — | Secret. Configurez-le avec `VISUAL_RECAP_AGENT=codex` pour exécuter le récapitulatif avec Codex à la place. |
233
+ | `VISUAL_RECAP_AGENT` | `claude` | Variable. Sélectionne le backend de l'agent de codage (`claude` ou `codex`). |
234
+ | `VISUAL_RECAP_MODEL` | `claude-sonnet-5` pour Claude ; requis pour le backend compatible | Variable. Identifiant du modèle du fournisseur pour les backends compatibles OpenAI (requis dans ce cas). Pour Claude, non défini utilise désormais par défaut `claude-sonnet-5` — définissez-le pour le remplacer, par ex. `claude-haiku-4-5` pour le niveau le moins cher. Pour Codex, non défini utilise la valeur par défaut du CLI Codex lui-même. |
235
+ | `VISUAL_RECAP_REASONING` | valeur par défaut de chaque modèle | Variable. Profondeur de raisonnement : `none`, `minimal`, `low`, `medium`, `high` ou `xhigh`. S'applique au backend Codex. |
236
+ | `RECAP_CLI_VERSION` | `latest` | Variable. Épingle la version `@agent-native/recap-cli` CLI installée par le flux de travail, par ex. `1.5.0`. Voir [Version pinning](#version-pinning-copy-variant). |
237
+ | `PLAN_RECAP_APP_URL` | `https://plan.agent-native.com` | Secret. Uniquement lors de l'auto-hébergement de l'application Plans à une origine différente. |
220
238
 
221
- Le workflow détecte automatiquement comment appeler son assistant CLI (source locale dans ce monorepo, le `@agent-native/core` publié ailleurs), il n'y a donc aucune variable `RECAP_CLI` à définir.
239
+ Le workflow détecte automatiquement comment appeler son assistant CLI (source locale dans ce monorepo, le `@agent-native/recap-cli` publié ailleurs), il n'y a donc aucune variable `RECAP_CLI` à définir.
222
240
 
223
241
  ## Capture d'écran en ligne dans le commentaire
224
242
 
@@ -360,9 +378,9 @@ récapitulatif sans envoyer le contenu du récapitulatif à la base de données
360
378
  même flux d'assistance localement en mode fichiers locaux :
361
379
 
362
380
  ```bash
363
- npx @agent-native/core@latest recap collect-diff --base main --head HEAD --out recap.diff --stat recap.stat
364
- npx @agent-native/core@latest recap scan --diff recap.diff
365
- npx @agent-native/core@latest recap build-prompt --pr 123 --diff recap.diff --stat recap.stat --local-files --local-dir plans/pr-123-visual-recap
381
+ npx @agent-native/recap-cli@latest recap collect-diff --base main --head HEAD --out recap.diff --stat recap.stat
382
+ npx @agent-native/recap-cli@latest recap scan --diff recap.diff
383
+ npx @agent-native/recap-cli@latest recap build-prompt --pr 123 --diff recap.diff --stat recap.stat --local-files --local-dir plans/pr-123-visual-recap
366
384
  ```
367
385
 
368
386
  Donnez le `recap-prompt.md` généré à votre agent de codage. En mode fichiers locaux
@@ -392,7 +410,7 @@ Le récapitulatif est une aide à la révision superposée au flux normal de rel
392
410
 
393
411
  ## Épinglage de version (variante de copie) {#version-pinning-copy-variant}
394
412
 
395
- Par défaut, le workflow de copie de variante installe `@agent-native/core@latest` au moment de l'exécution afin que chaque exécution de récapitulation récupère automatiquement le dernier CLI. Si votre CI a besoin d'outils reproductibles, définissez la variable du référentiel **`RECAP_CLI_VERSION`** pour épingler la version installée :
413
+ Par défaut, le workflow de copie de variante installe `@agent-native/recap-cli@latest` au moment de l'exécution afin que chaque exécution de récapitulation récupère automatiquement le dernier CLI. Si votre CI a besoin d'outils reproductibles, définissez la variable du référentiel **`RECAP_CLI_VERSION`** pour épingler la version installée :
396
414
 
397
415
  1. Accédez aux **Paramètres → Secrets et variables → Actions → Variables** de votre dépôt.
398
416
  2. Créez une variable nommée `RECAP_CLI_VERSION` avec une valeur telle que `1.5.0`.
@@ -403,7 +421,7 @@ Pour la variante d'appelant réutilisable, utilisez plutôt l'entrée `cli-versi
403
421
 
404
422
  ## Liste autorisée d'analyse secrète
405
423
 
406
- Avant de publier un récapitulatif, le workflow exécute `npx @agent-native/core@latest recap scan` pour détecter les secrets probables dans le diff. Tout PR dont la différence correspond à un modèle secret connu est bloqué avec un commentaire explicatif : le récapitulatif n'est pas publié et aucun contenu de différence n'est envoyé à l'agent de codage.
424
+ Avant de publier un récapitulatif, le workflow exécute `npx @agent-native/recap-cli@latest recap scan` pour détecter les secrets probables dans le diff. Tout PR dont la différence correspond à un modèle secret connu est bloqué avec un commentaire explicatif : le récapitulatif n'est pas publié et aucun contenu de différence n'est envoyé à l'agent de codage.
407
425
 
408
426
  Dans de rares cas, un dépôt contient des appareils de test intentionnels ou des chaînes non secrètes qui ressemblent superficiellement à des modèles secrets (par exemple, une clé d'appareil dans un fichier de test). Pour supprimer un faux positif, créez `.github/recap-scan-allowlist` à la racine de votre référentiel.
409
427
 
@@ -437,7 +455,7 @@ La liste blanche n'est consultée que par la porte secrète-scan. Cela n'affecte
437
455
 
438
456
  ### Pourquoi utiliser la variante réutilisable ?
439
457
 
440
- Le programme d'installation par défaut copie le flux de travail complet d'environ 360 lignes YAML dans votre dépôt (l'option **copier**). C'est le bon choix pour les dépôts à air isolé ou les dépôts qui doivent auditer chaque ligne de ce qui s'exécute. L'inconvénient est que les corrections de bogues et les améliorations ne vous parviennent jamais : vous devez réexécuter `npx @agent-native/core@latest recap setup` manuellement après chaque version.
458
+ Le programme d'installation par défaut copie le flux de travail complet d'environ 360 lignes YAML dans votre dépôt (l'option **copier**). C'est le bon choix pour les dépôts à air isolé ou les dépôts qui doivent auditer chaque ligne de ce qui s'exécute. L'inconvénient est que les corrections de bogues et les améliorations ne vous parviennent jamais : vous devez réexécuter `npx @agent-native/recap-cli@latest recap setup` manuellement après chaque version.
441
459
 
442
460
  L'option **réutilisable** écrit à la place un appelant mince d'environ 20 lignes. Il délègue à `BuilderIO/agent-native/.github/workflows/pr-visual-recap-reusable.yml` via `uses:`. Chaque appelant récupère automatiquement la dernière logique lors de l'exécution du workflow, sans qu'aucune mise à jour locale ne soit nécessaire.
443
461
 
@@ -450,7 +468,7 @@ L'option **réutilisable** écrit à la place un appelant mince d'environ 20 lig
450
468
 
451
469
  ### Extrait de l'appelant
452
470
 
453
- Voici ce qu'écrit `npx @agent-native/core@latest recap setup --reusable` (ou vous pouvez le coller manuellement) :
471
+ Voici ce qu'écrit `npx @agent-native/recap-cli@latest recap setup --reusable` (ou vous pouvez le coller manuellement) :
454
472
 
455
473
  ```yaml
456
474
  name: PR Visual Recap
@@ -485,7 +503,7 @@ jobs:
485
503
  skill-source: ${{ vars.VISUAL_RECAP_SKILL_SOURCE || 'auto' }}
486
504
  runs-on: ${{ vars.VISUAL_RECAP_RUNS_ON || '"ubuntu-latest"' }}
487
505
  gate-runs-on: ${{ vars.VISUAL_RECAP_GATE_RUNS_ON || 'ubuntu-latest' }}
488
- # cli-version: "latest" # pin to a specific @agent-native/core version
506
+ # cli-version: "latest" # pin to a specific @agent-native/recap-cli version
489
507
  ```
490
508
 
491
509
  Les mêmes secrets et variables décrits dans [Secrets and variables](#secrets-and-variables) s'appliquent. L'appelant réutilisable transmet `VISUAL_RECAP_RUNS_ON` via `runs-on` pour le job complet et `VISUAL_RECAP_GATE_RUNS_ON` via l'étiquette simple `gate-runs-on` pour le gate. Les deux utilisent `ubuntu-latest` par défaut.
@@ -494,15 +512,15 @@ Les mêmes secrets et variables décrits dans [Secrets and variables](#secrets-a
494
512
 
495
513
  ```bash
496
514
  # Écrivez l'appelant léger au lieu de la copie complète :
497
- npx @agent-native/core@latest recap setup --reusable
515
+ npx @agent-native/recap-cli@latest recap setup --reusable
498
516
 
499
517
  # Ou avec une référence épinglée pour plus de reproductibilité :
500
- npx @agent-native/core@latest recap setup --reusable --ref v1.2.3
518
+ npx @agent-native/recap-cli@latest recap setup --reusable --ref v1.2.3
501
519
  ```
502
520
 
503
521
  Les deux variantes écrivent le flux de travail dans `.github/workflows/pr-visual-recap.yml`. Si un workflow existant existe déjà et diffère, la commande refuse et vous demande de passer `--force` pour l'écraser.
504
522
 
505
- Après l'écriture, exécutez `npx @agent-native/core@latest recap doctor` comme d'habitude pour confirmer que les secrets sont configurés.
523
+ Après l'écriture, exécutez `npx @agent-native/recap-cli@latest recap doctor` comme d'habitude pour confirmer que les secrets sont configurés.
506
524
 
507
525
  ### Épinglage de version
508
526
 
@@ -512,7 +530,7 @@ Par défaut, l'appelant fait référence à `@main`, qui utilise toujours la der
512
530
  uses: BuilderIO/agent-native/.github/workflows/pr-visual-recap-reusable.yml@v1.2.3
513
531
  ```
514
532
 
515
- L'entrée `cli-version` contrôle quelle version de `@agent-native/core` CLI s'exécute dans le flux de travail : laissez-la sur `"latest"` pour suivre la version la plus récente, ou épinglez-la à une chaîne de version (par exemple, `"1.5.0"`) pour une reproductibilité totale.
533
+ L'entrée `cli-version` contrôle quelle version de `@agent-native/recap-cli` CLI s'exécute dans le flux de travail : laissez-la sur `"latest"` pour suivre la version la plus récente, ou épinglez-la à une chaîne de version (par exemple, `"1.5.0"`) pour une reproductibilité totale.
516
534
 
517
535
  ### Contexte de l'événement workflow_call
518
536
 
@@ -212,6 +212,13 @@ Si le premier passage comporte encore des décisions responsables, l'agent peut
212
212
  **Formulaire de questions ouvertes** au bas du même plan. Y répondre et envoyer
213
213
  l'agent démarre un tour de révision par rapport au plan existant.
214
214
 
215
+ ## Coût et choix du modèle
216
+
217
+ Générer un plan ou un récapitulatif exécute une session agentique complète contre le LLM de votre agent de codage, et non un simple remplissage de modèle léger ; le coût dépend donc de la taille du diff ou du plan et du modèle choisi.
218
+
219
+ - Le modèle de chat par défaut de l'application est Sonnet 5 ; changez-le à tout moment dans les **Paramètres**. Haiku est l'option Claude moins chère, et Luna est l'option moins chère de la famille GPT-5.6.
220
+ - Les récapitulatifs de PR automatisés depuis l'action GitHub s'exécutent séparément de l'application interactive et ont leurs propres réglages de modèle et de coût — voir [PR Visual Recap](/docs/pr-visual-recap) pour `VISUAL_RECAP_MODEL`, `VISUAL_RECAP_AGENT` et `VISUAL_RECAP_REASONING`.
221
+
215
222
  ## Ce que vous pouvez en faire
216
223
 
217
224
  - **Révision avant mise en œuvre.** React vers les diagrammes, les wireframes, les onglets d'options,
@@ -102,13 +102,13 @@ description: "एक GitHub एक्शन जो प्रत्येक प
102
102
  npx @agent-native/core@latest skills add visual-plan --with-github-action
103
103
  ```
104
104
 
105
- यह `visual-plan` कौशल स्थापित करता है (जिसमें `visual-recap` कौशल शामिल है जो क्रिया चलाता है) और आपके रेपो में `.github/workflows/pr-visual-recap.yml` लिखता है। वर्कफ़्लो `npx @agent-native/core@latest recap <subcommand>` के माध्यम से **प्रकाशित CLI उपकमांड** को कॉल करता है - जिसमें `gate`, `collect-diff`, `block-reference`, `scan`, `build-prompt`, `publish`, `shot`, `comment`, `check`, और शामिल हैं। `usage` - इसलिए आपके रेपो में सहायक स्क्रिप्ट के रूप में कुछ भी कॉपी नहीं किया गया है। `setup` और `doctor` आपके द्वारा स्थानीय स्तर पर चलाए जाने वाले इंटरैक्टिव सहायक हैं; `gate` सुरक्षा-द्वार चरण है जो वर्कफ़्लो प्रत्येक पुनर्कथन से पहले चलता है।
105
+ यह `visual-plan` कौशल स्थापित करता है (जिसमें `visual-recap` कौशल शामिल है जो क्रिया चलाता है) और आपके रेपो में `.github/workflows/pr-visual-recap.yml` लिखता है। वर्कफ़्लो `npx @agent-native/recap-cli@latest recap <subcommand>` के माध्यम से **प्रकाशित CLI उपकमांड** को कॉल करता है - जिसमें `gate`, `collect-diff`, `block-reference`, `scan`, `build-prompt`, `publish`, `shot`, `comment`, `check`, और शामिल हैं। `usage` - इसलिए आपके रेपो में सहायक स्क्रिप्ट के रूप में कुछ भी कॉपी नहीं किया गया है। `setup` और `doctor` आपके द्वारा स्थानीय स्तर पर चलाए जाने वाले इंटरैक्टिव सहायक हैं; `gate` सुरक्षा-द्वार चरण है जो वर्कफ़्लो प्रत्येक पुनर्कथन से पहले चलता है।
106
106
 
107
107
  फिर निर्देशित सेटअप सहायक चलाएँ:
108
108
 
109
109
  ```bash
110
- npx @agent-native/core@latest recap setup
111
- npx @agent-native/core@latest recap doctor
110
+ npx @agent-native/recap-cli@latest recap setup
111
+ npx @agent-native/recap-cli@latest recap doctor
112
112
  ```
113
113
 
114
114
  `recap setup` वर्कफ़्लो को ताज़ा करता है, GitHub Actions सेट करने के लिए `gh` का उपयोग करता है
@@ -118,7 +118,7 @@ npx @agent-native/core@latest recap doctor
118
118
  जनरेट की गई वर्कफ़्लो फ़ाइल और इसे चलाने के लिए एक पीआर खोलें।
119
119
 
120
120
  डिफ़ॉल्ट रूप से, वर्कफ़्लो नवीनतम बंडल से अपना एजेंट प्रॉम्प्ट बनाता है
121
- `@agent-native/core@latest` में `visual-recap` मार्गदर्शन, किसी भी भाई-बहन सहित
121
+ `@agent-native/recap-cli@latest` में `visual-recap` मार्गदर्शन, किसी भी भाई-बहन सहित
122
122
  संदर्भ फ़ाइलें कौशल भेजती हैं। यदि आपका रेपो जानबूझकर अनुकूलित करता है और
123
123
  अपने प्रतिबद्ध `visual-recap` फ़ोल्डर को पिन करता है, रिपॉजिटरी वेरिएबल सेट करता है
124
124
  `VISUAL_RECAP_SKILL_SOURCE=repo`.
@@ -135,8 +135,8 @@ npx @agent-native/core@latest recap doctor
135
135
  JSON उद्धरण चिह्न आवश्यक हैं। यह मान पूरे `recap` जॉब के रनर को चुनता है। निर्देशित सेटअप के दौरान इसे कॉन्फ़िगर करने के लिए, वही JSON मान `--runs-on` को दें और फिर `doctor` से वर्कफ़्लो और रनर की उपलब्धता सत्यापित करें:
136
136
 
137
137
  ```bash
138
- npx @agent-native/core@latest recap setup --runs-on '["self-hosted","linux","x64","visual-recap"]'
139
- npx @agent-native/core@latest recap doctor
138
+ npx @agent-native/recap-cli@latest recap setup --runs-on '["self-hosted","linux","x64","visual-recap"]'
139
+ npx @agent-native/recap-cli@latest recap doctor
140
140
  ```
141
141
 
142
142
  हल्का गेट अलग से `ubuntu-latest` का उपयोग करता है। GitHub-होस्टेड रनर बंद करने वाली रिपॉजिटरी `VISUAL_RECAP_GATE_RUNS_ON` को JSON के बिना एक सादे लेबल पर सेट कर सकती हैं, या `--gate-runs-on visual-recap-gate` का उपयोग कर सकती हैं। कस्टम लेबल केवल उसी रिपॉजिटरी के `OWNER`, `MEMBER` या `COLLABORATOR` लेखकों के लिए उपयोग होता है; फ़ोर्क और अन्य लेखक `ubuntu-latest` पर भेजे जाते हैं और GitHub-होस्टेड रनर बंद होने पर बिना शेड्यूल रह सकते हैं। समर्पित और संभव हो तो अस्थायी रनर उपयोग करें; मानक गेट PR ट्री को चेक आउट नहीं करता और वर्कफ़्लो लॉजिक व PR मेटाडेटा का मूल्यांकन करता है।
@@ -160,12 +160,30 @@ npx @agent-native/core@latest recap doctor
160
160
 
161
161
  बैकएंड से परे, दो रिपॉजिटरी वैरिएबल एजेंट को चलाने के तरीके को ट्यून करते हैं:
162
162
 
163
- - **`VISUAL_RECAP_MODEL`** मॉडल को CLI (`--model`) में पिन करता है - उदाहरण के लिए Codex के लिए `gpt-5.6-sol`, या Claude मॉडल आईडी। CLI के अपने डिफ़ॉल्ट मॉडल का उपयोग करने के लिए इसे अनसेट छोड़ दें।
163
+ - **`VISUAL_RECAP_MODEL`** मॉडल को CLI (`--model`) में पिन करता है - उदाहरण के लिए Codex के लिए `gpt-5.6-luna`, कोई Claude मॉडल आईडी, या DeepSeek के लिए `deepseek-chat`। यह `openai-compatible` के लिए आवश्यक है। **Claude** बैकएंड के लिए, इसे अनसेट छोड़ने पर अब डिफ़ॉल्ट रूप से `claude-sonnet-5` उपयोग होता है; किसी दूसरे Claude मॉडल का उपयोग करने के लिए चर को स्पष्ट रूप से सेट करें, जैसे सस्ता `claude-haiku-4-5`। **Codex** बैकएंड के लिए, इसे अनसेट छोड़ने पर Codex CLI का अपना डिफ़ॉल्ट मॉडल उपयोग होता है।
164
164
  - **`VISUAL_RECAP_REASONING`** तर्क की गहराई निर्धारित करता है: `none`, `minimal`, `low`, `medium`, `high`, या `xhigh`। यह Codex बैकएंड पर लागू होता है; Claude का तर्क मॉडल-चालित है, इसलिए इस चर को वहां नजरअंदाज कर दिया गया है।
165
165
  - **`VISUAL_RECAP_SKILL_SOURCE`** त्वरित ताजगी को नियंत्रित करता है: `auto`/unset नवीनतम बंडल कौशल मार्गदर्शन का उपयोग करता है, जबकि `repo` प्रतिबद्ध रेपो-स्थानीय `visual-recap` कौशल फ़ोल्डर में पिन करता है।
166
166
 
167
167
  उदाहरण के लिए, Codex पर GPT-5.6 Sol के साथ उच्च तर्क पर रिकैप चलाने के लिए, रिपॉजिटरी वेरिएबल `VISUAL_RECAP_AGENT=codex`, `VISUAL_RECAP_MODEL=gpt-5.6-sol`, और `VISUAL_RECAP_REASONING=high` सेट करें।
168
168
 
169
+ ## लागत
170
+
171
+ प्रत्येक रिकैप रन एक पूर्ण एजेंटिक कोडिंग-एजेंट सत्र है जो एक वास्तविक diff पढ़ता है, न कि कोई सस्ता टेम्प्लेटेड सारांश, इसलिए इसकी लागत मॉडल चुनाव और यह कितनी बार चलता है, इस पर निर्भर करती है:
172
+
173
+ - **प्रत्येक PR पुश पर एक पूरा सत्र।** डिफ़ॉल्ट ट्रिगर `synchronize` पर चलता है, इसलिए जिस PR को दस बार पुश किया जाता है, वह एजेंट को दस बार चलाता है।
174
+ - **हर बार पूरा PR**, न कि केवल पिछले रन के बाद के कमिट — लागत PR के कुल आकार के अनुसार बढ़ती है, न कि वृद्धिशील diff आकार के अनुसार।
175
+ - **Diff इनपुट लगभग 600KB तक सीमित।** यह प्रति रन सबसे खराब स्थिति को सीमित करता है, लेकिन बड़े diff अभी भी छोटे diff की तुलना में काफी अधिक लागत लेते हैं।
176
+ - **विफलता पर एक स्वचालित पुनः प्रयास**, जो किसी अस्थायी रूप से विफल होने वाले रन की लागत को लगभग दोगुना कर सकता है।
177
+
178
+ लागत कम करने के लिए:
179
+
180
+ - **एक सस्ता मॉडल पिन करें।** Claude के लिए, सरल या छोटे रिपॉज़िटरी के लिए `VISUAL_RECAP_MODEL=claude-haiku-4-5` सेट करें — यह सबसे सस्ता Claude स्तर है; `claude-sonnet-5` (डिफ़ॉल्ट) संतुलित स्तर है।
181
+ - **सस्ते मॉडल के साथ Codex पर स्विच करें।** `VISUAL_RECAP_AGENT=codex` को `VISUAL_RECAP_MODEL=gpt-5.6-luna` (सबसे सस्ता GPT-5.6 स्तर) या `gpt-5.6-terra` (मध्य-स्तर) के साथ सेट करें, और रीज़निंग-टोकन खर्च को और कम करने के लिए `VISUAL_RECAP_REASONING=low` सेट करें। रीज़निंग गहराई केवल Codex पर लागू होती है।
182
+ - **किसी सस्ते OpenAI-संगत प्रदाता की ओर इंगित करें।** DeepSeek, Kimi, या किसी अन्य OpenAI-संगत एंडपॉइंट को लक्षित करते हुए `VISUAL_RECAP_BASE_URL`/`VISUAL_RECAP_MODEL`/`VISUAL_RECAP_API_KEY` के साथ `VISUAL_RECAP_AGENT=openai-compatible` सेट करें।
183
+ - **रिकैप कम बार करें।** इंस्टॉल किए गए वर्कफ़्लो के `on.pull_request.types` को `[opened, synchronize, reopened, ready_for_review, closed]` से बदलकर `[opened, ready_for_review, closed]` करें ताकि यह हर पुश पर नहीं, बल्कि केवल तब रिकैप करे जब कोई PR खुले और जब वह मर्ज हो।
184
+
185
+ हर रन यह रिकॉर्ड करता है कि वास्तव में कितना खर्च हुआ: वर्कफ़्लो का `recap usage` चरण टोकन और लागत उपयोग को प्रकाशित योजना से जोड़ देता है, ताकि आप अनुमान लगाने के बजाय प्रति रन वास्तविक खर्च देख सकें।
186
+
169
187
  ## रहस्य और चर
170
188
 
171
189
  इन्हें अपने भंडार की **सेटिंग्स → रहस्य और चर → Actions** में सेट करें।
@@ -196,11 +214,11 @@ npx @agent-native/core@latest connect https://plan.agent-native.com --service-to
196
214
 
197
215
  **सोलो: एक व्यक्तिगत टोकन अभी भी काम करता है।** इसे `npx @agent-native/core@latest connect` के साथ मिंट करें
198
216
  आपके प्लान ऐप के विरुद्ध। होस्ट किए गए ऐप के लिए, यह एक स्थानीय भी लिखता है
199
- प्रकाशन-टोकन फ़ाइल जिसे `npx @agent-native/core@latest recap setup` पढ़ सकता है:
217
+ प्रकाशन-टोकन फ़ाइल जिसे `npx @agent-native/recap-cli@latest recap setup` पढ़ सकता है:
200
218
 
201
219
  ```bash
202
220
  npx @agent-native/core@latest connect https://plan.agent-native.com --client codex
203
- npx @agent-native/core@latest recap setup
221
+ npx @agent-native/recap-cli@latest recap setup
204
222
  ```
205
223
 
206
224
  यदि आप मैन्युअल सेटअप पसंद करते हैं, तो टोकन को GitHub सीक्रेट में पेस्ट करें। ए
@@ -209,16 +227,16 @@ npx @agent-native/core@latest recap setup
209
227
 
210
228
  ### वैकल्पिक (केवल यदि आप डिफ़ॉल्ट बदलते हैं)
211
229
 
212
- | गुप्त/चर | डिफ़ॉल्ट | जब आपको इसकी आवश्यकता हो |
213
- | ------------------------ | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
214
- | `OPENAI_API_KEY` | — | गुप्त. इसके बजाय Codex के साथ रिकैप चलाने के लिए `VISUAL_RECAP_AGENT=codex` के साथ सेट करें। |
215
- | `VISUAL_RECAP_AGENT` | `claude` | परिवर्तनीय. कोडिंग-एजेंट बैकएंड (`claude` या `codex`) का चयन करता है। |
216
- | `VISUAL_RECAP_MODEL` | प्रत्येक CLI का डिफ़ॉल्ट | चर। मॉडल को पिन करें - उदा. Codex के लिए `gpt-5.6-sol`, या Claude मॉडल आईडी। अनसेट CLI के स्वयं के डिफ़ॉल्ट का उपयोग करता है। |
217
- | `VISUAL_RECAP_REASONING` | प्रत्येक मॉडल का डिफ़ॉल्ट | परिवर्तनीय. तर्क की गहराई: `none`, `minimal`, `low`, `medium`, `high`, या `xhigh`। Codex बैकएंड पर लागू होता है। |
218
- | `RECAP_CLI_VERSION` | `latest` | चर। वर्कफ़्लो इंस्टॉल होने पर `@agent-native/core` CLI संस्करण को पिन करें - उदाहरण के लिए `1.5.0`. [Version pinning](#version-pinning-copy-variant) देखें. |
219
- | `PLAN_RECAP_APP_URL` | `https://plan.agent-native.com` | गुप्त. केवल तभी जब प्लान्स ऐप को किसी भिन्न मूल पर स्वयं-होस्ट किया जाए। |
230
+ | गुप्त/चर | डिफ़ॉल्ट | जब आपको इसकी आवश्यकता हो |
231
+ | ------------------------ | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
232
+ | `OPENAI_API_KEY` | — | गुप्त. इसके बजाय Codex के साथ रिकैप चलाने के लिए `VISUAL_RECAP_AGENT=codex` के साथ सेट करें। |
233
+ | `VISUAL_RECAP_AGENT` | `claude` | परिवर्तनीय. कोडिंग-एजेंट बैकएंड (`claude` या `codex`) का चयन करता है। |
234
+ | `VISUAL_RECAP_MODEL` | Claude के लिए `claude-sonnet-5`; संगत बैकएंड के लिए आवश्यक | चर। OpenAI-संगत बैकएंड के लिए प्रदाता मॉडल आईडी (वहां आवश्यक)। Claude के लिए, अनसेट अब डिफ़ॉल्ट रूप से `claude-sonnet-5` उपयोग करता है — इसे ओवरराइड करने के लिए सेट करें, जैसे सबसे सस्ते स्तर के लिए `claude-haiku-4-5`। Codex के लिए, अनसेट Codex CLI के अपने डिफ़ॉल्ट का उपयोग करता है। |
235
+ | `VISUAL_RECAP_REASONING` | प्रत्येक मॉडल का डिफ़ॉल्ट | परिवर्तनीय. तर्क की गहराई: `none`, `minimal`, `low`, `medium`, `high`, या `xhigh`। Codex बैकएंड पर लागू होता है। |
236
+ | `RECAP_CLI_VERSION` | `latest` | चर। वर्कफ़्लो इंस्टॉल होने पर `@agent-native/recap-cli` CLI संस्करण को पिन करें - उदाहरण के लिए `1.5.0`. [Version pinning](#version-pinning-copy-variant) देखें. |
237
+ | `PLAN_RECAP_APP_URL` | `https://plan.agent-native.com` | गुप्त. केवल तभी जब प्लान्स ऐप को किसी भिन्न मूल पर स्वयं-होस्ट किया जाए। |
220
238
 
221
- वर्कफ़्लो स्वचालित रूप से पता लगाता है कि इसके सहायक CLI (इस मोनोरेपो के अंदर स्थानीय स्रोत, कहीं और प्रकाशित `@agent-native/core`) को कैसे लागू किया जाए, इसलिए सेट करने के लिए कोई `RECAP_CLI` वेरिएबल नहीं है।
239
+ वर्कफ़्लो स्वचालित रूप से पता लगाता है कि इसके सहायक CLI (इस मोनोरेपो के अंदर स्थानीय स्रोत, कहीं और प्रकाशित `@agent-native/recap-cli`) को कैसे लागू किया जाए, इसलिए सेट करने के लिए कोई `RECAP_CLI` वेरिएबल नहीं है।
222
240
 
223
241
  ## टिप्पणी में इनलाइन स्क्रीनशॉट
224
242
 
@@ -360,9 +378,9 @@ Agent-Native योजना डेटाबेस में पुनर्क
360
378
  इसके बजाय स्थानीय-फ़ाइल मोड में समान सहायक प्रवाह स्थानीय रूप से होता है:
361
379
 
362
380
  ```bash
363
- npx @agent-native/core@latest recap collect-diff --base main --head HEAD --out recap.diff --stat recap.stat
364
- npx @agent-native/core@latest recap scan --diff recap.diff
365
- npx @agent-native/core@latest recap build-prompt --pr 123 --diff recap.diff --stat recap.stat --local-files --local-dir plans/pr-123-visual-recap
381
+ npx @agent-native/recap-cli@latest recap collect-diff --base main --head HEAD --out recap.diff --stat recap.stat
382
+ npx @agent-native/recap-cli@latest recap scan --diff recap.diff
383
+ npx @agent-native/recap-cli@latest recap build-prompt --pr 123 --diff recap.diff --stat recap.stat --local-files --local-dir plans/pr-123-visual-recap
366
384
  ```
367
385
 
368
386
  जनरेट किए गए `recap-prompt.md` को अपने कोडिंग एजेंट को दें। स्थानीय-फ़ाइलें मोड
@@ -392,7 +410,7 @@ npx @agent-native/core@latest plan local serve --dir plans/pr-123-visual-recap -
392
410
 
393
411
  ## संस्करण पिनिंग (कॉपी संस्करण) {#version-pinning-copy-variant}
394
412
 
395
- डिफ़ॉल्ट रूप से कॉपी-वेरिएंट वर्कफ़्लो रन टाइम पर `@agent-native/core@latest` इंस्टॉल करता है इसलिए प्रत्येक रीकैप रन स्वचालित रूप से नवीनतम CLI चुनता है। यदि आपके CI को प्रतिलिपि प्रस्तुत करने योग्य टूलींग की आवश्यकता है, तो स्थापित संस्करण को पिन करने के लिए **`RECAP_CLI_VERSION`** रिपोजिटरी वेरिएबल सेट करें:
413
+ डिफ़ॉल्ट रूप से कॉपी-वेरिएंट वर्कफ़्लो रन टाइम पर `@agent-native/recap-cli@latest` इंस्टॉल करता है इसलिए प्रत्येक रीकैप रन स्वचालित रूप से नवीनतम CLI चुनता है। यदि आपके CI को प्रतिलिपि प्रस्तुत करने योग्य टूलींग की आवश्यकता है, तो स्थापित संस्करण को पिन करने के लिए **`RECAP_CLI_VERSION`** रिपोजिटरी वेरिएबल सेट करें:
396
414
 
397
415
  1. अपने रेपो की **सेटिंग्स → रहस्य और वेरिएबल्स → Actions → वेरिएबल्स** पर जाएं।
398
416
  2. `1.5.0` जैसे मान के साथ `RECAP_CLI_VERSION` नाम का एक वेरिएबल बनाएं।
@@ -403,7 +421,7 @@ npx @agent-native/core@latest plan local serve --dir plans/pr-123-visual-recap -
403
421
 
404
422
  ## गुप्त-स्कैन अनुमति सूची
405
423
 
406
- रिकैप प्रकाशित करने से पहले वर्कफ़्लो अंतर में संभावित रहस्यों का पता लगाने के लिए `npx @agent-native/core@latest recap scan` चलाता है। कोई भी पीआर जिसका अंतर ज्ञात-गुप्त पैटर्न से मेल खाता है, उसे एक व्याख्यात्मक टिप्पणी के साथ अवरुद्ध कर दिया जाता है - पुनर्कथन प्रकाशित नहीं किया जाता है, और कोडिंग एजेंट को कोई भिन्न सामग्री नहीं भेजी जाती है।
424
+ रिकैप प्रकाशित करने से पहले वर्कफ़्लो अंतर में संभावित रहस्यों का पता लगाने के लिए `npx @agent-native/recap-cli@latest recap scan` चलाता है। कोई भी पीआर जिसका अंतर ज्ञात-गुप्त पैटर्न से मेल खाता है, उसे एक व्याख्यात्मक टिप्पणी के साथ अवरुद्ध कर दिया जाता है - पुनर्कथन प्रकाशित नहीं किया जाता है, और कोडिंग एजेंट को कोई भिन्न सामग्री नहीं भेजी जाती है।
407
425
 
408
426
  दुर्लभ मामलों में किसी रेपो में जानबूझकर परीक्षण फिक्स्चर या गैर-गुप्त स्ट्रिंग्स होती हैं जो सतही तौर पर गुप्त पैटर्न से मिलती जुलती होती हैं (उदाहरण के लिए, परीक्षण फ़ाइल में एक फिक्स्चर कुंजी)। झूठी सकारात्मकता को दबाने के लिए, अपने रिपॉजिटरी के रूट में `.github/recap-scan-allowlist` बनाएं।
409
427
 
@@ -437,7 +455,7 @@ EXAMPLE_API_KEY=placeholder-value
437
455
 
438
456
  ### पुनः प्रयोज्य संस्करण का उपयोग क्यों करें?
439
457
 
440
- डिफ़ॉल्ट इंस्टॉलर पूर्ण ~360-लाइन वर्कफ़्लो YAML को आपके रेपो (**कॉपी** विकल्प) में कॉपी करता है। यह एयर-गैप्ड रिपोज़ या रिपोज़ के लिए सही विकल्प है, जिन्हें चलने वाली प्रत्येक पंक्ति का ऑडिट करने की आवश्यकता होती है। नकारात्मक पक्ष यह है कि बग फिक्स और सुधार कभी भी आप तक नहीं पहुंचते हैं - आपको प्रत्येक रिलीज़ के बाद `npx @agent-native/core@latest recap setup` को मैन्युअल रूप से फिर से चलाने की आवश्यकता होती है।
458
+ डिफ़ॉल्ट इंस्टॉलर पूर्ण ~360-लाइन वर्कफ़्लो YAML को आपके रेपो (**कॉपी** विकल्प) में कॉपी करता है। यह एयर-गैप्ड रिपोज़ या रिपोज़ के लिए सही विकल्प है, जिन्हें चलने वाली प्रत्येक पंक्ति का ऑडिट करने की आवश्यकता होती है। नकारात्मक पक्ष यह है कि बग फिक्स और सुधार कभी भी आप तक नहीं पहुंचते हैं - आपको प्रत्येक रिलीज़ के बाद `npx @agent-native/recap-cli@latest recap setup` को मैन्युअल रूप से फिर से चलाने की आवश्यकता होती है।
441
459
 
442
460
  **पुन: प्रयोज्य** विकल्प इसके बजाय एक पतली ~20-लाइन कॉलर लिखता है। यह `uses:` के माध्यम से `BuilderIO/agent-native/.github/workflows/pr-visual-recap-reusable.yml` को सौंपता है। जब वर्कफ़्लो चलता है तो प्रत्येक कॉलर स्वचालित रूप से नवीनतम तर्क उठाता है, बिना किसी स्थानीय अपडेट की आवश्यकता के।
443
461
 
@@ -450,7 +468,7 @@ EXAMPLE_API_KEY=placeholder-value
450
468
 
451
469
  ### कॉलर स्निपेट
452
470
 
453
- `npx @agent-native/core@latest recap setup --reusable` यही लिखता है (या आप इसे मैन्युअल रूप से पेस्ट कर सकते हैं):
471
+ `npx @agent-native/recap-cli@latest recap setup --reusable` यही लिखता है (या आप इसे मैन्युअल रूप से पेस्ट कर सकते हैं):
454
472
 
455
473
  ```yaml
456
474
  name: PR Visual Recap
@@ -485,7 +503,7 @@ jobs:
485
503
  skill-source: ${{ vars.VISUAL_RECAP_SKILL_SOURCE || 'auto' }}
486
504
  runs-on: ${{ vars.VISUAL_RECAP_RUNS_ON || '"ubuntu-latest"' }}
487
505
  gate-runs-on: ${{ vars.VISUAL_RECAP_GATE_RUNS_ON || 'ubuntu-latest' }}
488
- # cli-version: "latest" # pin to a specific @agent-native/core version
506
+ # cli-version: "latest" # pin to a specific @agent-native/recap-cli version
489
507
  ```
490
508
 
491
509
  [Secrets and variables](#secrets-and-variables) में वर्णित समान रहस्य और चर लागू होते हैं। पुन: प्रयोज्य कॉलर पूरे जॉब के लिए `VISUAL_RECAP_RUNS_ON` को `runs-on` और गेट के लिए `VISUAL_RECAP_GATE_RUNS_ON` को एकल-लेबल `gate-runs-on` के रूप में भेजता है। दोनों छोड़ने पर `ubuntu-latest` उपयोग करते हैं।
@@ -494,15 +512,15 @@ jobs:
494
512
 
495
513
  ```bash
496
514
  # पूरी कॉपी के बजाय पतला कॉलर लिखें:
497
- npx @agent-native/core@latest recap setup --reusable
515
+ npx @agent-native/recap-cli@latest recap setup --reusable
498
516
 
499
517
  # या प्रतिलिपि प्रस्तुत करने योग्यता के लिए पिन किए गए रेफरी के साथ:
500
- npx @agent-native/core@latest recap setup --reusable --ref v1.2.3
518
+ npx @agent-native/recap-cli@latest recap setup --reusable --ref v1.2.3
501
519
  ```
502
520
 
503
521
  दोनों वेरिएंट वर्कफ़्लो को `.github/workflows/pr-visual-recap.yml` पर लिखते हैं। यदि कोई मौजूदा वर्कफ़्लो पहले से मौजूद है और भिन्न है, तो कमांड अस्वीकार कर देता है और आपको ओवरराइट करने के लिए `--force` पास करने के लिए कहता है।
504
522
 
505
- लिखने के बाद, रहस्य कॉन्फ़िगर किए जाने की पुष्टि करने के लिए हमेशा की तरह `npx @agent-native/core@latest recap doctor` चलाएं।
523
+ लिखने के बाद, रहस्य कॉन्फ़िगर किए जाने की पुष्टि करने के लिए हमेशा की तरह `npx @agent-native/recap-cli@latest recap doctor` चलाएं।
506
524
 
507
525
  ### संस्करण पिन करना
508
526
 
@@ -512,7 +530,7 @@ npx @agent-native/core@latest recap setup --reusable --ref v1.2.3
512
530
  uses: BuilderIO/agent-native/.github/workflows/pr-visual-recap-reusable.yml@v1.2.3
513
531
  ```
514
532
 
515
- `cli-version` इनपुट नियंत्रित करता है कि वर्कफ़्लो के अंदर कौन सा `@agent-native/core` CLI संस्करण चलता है - नवीनतम रिलीज़ को ट्रैक करने के लिए इसे `"latest"` पर छोड़ दें, या पूर्ण प्रतिलिपि प्रस्तुत करने योग्यता के लिए इसे संस्करण स्ट्रिंग (जैसे `"1.5.0"`) पर पिन करें।
533
+ `cli-version` इनपुट नियंत्रित करता है कि वर्कफ़्लो के अंदर कौन सा `@agent-native/recap-cli` CLI संस्करण चलता है - नवीनतम रिलीज़ को ट्रैक करने के लिए इसे `"latest"` पर छोड़ दें, या पूर्ण प्रतिलिपि प्रस्तुत करने योग्यता के लिए इसे संस्करण स्ट्रिंग (जैसे `"1.5.0"`) पर पिन करें।
516
534
 
517
535
  ### वर्कफ़्लो_कॉल ईवेंट संदर्भ
518
536
 
@@ -212,6 +212,13 @@ vscode://builder.agent-native/open?url=<encoded-plan-url>
212
212
  **खुले प्रश्न** उसी योजना के निचले भाग में बनते हैं। इसका उत्तर देकर भेज रहा हूं
213
213
  यह एजेंट के लिए मौजूदा योजना के विरुद्ध एक संशोधन मोड़ शुरू करता है।
214
214
 
215
+ ## लागत और मॉडल चुनाव
216
+
217
+ कोई योजना या रिकैप बनाना आपके कोडिंग एजेंट के LLM पर एक पूर्ण एजेंटिक सत्र चलाता है, न कि कोई हल्का टेम्प्लेट फिल, इसलिए लागत diff या योजना के आकार और आपके द्वारा चुने गए मॉडल के अनुसार बढ़ती है।
218
+
219
+ - ऐप का अपना डिफ़ॉल्ट चैट मॉडल Sonnet 5 है; इसे किसी भी समय **सेटिंग्स** में बदलें। Haiku सस्ता Claude विकल्प है, और Luna GPT-5.6 परिवार में सस्ता विकल्प है।
220
+ - GitHub Action से स्वचालित PR रिकैप इंटरैक्टिव ऐप से अलग चलते हैं और इनके अपने मॉडल और लागत नियंत्रण होते हैं — `VISUAL_RECAP_MODEL`, `VISUAL_RECAP_AGENT`, और `VISUAL_RECAP_REASONING` के लिए [PR Visual Recap](/docs/pr-visual-recap) देखें।
221
+
215
222
  ## आप इसके साथ क्या कर सकते हैं
216
223
 
217
224
  - **कार्यान्वयन से पहले समीक्षा करें।** आरेख, वायरफ्रेम, विकल्प टैब के लिए React,