@agent-native/core 0.84.5 → 0.84.7

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