@agent-native/core 0.100.2 → 0.101.3
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 +83 -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/credentials/index.ts +41 -8
- package/corpus/core/src/extensions/fetch-tool.ts +33 -3
- package/corpus/core/src/notifications/channels.ts +20 -6
- 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 +26 -10
- package/corpus/core/src/secrets/storage.ts +16 -3
- 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 +61 -7
- package/corpus/core/src/server/derived-secret.ts +5 -1
- 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/changelog/2026-07-14-long-running-cross-app-analyses-now-continue-reliably-in-the.md +6 -0
- package/corpus/templates/analytics/server/lib/dashboard-report.ts +156 -3
- package/corpus/templates/analytics/server/plugins/agent-chat.ts +8 -4
- 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/share-dialog.tsx +44 -81
- 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/i18n/ar-SA.ts +0 -8
- package/corpus/templates/clips/app/i18n/de-DE.ts +0 -9
- package/corpus/templates/clips/app/i18n/en-US.ts +0 -8
- package/corpus/templates/clips/app/i18n/es-ES.ts +0 -9
- package/corpus/templates/clips/app/i18n/fr-FR.ts +0 -9
- package/corpus/templates/clips/app/i18n/hi-IN.ts +0 -8
- package/corpus/templates/clips/app/i18n/ja-JP.ts +0 -9
- package/corpus/templates/clips/app/i18n/ko-KR.ts +0 -9
- package/corpus/templates/clips/app/i18n/pt-BR.ts +0 -9
- package/corpus/templates/clips/app/i18n/zh-CN.ts +0 -7
- package/corpus/templates/clips/app/i18n/zh-TW.ts +0 -7
- 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/changelog/2026-07-14-share-dialogs-show-separate-links-for-people-and-agents.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/dispatch/changelog/2026-07-14-dispatch-now-distinguishes-connected-agents-from-locally-mou.md +6 -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/credentials/index.d.ts +12 -7
- package/dist/credentials/index.d.ts.map +1 -1
- package/dist/credentials/index.js +33 -8
- package/dist/credentials/index.js.map +1 -1
- package/dist/extensions/fetch-tool.d.ts +13 -1
- package/dist/extensions/fetch-tool.d.ts.map +1 -1
- package/dist/extensions/fetch-tool.js +9 -2
- package/dist/extensions/fetch-tool.js.map +1 -1
- package/dist/notifications/channels.js +20 -4
- package/dist/notifications/channels.js.map +1 -1
- 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 +3 -3
- 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 +15 -7
- package/dist/secrets/crypto.d.ts.map +1 -1
- package/dist/secrets/crypto.js +23 -10
- package/dist/secrets/crypto.js.map +1 -1
- package/dist/secrets/routes.d.ts +9 -9
- package/dist/secrets/storage.d.ts.map +1 -1
- package/dist/secrets/storage.js +16 -3
- 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 +20 -0
- package/dist/server/agent-chat-plugin.d.ts.map +1 -1
- package/dist/server/agent-chat-plugin.js +39 -4
- package/dist/server/agent-chat-plugin.js.map +1 -1
- package/dist/server/derived-secret.d.ts +1 -1
- package/dist/server/derived-secret.d.ts.map +1 -1
- package/dist/server/derived-secret.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/clips/app/components/sharing/slack-share-hint.tsx +0 -68
- package/corpus/templates/forms/server/routes/api/forms/og/[slug]/og.png.get.ts +0 -45
|
@@ -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
|
+
- تعمل ملخصات طلبات السحب (PR) الآلية من GitHub Action بشكل منفصل عن التطبيق التفاعلي، ولها مقابض النموذج والتكلفة الخاصة بها — راجع [PR Visual Recap](/docs/pr-visual-recap) للاطلاع على `VISUAL_RECAP_MODEL` و`VISUAL_RECAP_AGENT` و`VISUAL_RECAP_REASONING`.
|
|
221
|
+
|
|
215
222
|
## ما يمكنك فعله به
|
|
216
223
|
|
|
217
224
|
- **المراجعة قبل التنفيذ.** React للرسومات التخطيطية، والإطارات السلكية، وعلامات تبويب الخيارات،
|
|
@@ -102,13 +102,13 @@ explizit jederzeit:
|
|
|
102
102
|
npx @agent-native/core@latest skills add visual-plan --with-github-action
|
|
103
103
|
```
|
|
104
104
|
|
|
105
|
-
Dadurch wird der `visual-plan`-Skill installiert (der den `visual-recap`-Skill enthält, den die Aktion ausführt) und `.github/workflows/pr-visual-recap.yml` in Ihr Repo schreiben. Der Workflow ruft **veröffentlichte CLI-Unterbefehle** über `npx @agent-native/
|
|
105
|
+
Dadurch wird der `visual-plan`-Skill installiert (der den `visual-recap`-Skill enthält, den die Aktion ausführt) und `.github/workflows/pr-visual-recap.yml` in Ihr Repo schreiben. Der Workflow ruft **veröffentlichte CLI-Unterbefehle** über `npx @agent-native/recap-cli@latest recap <subcommand>` auf – einschließlich `gate`, `collect-diff`, `block-reference`, `scan`, `build-prompt`, `publish`, `shot`, `comment`, `check` und `usage` – sodass nichts in Ihr kopiert wird repo als Hilfsskripte. `setup` und `doctor` sind die interaktiven Helfer, die Sie lokal ausführen; `gate` ist der Sicherheits-Gate-Schritt, den der Workflow vor jeder Zusammenfassung ausführt.
|
|
106
106
|
|
|
107
107
|
Führen Sie dann den geführten Einrichtungshelfer aus:
|
|
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` aktualisiert den Workflow und verwendet `gh` zum Festlegen von GitHub Actions
|
|
@@ -118,7 +118,7 @@ gesetzt. Geheime Werte werden über stdin an `gh` gesendet, nicht über Befehlsa
|
|
|
118
118
|
die generierte Workflow-Datei und öffnen Sie eine PR, um ihre Ausführung zu sehen.
|
|
119
119
|
|
|
120
120
|
Standardmäßig erstellt der Workflow seine Agentenaufforderung aus dem neuesten Paket
|
|
121
|
-
`visual-recap`-Anleitung in `@agent-native/
|
|
121
|
+
`visual-recap`-Anleitung in `@agent-native/recap-cli@latest`, einschließlich aller Geschwister
|
|
122
122
|
Referenzdateien, mit denen der Skill geliefert wird. Wenn Ihr Repo absichtlich angepasst wird und
|
|
123
123
|
pinnen den festgeschriebenen `visual-recap`-Ordner an und legen die Repository-Variable fest
|
|
124
124
|
`VISUAL_RECAP_SKILL_SOURCE=repo`.
|
|
@@ -135,8 +135,8 @@ Standardmäßig wird der Workflow auf von GitHub gehosteten `ubuntu-latest`-Runn
|
|
|
135
135
|
Die JSON-Anführungszeichen sind erforderlich. Dieser Wert wählt den Runner für den vollständigen `recap`-Job. Übergeben Sie zur Konfiguration während der geführten Einrichtung denselben JSON-Wert an `--runs-on` und prüfen Sie anschließend den Workflow und die Verfügbarkeit des Runners mit `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
|
Das einfache Gate verwendet separat `ubuntu-latest`. Repositorys ohne von GitHub gehostete Runner können `VISUAL_RECAP_GATE_RUNS_ON` auf ein einzelnes Klartext-Label ohne JSON setzen oder `--gate-runs-on visual-recap-gate` verwenden. Das benutzerdefinierte Label gilt nur für `OWNER`-, `MEMBER`- oder `COLLABORATOR`-Autoren desselben Repositorys; Forks und andere Autoren werden auf `ubuntu-latest` gezwungen und können ohne GitHub-gehostete Runner ungeplant bleiben. Nutzen Sie einen dedizierten, möglichst kurzlebigen Runner: Das Standard-Gate checkt den PR-Baum nicht aus und wertet Workflow-Logik sowie PR-Metadaten aus.
|
|
@@ -160,12 +160,30 @@ Wenn die Variable nicht gesetzt ist, verwendet die Aktion `claude`.
|
|
|
160
160
|
|
|
161
161
|
Über das Backend hinaus optimieren zwei Repository-Variablen, _wie_ der Agent ausgeführt wird:
|
|
162
162
|
|
|
163
|
-
- **`VISUAL_RECAP_MODEL`** pinnt das an CLI (`--model`) übergebene Modell – zum Beispiel `gpt-5.6-
|
|
163
|
+
- **`VISUAL_RECAP_MODEL`** pinnt das an CLI (`--model`) übergebene Modell – zum Beispiel `gpt-5.6-luna` für Codex, eine Claude-Modell-ID oder `deepseek-chat` für DeepSeek. Für `openai-compatible` ist sie erforderlich. Für das **Claude**-Backend führt ein nicht gesetzter Wert jetzt standardmäßig zu `claude-sonnet-5`; setzen Sie die Variable explizit, um ein anderes Claude-Modell zu verwenden, etwa das günstigere `claude-haiku-4-5`. Für das **Codex**-Backend verwendet ein nicht gesetzter Wert das eigene Standardmodell des Codex CLI.
|
|
164
164
|
- **`VISUAL_RECAP_REASONING`** legt die Argumentationstiefe fest: `none`, `minimal`, `low`, `medium`, `high` oder `xhigh`. Es gilt für das Codex-Backend; Die Argumentation von Claude ist modellgesteuert, daher wird diese Variable dort ignoriert.
|
|
165
165
|
- **`VISUAL_RECAP_SKILL_SOURCE`** steuert die Aktualität der Eingabeaufforderung: `auto`/unset verwendet die neueste gebündelte Skill-Anleitung, während `repo` an den festgeschriebenen Repository-lokalen `visual-recap`-Skill-Ordner angeheftet wird.
|
|
166
166
|
|
|
167
167
|
Um beispielsweise die Zusammenfassung auf Codex mit GPT-5.6 Sol bei hoher Argumentation auszuführen, legen Sie die Repository-Variablen `VISUAL_RECAP_AGENT=codex`, `VISUAL_RECAP_MODEL=gpt-5.6-sol` und `VISUAL_RECAP_REASONING=high` fest.
|
|
168
168
|
|
|
169
|
+
## Kosten
|
|
170
|
+
|
|
171
|
+
Jeder Zusammenfassungslauf ist eine vollständige agentische Coding-Agent-Sitzung, die einen echten Diff liest, keine günstige, vorlagenbasierte Zusammenfassung – die Kosten hängen daher von der Modellwahl und davon ab, wie oft der Lauf ausgeführt wird:
|
|
172
|
+
|
|
173
|
+
- **Eine vollständige Sitzung pro PR-Push.** Der Standard-Trigger reagiert auf `synchronize`, sodass ein PR, der zehnmal gepusht wird, den Agenten zehnmal ausführt.
|
|
174
|
+
- **Jedes Mal der gesamte PR**, nicht nur die Commits seit dem letzten Lauf – die Kosten skalieren mit der Gesamtgröße des PR, nicht mit der inkrementellen Diff-Größe.
|
|
175
|
+
- **Diff-Eingabe auf ~600KB begrenzt.** Dies begrenzt den ungünstigsten Fall pro Lauf, aber große Diffs kosten weiterhin spürbar mehr als kleine.
|
|
176
|
+
- **Ein automatischer Wiederholungsversuch bei einem Fehler**, der die Kosten eines vorübergehend fehlgeschlagenen Laufs etwa verdoppeln kann.
|
|
177
|
+
|
|
178
|
+
So senken Sie die Kosten:
|
|
179
|
+
|
|
180
|
+
- **Pinnen Sie ein günstigeres Modell.** Setzen Sie für Claude `VISUAL_RECAP_MODEL=claude-haiku-4-5` bei einfachen oder kleinen Repositorys – das ist die günstigste Claude-Stufe; `claude-sonnet-5` (die Standardeinstellung) ist die ausgewogene Stufe.
|
|
181
|
+
- **Wechseln Sie zu Codex mit einem günstigeren Modell.** Setzen Sie `VISUAL_RECAP_AGENT=codex` zusammen mit `VISUAL_RECAP_MODEL=gpt-5.6-luna` (die günstigste GPT-5.6-Stufe) oder `gpt-5.6-terra` (mittlere Stufe), und setzen Sie `VISUAL_RECAP_REASONING=low`, um die Ausgaben für Argumentations-Token weiter zu senken. Die Argumentationstiefe gilt nur für Codex.
|
|
182
|
+
- **Nutzen Sie einen günstigeren OpenAI-kompatiblen Anbieter.** Setzen Sie `VISUAL_RECAP_AGENT=openai-compatible` zusammen mit `VISUAL_RECAP_BASE_URL`/`VISUAL_RECAP_MODEL`/`VISUAL_RECAP_API_KEY`, die auf DeepSeek, Kimi oder einen anderen OpenAI-kompatiblen Endpunkt verweisen.
|
|
183
|
+
- **Fassen Sie seltener zusammen.** Bearbeiten Sie `on.pull_request.types` des installierten Workflows von `[opened, synchronize, reopened, ready_for_review, closed]` zu `[opened, ready_for_review, closed]`, sodass nur beim Öffnen und beim Mergen eines PR zusammengefasst wird, statt bei jedem Push.
|
|
184
|
+
|
|
185
|
+
Jeder Lauf zeichnet auf, was er tatsächlich gekostet hat: Der `recap usage`-Schritt des Workflows fügt dem veröffentlichten Plan Token- und Kostennutzung hinzu, sodass Sie die tatsächlichen Ausgaben pro Lauf einsehen können, statt zu raten.
|
|
186
|
+
|
|
169
187
|
## Geheimnisse und Variablen
|
|
170
188
|
|
|
171
189
|
Legen Sie diese in den **Einstellungen → Geheimnisse und Variablen → Actions** Ihres Repositorys fest.
|
|
@@ -196,11 +214,11 @@ Pläne-App.
|
|
|
196
214
|
|
|
197
215
|
**Solo: Ein persönlicher Token funktioniert weiterhin.** Prägen Sie ihn mit `npx @agent-native/core@latest connect`
|
|
198
216
|
gegen Ihre Pläne-App. Für die gehostete App schreibt dies auch eine lokale
|
|
199
|
-
Publish-Token-Datei, die `npx @agent-native/
|
|
217
|
+
Publish-Token-Datei, die `npx @agent-native/recap-cli@latest recap setup` lesen kann:
|
|
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
|
Wenn Sie die manuelle Einrichtung bevorzugen, fügen Sie das Token in das GitHub-Geheimnis ein. Verwenden Sie ein
|
|
@@ -209,16 +227,16 @@ echtes Token.
|
|
|
209
227
|
|
|
210
228
|
### Optional (nur wenn Sie die Standardeinstellungen ändern)
|
|
211
229
|
|
|
212
|
-
| Geheimnis/Variable | Standard
|
|
213
|
-
| ------------------------ |
|
|
214
|
-
| `OPENAI_API_KEY` | —
|
|
215
|
-
| `VISUAL_RECAP_AGENT` | `claude`
|
|
216
|
-
| `VISUAL_RECAP_MODEL` |
|
|
217
|
-
| `VISUAL_RECAP_REASONING` | Standardeinstellung jedes Modells
|
|
218
|
-
| `RECAP_CLI_VERSION` | `latest`
|
|
219
|
-
| `PLAN_RECAP_APP_URL` | `https://plan.agent-native.com`
|
|
230
|
+
| Geheimnis/Variable | Standard | Wenn Sie es brauchen |
|
|
231
|
+
| ------------------------ | --------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
232
|
+
| `OPENAI_API_KEY` | — | Geheimnis. Zusammen mit `VISUAL_RECAP_AGENT=codex` einstellen, um die Zusammenfassung stattdessen mit Codex auszuführen. |
|
|
233
|
+
| `VISUAL_RECAP_AGENT` | `claude` | Variable. Wählt das Coding-Agent-Backend (`claude` oder `codex`) aus. |
|
|
234
|
+
| `VISUAL_RECAP_MODEL` | `claude-sonnet-5` für Claude; für das kompatible Backend erforderlich | Variable. Anbieter-Modell-ID für OpenAI-kompatible Backends (dort erforderlich). Für Claude führt ein nicht gesetzter Wert jetzt standardmäßig zu `claude-sonnet-5` – setzen Sie ihn, um es zu überschreiben, z. B. `claude-haiku-4-5` für die günstigste Stufe. Für Codex verwendet ein nicht gesetzter Wert die eigene Standardeinstellung des Codex CLI. |
|
|
235
|
+
| `VISUAL_RECAP_REASONING` | Standardeinstellung jedes Modells | Variable. Argumentationstiefe: `none`, `minimal`, `low`, `medium`, `high` oder `xhigh`. Gilt für das Codex-Backend. |
|
|
236
|
+
| `RECAP_CLI_VERSION` | `latest` | Variable. Pinnt die `@agent-native/recap-cli` CLI-Version, die der Workflow installiert – z. B. `1.5.0`. Siehe [Version pinning](#version-pinning-copy-variant). |
|
|
237
|
+
| `PLAN_RECAP_APP_URL` | `https://plan.agent-native.com` | Geheimnis. Nur beim Selbsthosten der Plans-App an einem anderen Ursprung. |
|
|
220
238
|
|
|
221
|
-
Der Workflow erkennt automatisch, wie sein Hilfsprogramm CLI (lokale Quelle in diesem Monorepo, das an anderer Stelle veröffentlichte `@agent-native/
|
|
239
|
+
Der Workflow erkennt automatisch, wie sein Hilfsprogramm CLI (lokale Quelle in diesem Monorepo, das an anderer Stelle veröffentlichte `@agent-native/recap-cli`) aufgerufen wird, sodass keine `RECAP_CLI`-Variable festgelegt werden muss.
|
|
222
240
|
|
|
223
241
|
## Inline-Screenshot im Kommentar
|
|
224
242
|
|
|
@@ -359,9 +377,9 @@ Rekapitulieren, ohne Rekapitulationsinhalte an die Agent-Native-Plandatenbank zu
|
|
|
359
377
|
gleicher Hilfsablauf lokal im Modus „Lokale Dateien“ stattdessen:
|
|
360
378
|
|
|
361
379
|
```bash
|
|
362
|
-
npx @agent-native/
|
|
363
|
-
npx @agent-native/
|
|
364
|
-
npx @agent-native/
|
|
380
|
+
npx @agent-native/recap-cli@latest recap collect-diff --base main --head HEAD --out recap.diff --stat recap.stat
|
|
381
|
+
npx @agent-native/recap-cli@latest recap scan --diff recap.diff
|
|
382
|
+
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
|
|
365
383
|
```
|
|
366
384
|
|
|
367
385
|
Geben Sie das generierte `recap-prompt.md` an Ihren Codierungsagenten. Im lokalen Dateimodus
|
|
@@ -391,7 +409,7 @@ Die Zusammenfassung ist eine Überprüfungshilfe, die über dem normalen PR-Abla
|
|
|
391
409
|
|
|
392
410
|
## Versionspinning (Kopiervariante) {#version-pinning-copy-variant}
|
|
393
411
|
|
|
394
|
-
Standardmäßig installiert der Kopiervarianten-Workflow `@agent-native/
|
|
412
|
+
Standardmäßig installiert der Kopiervarianten-Workflow `@agent-native/recap-cli@latest` zur Laufzeit, sodass bei jedem Wiederholungslauf automatisch das neueste CLI übernommen wird. Wenn Ihr CI reproduzierbare Tools benötigt, legen Sie die Repository-Variable **`RECAP_CLI_VERSION`** fest, um die installierte Version anzuheften:
|
|
395
413
|
|
|
396
414
|
1. Gehen Sie zu **Einstellungen → Geheimnisse und Variablen → Actions → Variablen** Ihres Repos.
|
|
397
415
|
2. Erstellen Sie eine Variable namens `RECAP_CLI_VERSION` mit einem Wert wie `1.5.0`.
|
|
@@ -402,7 +420,7 @@ Verwenden Sie für die wiederverwendbare Caller-Variante stattdessen die Eingabe
|
|
|
402
420
|
|
|
403
421
|
## Zulassungsliste für geheime Scans
|
|
404
422
|
|
|
405
|
-
Vor der Veröffentlichung einer Zusammenfassung führt der Workflow `npx @agent-native/
|
|
423
|
+
Vor der Veröffentlichung einer Zusammenfassung führt der Workflow `npx @agent-native/recap-cli@latest recap scan` aus, um wahrscheinliche Geheimnisse im Diff zu erkennen. Jeder PR, dessen Diff mit einem bekannten geheimen Muster übereinstimmt, wird mit einem erläuternden Kommentar blockiert – die Zusammenfassung wird nicht veröffentlicht und es werden keine Diff-Inhalte an den Codierungsagenten gesendet.
|
|
406
424
|
|
|
407
425
|
In seltenen Fällen verfügt ein Repo über absichtliche Test-Fixtures oder nicht geheime Zeichenfolgen, die oberflächlich betrachtet geheimen Mustern ähneln (z. B. ein Fixture-Schlüssel in einer Testdatei). Um ein falsch positives Ergebnis zu unterdrücken, erstellen Sie `.github/recap-scan-allowlist` im Stammverzeichnis Ihres Repositorys.
|
|
408
426
|
|
|
@@ -436,7 +454,7 @@ Die Zulassungsliste wird nur vom Secret-Scan-Gate konsultiert. Es hat keinen Ein
|
|
|
436
454
|
|
|
437
455
|
### Warum die wiederverwendbare Variante verwenden?
|
|
438
456
|
|
|
439
|
-
Das Standardinstallationsprogramm kopiert den vollständigen ~360-Zeilen-Workflow YAML in Ihr Repo (die Option **Kopieren**). Dies ist die richtige Wahl für Air-Gap-Repos oder Repos, die jede Zeile ihrer Ausführung prüfen müssen. Der Nachteil ist, dass Fehlerkorrekturen und Verbesserungen Sie nie erreichen – Sie müssen `npx @agent-native/
|
|
457
|
+
Das Standardinstallationsprogramm kopiert den vollständigen ~360-Zeilen-Workflow YAML in Ihr Repo (die Option **Kopieren**). Dies ist die richtige Wahl für Air-Gap-Repos oder Repos, die jede Zeile ihrer Ausführung prüfen müssen. Der Nachteil ist, dass Fehlerkorrekturen und Verbesserungen Sie nie erreichen – Sie müssen `npx @agent-native/recap-cli@latest recap setup` nach jeder Veröffentlichung manuell erneut ausführen.
|
|
440
458
|
|
|
441
459
|
Die Option **wiederverwendbar** schreibt stattdessen einen dünnen Aufrufer mit ca. 20 Leitungen. Es wird über `uses:` an `BuilderIO/agent-native/.github/workflows/pr-visual-recap-reusable.yml` delegiert. Jeder Aufrufer ruft automatisch die neueste Logik ab, wenn der Workflow ausgeführt wird, ohne dass eine lokale Aktualisierung erforderlich ist.
|
|
442
460
|
|
|
@@ -449,7 +467,7 @@ Die Option **wiederverwendbar** schreibt stattdessen einen dünnen Aufrufer mit
|
|
|
449
467
|
|
|
450
468
|
### Anrufer-Snippet
|
|
451
469
|
|
|
452
|
-
Das schreibt `npx @agent-native/
|
|
470
|
+
Das schreibt `npx @agent-native/recap-cli@latest recap setup --reusable` (oder Sie können es manuell einfügen):
|
|
453
471
|
|
|
454
472
|
```yaml
|
|
455
473
|
name: PR Visual Recap
|
|
@@ -484,7 +502,7 @@ jobs:
|
|
|
484
502
|
skill-source: ${{ vars.VISUAL_RECAP_SKILL_SOURCE || 'auto' }}
|
|
485
503
|
runs-on: ${{ vars.VISUAL_RECAP_RUNS_ON || '"ubuntu-latest"' }}
|
|
486
504
|
gate-runs-on: ${{ vars.VISUAL_RECAP_GATE_RUNS_ON || 'ubuntu-latest' }}
|
|
487
|
-
# cli-version: "latest" # pin to a specific @agent-native/
|
|
505
|
+
# cli-version: "latest" # pin to a specific @agent-native/recap-cli version
|
|
488
506
|
```
|
|
489
507
|
|
|
490
508
|
Es gelten dieselben Geheimnisse und Variablen wie unter [Secrets and variables](#secrets-and-variables). Der wiederverwendbare Aufrufer leitet `VISUAL_RECAP_RUNS_ON` als `runs-on` für den vollständigen Job und `VISUAL_RECAP_GATE_RUNS_ON` als einfaches `gate-runs-on`-Label für das Gate weiter. Ohne Eingabe verwenden beide `ubuntu-latest`.
|
|
@@ -493,15 +511,15 @@ Es gelten dieselben Geheimnisse und Variablen wie unter [Secrets and variables](
|
|
|
493
511
|
|
|
494
512
|
```bash
|
|
495
513
|
# Schreiben Sie den Thin Caller anstelle der vollständigen Kopie:
|
|
496
|
-
npx @agent-native/
|
|
514
|
+
npx @agent-native/recap-cli@latest recap setup --reusable
|
|
497
515
|
|
|
498
516
|
# Oder mit einer angehefteten Referenz zur Reproduzierbarkeit:
|
|
499
|
-
npx @agent-native/
|
|
517
|
+
npx @agent-native/recap-cli@latest recap setup --reusable --ref v1.2.3
|
|
500
518
|
```
|
|
501
519
|
|
|
502
520
|
Beide Varianten schreiben den Workflow nach `.github/workflows/pr-visual-recap.yml`. Wenn bereits ein vorhandener Workflow vorhanden ist und dieser abweicht, lehnt der Befehl ab und fordert Sie auf, `--force` zum Überschreiben zu übergeben.
|
|
503
521
|
|
|
504
|
-
Führen Sie nach dem Schreiben wie gewohnt `npx @agent-native/
|
|
522
|
+
Führen Sie nach dem Schreiben wie gewohnt `npx @agent-native/recap-cli@latest recap doctor` aus, um zu bestätigen, dass die Geheimnisse konfiguriert sind.
|
|
505
523
|
|
|
506
524
|
### Versionsfixierung
|
|
507
525
|
|
|
@@ -511,7 +529,7 @@ Standardmäßig verweist der Aufrufer auf `@main`, das immer die neueste veröff
|
|
|
511
529
|
uses: BuilderIO/agent-native/.github/workflows/pr-visual-recap-reusable.yml@v1.2.3
|
|
512
530
|
```
|
|
513
531
|
|
|
514
|
-
Die `cli-version`-Eingabe steuert, welche `@agent-native/
|
|
532
|
+
Die `cli-version`-Eingabe steuert, welche `@agent-native/recap-cli` CLI-Version im Workflow ausgeführt wird – belassen Sie sie bei `"latest"`, um die neueste Version zu verfolgen, oder heften Sie sie für eine vollständige Reproduzierbarkeit an eine Versionszeichenfolge (z. B. `"1.5.0"`).
|
|
515
533
|
|
|
516
534
|
### workflow_call-Ereigniskontext
|
|
517
535
|
|
|
@@ -214,6 +214,13 @@ Wenn es im ersten Durchgang noch verantwortbare Entscheidungen gibt, kann der Ag
|
|
|
214
214
|
Formular **Offene Fragen** am Ende desselben Plans. Beantworten und senden
|
|
215
215
|
Es wird dem Agenten eine Revisionsrunde gegen den bestehenden Plan eingeleitet.
|
|
216
216
|
|
|
217
|
+
## Kosten und Modellwahl
|
|
218
|
+
|
|
219
|
+
Das Erstellen eines Plans oder einer Zusammenfassung führt eine vollständige agentische Sitzung mit dem LLM Ihres Coding-Agenten aus, keine leichtgewichtige Vorlagenbefüllung – die Kosten skalieren daher mit der Größe des Diffs oder Plans und dem gewählten Modell.
|
|
220
|
+
|
|
221
|
+
- Das eigene Standard-Chat-Modell der App ist Sonnet 5; ändern Sie es jederzeit in den **Einstellungen**. Haiku ist die günstigere Claude-Option, und Luna ist die günstigere Option in der GPT-5.6-Familie.
|
|
222
|
+
- Automatisierte PR-Zusammenfassungen aus der GitHub Action laufen getrennt von der interaktiven App und haben eigene Regler für Modell und Kosten – siehe [PR Visual Recap](/docs/pr-visual-recap) für `VISUAL_RECAP_MODEL`, `VISUAL_RECAP_AGENT` und `VISUAL_RECAP_REASONING`.
|
|
223
|
+
|
|
217
224
|
## Was Sie damit machen können
|
|
218
225
|
|
|
219
226
|
- **Überprüfung vor der Implementierung.** React zu Diagrammen, Wireframes, Optionsregisterkarten,
|
|
@@ -102,13 +102,13 @@ explícitamente en cualquier momento:
|
|
|
102
102
|
npx @agent-native/core@latest skills add visual-plan --with-github-action
|
|
103
103
|
```
|
|
104
104
|
|
|
105
|
-
Esto instala la habilidad `visual-plan` (que incluye la habilidad `visual-recap` que ejecuta la acción) y escribe `.github/workflows/pr-visual-recap.yml` en su repositorio. El flujo de trabajo llama a **subcomandos CLI publicados** a través de `npx @agent-native/
|
|
105
|
+
Esto instala la habilidad `visual-plan` (que incluye la habilidad `visual-recap` que ejecuta la acción) y escribe `.github/workflows/pr-visual-recap.yml` en su repositorio. El flujo de trabajo llama a **subcomandos CLI publicados** a través de `npx @agent-native/recap-cli@latest recap <subcommand>`, incluidos `gate`, `collect-diff`, `block-reference`, `scan`, `build-prompt`, `publish`, `shot`, `comment`, `check` y `usage`, por lo que no se copia nada en su repositorio como scripts de ayuda. `setup` y `doctor` son los ayudantes interactivos que ejecuta localmente; `gate` es el paso de seguridad que ejecuta el flujo de trabajo antes de cada resumen.
|
|
106
106
|
|
|
107
107
|
Luego ejecute el asistente de configuración guiada:
|
|
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` actualiza el flujo de trabajo, usa `gh` para configurar GitHub Actions
|
|
@@ -118,7 +118,7 @@ conjunto. Los valores secretos se envían a `gh` a través de la entrada estánd
|
|
|
118
118
|
el archivo de flujo de trabajo generado y abra un PR para verlo ejecutar.
|
|
119
119
|
|
|
120
120
|
De forma predeterminada, el flujo de trabajo crea el mensaje del agente a partir del último paquete
|
|
121
|
-
Guía de `visual-recap` en `@agent-native/
|
|
121
|
+
Guía de `visual-recap` en `@agent-native/recap-cli@latest`, incluido cualquier hermano
|
|
122
122
|
archivos de referencia con los que se envía la habilidad. Si su repositorio personaliza intencionalmente y
|
|
123
123
|
fija su carpeta `visual-recap` comprometida, establece la variable del repositorio
|
|
124
124
|
`VISUAL_RECAP_SKILL_SOURCE=repo`.
|
|
@@ -135,8 +135,8 @@ De forma predeterminada, el flujo de trabajo se ejecuta en ejecutores `ubuntu-la
|
|
|
135
135
|
Las comillas JSON son obligatorias. Este valor selecciona el ejecutor del trabajo completo `recap`. Para configurarlo durante la instalación guiada, pase el mismo valor JSON a `--runs-on` y después valide el flujo de trabajo y la disponibilidad del ejecutor con `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
|
La barrera ligera usa `ubuntu-latest` por separado. Los repositorios sin ejecutores alojados por GitHub pueden establecer `VISUAL_RECAP_GATE_RUNS_ON` en una sola etiqueta de texto sin JSON, o usar `--gate-runs-on visual-recap-gate`. La etiqueta personalizada solo se usa para autores `OWNER`, `MEMBER` o `COLLABORATOR` del mismo repositorio; los forks y demás autores se fuerzan a `ubuntu-latest` y pueden quedar sin programar si los ejecutores alojados están desactivados. Use un ejecutor dedicado y, preferiblemente, efímero: la barrera estándar no descarga el árbol del PR y evalúa la lógica del flujo de trabajo y los metadatos del PR.
|
|
@@ -160,12 +160,30 @@ Si la variable no está configurada, la acción utiliza `claude`.
|
|
|
160
160
|
|
|
161
161
|
Más allá del backend, dos variables del repositorio ajustan _cómo_ se ejecuta el agente:
|
|
162
162
|
|
|
163
|
-
- **`VISUAL_RECAP_MODEL`** fija el modelo pasado al CLI (`--model`)
|
|
163
|
+
- **`VISUAL_RECAP_MODEL`** fija el modelo pasado al CLI (`--model`) — por ejemplo, `gpt-5.6-luna` para Codex, una identificación de modelo Claude, o `deepseek-chat` para DeepSeek. Es obligatorio para `openai-compatible`. Para el backend **Claude**, dejarlo sin configurar ahora utiliza `claude-sonnet-5` de forma predeterminada; configure la variable explícitamente para usar un modelo Claude diferente, como el más económico `claude-haiku-4-5`. Para el backend **Codex**, dejarlo sin configurar utiliza el modelo predeterminado propio del CLI de Codex.
|
|
164
164
|
- **`VISUAL_RECAP_REASONING`** establece la profundidad del razonamiento: `none`, `minimal`, `low`, `medium`, `high` o `xhigh`. Se aplica al backend Codex; El razonamiento de Claude se basa en modelos, por lo que esta variable se ignora allí.
|
|
165
165
|
- **`VISUAL_RECAP_SKILL_SOURCE`** controla la actualización de los mensajes: `auto`/unset utiliza la guía de habilidades incluida más reciente, mientras que `repo` se fija a la carpeta de habilidades `visual-recap` local del repositorio comprometido.
|
|
166
166
|
|
|
167
167
|
Por ejemplo, para ejecutar el resumen en Codex con GPT-5.6 Sol en razonamiento alto, configure las variables del repositorio `VISUAL_RECAP_AGENT=codex`, `VISUAL_RECAP_MODEL=gpt-5.6-sol` y `VISUAL_RECAP_REASONING=high`.
|
|
168
168
|
|
|
169
|
+
## Costo
|
|
170
|
+
|
|
171
|
+
Cada ejecución de resumen es una sesión completa de agente de codificación que lee un diff real, no un resumen barato basado en plantillas, por lo que su costo depende de la elección del modelo y de la frecuencia con la que se ejecuta:
|
|
172
|
+
|
|
173
|
+
- **Una sesión completa por cada push al PR.** El disparador predeterminado se activa en `synchronize`, por lo que un PR al que se le hacen diez pushes ejecuta el agente diez veces.
|
|
174
|
+
- **Todo el PR cada vez**, no solo los commits desde la última ejecución — el costo escala con el tamaño total del PR, no con el tamaño incremental del diff.
|
|
175
|
+
- **Entrada de diff limitada a ~600KB.** Esto acota el peor caso por ejecución, pero los diffs grandes siguen costando considerablemente más que los pequeños.
|
|
176
|
+
- **Un reintento automático en caso de fallo**, que puede aproximadamente duplicar el costo de una ejecución que falla de forma transitoria.
|
|
177
|
+
|
|
178
|
+
Para reducir el costo:
|
|
179
|
+
|
|
180
|
+
- **Fije un modelo más económico.** Para Claude, configure `VISUAL_RECAP_MODEL=claude-haiku-4-5` para repositorios simples o pequeños — es el nivel más económico de Claude; `claude-sonnet-5` (el predeterminado) es el nivel equilibrado.
|
|
181
|
+
- **Cambie a Codex con un modelo más económico.** Configure `VISUAL_RECAP_AGENT=codex` con `VISUAL_RECAP_MODEL=gpt-5.6-luna` (el nivel más económico de GPT-5.6) o `gpt-5.6-terra` (nivel intermedio), y configure `VISUAL_RECAP_REASONING=low` para reducir aún más el gasto en tokens de razonamiento. La profundidad de razonamiento solo se aplica a Codex.
|
|
182
|
+
- **Apunte a un proveedor compatible con OpenAI más económico.** Configure `VISUAL_RECAP_AGENT=openai-compatible` con `VISUAL_RECAP_BASE_URL`/`VISUAL_RECAP_MODEL`/`VISUAL_RECAP_API_KEY` apuntando a DeepSeek, Kimi o cualquier otro endpoint compatible con OpenAI.
|
|
183
|
+
- **Resuma con menos frecuencia.** Edite el `on.pull_request.types` del flujo de trabajo instalado de `[opened, synchronize, reopened, ready_for_review, closed]` a `[opened, ready_for_review, closed]` para que solo genere resúmenes cuando un PR se abre y cuando se fusiona, en lugar de en cada push.
|
|
184
|
+
|
|
185
|
+
Cada ejecución registra lo que realmente gastó: el paso `recap usage` del flujo de trabajo adjunta el uso de tokens y costo al plan publicado, para que pueda ver el gasto real por ejecución en lugar de adivinar.
|
|
186
|
+
|
|
169
187
|
## Secretos y variables
|
|
170
188
|
|
|
171
189
|
Configúrelos en **Configuración → Secretos y variables → Actions** de su repositorio.
|
|
@@ -196,11 +214,11 @@ Aplicación de planes.
|
|
|
196
214
|
|
|
197
215
|
**Solo: un token personal todavía funciona.** Acuñalo con `npx @agent-native/core@latest connect`
|
|
198
216
|
contra tu aplicación de Planes. Para la aplicación alojada, esto también escribe un local
|
|
199
|
-
archivo de token de publicación que `npx @agent-native/
|
|
217
|
+
archivo de token de publicación que `npx @agent-native/recap-cli@latest recap setup` puede leer:
|
|
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 prefiere la configuración manual, pegue el token en el secreto GitHub. Utilice un
|
|
@@ -209,16 +227,16 @@ token real.
|
|
|
209
227
|
|
|
210
228
|
### Opcional (solo si cambia los valores predeterminados)
|
|
211
229
|
|
|
212
|
-
| Secreto/variable | Predeterminado
|
|
213
|
-
| ------------------------ |
|
|
214
|
-
| `OPENAI_API_KEY` | —
|
|
215
|
-
| `VISUAL_RECAP_AGENT` | `claude`
|
|
216
|
-
| `VISUAL_RECAP_MODEL` |
|
|
217
|
-
| `VISUAL_RECAP_REASONING` | valor predeterminado de cada modelo
|
|
218
|
-
| `RECAP_CLI_VERSION` | `latest`
|
|
219
|
-
| `PLAN_RECAP_APP_URL` | `https://plan.agent-native.com`
|
|
230
|
+
| Secreto/variable | Predeterminado | Cuando lo necesites |
|
|
231
|
+
| ------------------------ | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
232
|
+
| `OPENAI_API_KEY` | — | Secreto. Configúrelo junto con `VISUAL_RECAP_AGENT=codex` para ejecutar el resumen con Codex. |
|
|
233
|
+
| `VISUAL_RECAP_AGENT` | `claude` | Variable. Selecciona el backend del agente de codificación (`claude` o `codex`). |
|
|
234
|
+
| `VISUAL_RECAP_MODEL` | `claude-sonnet-5` para Claude; obligatorio para el backend compatible | Variable. Identificación del modelo del proveedor para backends compatibles con OpenAI (obligatoria allí). Para Claude, sin configurar ahora usa `claude-sonnet-5` de forma predeterminada — configúrelo para anularlo, p. ej. `claude-haiku-4-5` para el nivel más económico. Para Codex, sin configurar utiliza el valor predeterminado propio del CLI de Codex. |
|
|
235
|
+
| `VISUAL_RECAP_REASONING` | valor predeterminado de cada modelo | Variable. Profundidad de razonamiento: `none`, `minimal`, `low`, `medium`, `high` o `xhigh`. Se aplica al backend Codex. |
|
|
236
|
+
| `RECAP_CLI_VERSION` | `latest` | Variable. Fija la versión `@agent-native/recap-cli` CLI que instala el flujo de trabajo, p. `1.5.0`. Ver [Version pinning](#version-pinning-copy-variant). |
|
|
237
|
+
| `PLAN_RECAP_APP_URL` | `https://plan.agent-native.com` | Secreto. Solo cuando se aloja la aplicación Planes en un origen diferente. |
|
|
220
238
|
|
|
221
|
-
El flujo de trabajo detecta automáticamente cómo invocar su asistente CLI (fuente local dentro de este monorepo, el `@agent-native/
|
|
239
|
+
El flujo de trabajo detecta automáticamente cómo invocar su asistente CLI (fuente local dentro de este monorepo, el `@agent-native/recap-cli` publicado en otro lugar), por lo que no hay ninguna variable `RECAP_CLI` para configurar.
|
|
222
240
|
|
|
223
241
|
## Captura de pantalla en línea en el comentario
|
|
224
242
|
|
|
@@ -359,9 +377,9 @@ recapitular sin enviar el contenido del resumen a la base de datos del plan Agen
|
|
|
359
377
|
en su lugar, el mismo flujo de ayuda local en modo de archivos locales:
|
|
360
378
|
|
|
361
379
|
```bash
|
|
362
|
-
npx @agent-native/
|
|
363
|
-
npx @agent-native/
|
|
364
|
-
npx @agent-native/
|
|
380
|
+
npx @agent-native/recap-cli@latest recap collect-diff --base main --head HEAD --out recap.diff --stat recap.stat
|
|
381
|
+
npx @agent-native/recap-cli@latest recap scan --diff recap.diff
|
|
382
|
+
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
|
|
365
383
|
```
|
|
366
384
|
|
|
367
385
|
Entregue el `recap-prompt.md` generado a su agente codificador. En modo de archivos locales
|
|
@@ -391,7 +409,7 @@ El resumen es una ayuda de revisión que se suma al flujo normal de relaciones p
|
|
|
391
409
|
|
|
392
410
|
## Fijación de versión (variante de copia) {#version-pinning-copy-variant}
|
|
393
411
|
|
|
394
|
-
De forma predeterminada, el flujo de trabajo de variante de copia instala `@agent-native/
|
|
412
|
+
De forma predeterminada, el flujo de trabajo de variante de copia instala `@agent-native/recap-cli@latest` en tiempo de ejecución, de modo que cada ejecución de resumen selecciona automáticamente el CLI más reciente. Si su CI necesita herramientas reproducibles, configure la variable de repositorio **`RECAP_CLI_VERSION`** para fijar la versión instalada:
|
|
395
413
|
|
|
396
414
|
1. Vaya a **Configuración → Secretos y variables → Actions → Variables** de su repositorio.
|
|
397
415
|
2. Cree una variable llamada `RECAP_CLI_VERSION` con un valor como `1.5.0`.
|
|
@@ -402,7 +420,7 @@ Para la variante de llamada reutilizable, utilice la entrada `cli-version` (cons
|
|
|
402
420
|
|
|
403
421
|
## Lista permitida de escaneo secreto
|
|
404
422
|
|
|
405
|
-
Antes de publicar un resumen, el flujo de trabajo ejecuta `npx @agent-native/
|
|
423
|
+
Antes de publicar un resumen, el flujo de trabajo ejecuta `npx @agent-native/recap-cli@latest recap scan` para detectar posibles secretos en la diferencia. Cualquier PR cuya diferencia coincida con un patrón secreto conocido se bloquea con un comentario explicativo: el resumen no se publica y no se envía ningún contenido de diferencia al agente codificador.
|
|
406
424
|
|
|
407
425
|
En casos excepcionales, un repositorio tiene dispositivos de prueba intencionales o cadenas no secretas que superficialmente se parecen a patrones secretos (por ejemplo, una clave de dispositivo en un archivo de prueba). Para suprimir un falso positivo, cree `.github/recap-scan-allowlist` en la raíz de su repositorio.
|
|
408
426
|
|
|
@@ -436,7 +454,7 @@ La lista de permitidos solo la consulta la puerta de escaneo secreto. No afecta
|
|
|
436
454
|
|
|
437
455
|
### ¿Por qué utilizar la variante reutilizable?
|
|
438
456
|
|
|
439
|
-
El instalador predeterminado copia el flujo de trabajo completo de ~360 líneas YAML en su repositorio (la opción **copiar**). Esta es la opción correcta para repositorios aislados o repositorios que necesitan auditar cada línea de lo que se ejecuta. La desventaja es que las correcciones de errores y las mejoras nunca llegan a usted: debe volver a ejecutar `npx @agent-native/
|
|
457
|
+
El instalador predeterminado copia el flujo de trabajo completo de ~360 líneas YAML en su repositorio (la opción **copiar**). Esta es la opción correcta para repositorios aislados o repositorios que necesitan auditar cada línea de lo que se ejecuta. La desventaja es que las correcciones de errores y las mejoras nunca llegan a usted: debe volver a ejecutar `npx @agent-native/recap-cli@latest recap setup` manualmente después de cada versión.
|
|
440
458
|
|
|
441
459
|
En su lugar, la opción **reutilizable** escribe una persona que llama delgada de ~20 líneas. Delega a `BuilderIO/agent-native/.github/workflows/pr-visual-recap-reusable.yml` vía `uses:`. Cada persona que llama selecciona automáticamente la lógica más reciente cuando se ejecuta el flujo de trabajo, sin necesidad de actualización local.
|
|
442
460
|
|
|
@@ -449,7 +467,7 @@ En su lugar, la opción **reutilizable** escribe una persona que llama delgada d
|
|
|
449
467
|
|
|
450
468
|
### Fragmento de la persona que llama
|
|
451
469
|
|
|
452
|
-
Esto es lo que escribe `npx @agent-native/
|
|
470
|
+
Esto es lo que escribe `npx @agent-native/recap-cli@latest recap setup --reusable` (o puedes pegarlo manualmente):
|
|
453
471
|
|
|
454
472
|
```yaml
|
|
455
473
|
name: PR Visual Recap
|
|
@@ -484,7 +502,7 @@ jobs:
|
|
|
484
502
|
skill-source: ${{ vars.VISUAL_RECAP_SKILL_SOURCE || 'auto' }}
|
|
485
503
|
runs-on: ${{ vars.VISUAL_RECAP_RUNS_ON || '"ubuntu-latest"' }}
|
|
486
504
|
gate-runs-on: ${{ vars.VISUAL_RECAP_GATE_RUNS_ON || 'ubuntu-latest' }}
|
|
487
|
-
# cli-version: "latest" # pin to a specific @agent-native/
|
|
505
|
+
# cli-version: "latest" # pin to a specific @agent-native/recap-cli version
|
|
488
506
|
```
|
|
489
507
|
|
|
490
508
|
Se aplican los mismos secretos y variables descritos en [Secrets and variables](#secrets-and-variables); configúrelos como en la variante de copia. El llamador reutilizable reenvía `VISUAL_RECAP_RUNS_ON` como `runs-on` para el trabajo completo y `VISUAL_RECAP_GATE_RUNS_ON` como la etiqueta simple `gate-runs-on` para la barrera. Ambos conservan `ubuntu-latest` cuando se omiten.
|
|
@@ -493,15 +511,15 @@ Se aplican los mismos secretos y variables descritos en [Secrets and variables](
|
|
|
493
511
|
|
|
494
512
|
```bash
|
|
495
513
|
# Escriba la persona que llama en lugar de la copia completa:
|
|
496
|
-
npx @agent-native/
|
|
514
|
+
npx @agent-native/recap-cli@latest recap setup --reusable
|
|
497
515
|
|
|
498
516
|
# O con una referencia fijada para mayor reproducibilidad:
|
|
499
|
-
npx @agent-native/
|
|
517
|
+
npx @agent-native/recap-cli@latest recap setup --reusable --ref v1.2.3
|
|
500
518
|
```
|
|
501
519
|
|
|
502
520
|
Ambas variantes escriben el flujo de trabajo en `.github/workflows/pr-visual-recap.yml`. Si ya existe un flujo de trabajo existente y es diferente, el comando lo rechaza y le indica que pase `--force` para sobrescribirlo.
|
|
503
521
|
|
|
504
|
-
Después de escribir, ejecute `npx @agent-native/
|
|
522
|
+
Después de escribir, ejecute `npx @agent-native/recap-cli@latest recap doctor` como de costumbre para confirmar que los secretos estén configurados.
|
|
505
523
|
|
|
506
524
|
### Fijar versión
|
|
507
525
|
|
|
@@ -511,7 +529,7 @@ De forma predeterminada, la persona que llama hace referencia a `@main`, que sie
|
|
|
511
529
|
uses: BuilderIO/agent-native/.github/workflows/pr-visual-recap-reusable.yml@v1.2.3
|
|
512
530
|
```
|
|
513
531
|
|
|
514
|
-
La entrada `cli-version` controla qué versión de `@agent-native/
|
|
532
|
+
La entrada `cli-version` controla qué versión de `@agent-native/recap-cli` CLI se ejecuta dentro del flujo de trabajo; déjela en `"latest"` para realizar un seguimiento de la versión más reciente o fíjela a una cadena de versión (por ejemplo, `"1.5.0"`) para una reproducibilidad total.
|
|
515
533
|
|
|
516
534
|
### contexto del evento workflow_call
|
|
517
535
|
|
|
@@ -212,6 +212,20 @@ Si el primer pase todavía tiene decisiones responsables, el agente puede coloca
|
|
|
212
212
|
Formulario **Preguntas abiertas** en la parte inferior del mismo plan. Responderlo y enviar
|
|
213
213
|
El agente inicia un turno de revisión contra el plan existente.
|
|
214
214
|
|
|
215
|
+
## Costo y elección de modelo
|
|
216
|
+
|
|
217
|
+
Generar un plan o un resumen ejecuta una sesión completa de agente frente al LLM
|
|
218
|
+
de su agente de codificación, no un simple relleno de plantilla ligero, por lo que
|
|
219
|
+
el costo escala con el tamaño del diff o del plan y con el modelo que elija.
|
|
220
|
+
|
|
221
|
+
- El modelo de chat predeterminado de la propia aplicación es Sonnet 5; cámbielo
|
|
222
|
+
en cualquier momento en **Configuración**. Haiku es la opción más económica de
|
|
223
|
+
Claude, y Luna es la opción más económica dentro de la familia GPT-5.6.
|
|
224
|
+
- Los resúmenes de PR automatizados de la GitHub Action se ejecutan por separado
|
|
225
|
+
de la aplicación interactiva y tienen sus propios controles de modelo y costo;
|
|
226
|
+
consulte [PR Visual Recap](/docs/pr-visual-recap) para `VISUAL_RECAP_MODEL`,
|
|
227
|
+
`VISUAL_RECAP_AGENT` y `VISUAL_RECAP_REASONING`.
|
|
228
|
+
|
|
215
229
|
## Qué puedes hacer con él
|
|
216
230
|
|
|
217
231
|
- **Revisión antes de la implementación.** React a diagramas, estructuras alámbricas, pestañas de opciones,
|