@agent-native/core 0.105.0 → 0.106.1

package/corpus/templates/design/app/components/visual-editor/index.ts

@@ -1,4 +1,8 @@
 export { SaveStatusIndicator } from "./SaveStatusIndicator";
 export { DrawOverlay, type DrawAnnotation } from "./DrawOverlay";
 export { CanvasCommentPins, type CanvasPin } from "./CanvasCommentPins";
-export { ReviewCanvasPins, type ReviewFocusRequest } from "./ReviewCanvasPins";
+export {
+  ReviewCanvasPins,
+  type RepromptDraftRequest,
+  type ReviewFocusRequest,
+} from "./ReviewCanvasPins";

package/corpus/templates/design/app/components/visual-editor/review-canvas-state.ts

@@ -1,8 +1,26 @@
-import type {
-  DesignReviewAnchor,
-  ReviewAnchorPoint,
+import {
+  parseReviewAnchor,
+  type DesignReviewAnchor,
+  type ReviewAnchorPoint,
 } from "../../../shared/review-anchor";
 
+export interface ReviewPinPosition {
+  point: ReviewAnchorPoint;
+  source: "node" | "selector" | "point";
+}
+
+// Layer identity enriches the comment; the point remains user-authored.
+export function getReviewPinPosition(
+  anchor: unknown,
+): ReviewPinPosition | null {
+  const parsed = parseReviewAnchor(anchor);
+  if (!parsed) return null;
+  return {
+    point: parsed.point,
+    source: parsed.nodeId ? "node" : parsed.selector ? "selector" : "point",
+  };
+}
+
 export interface ReviewDraftPin {
   id: string;
   anchor: DesignReviewAnchor;

package/corpus/templates/design/app/i18n/ar-SA.ts

@@ -2,6 +2,41 @@ import { messagesByLocale } from "../i18n-data";
 
 const messages = {
   ...messagesByLocale["ar-SA"],
+  designEditor: {
+    ...messagesByLocale["ar-SA"].designEditor,
+    nodeRewrite: {
+      composerTitle: "اسأل عن التحديد أو غيّره",
+      send: "إرسال",
+      autoHint: "صِف تغييرًا أو اطرح سؤالًا",
+      willPreview: "سيعرض التغييرات لموافقتك",
+      willAsk: "سيسأل الوكيل دون تغيير التصميم",
+      modeAuto: "تلقائي",
+      modePreview: "معاينة التغيير",
+      modeAsk: "اسأل الوكيل",
+      modeRegenerate: "إعادة الإنشاء",
+      agentModeOptions: "اختيار سلوك الوكيل",
+      pendingReview: "مراجعة التغييرات · {{count}}",
+      pendingReviewMenu: "تغييرات جاهزة للمراجعة",
+      reviewCandidate: "مراجعة التغيير",
+      regenerate: "إعادة الإنشاء…",
+      sending: "جارٍ إعادة الإنشاء…",
+      sent: "تم إرسال طلب إعادة الإنشاء",
+      sendFailed: "تعذّر إرسال طلب إعادة الإنشاء",
+      previewTitle: "التحديد المعاد إنشاؤه",
+      variants: "بدائل إعادة الإنشاء",
+      variantNumber: "البديل {{count}}: {{summary}}",
+      candidatePosition: "{{current}} من {{total}}",
+      previousCandidate: "النتيجة السابقة",
+      nextCandidate: "النتيجة التالية",
+      refinePlaceholder: "حسّن هذه النتيجة…",
+      refine: "تحسين النتيجة",
+      refinementSent: "تم إرسال التحسين",
+      refinementFailed: "تعذّر إرسال التحسين",
+      accept: "قبول",
+      reject: "رفض",
+      resolveFailed: "تعذّر حسم هذا الاقتراح",
+    },
+  },
   review: {
     comments: "التعليقات",
     commentsTab: "التعليقات · {{count}}",

package/corpus/templates/design/app/i18n/de-DE.ts

@@ -2,6 +2,41 @@ import { messagesByLocale } from "../i18n-data";
 
 const messages = {
   ...messagesByLocale["de-DE"],
+  designEditor: {
+    ...messagesByLocale["de-DE"].designEditor,
+    nodeRewrite: {
+      composerTitle: "Auswahl fragen oder ändern",
+      send: "Senden",
+      autoHint: "Beschreibe eine Änderung oder stelle eine Frage",
+      willPreview: "Zeigt Änderungen zur Freigabe als Vorschau",
+      willAsk: "Fragt den Agenten, ohne das Design zu ändern",
+      modeAuto: "Automatisch",
+      modePreview: "Änderungsvorschau",
+      modeAsk: "Agenten fragen",
+      modeRegenerate: "Neu generieren",
+      agentModeOptions: "Agentenverhalten auswählen",
+      pendingReview: "Änderungen prüfen · {{count}}",
+      pendingReviewMenu: "Änderungen zur Prüfung bereit",
+      reviewCandidate: "Änderung prüfen",
+      regenerate: "Neu generieren…",
+      sending: "Wird neu generiert…",
+      sent: "Anfrage zur Neugenerierung gesendet",
+      sendFailed: "Anfrage zur Neugenerierung konnte nicht gesendet werden",
+      previewTitle: "Neu generierte Auswahl",
+      variants: "Varianten der Neugenerierung",
+      variantNumber: "Variante {{count}}: {{summary}}",
+      candidatePosition: "{{current}} von {{total}}",
+      previousCandidate: "Vorheriges Ergebnis",
+      nextCandidate: "Nächstes Ergebnis",
+      refinePlaceholder: "Dieses Ergebnis verfeinern…",
+      refine: "Ergebnis verfeinern",
+      refinementSent: "Verfeinerung gesendet",
+      refinementFailed: "Verfeinerung konnte nicht gesendet werden",
+      accept: "Übernehmen",
+      reject: "Verwerfen",
+      resolveFailed: "Dieser Vorschlag konnte nicht aufgelöst werden",
+    },
+  },
   review: {
     comments: "Kommentare",
     commentsTab: "Kommentare · {{count}}",

package/corpus/templates/design/app/i18n/es-ES.ts

@@ -2,6 +2,41 @@ import { messagesByLocale } from "../i18n-data";
 
 const messages = {
   ...messagesByLocale["es-ES"],
+  designEditor: {
+    ...messagesByLocale["es-ES"].designEditor,
+    nodeRewrite: {
+      composerTitle: "Pregunta o cambia la selección",
+      send: "Enviar",
+      autoHint: "Describe un cambio o haz una pregunta",
+      willPreview: "Mostrará una vista previa para que la apruebes",
+      willAsk: "Preguntará al agente sin cambiar el diseño",
+      modeAuto: "Automático",
+      modePreview: "Vista previa del cambio",
+      modeAsk: "Preguntar al agente",
+      modeRegenerate: "Regenerar",
+      agentModeOptions: "Elegir el comportamiento del agente",
+      pendingReview: "Revisar cambios · {{count}}",
+      pendingReviewMenu: "Cambios listos para revisar",
+      reviewCandidate: "Revisar cambio",
+      regenerate: "Regenerar…",
+      sending: "Regenerando…",
+      sent: "Solicitud de regeneración enviada",
+      sendFailed: "No se pudo enviar la solicitud de regeneración",
+      previewTitle: "Selección regenerada",
+      variants: "Variantes regeneradas",
+      variantNumber: "Variante {{count}}: {{summary}}",
+      candidatePosition: "{{current}} de {{total}}",
+      previousCandidate: "Resultado anterior",
+      nextCandidate: "Resultado siguiente",
+      refinePlaceholder: "Refinar este resultado…",
+      refine: "Refinar resultado",
+      refinementSent: "Refinamiento enviado",
+      refinementFailed: "No se pudo enviar el refinamiento",
+      accept: "Aceptar",
+      reject: "Rechazar",
+      resolveFailed: "No se pudo resolver esta propuesta",
+    },
+  },
   review: {
     comments: "Comentarios",
     commentsTab: "Comentarios · {{count}}",

package/corpus/templates/design/app/i18n/fr-FR.ts

@@ -2,6 +2,41 @@ import { messagesByLocale } from "../i18n-data";
 
 const messages = {
   ...messagesByLocale["fr-FR"],
+  designEditor: {
+    ...messagesByLocale["fr-FR"].designEditor,
+    nodeRewrite: {
+      composerTitle: "Questionner ou modifier la sélection",
+      send: "Envoyer",
+      autoHint: "Décrivez un changement ou posez une question",
+      willPreview: "Affichera un aperçu à valider",
+      willAsk: "Interrogera l’agent sans modifier le design",
+      modeAuto: "Auto",
+      modePreview: "Aperçu du changement",
+      modeAsk: "Interroger l’agent",
+      modeRegenerate: "Régénérer",
+      agentModeOptions: "Choisir le comportement de l’agent",
+      pendingReview: "Vérifier les changements · {{count}}",
+      pendingReviewMenu: "Changements prêts à vérifier",
+      reviewCandidate: "Vérifier le changement",
+      regenerate: "Régénérer…",
+      sending: "Régénération…",
+      sent: "Demande de régénération envoyée",
+      sendFailed: "Impossible d’envoyer la demande de régénération",
+      previewTitle: "Sélection régénérée",
+      variants: "Variantes régénérées",
+      variantNumber: "Variante {{count}} : {{summary}}",
+      candidatePosition: "{{current}} sur {{total}}",
+      previousCandidate: "Résultat précédent",
+      nextCandidate: "Résultat suivant",
+      refinePlaceholder: "Affiner ce résultat…",
+      refine: "Affiner le résultat",
+      refinementSent: "Affinement envoyé",
+      refinementFailed: "Impossible d’envoyer l’affinement",
+      accept: "Accepter",
+      reject: "Rejeter",
+      resolveFailed: "Impossible de résoudre cette proposition",
+    },
+  },
   review: {
     comments: "Commentaires",
     commentsTab: "Commentaires · {{count}}",

package/corpus/templates/design/app/i18n/hi-IN.ts

@@ -2,6 +2,41 @@ import { messagesByLocale } from "../i18n-data";
 
 const messages = {
   ...messagesByLocale["hi-IN"],
+  designEditor: {
+    ...messagesByLocale["hi-IN"].designEditor,
+    nodeRewrite: {
+      composerTitle: "चयन के बारे में पूछें या बदलें",
+      send: "भेजें",
+      autoHint: "कोई बदलाव बताएँ या सवाल पूछें",
+      willPreview: "आपकी मंज़ूरी के लिए बदलावों का पूर्वावलोकन दिखाएगा",
+      willAsk: "डिज़ाइन बदले बिना एजेंट से पूछेगा",
+      modeAuto: "अपने आप",
+      modePreview: "बदलाव का पूर्वावलोकन",
+      modeAsk: "एजेंट से पूछें",
+      modeRegenerate: "फिर से बनाएँ",
+      agentModeOptions: "एजेंट का व्यवहार चुनें",
+      pendingReview: "बदलाव देखें · {{count}}",
+      pendingReviewMenu: "देखने के लिए तैयार बदलाव",
+      reviewCandidate: "बदलाव देखें",
+      regenerate: "फिर से बनाएँ…",
+      sending: "फिर से बनाया जा रहा है…",
+      sent: "पुनर्निर्माण अनुरोध भेजा गया",
+      sendFailed: "पुनर्निर्माण अनुरोध नहीं भेजा जा सका",
+      previewTitle: "फिर से बनाया गया चयन",
+      variants: "पुनर्निर्माण विकल्प",
+      variantNumber: "विकल्प {{count}}: {{summary}}",
+      candidatePosition: "{{total}} में से {{current}}",
+      previousCandidate: "पिछला परिणाम",
+      nextCandidate: "अगला परिणाम",
+      refinePlaceholder: "इस परिणाम को सुधारें…",
+      refine: "परिणाम सुधारें",
+      refinementSent: "सुधार भेजा गया",
+      refinementFailed: "सुधार नहीं भेजा जा सका",
+      accept: "स्वीकार करें",
+      reject: "अस्वीकार करें",
+      resolveFailed: "इस प्रस्ताव को पूरा नहीं किया जा सका",
+    },
+  },
   review: {
     comments: "टिप्पणियाँ",
     commentsTab: "टिप्पणियाँ · {{count}}",

package/corpus/templates/design/app/i18n/ja-JP.ts

@@ -2,6 +2,41 @@ import { messagesByLocale } from "../i18n-data";
 
 const messages = {
   ...messagesByLocale["ja-JP"],
+  designEditor: {
+    ...messagesByLocale["ja-JP"].designEditor,
+    nodeRewrite: {
+      composerTitle: "選択範囲について質問または変更",
+      send: "送信",
+      autoHint: "変更内容を入力するか質問してください",
+      willPreview: "承認前に変更をプレビューします",
+      willAsk: "デザインを変更せずにエージェントへ質問します",
+      modeAuto: "自動",
+      modePreview: "変更をプレビュー",
+      modeAsk: "エージェントに質問",
+      modeRegenerate: "再生成",
+      agentModeOptions: "エージェントの動作を選択",
+      pendingReview: "変更を確認 · {{count}}",
+      pendingReviewMenu: "確認待ちの変更",
+      reviewCandidate: "変更を確認",
+      regenerate: "再生成…",
+      sending: "再生成中…",
+      sent: "再生成リクエストを送信しました",
+      sendFailed: "再生成リクエストを送信できませんでした",
+      previewTitle: "再生成された選択範囲",
+      variants: "再生成バリエーション",
+      variantNumber: "バリエーション {{count}}: {{summary}}",
+      candidatePosition: "{{total}}件中{{current}}件目",
+      previousCandidate: "前の結果",
+      nextCandidate: "次の結果",
+      refinePlaceholder: "この結果を調整…",
+      refine: "結果を調整",
+      refinementSent: "調整内容を送信しました",
+      refinementFailed: "調整内容を送信できませんでした",
+      accept: "承認",
+      reject: "却下",
+      resolveFailed: "この提案を解決できませんでした",
+    },
+  },
   review: {
     comments: "コメント",
     commentsTab: "コメント · {{count}}",

package/corpus/templates/design/app/i18n/ko-KR.ts

@@ -2,6 +2,41 @@ import { messagesByLocale } from "../i18n-data";
 
 const messages = {
   ...messagesByLocale["ko-KR"],
+  designEditor: {
+    ...messagesByLocale["ko-KR"].designEditor,
+    nodeRewrite: {
+      composerTitle: "선택 영역 질문 또는 변경",
+      send: "보내기",
+      autoHint: "변경 사항을 설명하거나 질문하세요",
+      willPreview: "승인 전에 변경 사항을 미리 보여줍니다",
+      willAsk: "디자인을 변경하지 않고 에이전트에게 질문합니다",
+      modeAuto: "자동",
+      modePreview: "변경 미리보기",
+      modeAsk: "에이전트에게 질문",
+      modeRegenerate: "다시 생성",
+      agentModeOptions: "에이전트 동작 선택",
+      pendingReview: "변경 검토 · {{count}}",
+      pendingReviewMenu: "검토할 변경 사항",
+      reviewCandidate: "변경 검토",
+      regenerate: "다시 생성…",
+      sending: "다시 생성 중…",
+      sent: "재생성 요청을 보냈습니다",
+      sendFailed: "재생성 요청을 보내지 못했습니다",
+      previewTitle: "다시 생성된 선택 영역",
+      variants: "재생성 변형",
+      variantNumber: "변형 {{count}}: {{summary}}",
+      candidatePosition: "{{total}}개 중 {{current}}개",
+      previousCandidate: "이전 결과",
+      nextCandidate: "다음 결과",
+      refinePlaceholder: "이 결과 다듬기…",
+      refine: "결과 다듬기",
+      refinementSent: "수정 요청을 보냈습니다",
+      refinementFailed: "수정 요청을 보내지 못했습니다",
+      accept: "적용",
+      reject: "거부",
+      resolveFailed: "이 제안을 처리하지 못했습니다",
+    },
+  },
   review: {
     comments: "댓글",
     commentsTab: "댓글 · {{count}}",

package/corpus/templates/design/app/i18n/pt-BR.ts

@@ -2,6 +2,41 @@ import { messagesByLocale } from "../i18n-data";
 
 const messages = {
   ...messagesByLocale["pt-BR"],
+  designEditor: {
+    ...messagesByLocale["pt-BR"].designEditor,
+    nodeRewrite: {
+      composerTitle: "Pergunte ou altere a seleção",
+      send: "Enviar",
+      autoHint: "Descreva uma alteração ou faça uma pergunta",
+      willPreview: "Mostrará as alterações para sua aprovação",
+      willAsk: "Perguntará ao agente sem alterar o design",
+      modeAuto: "Automático",
+      modePreview: "Prévia da alteração",
+      modeAsk: "Perguntar ao agente",
+      modeRegenerate: "Regenerar",
+      agentModeOptions: "Escolher o comportamento do agente",
+      pendingReview: "Revisar alterações · {{count}}",
+      pendingReviewMenu: "Alterações prontas para revisão",
+      reviewCandidate: "Revisar alteração",
+      regenerate: "Regenerar…",
+      sending: "Regenerando…",
+      sent: "Solicitação de regeneração enviada",
+      sendFailed: "Não foi possível enviar a solicitação de regeneração",
+      previewTitle: "Seleção regenerada",
+      variants: "Variações regeneradas",
+      variantNumber: "Variação {{count}}: {{summary}}",
+      candidatePosition: "{{current}} de {{total}}",
+      previousCandidate: "Resultado anterior",
+      nextCandidate: "Próximo resultado",
+      refinePlaceholder: "Refinar este resultado…",
+      refine: "Refinar resultado",
+      refinementSent: "Refinamento enviado",
+      refinementFailed: "Não foi possível enviar o refinamento",
+      accept: "Aceitar",
+      reject: "Rejeitar",
+      resolveFailed: "Não foi possível resolver esta proposta",
+    },
+  },
   review: {
     comments: "Comentários",
     commentsTab: "Comentários · {{count}}",

package/corpus/templates/design/app/i18n/zh-CN.ts

@@ -2,6 +2,41 @@ import { messagesByLocale } from "../i18n-data";
 
 const messages = {
   ...messagesByLocale["zh-CN"],
+  designEditor: {
+    ...messagesByLocale["zh-CN"].designEditor,
+    nodeRewrite: {
+      composerTitle: "询问或更改所选内容",
+      send: "发送",
+      autoHint: "描述更改或提出问题",
+      willPreview: "将显示更改预览供你确认",
+      willAsk: "将在不更改设计的情况下询问智能体",
+      modeAuto: "自动",
+      modePreview: "预览更改",
+      modeAsk: "询问智能体",
+      modeRegenerate: "重新生成",
+      agentModeOptions: "选择智能体行为",
+      pendingReview: "查看更改 · {{count}}",
+      pendingReviewMenu: "待查看的更改",
+      reviewCandidate: "查看更改",
+      regenerate: "重新生成…",
+      sending: "正在重新生成…",
+      sent: "已发送重新生成请求",
+      sendFailed: "无法发送重新生成请求",
+      previewTitle: "已重新生成所选内容",
+      variants: "重新生成方案",
+      variantNumber: "方案 {{count}}：{{summary}}",
+      candidatePosition: "第 {{current}} 个，共 {{total}} 个",
+      previousCandidate: "上一个结果",
+      nextCandidate: "下一个结果",
+      refinePlaceholder: "继续调整此结果…",
+      refine: "调整结果",
+      refinementSent: "已发送调整请求",
+      refinementFailed: "无法发送调整请求",
+      accept: "接受",
+      reject: "拒绝",
+      resolveFailed: "无法处理此提案",
+    },
+  },
   review: {
     comments: "评论",
     commentsTab: "评论 · {{count}}",

package/corpus/templates/design/app/i18n/zh-TW.ts

@@ -426,6 +426,38 @@ const messages = {
   designEditor: {
     ...designTemplateFeatureOverrides["zh-TW"].designEditor,
     askAgent: "詢問代理",
+    nodeRewrite: {
+      composerTitle: "詢問或變更所選內容",
+      send: "傳送",
+      autoHint: "描述變更或提出問題",
+      willPreview: "將顯示變更預覽供你確認",
+      willAsk: "將在不變更設計的情況下詢問代理",
+      modeAuto: "自動",
+      modePreview: "預覽變更",
+      modeAsk: "詢問代理",
+      modeRegenerate: "重新生成",
+      agentModeOptions: "選擇代理行為",
+      pendingReview: "檢視變更 · {{count}}",
+      pendingReviewMenu: "待檢視的變更",
+      reviewCandidate: "檢視變更",
+      regenerate: "重新生成…",
+      sending: "正在重新生成…",
+      sent: "已傳送重新生成要求",
+      sendFailed: "無法傳送重新生成要求",
+      previewTitle: "已重新生成所選內容",
+      variants: "重新生成方案",
+      variantNumber: "方案 {{count}}：{{summary}}",
+      candidatePosition: "第 {{current}} 個，共 {{total}} 個",
+      previousCandidate: "上一個結果",
+      nextCandidate: "下一個結果",
+      refinePlaceholder: "繼續調整此結果…",
+      refine: "調整結果",
+      refinementSent: "已傳送調整要求",
+      refinementFailed: "無法傳送調整要求",
+      accept: "接受",
+      reject: "拒絕",
+      resolveFailed: "無法處理此提案",
+    },
     autoLayoutSuggestion: {
       menuLabel: "建議自動版面配置…",
       title: "建議自動版面配置",

package/corpus/templates/design/app/i18n-data.ts

@@ -928,6 +928,38 @@ const enUS = {
       stay: "Stay here",
       leave: "Leave without applying",
     },
+    nodeRewrite: {
+      composerTitle: "Ask or change selection",
+      send: "Send",
+      autoHint: "Describe a change or ask a question",
+      willPreview: "Will preview changes for your approval",
+      willAsk: "Will ask the agent without changing the design",
+      modeAuto: "Auto",
+      modePreview: "Preview change",
+      modeAsk: "Ask agent",
+      modeRegenerate: "Regenerate",
+      agentModeOptions: "Choose agent behavior",
+      pendingReview: "Review changes · {{count}}",
+      pendingReviewMenu: "Changes ready to review",
+      reviewCandidate: "Review change",
+      regenerate: "Regenerate…",
+      sending: "Regenerating…",
+      sent: "Regeneration request sent",
+      sendFailed: "Could not send the regeneration request",
+      previewTitle: "Regenerated selection",
+      variants: "Regeneration variants",
+      variantNumber: "Variant {{count}}: {{summary}}",
+      candidatePosition: "{{current}} of {{total}}",
+      previousCandidate: "Previous candidate",
+      nextCandidate: "Next candidate",
+      refinePlaceholder: "Refine this result…",
+      refine: "Refine result",
+      refinementSent: "Refinement sent",
+      refinementFailed: "Could not send the refinement",
+      accept: "Accept",
+      reject: "Reject",
+      resolveFailed: "Could not resolve this proposal",
+    },
     capabilities: {
       "deterministic-style-edit": "Safe style edit",
       "deterministic-class-edit": "Safe class edit",

package/corpus/templates/design/app/lib/node-reprompt.ts

@@ -0,0 +1,110 @@
+import type { NodeRewriteTarget } from "@shared/node-rewrite";
+
+const MAX_SUBTREE_EXCERPT_LENGTH = 4_000;
+
+export const NODE_REPROMPT_RESOLVED_EVENT = "design:node-reprompt-resolved";
+export const NODE_REPROMPT_PRESENTED_EVENT = "design:node-reprompt-presented";
+
+export type NodeRepromptSendMode = "preview" | "ask";
+
+const QUESTION_OPENING =
+  /^(?:what|why|how|which|where|when|who|should|would|could|can|do|does|is|are)\b/i;
+const QUESTION_INTENT =
+  /\b(?:explain|review|critique|feedback|thoughts|opinion|recommend|suggest(?:ion)?s?|ideas?|compare)\b/i;
+const EDIT_INTENT =
+  /\b(?:make|change|replace|add|remove|delete|use|set|turn|update|rewrite|reword|shorten|lengthen|move|resize|align|center|increase|decrease|darken|lighten|tighten|loosen|swap|convert|style|restyle|redesign|improve|fix|create|generate|show)\b/i;
+const POLITE_EDIT_INTENT =
+  /^(?:please\s+)?(?:can|could|would)\s+you\s+(?:please\s+)?(?:make|change|replace|add|remove|delete|use|set|turn|update|rewrite|reword|shorten|lengthen|move|resize|align|center|increase|decrease|darken|lighten|tighten|loosen|swap|convert|style|restyle|redesign|improve|fix|create|generate|show)\b/i;
+
+export function inferNodeRepromptSendMode(
+  instruction: string,
+  options: { hasEditableTarget: boolean },
+): NodeRepromptSendMode {
+  const value = instruction.trim();
+  if (!value || !options.hasEditableTarget) return "ask";
+  if (POLITE_EDIT_INTENT.test(value)) return "preview";
+  if (QUESTION_OPENING.test(value) || value.endsWith("?")) return "ask";
+  if (QUESTION_INTENT.test(value) && !EDIT_INTENT.test(value)) return "ask";
+  if (EDIT_INTENT.test(value) || /\bgive\s+(?:this|it)\b/i.test(value)) {
+    return "preview";
+  }
+  return "ask";
+}
+
+function targetLabel(target: NodeRewriteTarget): string {
+  return target.nodeId ?? target.selector ?? "unknown";
+}
+
+export function nodeRepromptSubtreeExcerpt(html?: string | null): string {
+  const value = html?.trim() ?? "";
+  if (value.length <= MAX_SUBTREE_EXCERPT_LENGTH) return value;
+  return `${value.slice(0, MAX_SUBTREE_EXCERPT_LENGTH)}\n<!-- excerpt truncated -->`;
+}
+
+interface NodeRepromptSubmissionArgs {
+  repromptId: string;
+  designId: string;
+  fileId: string;
+  target: NodeRewriteTarget;
+  baseVersionHash: string;
+  instruction: string;
+  subtreeHtml?: string | null;
+  priorProposalId?: string;
+}
+
+type NodeSelectionQuestionArgs = Omit<
+  NodeRepromptSubmissionArgs,
+  "repromptId" | "baseVersionHash" | "priorProposalId"
+>;
+
+function formatNodeRepromptContext(args: NodeRepromptSubmissionArgs): string {
+  return [
+    "[Reprompt selection]",
+    `repromptId: ${args.repromptId}`,
+    `designId: ${args.designId}`,
+    `fileId: ${args.fileId}`,
+    `baseVersionHash: ${args.baseVersionHash}`,
+    `target: ${targetLabel(args.target)}`,
+    args.target.nodeId ? `targetNodeId: ${args.target.nodeId}` : "",
+    args.target.selector ? `targetSelector: ${args.target.selector}` : "",
+    args.priorProposalId ? `priorProposalId: ${args.priorProposalId}` : "",
+    "--- selected subtree (outerHTML excerpt, truncated) ---",
+    nodeRepromptSubtreeExcerpt(args.subtreeHtml),
+    "--- instruction ---",
+    args.instruction.trim(),
+  ]
+    .filter(Boolean)
+    .join("\n");
+}
+
+export function formatNodeRepromptSubmission(
+  args: NodeRepromptSubmissionArgs,
+): { message: string; context: string } {
+  return {
+    message: args.instruction.trim(),
+    context: formatNodeRepromptContext(args),
+  };
+}
+
+export function formatNodeSelectionQuestion(args: NodeSelectionQuestionArgs): {
+  message: string;
+  context: string;
+} {
+  return {
+    message: args.instruction.trim(),
+    context: [
+      "[Selection question]",
+      `designId: ${args.designId}`,
+      `fileId: ${args.fileId}`,
+      `target: ${targetLabel(args.target)}`,
+      args.target.nodeId ? `targetNodeId: ${args.target.nodeId}` : "",
+      args.target.selector ? `targetSelector: ${args.target.selector}` : "",
+      "--- selected subtree (outerHTML excerpt, truncated) ---",
+      nodeRepromptSubtreeExcerpt(args.subtreeHtml),
+      "--- question ---",
+      args.instruction.trim(),
+    ]
+      .filter(Boolean)
+      .join("\n"),
+  };
+}

package/corpus/templates/design/changelog/2026-07-16-design-editing-and-review-are-now-more-predictable.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-16
+---
+
+Design editing and review are now more predictable, with selection-based regeneration, clearer candidate approval, accurate layer comments, smarter agent prompts, and cleaner template behavior.