@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.
- package/corpus/README.md +2 -2
- package/corpus/core/CHANGELOG.md +73 -0
- package/corpus/core/docs/content/locales/ar-SA/pr-visual-recap.mdx +48 -30
- package/corpus/core/docs/content/locales/ar-SA/template-plan.mdx +7 -0
- package/corpus/core/docs/content/locales/de-DE/pr-visual-recap.mdx +48 -30
- package/corpus/core/docs/content/locales/de-DE/template-plan.mdx +7 -0
- package/corpus/core/docs/content/locales/es-ES/pr-visual-recap.mdx +48 -30
- package/corpus/core/docs/content/locales/es-ES/template-plan.mdx +14 -0
- package/corpus/core/docs/content/locales/fr-FR/pr-visual-recap.mdx +48 -30
- package/corpus/core/docs/content/locales/fr-FR/template-plan.mdx +7 -0
- package/corpus/core/docs/content/locales/hi-IN/pr-visual-recap.mdx +48 -30
- package/corpus/core/docs/content/locales/hi-IN/template-plan.mdx +7 -0
- package/corpus/core/docs/content/locales/ja-JP/pr-visual-recap.mdx +48 -30
- package/corpus/core/docs/content/locales/ja-JP/template-plan.mdx +7 -0
- package/corpus/core/docs/content/locales/ko-KR/pr-visual-recap.mdx +48 -30
- package/corpus/core/docs/content/locales/ko-KR/template-plan.mdx +7 -0
- package/corpus/core/docs/content/locales/pt-BR/pr-visual-recap.mdx +48 -30
- package/corpus/core/docs/content/locales/pt-BR/template-plan.mdx +14 -0
- package/corpus/core/docs/content/locales/zh-CN/pr-visual-recap.mdx +48 -30
- package/corpus/core/docs/content/locales/zh-CN/template-plan.mdx +7 -0
- package/corpus/core/docs/content/locales/zh-TW/pr-visual-recap.mdx +48 -30
- package/corpus/core/docs/content/locales/zh-TW/template-plan.mdx +7 -0
- package/corpus/core/docs/content/pr-visual-recap.mdx +50 -32
- package/corpus/core/docs/content/template-plan.mdx +14 -0
- package/corpus/core/docs/content/toolkit-comments-review.mdx +16 -2
- package/corpus/core/package.json +4 -1
- package/corpus/core/src/a2a/index.ts +2 -1
- package/corpus/core/src/a2a/server.ts +34 -9
- package/corpus/core/src/agent/production-agent.ts +56 -10
- package/corpus/core/src/cli/create.ts +47 -19
- package/corpus/core/src/cli/pr-visual-recap-workflow.ts +2 -3
- package/corpus/core/src/cli/recap.ts +3 -4932
- package/corpus/core/src/cli/skills-content/visual-plan-skill.ts +6 -4
- package/corpus/core/src/cli/skills-content/visual-recap-skill.ts +7 -1
- package/corpus/core/src/client/AgentPanel.tsx +19 -17
- package/corpus/core/src/client/AssistantChat.tsx +4 -0
- package/corpus/core/src/client/analytics.ts +8 -1
- package/corpus/core/src/client/chat/markdown-renderer.tsx +54 -8
- package/corpus/core/src/client/chat/message-components.tsx +8 -2
- package/corpus/core/src/client/clipboard.ts +28 -1
- package/corpus/core/src/client/composer/PromptComposer.tsx +4 -0
- package/corpus/core/src/client/composer/TiptapComposer.tsx +30 -3
- package/corpus/core/src/client/guided-questions.tsx +4 -0
- package/corpus/core/src/client/i18n.tsx +2 -1
- package/corpus/core/src/client/index.ts +4 -0
- package/corpus/core/src/client/review/ReviewCommentComposer.tsx +108 -0
- package/corpus/core/src/client/review/ReviewThreadPanel.tsx +482 -150
- package/corpus/core/src/client/review/index.ts +8 -0
- package/corpus/core/src/client/review/use-review.ts +35 -1
- package/corpus/core/src/client/use-agent-chat-context.ts +3 -2
- package/corpus/core/src/integrations/webhook-handler.ts +4 -2
- package/corpus/core/src/review/actions/create-review-comment.ts +2 -1
- package/corpus/core/src/review/actions/get-review-feedback.ts +6 -11
- package/corpus/core/src/review/actions/list-review-comments.ts +38 -4
- package/corpus/core/src/review/actions/reply-review-comment.ts +33 -22
- package/corpus/core/src/review/actions/resolve-review-thread.ts +29 -2
- package/corpus/core/src/review/actions/send-review-thread-to-agent.ts +62 -0
- package/corpus/core/src/review/identity.ts +101 -0
- package/corpus/core/src/review/index.ts +14 -0
- package/corpus/core/src/review/store.ts +315 -8
- package/corpus/core/src/review/types.ts +4 -0
- package/corpus/core/src/secrets/crypto.ts +98 -47
- package/corpus/core/src/secrets/index.ts +2 -1
- package/corpus/core/src/secrets/schema.ts +3 -0
- package/corpus/core/src/secrets/storage.ts +164 -31
- package/corpus/core/src/server/action-discovery.ts +4 -0
- package/corpus/core/src/server/action-routes.ts +125 -4
- package/corpus/core/src/server/agent-chat/plugin-options.ts +16 -0
- package/corpus/core/src/server/agent-chat-plugin.ts +1 -0
- package/corpus/core/src/server/index.ts +8 -0
- package/corpus/core/src/vite/action-types-plugin.ts +4 -0
- package/corpus/templates/analytics/changelog/2026-07-14-daily-dashboard-email-captures-authenticate-with-a-sessi.md +6 -0
- package/corpus/templates/analytics/server/lib/dashboard-report.ts +156 -3
- package/corpus/templates/assets/app/components/generation/GenerationResults.tsx +402 -142
- package/corpus/templates/assets/app/components/layout/Layout.tsx +4 -0
- package/corpus/templates/assets/app/hooks/use-navigation-state.ts +3 -1
- package/corpus/templates/assets/app/i18n/zh-TW.ts +1 -0
- package/corpus/templates/assets/app/i18n-data.ts +1 -0
- package/corpus/templates/assets/app/routes/library.tsx +187 -48
- package/corpus/templates/assets/changelog/2026-07-13-assets-keeps-the-right-chat-sidebar-closed-when-the-full-pag.md +6 -0
- package/corpus/templates/assets/changelog/2026-07-13-merged-the-candidates-panel-into-the-library-as-a-drafts-tab.md +6 -0
- package/corpus/templates/chat/app/lib/agent-page.tsx +40 -0
- package/corpus/templates/chat/app/routes/agent.tsx +5 -3
- package/corpus/templates/chat/changelog/2026-07-14-fixed-chat-template-startup-with-older-core-versions.md +6 -0
- package/corpus/templates/clips/.agents/skills/ai-video-tools/SKILL.md +5 -0
- package/corpus/templates/clips/AGENTS.md +4 -0
- package/corpus/templates/clips/actions/get-feature-flags.ts +30 -0
- package/corpus/templates/clips/actions/lib/transcript-preview.ts +48 -0
- package/corpus/templates/clips/actions/request-transcript.ts +41 -1
- package/corpus/templates/clips/actions/view-screen.ts +5 -9
- package/corpus/templates/clips/app/components/library/library-layout.tsx +1 -1
- package/corpus/templates/clips/app/components/player/video-player.tsx +39 -1
- package/corpus/templates/clips/app/hooks/use-desktop-promo.ts +6 -12
- package/corpus/templates/clips/app/hooks/use-mse-video-source.ts +146 -0
- package/corpus/templates/clips/app/lib/capture-install-options.ts +21 -0
- package/corpus/templates/clips/app/lib/fmp4.ts +271 -0
- package/corpus/templates/clips/app/lib/mse-video-loader.ts +585 -0
- package/corpus/templates/clips/app/routes/_app.dictate.tsx +0 -4
- package/corpus/templates/clips/app/routes/_app.meetings.$meetingId.tsx +5 -13
- package/corpus/templates/clips/app/routes/_app.meetings._index.tsx +2 -37
- package/corpus/templates/clips/app/routes/download.tsx +3 -2
- package/corpus/templates/clips/changelog/2026-07-10-shared-clips-now-start-playing-instantly-instead-of-showing-.md +6 -0
- package/corpus/templates/clips/changelog/2026-07-14-clips-now-distinguishes-transcript-previews-from-incomplete-.md +6 -0
- package/corpus/templates/clips/changelog/2026-07-14-desktop-app-prompts-stay-hidden-after-you-download-the-insta.md +6 -0
- package/corpus/templates/clips/desktop/src/lib/recorder.ts +5 -0
- package/corpus/templates/clips/desktop/src/overlays/recording-pill.tsx +10 -0
- package/corpus/templates/clips/desktop/src-tauri/src/lib.rs +4 -0
- package/corpus/templates/clips/desktop/src-tauri/src/native_screen/custom_capture.rs +2518 -0
- package/corpus/templates/clips/desktop/src-tauri/src/native_screen/live_upload.rs +353 -0
- package/corpus/templates/clips/desktop/src-tauri/src/native_screen.rs +558 -67
- package/corpus/templates/clips/desktop/src-tauri/src/recording_indicator.rs +11 -1
- package/corpus/templates/clips/desktop/src-tauri/src/remote_flags.rs +188 -0
- package/corpus/templates/clips/desktop/src-tauri/src/whisper_speech.rs +1 -1
- package/corpus/templates/clips/server/lib/post-finalize-dispatch.ts +1 -0
- package/corpus/templates/clips/server/plugins/agent-chat.ts +5 -0
- package/corpus/templates/clips/server/routes/api/_agent-native-background/post-finalize-worker.post.ts +5 -1
- package/corpus/templates/clips/shared/feature-flags.ts +41 -0
- package/corpus/templates/design/.agents/skills/design-generation/SKILL.md +3 -0
- package/corpus/templates/design/.agents/skills/design-review-feedback/SKILL.md +42 -0
- package/corpus/templates/design/AGENTS.md +6 -0
- package/corpus/templates/design/README.md +1 -0
- package/corpus/templates/design/actions/navigate.ts +4 -4
- package/corpus/templates/design/actions/view-screen.ts +116 -2
- package/corpus/templates/design/agent-native.app-skill.json +5 -0
- package/corpus/templates/design/app/components/design/DesignCanvas.tsx +52 -59
- package/corpus/templates/design/app/components/design/DesignExtensionsPanel.tsx +13 -9
- package/corpus/templates/design/app/components/design/EditPanel.tsx +79 -11
- package/corpus/templates/design/app/components/design/LayersPanel.tsx +78 -65
- package/corpus/templates/design/app/components/design/ReviewCommentsPanel.tsx +161 -0
- package/corpus/templates/design/app/components/design/ReviewStatusControl.tsx +96 -0
- package/corpus/templates/design/app/components/design/bridge/hit-test.bridge.ts +166 -0
- package/corpus/templates/design/app/components/layout/Layout.tsx +1 -0
- package/corpus/templates/design/app/components/visual-editor/ReviewCanvasPins.tsx +1077 -0
- package/corpus/templates/design/app/components/visual-editor/index.ts +1 -0
- package/corpus/templates/design/app/components/visual-editor/review-canvas-state.ts +42 -0
- package/corpus/templates/design/app/hooks/use-design-systems.ts +2 -2
- package/corpus/templates/design/app/hooks/use-navigation-state.ts +9 -6
- package/corpus/templates/design/app/hooks/use-question-flow.ts +7 -1
- package/corpus/templates/design/app/i18n/ar-SA.ts +56 -1
- package/corpus/templates/design/app/i18n/de-DE.ts +57 -1
- package/corpus/templates/design/app/i18n/en-US.ts +56 -1
- package/corpus/templates/design/app/i18n/es-ES.ts +56 -1
- package/corpus/templates/design/app/i18n/fr-FR.ts +57 -1
- package/corpus/templates/design/app/i18n/hi-IN.ts +56 -1
- package/corpus/templates/design/app/i18n/ja-JP.ts +56 -1
- package/corpus/templates/design/app/i18n/ko-KR.ts +56 -1
- package/corpus/templates/design/app/i18n/pt-BR.ts +57 -1
- package/corpus/templates/design/app/i18n/zh-CN.ts +56 -1
- package/corpus/templates/design/app/i18n/zh-TW.ts +51 -0
- package/corpus/templates/design/app/pages/Present.tsx +172 -14
- package/corpus/templates/design/app/pages/design-editor/overview-camera.ts +23 -0
- package/corpus/templates/design/app/pages/design-editor/tool-state.ts +10 -0
- package/corpus/templates/design/app/pages/present-review-state.ts +18 -0
- package/corpus/templates/design/app/public-routes.ts +8 -0
- package/corpus/templates/design/app/root.tsx +7 -6
- package/corpus/templates/design/changelog/2026-07-13-dragged-design-assets-now-appear-at-the-visible-drop-locatio.md +6 -0
- package/corpus/templates/design/changelog/2026-07-13-reviewers-can-pin-comments-on-shared-designs-and-apply-verif.md +6 -0
- package/corpus/templates/design/server/plugins/agent-chat.ts +10 -0
- package/corpus/templates/design/server/plugins/auth.ts +7 -5
- package/corpus/templates/design/server/plugins/review.ts +9 -0
- package/corpus/templates/design/shared/review-anchor.ts +83 -0
- package/corpus/templates/design/shared/review-summary.ts +25 -0
- package/corpus/templates/forms/.agents/skills/form-publishing/SKILL.md +2 -0
- package/corpus/templates/forms/AGENTS.md +4 -0
- package/corpus/templates/forms/actions/create-form.ts +2 -1
- package/corpus/templates/forms/actions/update-form.ts +5 -2
- package/corpus/templates/forms/app/i18n/ar-SA.ts +3 -0
- package/corpus/templates/forms/app/i18n/de-DE.ts +3 -0
- package/corpus/templates/forms/app/i18n/en-US.ts +3 -0
- package/corpus/templates/forms/app/i18n/es-ES.ts +3 -0
- package/corpus/templates/forms/app/i18n/fr-FR.ts +3 -0
- package/corpus/templates/forms/app/i18n/hi-IN.ts +3 -0
- package/corpus/templates/forms/app/i18n/ja-JP.ts +3 -0
- package/corpus/templates/forms/app/i18n/ko-KR.ts +3 -0
- package/corpus/templates/forms/app/i18n/pt-BR.ts +3 -0
- package/corpus/templates/forms/app/i18n/zh-CN.ts +3 -0
- package/corpus/templates/forms/app/i18n/zh-TW.ts +3 -0
- package/corpus/templates/forms/app/pages/FormBuilderPage.tsx +19 -0
- package/corpus/templates/forms/changelog/2026-07-14-fixed-the-ask-forms-loading-input-appearing-above-the-welcom.md +6 -0
- package/corpus/templates/forms/changelog/2026-07-14-form-social-previews-now-show-the-form-title-description-and.md +6 -0
- package/corpus/templates/forms/changelog/2026-07-14-forms-can-email-the-form-owner-when-new-responses-arrive.md +6 -0
- package/corpus/templates/forms/server/handlers/submissions.ts +17 -0
- package/corpus/templates/forms/server/lib/form-og-image.ts +64 -6
- package/corpus/templates/forms/server/lib/public-form-ssr.ts +6 -2
- package/corpus/templates/forms/server/lib/response-email.ts +65 -0
- package/corpus/templates/forms/server/plugins/agent-chat.ts +1 -0
- package/corpus/templates/forms/server/routes/api/forms/og/[...slug]/og.png.get.ts +184 -0
- package/corpus/templates/forms/shared/types.ts +2 -0
- package/corpus/templates/plan/.agents/skills/visual-plan/SKILL.md +6 -4
- package/corpus/templates/plan/.agents/skills/visual-recap/SKILL.md +7 -1
- package/dist/a2a/index.d.ts +2 -1
- package/dist/a2a/index.d.ts.map +1 -1
- package/dist/a2a/index.js +1 -1
- package/dist/a2a/index.js.map +1 -1
- package/dist/a2a/server.d.ts +25 -0
- package/dist/a2a/server.d.ts.map +1 -1
- package/dist/a2a/server.js +30 -6
- package/dist/a2a/server.js.map +1 -1
- package/dist/agent/production-agent.d.ts +2 -0
- package/dist/agent/production-agent.d.ts.map +1 -1
- package/dist/agent/production-agent.js +37 -12
- package/dist/agent/production-agent.js.map +1 -1
- package/dist/cli/create.d.ts +5 -3
- package/dist/cli/create.d.ts.map +1 -1
- package/dist/cli/create.js +44 -19
- package/dist/cli/create.js.map +1 -1
- package/dist/cli/pr-visual-recap-workflow.d.ts +2 -2
- package/dist/cli/pr-visual-recap-workflow.d.ts.map +1 -1
- package/dist/cli/pr-visual-recap-workflow.js +2 -2
- package/dist/cli/pr-visual-recap-workflow.js.map +1 -1
- package/dist/cli/recap.d.ts +3 -562
- package/dist/cli/recap.d.ts.map +1 -1
- package/dist/cli/recap.js +3 -3875
- package/dist/cli/recap.js.map +1 -1
- package/dist/cli/skills-content/visual-plan-skill.d.ts +1 -1
- package/dist/cli/skills-content/visual-plan-skill.d.ts.map +1 -1
- package/dist/cli/skills-content/visual-plan-skill.js +6 -4
- package/dist/cli/skills-content/visual-plan-skill.js.map +1 -1
- package/dist/cli/skills-content/visual-recap-skill.d.ts +1 -1
- package/dist/cli/skills-content/visual-recap-skill.d.ts.map +1 -1
- package/dist/cli/skills-content/visual-recap-skill.js +7 -1
- package/dist/cli/skills-content/visual-recap-skill.js.map +1 -1
- package/dist/client/AgentPanel.d.ts.map +1 -1
- package/dist/client/AgentPanel.js +3 -3
- package/dist/client/AgentPanel.js.map +1 -1
- package/dist/client/AssistantChat.d.ts +2 -0
- package/dist/client/AssistantChat.d.ts.map +1 -1
- package/dist/client/AssistantChat.js +2 -2
- package/dist/client/AssistantChat.js.map +1 -1
- package/dist/client/analytics.d.ts +5 -0
- package/dist/client/analytics.d.ts.map +1 -1
- package/dist/client/analytics.js +3 -1
- package/dist/client/analytics.js.map +1 -1
- package/dist/client/chat/markdown-renderer.d.ts +1 -0
- package/dist/client/chat/markdown-renderer.d.ts.map +1 -1
- package/dist/client/chat/markdown-renderer.js +36 -1
- package/dist/client/chat/markdown-renderer.js.map +1 -1
- package/dist/client/chat/message-components.d.ts.map +1 -1
- package/dist/client/chat/message-components.js +5 -2
- package/dist/client/chat/message-components.js.map +1 -1
- package/dist/client/clipboard.d.ts +3 -1
- package/dist/client/clipboard.d.ts.map +1 -1
- package/dist/client/clipboard.js +24 -1
- package/dist/client/clipboard.js.map +1 -1
- package/dist/client/composer/PromptComposer.d.ts +2 -0
- package/dist/client/composer/PromptComposer.d.ts.map +1 -1
- package/dist/client/composer/PromptComposer.js +2 -2
- package/dist/client/composer/PromptComposer.js.map +1 -1
- package/dist/client/composer/TiptapComposer.d.ts +3 -1
- package/dist/client/composer/TiptapComposer.d.ts.map +1 -1
- package/dist/client/composer/TiptapComposer.js +20 -5
- package/dist/client/composer/TiptapComposer.js.map +1 -1
- package/dist/client/guided-questions.d.ts +3 -1
- package/dist/client/guided-questions.d.ts.map +1 -1
- package/dist/client/guided-questions.js +2 -1
- package/dist/client/guided-questions.js.map +1 -1
- package/dist/client/i18n.d.ts.map +1 -1
- package/dist/client/i18n.js +3 -1
- package/dist/client/i18n.js.map +1 -1
- package/dist/client/index.d.ts +1 -1
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js +1 -1
- package/dist/client/index.js.map +1 -1
- package/dist/client/review/ReviewCommentComposer.d.ts +18 -0
- package/dist/client/review/ReviewCommentComposer.d.ts.map +1 -0
- package/dist/client/review/ReviewCommentComposer.js +30 -0
- package/dist/client/review/ReviewCommentComposer.js.map +1 -0
- package/dist/client/review/ReviewThreadPanel.d.ts +28 -1
- package/dist/client/review/ReviewThreadPanel.d.ts.map +1 -1
- package/dist/client/review/ReviewThreadPanel.js +151 -39
- package/dist/client/review/ReviewThreadPanel.js.map +1 -1
- package/dist/client/review/index.d.ts +3 -2
- package/dist/client/review/index.d.ts.map +1 -1
- package/dist/client/review/index.js +2 -1
- package/dist/client/review/index.js.map +1 -1
- package/dist/client/review/use-review.d.ts +23 -0
- package/dist/client/review/use-review.d.ts.map +1 -1
- package/dist/client/review/use-review.js +3 -0
- package/dist/client/review/use-review.js.map +1 -1
- package/dist/client/use-agent-chat-context.d.ts +1 -1
- package/dist/client/use-agent-chat-context.d.ts.map +1 -1
- package/dist/client/use-agent-chat-context.js +4 -2
- package/dist/client/use-agent-chat-context.js.map +1 -1
- package/dist/collab/awareness.d.ts +2 -2
- package/dist/collab/awareness.d.ts.map +1 -1
- package/dist/collab/struct-routes.d.ts +1 -1
- package/dist/file-upload/actions/upload-image.d.ts +1 -1
- package/dist/integrations/webhook-handler.d.ts.map +1 -1
- package/dist/integrations/webhook-handler.js +3 -2
- package/dist/integrations/webhook-handler.js.map +1 -1
- package/dist/notifications/routes.d.ts +3 -3
- package/dist/observability/routes.d.ts +5 -5
- package/dist/progress/routes.d.ts +1 -1
- package/dist/provider-api/corpus-jobs.d.ts +2 -2
- package/dist/resources/handlers.d.ts +2 -2
- package/dist/review/actions/create-review-comment.js +2 -1
- package/dist/review/actions/create-review-comment.js.map +1 -1
- package/dist/review/actions/get-review-feedback.js +6 -11
- package/dist/review/actions/get-review-feedback.js.map +1 -1
- package/dist/review/actions/list-review-comments.d.ts +1 -0
- package/dist/review/actions/list-review-comments.js +25 -4
- package/dist/review/actions/list-review-comments.js.map +1 -1
- package/dist/review/actions/reply-review-comment.js +12 -5
- package/dist/review/actions/reply-review-comment.js.map +1 -1
- package/dist/review/actions/resolve-review-thread.d.ts +3 -0
- package/dist/review/actions/resolve-review-thread.js +20 -3
- package/dist/review/actions/resolve-review-thread.js.map +1 -1
- package/dist/review/actions/send-review-thread-to-agent.d.ts +17 -0
- package/dist/review/actions/send-review-thread-to-agent.d.ts.map +1 -0
- package/dist/review/actions/send-review-thread-to-agent.js +49 -0
- package/dist/review/actions/send-review-thread-to-agent.js.map +1 -0
- package/dist/review/identity.d.ts +6 -0
- package/dist/review/identity.d.ts.map +1 -0
- package/dist/review/identity.js +68 -0
- package/dist/review/identity.js.map +1 -0
- package/dist/review/index.d.ts +3 -1
- package/dist/review/index.d.ts.map +1 -1
- package/dist/review/index.js +2 -1
- package/dist/review/index.js.map +1 -1
- package/dist/review/store.d.ts +36 -0
- package/dist/review/store.d.ts.map +1 -1
- package/dist/review/store.js +223 -8
- package/dist/review/store.js.map +1 -1
- package/dist/review/types.d.ts +4 -0
- package/dist/review/types.d.ts.map +1 -1
- package/dist/review/types.js.map +1 -1
- package/dist/secrets/crypto.d.ts +35 -13
- package/dist/secrets/crypto.d.ts.map +1 -1
- package/dist/secrets/crypto.js +78 -41
- package/dist/secrets/crypto.js.map +1 -1
- package/dist/secrets/index.d.ts.map +1 -1
- package/dist/secrets/index.js +2 -1
- package/dist/secrets/index.js.map +1 -1
- package/dist/secrets/routes.d.ts +9 -9
- package/dist/secrets/schema.d.ts +20 -1
- package/dist/secrets/schema.d.ts.map +1 -1
- package/dist/secrets/schema.js +3 -0
- package/dist/secrets/schema.js.map +1 -1
- package/dist/secrets/storage.d.ts +7 -7
- package/dist/secrets/storage.d.ts.map +1 -1
- package/dist/secrets/storage.js +121 -30
- package/dist/secrets/storage.js.map +1 -1
- package/dist/server/action-discovery.d.ts.map +1 -1
- package/dist/server/action-discovery.js +4 -0
- package/dist/server/action-discovery.js.map +1 -1
- package/dist/server/action-routes.d.ts +45 -0
- package/dist/server/action-routes.d.ts.map +1 -1
- package/dist/server/action-routes.js +71 -5
- package/dist/server/action-routes.js.map +1 -1
- package/dist/server/agent-chat/plugin-options.d.ts +16 -0
- package/dist/server/agent-chat/plugin-options.d.ts.map +1 -1
- package/dist/server/agent-chat/plugin-options.js.map +1 -1
- package/dist/server/agent-chat-plugin.d.ts.map +1 -1
- package/dist/server/agent-chat-plugin.js +1 -0
- package/dist/server/agent-chat-plugin.js.map +1 -1
- package/dist/server/index.d.ts +3 -1
- package/dist/server/index.d.ts.map +1 -1
- package/dist/server/index.js +2 -0
- package/dist/server/index.js.map +1 -1
- package/dist/vite/action-types-plugin.d.ts.map +1 -1
- package/dist/vite/action-types-plugin.js +4 -0
- package/dist/vite/action-types-plugin.js.map +1 -1
- package/docs/content/locales/ar-SA/pr-visual-recap.mdx +48 -30
- package/docs/content/locales/ar-SA/template-plan.mdx +7 -0
- package/docs/content/locales/de-DE/pr-visual-recap.mdx +48 -30
- package/docs/content/locales/de-DE/template-plan.mdx +7 -0
- package/docs/content/locales/es-ES/pr-visual-recap.mdx +48 -30
- package/docs/content/locales/es-ES/template-plan.mdx +14 -0
- package/docs/content/locales/fr-FR/pr-visual-recap.mdx +48 -30
- package/docs/content/locales/fr-FR/template-plan.mdx +7 -0
- package/docs/content/locales/hi-IN/pr-visual-recap.mdx +48 -30
- package/docs/content/locales/hi-IN/template-plan.mdx +7 -0
- package/docs/content/locales/ja-JP/pr-visual-recap.mdx +48 -30
- package/docs/content/locales/ja-JP/template-plan.mdx +7 -0
- package/docs/content/locales/ko-KR/pr-visual-recap.mdx +48 -30
- package/docs/content/locales/ko-KR/template-plan.mdx +7 -0
- package/docs/content/locales/pt-BR/pr-visual-recap.mdx +48 -30
- package/docs/content/locales/pt-BR/template-plan.mdx +14 -0
- package/docs/content/locales/zh-CN/pr-visual-recap.mdx +48 -30
- package/docs/content/locales/zh-CN/template-plan.mdx +7 -0
- package/docs/content/locales/zh-TW/pr-visual-recap.mdx +48 -30
- package/docs/content/locales/zh-TW/template-plan.mdx +7 -0
- package/docs/content/pr-visual-recap.mdx +50 -32
- package/docs/content/template-plan.mdx +14 -0
- package/docs/content/toolkit-comments-review.mdx +16 -2
- package/package.json +4 -1
- 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/
|
|
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/
|
|
111
|
-
npx @agent-native/
|
|
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/
|
|
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/
|
|
139
|
-
npx @agent-native/
|
|
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-
|
|
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/
|
|
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/
|
|
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
|
|
213
|
-
| ------------------------ |
|
|
214
|
-
| `OPENAI_API_KEY` | —
|
|
215
|
-
| `VISUAL_RECAP_AGENT` | `claude`
|
|
216
|
-
| `VISUAL_RECAP_MODEL` |
|
|
217
|
-
| `VISUAL_RECAP_REASONING` | valeur par défaut de chaque modèle
|
|
218
|
-
| `RECAP_CLI_VERSION` | `latest`
|
|
219
|
-
| `PLAN_RECAP_APP_URL` | `https://plan.agent-native.com`
|
|
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/
|
|
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/
|
|
364
|
-
npx @agent-native/
|
|
365
|
-
npx @agent-native/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
111
|
-
npx @agent-native/
|
|
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/
|
|
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/
|
|
139
|
-
npx @agent-native/
|
|
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-
|
|
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/
|
|
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/
|
|
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` | —
|
|
215
|
-
| `VISUAL_RECAP_AGENT` | `claude`
|
|
216
|
-
| `VISUAL_RECAP_MODEL` |
|
|
217
|
-
| `VISUAL_RECAP_REASONING` | प्रत्येक मॉडल का डिफ़ॉल्ट
|
|
218
|
-
| `RECAP_CLI_VERSION` | `latest`
|
|
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/
|
|
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/
|
|
364
|
-
npx @agent-native/
|
|
365
|
-
npx @agent-native/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
515
|
+
npx @agent-native/recap-cli@latest recap setup --reusable
|
|
498
516
|
|
|
499
517
|
# या प्रतिलिपि प्रस्तुत करने योग्यता के लिए पिन किए गए रेफरी के साथ:
|
|
500
|
-
npx @agent-native/
|
|
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/
|
|
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/
|
|
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,
|