@agent-native/core 0.84.6 → 0.84.8

package/corpus/templates/design/app/pages/DesignEditor.tsx

@@ -1302,6 +1302,33 @@ function designIntakeQuestionDirectives(
   ];
 }
 
+function promptRequestsVariantExploration(prompt: string): boolean {
+  const normalized = prompt.toLowerCase();
+  const asksForVariants =
+    /\b(variant|variants|variation|variations|direction|directions|option|options|concept|concepts|exploration|explorations)\b/.test(
+      normalized,
+    );
+  if (!asksForVariants) return false;
+  return (
+    /\b(2|3|4|5|two|three|four|five|multiple|several|distinct|different|choose|compare|side[-\s]?by[-\s]?side)\b/.test(
+      normalized,
+    ) || /\bto choose from\b/.test(normalized)
+  );
+}
+
+function designVariantGenerationDirectives(
+  designId: string,
+  designSystemId?: string | null,
+): string[] {
+  return [
+    `Use the \`present-design-variants --designId="${designId}"\` action first. The design already exists - DO NOT call create-design.`,
+    ...designSystemGenerationDirectives(designSystemId),
+    "The user's prompt already asks to explore multiple directions, so DO NOT call `show-design-questions` first and DO NOT call `generate-design` first.",
+    "Call `present-design-variants` with 2-5 concise directions (3 when unspecified). Prefer label, description, accentColor, and feature bullets; omit large content HTML when needed because the action can render compact representative screens.",
+    "Wait for the user's chat pick, delete the unchosen variant screens, then continue from the kept screen.",
+  ];
+}
+
 function designGenerationDirectives(
   designId: string,
   designSystemId?: string | null,
@@ -1309,7 +1336,7 @@ function designGenerationDirectives(
   return [
     `Use the \`generate-design --designId="${designId}"\` action with exactly one complete, renderable \`index.html\` file first. The design already exists - DO NOT call create-design.`,
     ...designSystemGenerationDirectives(designSystemId),
-    "If the user asked to explore variations, call `present-design-variants` with 2-5 compact, complete HTML directions: one representative screen per direction, not a full app per variant. Wait for their chat pick, delete the unchosen variant screens, then continue from the kept screen. Otherwise generate one polished first direction.",
+    "If the user asked to explore variations, call `present-design-variants` with 2-5 concise directions. Prefer label, description, accentColor, and feature bullets; omit large content HTML when needed because the action can render compact representative screens. Wait for their chat pick, delete the unchosen variant screens, then continue from the kept screen. Otherwise generate one polished first direction.",
     "Keep the first pass bounded enough to finish quickly: one self-contained Alpine.js + Tailwind CDN HTML document, polished but concise. Add 3-6 tweaks only when they naturally fit the design.",
     "After generate-design succeeds, stop and summarize what was created.",
   ];
@@ -5955,7 +5982,9 @@ export default function DesignEditor() {
       return;
     }
 
-    const shouldSkipQuestions = pending.skipQuestions === true;
+    const shouldExploreVariants = promptRequestsVariantExploration(prompt);
+    const shouldSkipQuestions =
+      pending.skipQuestions === true || shouldExploreVariants;
     const context = [
       sourceContext,
       `Design id: "${id}"`,
@@ -5966,9 +5995,11 @@ export default function DesignEditor() {
         : "",
       fileContext,
       "",
-      ...(shouldSkipQuestions
-        ? designGenerationDirectives(id, pendingDesignSystemId)
-        : designIntakeQuestionDirectives(id, pendingDesignSystemId)),
+      ...(shouldExploreVariants
+        ? designVariantGenerationDirectives(id, pendingDesignSystemId)
+        : shouldSkipQuestions
+          ? designGenerationDirectives(id, pendingDesignSystemId)
+          : designIntakeQuestionDirectives(id, pendingDesignSystemId)),
     ].join("\n");
 
     clearGenerationCompleteTimer();
@@ -17082,13 +17113,20 @@ ${serializedHtml}
           persistPromptDesignSystem(designSystemId);
           const fileContext = formatUploadedFileContext(files);
           const images = imageAttachmentsFromUploadedFiles(files);
+          const shouldExploreVariants =
+            promptRequestsVariantExploration(prompt);
+          const shouldSkipQuestions = shouldExploreVariants;
           const context = [
             `The user has design "${id}" (title: "${design.title}") open and wants to fill it with design files.`,
             `User request: "${prompt}"`,
             designSystemId ? `Design system id: "${designSystemId}"` : "",
             fileContext,
             "",
-            ...designIntakeQuestionDirectives(id, designSystemId),
+            ...(shouldExploreVariants
+              ? designVariantGenerationDirectives(id, designSystemId)
+              : shouldSkipQuestions
+                ? designGenerationDirectives(id, designSystemId)
+                : designIntakeQuestionDirectives(id, designSystemId)),
           ].join("\n");
           clearGenerationCompleteTimer();
           setGenerationIssue(null);
@@ -17104,7 +17142,9 @@ ${serializedHtml}
           });
           setHasPendingGeneration(true);
           const runTabId = agentSubmit(
-            `Prepare design questions for "${design.title}": ${prompt}`,
+            shouldSkipQuestions
+              ? `Generate design for "${design.title}": ${prompt}`
+              : `Prepare design questions for "${design.title}": ${prompt}`,
             context,
             { ...options, newTab: true, images },
           );

package/corpus/templates/design/changelog/2026-07-01-design-prompts-that-ask-for-multiple-directions-now-start-generating-variants.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-01
+---
+
+Design prompts that already ask for multiple directions now start generating variants instead of stopping at intake questions.

package/corpus/templates/design/changelog/2026-07-01-design-variants-can-now-be-generated-from-compact-directions.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-01
+---
+
+Design variants can now be generated from compact directions, reducing long-running agent stalls.

package/dist/client/agent-chat-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-chat-adapter.d.ts","sourceRoot":"","sources":["../../src/client/agent-chat-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,qBAAqB,CAAC;AAMhF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAkBrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,MAAM,oBAAoB;AAC9B;;;;GAIG;AACD,KAAK;AACP,0EAA0E;GACxE,WAAW,CAAC;AA0oChB;;;;GAIG;AACH;;;GAGG;AACH,MAAM,WAAW,6BAA6B;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IAC3C,SAAS,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IAC5C,SAAS,CAAC,EAAE;QAAE,OAAO,EAAE,eAAe,GAAG,SAAS,CAAA;KAAE,CAAC;IACrD,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,CAAA;KAAE,CAAC;IAC3D,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED,wBAAgB,sBAAsB,CACpC,OAAO,CAAC,EAAE,6BAA6B,GACtC,gBAAgB,CAk7ClB"}
+{"version":3,"file":"agent-chat-adapter.d.ts","sourceRoot":"","sources":["../../src/client/agent-chat-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,qBAAqB,CAAC;AAMhF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAkBrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,MAAM,oBAAoB;AAC9B;;;;GAIG;AACD,KAAK;AACP,0EAA0E;GACxE,WAAW,CAAC;AAgqChB;;;;GAIG;AACH;;;GAGG;AACH,MAAM,WAAW,6BAA6B;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IAC3C,SAAS,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IAC5C,SAAS,CAAC,EAAE;QAAE,OAAO,EAAE,eAAe,GAAG,SAAS,CAAA;KAAE,CAAC;IACrD,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,CAAA;KAAE,CAAC;IAC3D,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED,wBAAgB,sBAAsB,CACpC,OAAO,CAAC,EAAE,6BAA6B,GACtC,gBAAgB,CAo+ClB"}

package/dist/client/agent-chat-adapter.js

@@ -41,6 +41,12 @@ const MAX_EMPTY_TRANSIENT_CONTINUATIONS = 3;
 // round re-sending any large pasted payload) before bailing. Catching the
 // repeat ends it in a few rounds with a clear, actionable message instead.
 const MAX_REPEATED_TRANSIENT_CONTINUATIONS = 3;
+// How many consecutive continuations that only reach the SAME "preparing
+// action" activity card we tolerate before giving up. This catches runs that
+// keep timing out while assembling a large tool payload: they are not empty,
+// and the narration may vary enough to bypass the text-repeat guard, but the
+// real tool never starts.
+const MAX_REPEATED_ACTION_PREPARATION_CONTINUATIONS = 3;
 const RETRY_BASE_DELAY_MS = 500;
 const RETRY_MAX_DELAY_MS = 8_000;
 const MAX_HISTORY_ATTACHMENT_CHARS = 60_000;
@@ -601,6 +607,17 @@ function lastActivityTool(trail) {
     }
     return undefined;
 }
+function lastUnresolvedToolActivity(content) {
+    for (let i = content.length - 1; i >= 0; i--) {
+        const part = content[i];
+        if (part.type === "tool-call" &&
+            part.activity === true &&
+            part.result === undefined) {
+            return part.toolName;
+        }
+    }
+    return undefined;
+}
 function snapshotContent(content) {
     return content.map((part) => part.type === "text" ? { ...part } : { ...part, args: { ...part.args } });
 }
@@ -688,7 +705,7 @@ function incrementalActionGuidance(tool) {
         case "update-design":
             return "persist a minimal first version (fewer files) with `generate-design`, then refine individual files with `edit-design` search/replace instead of resending everything";
         case "present-design-variants":
-            return "save compact but complete variant screens with `present-design-variants` first, keeping each HTML direction focused enough to finish, then refine the chosen direction with `generate-design` or `edit-design`";
+            return "call `present-design-variants` with concise labels, descriptions, accent colors, and feature bullets; omit large `content` HTML when needed so the action can render compact representative screens, then refine the chosen direction with `generate-design` or `edit-design`";
         case "create-visual-plan":
         case "create-ui-plan":
         case "create-plan-design":
@@ -1073,6 +1090,9 @@ export function createAgentChatAdapter(options) {
             let repeatedInFlightToolCount = 0;
             let recoveryGaveUpOnInFlightTool = false;
             const MAX_REPEATED_INFLIGHT_TOOL_STALLS = 3;
+            let lastPreparingToolName;
+            let repeatedActionPreparationCount = 0;
+            let recoveryGaveUpOnActionPreparation = false;
             const continuationHistoryFragments = [];
             const structuredContinuationFragments = [];
             let visibleContinuationPrefix = [];
@@ -1101,6 +1121,10 @@ export function createAgentChatAdapter(options) {
                     lastInFlightToolName
                         ? `last_inflight_tool: ${lastInFlightToolName}`
                         : "",
+                    `repeated_action_preparation_stalls: ${repeatedActionPreparationCount}`,
+                    lastPreparingToolName
+                        ? `last_preparing_tool: ${lastPreparingToolName}`
+                        : "",
                     `total_transient_continuations: ${totalTransientContinuationAttempts}`,
                     attemptedRunIds.length > 0
                         ? `attempted_runs: ${attemptedRunIds.join(", ")}`
@@ -1116,6 +1140,12 @@ export function createAgentChatAdapter(options) {
                 if (recoveryGaveUpOnRepetition) {
                     return "The agent got stuck repeating the same response without finishing, so I stopped the automatic retries. This often happens when it tries to re-type a large pasted file into one action — starting a new chat, or asking for a smaller first step, usually gets it unstuck.";
                 }
+                if (recoveryGaveUpOnActionPreparation) {
+                    const tool = lastPreparingToolName
+                        ? ` the ${humanizeActionName(lastPreparingToolName)} action`
+                        : " the same action";
+                    return `The agent got stuck preparing${tool} input and never started the tool, so I stopped the automatic retries. Try a smaller first step or a more compact version of the request.`;
+                }
                 if (content.length === 0 &&
                     (reason === "run_timeout" ||
                         reason === "no_progress" ||
@@ -1180,6 +1210,8 @@ export function createAgentChatAdapter(options) {
                         repeatedTransientContinuationAttempts,
                         repeatedInFlightToolCount,
                         lastInFlightToolName,
+                        repeatedActionPreparationCount,
+                        lastPreparingToolName,
                         totalTransientContinuationAttempts,
                         ...extra,
                     },
@@ -1197,6 +1229,8 @@ export function createAgentChatAdapter(options) {
                             repeatedTransientContinuationAttempts,
                             repeatedInFlightToolCount,
                             lastInFlightToolName,
+                            repeatedActionPreparationCount,
+                            lastPreparingToolName,
                             totalTransientContinuationAttempts,
                         },
                     },
@@ -1438,7 +1472,10 @@ export function createAgentChatAdapter(options) {
                     // Either real output or an actively-running tool counts as progress
                     // for the stalled/empty caps.
                     const madeProgress = madeContentProgress || hasInFlightTool;
-                    const madeDurableToolProgress = visibleContent.some((part) => part.type === "tool-call" && part.result !== undefined);
+                    const madeDurableToolProgress = visibleContent.some((part) => part.type === "tool-call" &&
+                        part.activity !== true &&
+                        part.result !== undefined);
+                    const currentPreparingToolName = lastUnresolvedToolActivity(visibleContent);
                     // In-flight tool stall guard. When the same write tool is stuck
                     // in-flight because the connection keeps dropping (stream_ended),
                     // hasInFlightTool=true keeps madeProgress=true and completely
@@ -1477,6 +1514,25 @@ export function createAgentChatAdapter(options) {
                     else if (!currentInFlightToolName) {
                         repeatedInFlightToolCount = 0;
                     }
+                    const isRepeatedActionPreparationCandidate = signal.reason !== "loop_limit" &&
+                        currentPreparingToolName !== undefined &&
+                        !hasInFlightTool &&
+                        !madeDurableToolProgress;
+                    if (isRepeatedActionPreparationCandidate) {
+                        if (currentPreparingToolName === lastPreparingToolName) {
+                            repeatedActionPreparationCount += 1;
+                        }
+                        else {
+                            repeatedActionPreparationCount = 0;
+                            lastPreparingToolName = currentPreparingToolName;
+                        }
+                    }
+                    else if (!currentPreparingToolName ||
+                        hasInFlightTool ||
+                        madeDurableToolProgress) {
+                        repeatedActionPreparationCount = 0;
+                        lastPreparingToolName = undefined;
+                    }
                     // Degenerate repetition guard. When the model gets stuck re-streaming
                     // the SAME narration every continuation without ever starting or
                     // finishing a tool, each round is "new" text — so madeProgress stays
@@ -1520,6 +1576,11 @@ export function createAgentChatAdapter(options) {
                             recoveryGaveUpOnInFlightTool = true;
                             return { ok: false, resetVisibleContent: false };
                         }
+                        if (repeatedActionPreparationCount >
+                            MAX_REPEATED_ACTION_PREPARATION_CONTINUATIONS) {
+                            recoveryGaveUpOnActionPreparation = true;
+                            return { ok: false, resetVisibleContent: false };
+                        }
                         // Bail fast on a non-advancing repetition loop, well before the
                         // stalled/empty/total budgets would (each round otherwise re-sends
                         // the whole pasted payload). Tracked separately so it never trips