@agent-native/core 0.100.2 → 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 +65 -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/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/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/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/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/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-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/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/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/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/routes.d.ts +9 -9
- 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 @@ 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,
|
|
@@ -102,13 +102,13 @@ PR Visual Recap は、すべてのプル リクエストを **ビジュアル
|
|
|
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` はワークフローを更新し、`gh` を使用して GitHub Actions を設定します
|
|
@@ -118,7 +118,7 @@ npx @agent-native/core@latest recap doctor
|
|
|
118
118
|
生成されたワークフロー ファイルを開き、PR を開いて実行を確認します。
|
|
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
|
バックエンドを超えて、2 つのリポジトリ変数がエージェントの実行方法を調整します。
|
|
162
162
|
|
|
163
|
-
- **`VISUAL_RECAP_MODEL`** は、CLI (`--model`) に渡されるモデルを固定します。たとえば、Codex の場合は `gpt-5.6-
|
|
163
|
+
- **`VISUAL_RECAP_MODEL`** は、CLI (`--model`) に渡されるモデルを固定します。たとえば、Codex の場合は `gpt-5.6-luna`、Claude モデル ID、または 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
|
たとえば、GPT-5.6 Sol を使用して Codex の要約を高度な推論で実行するには、リポジトリ変数 `VISUAL_RECAP_AGENT=codex`、`VISUAL_RECAP_MODEL=gpt-5.6-sol`、および `VISUAL_RECAP_REASONING=high` を設定します。
|
|
168
168
|
|
|
169
|
+
## コスト
|
|
170
|
+
|
|
171
|
+
各要約の実行は、安価なテンプレート要約ではなく実際の差分を読み取るフルエージェント型のコーディング エージェント セッションです。そのため、コストはモデルの選択と実行頻度によって変わります:
|
|
172
|
+
|
|
173
|
+
- **PR プッシュごとにフル セッション。** デフォルトのトリガーは `synchronize` で発火するため、10 回プッシュされた PR はエージェントを 10 回実行します。
|
|
174
|
+
- **毎回 PR 全体**を対象とし、前回の実行以降のコミットだけではありません — コストは差分の増分サイズではなく、PR 全体のサイズに応じて変わります。
|
|
175
|
+
- **差分の入力は約 600KB に制限されます。** これにより 1 回の実行あたりの最悪ケースは抑えられますが、大きな差分は小さな差分よりも実質的にコストがかかります。
|
|
176
|
+
- **失敗時の自動リトライは 1 回**あり、一時的に失敗した実行のコストをおおよそ倍増させる可能性があります。
|
|
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 互換プロバイダーを指定します。** `VISUAL_RECAP_AGENT=openai-compatible` を、DeepSeek、Kimi、またはその他の OpenAI 互換エンドポイントを対象とする `VISUAL_RECAP_BASE_URL`/`VISUAL_RECAP_MODEL`/`VISUAL_RECAP_API_KEY` とともに設定してください。
|
|
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
|
**Solo: 個人トークンはまだ機能します。** `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 互換バックエンド用のプロバイダー モデル ID (そこでは必須)。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
|
|
|
@@ -357,9 +375,9 @@ GitHub アクションは、ホストされ、共有可能な PR レビュー用
|
|
|
357
375
|
代わりに、同じヘルパー フローがローカル ファイル モードでローカルに表示されます:
|
|
358
376
|
|
|
359
377
|
```bash
|
|
360
|
-
npx @agent-native/
|
|
361
|
-
npx @agent-native/
|
|
362
|
-
npx @agent-native/
|
|
378
|
+
npx @agent-native/recap-cli@latest recap collect-diff --base main --head HEAD --out recap.diff --stat recap.stat
|
|
379
|
+
npx @agent-native/recap-cli@latest recap scan --diff recap.diff
|
|
380
|
+
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
|
|
363
381
|
```
|
|
364
382
|
|
|
365
383
|
生成された `recap-prompt.md` をコーディング エージェントに渡します。ローカルファイルモード
|
|
@@ -389,7 +407,7 @@ npx @agent-native/core@latest plan local serve --dir plans/pr-123-visual-recap -
|
|
|
389
407
|
|
|
390
408
|
## バージョンの固定 (コピー バリアント) {#version-pinning-copy-variant}
|
|
391
409
|
|
|
392
|
-
デフォルトでは、コピーバリアント ワークフローは実行時に `@agent-native/
|
|
410
|
+
デフォルトでは、コピーバリアント ワークフローは実行時に `@agent-native/recap-cli@latest` をインストールするため、要約を実行するたびに最新の CLI が自動的に選択されます。 CI に再現可能なツールが必要な場合は、**`RECAP_CLI_VERSION`** リポジトリ変数を設定して、インストールされているバージョンを固定します。
|
|
393
411
|
|
|
394
412
|
1. リポジトリの **[設定] → [シークレットと変数] → [Actions] → [変数]** に移動します。
|
|
395
413
|
2. `1.5.0` のような値を持つ `RECAP_CLI_VERSION` という名前の変数を作成します。
|
|
@@ -400,7 +418,7 @@ npx @agent-native/core@latest plan local serve --dir plans/pr-123-visual-recap -
|
|
|
400
418
|
|
|
401
419
|
## シークレットスキャン許可リスト
|
|
402
420
|
|
|
403
|
-
要約を公開する前に、ワークフローは `npx @agent-native/
|
|
421
|
+
要約を公開する前に、ワークフローは `npx @agent-native/recap-cli@latest recap scan` を実行して差分内の可能性のあるシークレットを検出します。差分が既知の秘密パターンと一致する PR は、説明コメントでブロックされます。要約は公開されず、差分コンテンツはコーディング エージェントに送信されません。
|
|
404
422
|
|
|
405
423
|
まれに、リポジトリに意図的なテスト フィクスチャや、表面的に秘密のパターンに似た非秘密の文字列 (テスト ファイル内のフィクスチャ キーなど) が含まれる場合があります。誤検知を抑制するには、リポジトリのルートに `.github/recap-scan-allowlist` を作成します。
|
|
406
424
|
|
|
@@ -434,7 +452,7 @@ EXAMPLE_API_KEY=placeholder-value
|
|
|
434
452
|
|
|
435
453
|
### なぜ再利用可能なバリアントを使用するのですか?
|
|
436
454
|
|
|
437
|
-
デフォルトのインストーラーは、約 360 行の完全なワークフロー YAML をリポジトリにコピーします (**コピー** オプション)。これは、エアギャップ リポジトリや、実行内容のすべての行を監査する必要があるリポジトリに最適です。欠点は、バグ修正や改善が決して届かないことです。リリースごとに `npx @agent-native/
|
|
455
|
+
デフォルトのインストーラーは、約 360 行の完全なワークフロー YAML をリポジトリにコピーします (**コピー** オプション)。これは、エアギャップ リポジトリや、実行内容のすべての行を監査する必要があるリポジトリに最適です。欠点は、バグ修正や改善が決して届かないことです。リリースごとに `npx @agent-native/recap-cli@latest recap setup` を手動で再実行する必要があります。
|
|
438
456
|
|
|
439
457
|
**再利用可能** オプションは、代わりに約 20 行の薄い呼び出し元を書き込みます。 `uses:` 経由で `BuilderIO/agent-native/.github/workflows/pr-visual-recap-reusable.yml` に委任します。すべての呼び出し元は、ワークフローの実行時に最新のロジックを自動的に取得し、ローカル更新は必要ありません。
|
|
440
458
|
|
|
@@ -447,7 +465,7 @@ EXAMPLE_API_KEY=placeholder-value
|
|
|
447
465
|
|
|
448
466
|
### 発信者のスニペット
|
|
449
467
|
|
|
450
|
-
これは `npx @agent-native/
|
|
468
|
+
これは `npx @agent-native/recap-cli@latest recap setup --reusable` が書いたものです (または手動で貼り付けることもできます):
|
|
451
469
|
|
|
452
470
|
```yaml
|
|
453
471
|
name: PR Visual Recap
|
|
@@ -482,7 +500,7 @@ jobs:
|
|
|
482
500
|
skill-source: ${{ vars.VISUAL_RECAP_SKILL_SOURCE || 'auto' }}
|
|
483
501
|
runs-on: ${{ vars.VISUAL_RECAP_RUNS_ON || '"ubuntu-latest"' }}
|
|
484
502
|
gate-runs-on: ${{ vars.VISUAL_RECAP_GATE_RUNS_ON || 'ubuntu-latest' }}
|
|
485
|
-
# cli-version: "latest" # pin to a specific @agent-native/
|
|
503
|
+
# cli-version: "latest" # pin to a specific @agent-native/recap-cli version
|
|
486
504
|
```
|
|
487
505
|
|
|
488
506
|
[Secrets and variables](#secrets-and-variables) で説明されているものと同じシークレットと変数が適用されます。再利用可能な呼び出し元は、完全なジョブ向けに `VISUAL_RECAP_RUNS_ON` を `runs-on` として、ゲート向けに `VISUAL_RECAP_GATE_RUNS_ON` を単一ラベルの `gate-runs-on` として渡します。省略時はどちらも `ubuntu-latest` です。
|
|
@@ -491,15 +509,15 @@ jobs:
|
|
|
491
509
|
|
|
492
510
|
```bash
|
|
493
511
|
# 完全なコピーの代わりにシン呼び出し元を作成します。
|
|
494
|
-
npx @agent-native/
|
|
512
|
+
npx @agent-native/recap-cli@latest recap setup --reusable
|
|
495
513
|
|
|
496
514
|
# または、再現性を高めるために固定された参照を使用します。
|
|
497
|
-
npx @agent-native/
|
|
515
|
+
npx @agent-native/recap-cli@latest recap setup --reusable --ref v1.2.3
|
|
498
516
|
```
|
|
499
517
|
|
|
500
518
|
どちらのバリアントもワークフローを `.github/workflows/pr-visual-recap.yml` に書き込みます。既存のワークフローがすでに存在し、異なる場合、コマンドは拒否され、上書きするために `--force` を渡すように指示されます。
|
|
501
519
|
|
|
502
|
-
書き込み後、通常どおり `npx @agent-native/
|
|
520
|
+
書き込み後、通常どおり `npx @agent-native/recap-cli@latest recap doctor` を実行して、シークレットが構成されていることを確認します。
|
|
503
521
|
|
|
504
522
|
### バージョンの固定
|
|
505
523
|
|
|
@@ -509,7 +527,7 @@ npx @agent-native/core@latest recap setup --reusable --ref v1.2.3
|
|
|
509
527
|
uses: BuilderIO/agent-native/.github/workflows/pr-visual-recap-reusable.yml@v1.2.3
|
|
510
528
|
```
|
|
511
529
|
|
|
512
|
-
`cli-version` 入力は、ワークフロー内でどの `@agent-native/
|
|
530
|
+
`cli-version` 入力は、ワークフロー内でどの `@agent-native/recap-cli` CLI バージョンを実行するかを制御します。最新のリリースを追跡するには `"latest"` のままにし、完全な再現性を得るためにバージョン文字列 (例: `"1.5.0"`) に固定します。
|
|
513
531
|
|
|
514
532
|
### workflow_call イベント コンテキスト
|
|
515
533
|
|
|
@@ -214,6 +214,13 @@ Codex、Claude コード、Markdown、または貼り付けられたプランが
|
|
|
214
214
|
**公開質問** フォームは同じプランの下部にあります。返信して送信
|
|
215
215
|
エージェントに対するそれは、既存の計画に対する改訂ターンを開始します。
|
|
216
216
|
|
|
217
|
+
## コストとモデルの選択
|
|
218
|
+
|
|
219
|
+
プランや要約の生成は、軽量なテンプレート埋め込みではなく、コーディング エージェントの LLM に対するフルエージェント型セッションを実行するため、コストは差分やプランのサイズと選択したモデルに応じて変わります。
|
|
220
|
+
|
|
221
|
+
- アプリ自体のデフォルト チャット モデルは Sonnet 5 です。いつでも **[設定]** で変更できます。Haiku はより安価な Claude の選択肢で、Luna は GPT-5.6 ファミリーの中でより安価な選択肢です。
|
|
222
|
+
- GitHub Action による自動 PR 要約は、インタラクティブなアプリとは別に実行され、独自のモデルとコストの調整項目を持ちます。`VISUAL_RECAP_MODEL`、`VISUAL_RECAP_AGENT`、`VISUAL_RECAP_REASONING` については [PR Visual Recap](/docs/pr-visual-recap) を参照してください。
|
|
223
|
+
|
|
217
224
|
## それを使って何ができるか
|
|
218
225
|
|
|
219
226
|
- **実装前に確認してください。** React を図、ワイヤーフレーム、オプション タブに追加します。
|