@algolia/wizard 0.103.0-rc.226.759 → 0.104.0

package/dist/main.js

@@ -1616,6 +1616,10 @@ async function clearWorkflowState(workflowId) {
 }
 
 // src/lib/modelProfiles.ts
+var MODEL_CAPABILITIES = {
+  "claude-haiku-5-5": { forcedToolUse: true, lowestThinking: "disabled" },
+  "claude-sonnet-5-5": { forcedToolUse: false, lowestThinking: "between_tools" }
+};
 var TOKENS_PER_MILLION = 1e6;
 var INITIAL_MODEL_ATTEMPT = 1;
 var NO_TOKENS = 0;
@@ -1627,57 +1631,57 @@ var IMPLEMENTATION_MAX_OUTPUT_TOKENS = 65536;
 var IMPLEMENTATION_MAX_STEPS = 48;
 var VALIDATION_MAX_OUTPUT_TOKENS = 8192;
 var VALIDATION_MAX_STEPS = 24;
-var HAIKU_4_5_PRICES = {
-  input: 1,
-  output: 5,
-  cacheRead: 0.1,
-  cacheWrite: 1.25
+var HAIKU_5_5_PRICES = {
+  input: 0.1,
+  output: 0.5,
+  cacheRead: 0.01,
+  cacheWrite: 0.125
 };
-var SONNET_5_PRICES = {
+var SONNET_5_5_PRICES = {
   input: 2,
   output: 10,
-  cacheRead: 0.2,
+  cacheRead: 0.1,
   cacheWrite: 2.5
 };
 var MODEL_PROFILES = {
   quick: {
-    model: "claude-haiku-4-5",
+    model: "claude-haiku-5-5",
     thinking: "disabled",
     maxOutputTokens: QUICK_MAX_OUTPUT_TOKENS,
     maxSteps: QUICK_MAX_STEPS,
-    prices: HAIKU_4_5_PRICES
+    prices: HAIKU_5_5_PRICES
   },
   analysis: {
-    model: "claude-sonnet-5",
+    model: "claude-sonnet-5-5",
     thinking: "adaptive",
     effort: "low",
     maxOutputTokens: ANALYSIS_MAX_OUTPUT_TOKENS,
     maxSteps: ANALYSIS_MAX_STEPS,
-    prices: SONNET_5_PRICES
+    prices: SONNET_5_5_PRICES
   },
   implementation: {
-    model: "claude-sonnet-5",
+    model: "claude-sonnet-5-5",
     thinking: "adaptive",
     effort: "medium",
     maxOutputTokens: IMPLEMENTATION_MAX_OUTPUT_TOKENS,
     maxSteps: IMPLEMENTATION_MAX_STEPS,
-    prices: SONNET_5_PRICES
+    prices: SONNET_5_5_PRICES
   },
   implementationRetry: {
-    model: "claude-sonnet-5",
+    model: "claude-sonnet-5-5",
     thinking: "adaptive",
     effort: "high",
     maxOutputTokens: IMPLEMENTATION_MAX_OUTPUT_TOKENS,
     maxSteps: IMPLEMENTATION_MAX_STEPS,
-    prices: SONNET_5_PRICES
+    prices: SONNET_5_5_PRICES
   },
   validation: {
-    model: "claude-sonnet-5",
+    model: "claude-sonnet-5-5",
     thinking: "adaptive",
     effort: "low",
     maxOutputTokens: VALIDATION_MAX_OUTPUT_TOKENS,
     maxSteps: VALIDATION_MAX_STEPS,
-    prices: SONNET_5_PRICES
+    prices: SONNET_5_5_PRICES
   }
 };
 function getModelProfile(profileName) {
@@ -1690,6 +1694,14 @@ function providerOptionsForProfile(profileName) {
     ...profile.effort !== void 0 && { effort: profile.effort }
   };
 }
+function toolChoiceForProfile(profileName) {
+  const { model } = getModelProfile(profileName);
+  return MODEL_CAPABILITIES[model].forcedToolUse ? "required" : "auto";
+}
+function lowestThinkingForProfile(profileName) {
+  const { model } = getModelProfile(profileName);
+  return { type: MODEL_CAPABILITIES[model].lowestThinking };
+}
 function tokenCount(value = NO_TOKENS) {
   return value;
 }
@@ -1710,6 +1722,7 @@ function estimateModelCost(profileName, usage) {
 var COUNT_METRIC = 1;
 var GAUGE_METRIC = 3;
 var FIRST_ATTEMPT = 1;
+var NO_CONTINUATION = 0;
 var NO_TOKENS2 = 0;
 var NO_COST = 0;
 var AGENT_TELEMETRY_CONTEXT = {
@@ -1863,6 +1876,12 @@ function agentRunMetrics(event, values, tags) {
       type: COUNT_METRIC,
       tags: runTags
     },
+    {
+      name: "wizard.agent.continuation",
+      value: Number((event.continuation ?? NO_CONTINUATION) > NO_CONTINUATION),
+      type: COUNT_METRIC,
+      tags: runTags
+    },
     ...event.stepCount === void 0 ? [] : [
       {
         name: "wizard.agent.step_count",
@@ -1905,6 +1924,7 @@ function trackAgentRun(event) {
           effort: profile.effort ?? "none",
           thinking: profile.thinking,
           attempt: event.attempt,
+          continuation: event.continuation,
           durationMs: event.durationMs,
           stepCount: event.stepCount,
           hitStepLimit: event.hitStepLimit,
@@ -2447,7 +2467,7 @@ async function ensureApplication(resumeAppId) {
 // package.json
 var package_default = {
   name: "@algolia/wizard",
-  version: "0.103.0-rc.226.759",
+  version: "0.104.0",
   description: "Magically implement Algolia functionality in your codebase",
   type: "module",
   engines: {
@@ -2494,11 +2514,11 @@ var package_default = {
     vitest: "^4.1.11"
   },
   dependencies: {
-    "@ai-sdk/anthropic": "^3.0.118",
-    "@ai-sdk/openai-compatible": "^2.0.75",
+    "@ai-sdk/anthropic": "^3.0.128",
+    "@ai-sdk/openai-compatible": "^2.0.81",
     "@hono/node-server": "^2.0.10",
     "@segment/analytics-node": "^3.1.0",
-    ai: "^6.0.283",
+    ai: "^6.0.302",
     "cross-keychain": "^1.1.0",
     dotenv: "^17.4.2",
     hono: "^4.13.8",
@@ -3196,6 +3216,18 @@ async function hasSymlinkParent(ctx, target) {
   }
   return false;
 }
+var fileLocks = /* @__PURE__ */ new Map();
+async function withFileLock(target, fn) {
+  const previous = fileLocks.get(target) ?? Promise.resolve();
+  const run2 = previous.then(fn);
+  const settled = run2.catch(() => void 0);
+  fileLocks.set(target, settled);
+  try {
+    return await run2;
+  } finally {
+    if (fileLocks.get(target) === settled) fileLocks.delete(target);
+  }
+}
 function symlinkTargetError(target) {
   return `Refused: ${target} is a symbolic link.`;
 }
@@ -3444,7 +3476,10 @@ function writeFileTool(ctx) {
         return secretEnvWriteRefusal(filePath);
       }
       try {
-        const writeError = await safeWriteFile(ctx, resolved2.target, content);
+        const writeError = await withFileLock(
+          resolved2.target,
+          () => safeWriteFile(ctx, resolved2.target, content)
+        );
         if (writeError) return writeError;
         useWizard.getState().recordWrittenFile(resolved2.target);
         return `Wrote to ${filePath}`;
@@ -3510,29 +3545,31 @@ function editFileTool(ctx) {
         return "Error: oldString and newString are identical. No change made.";
       }
       try {
-        const unsafe = await validateSafeWriteTarget(ctx, resolved2.target);
-        if (unsafe) return unsafe;
-        let content;
-        try {
-          content = await readFile5(resolved2.target, "utf8");
-        } catch (err) {
-          if (err.code === "ENOENT") {
-            return `Error: ${filePath} does not exist. To create it, use writeFile.`;
+        return await withFileLock(resolved2.target, async () => {
+          const unsafe = await validateSafeWriteTarget(ctx, resolved2.target);
+          if (unsafe) return unsafe;
+          let content;
+          try {
+            content = await readFile5(resolved2.target, "utf8");
+          } catch (err) {
+            if (err.code === "ENOENT") {
+              return `Error: ${filePath} does not exist. To create it, use writeFile.`;
+            }
+            throw err;
           }
-          throw err;
-        }
-        const matches = countOccurrences(content, oldString);
-        if (matches === 0) {
-          return `Error: oldString not found in ${filePath}. Read the file again and copy the exact text, including whitespace.`;
-        }
-        if (matches > 1 && !replaceAll) {
-          return `Error: oldString matches ${matches} places in ${filePath}. Add surrounding lines to make it unique, or set replaceAll to true.`;
-        }
-        const updated = replaceAll ? content.split(oldString).join(newString) : replaceFirst(content, oldString, newString);
-        const writeError = await safeWriteFile(ctx, resolved2.target, updated);
-        if (writeError) return writeError;
-        useWizard.getState().recordWrittenFile(resolved2.target);
-        return matches > 1 ? `Edited ${filePath} (${matches} replacements)` : `Edited ${filePath}. ${editedSnippet(updated, content.indexOf(oldString), newString)}`;
+          const matches = countOccurrences(content, oldString);
+          if (matches === 0) {
+            return `Error: oldString not found in ${filePath}. Read the file again and copy the exact text, including whitespace.`;
+          }
+          if (matches > 1 && !replaceAll) {
+            return `Error: oldString matches ${matches} places in ${filePath}. Add surrounding lines to make it unique, or set replaceAll to true.`;
+          }
+          const updated = replaceAll ? content.split(oldString).join(newString) : replaceFirst(content, oldString, newString);
+          const writeError = await safeWriteFile(ctx, resolved2.target, updated);
+          if (writeError) return writeError;
+          useWizard.getState().recordWrittenFile(resolved2.target);
+          return matches > 1 ? `Edited ${filePath} (${matches} replacements)` : `Edited ${filePath}. ${editedSnippet(updated, content.indexOf(oldString), newString)}`;
+        });
       } catch (err) {
         return `Error editing ${filePath}: ${err.message}`;
       }
@@ -3872,82 +3909,87 @@ function writeCredentialsTool(ctx) {
       if (!targetIndex) {
         return "Error: no target index is set for this run, so a scoped write key cannot be provisioned.";
       }
-      let existing = "";
-      let present;
-      try {
-        const targetError = await validateSafeWriteTarget(ctx, resolved2.target);
-        if (targetError) return targetError;
+      return withFileLock(resolved2.target, async () => {
+        let existing = "";
+        let present;
         try {
-          existing = await readFile7(resolved2.target, "utf8");
+          const targetError = await validateSafeWriteTarget(
+            ctx,
+            resolved2.target
+          );
+          if (targetError) return targetError;
+          try {
+            existing = await readFile7(resolved2.target, "utf8");
+          } catch (err) {
+            if (err.code !== "ENOENT") throw err;
+          }
+          present = [APP_ID_VAR, API_KEY_VAR].filter(
+            (name) => readEnv(existing, name) !== null
+          );
         } catch (err) {
-          if (err.code !== "ENOENT") throw err;
+          return `Error writing credentials to ${filePath}: ${err.message}`;
         }
-        present = [APP_ID_VAR, API_KEY_VAR].filter(
-          (name) => readEnv(existing, name) !== null
-        );
-      } catch (err) {
-        return `Error writing credentials to ${filePath}: ${err.message}`;
-      }
-      const credentials = [];
-      const notes = [];
-      const fileAppId = readEnv(existing, APP_ID_VAR);
-      const fileKey = readEnv(existing, API_KEY_VAR);
-      const fileIndex = readEnv(existing, INDEX_NAME_VAR);
-      if (fileAppId === null || fileKey === null) {
-        try {
-          const selected = (await requireApplication(ctx.appId)).id;
-          if (fileAppId === null) credentials.push([APP_ID_VAR, selected]);
-          if (fileKey === null) {
-            if (fileAppId !== null && fileAppId !== selected) {
+        const credentials = [];
+        const notes = [];
+        const fileAppId = readEnv(existing, APP_ID_VAR);
+        const fileKey = readEnv(existing, API_KEY_VAR);
+        const fileIndex = readEnv(existing, INDEX_NAME_VAR);
+        if (fileAppId === null || fileKey === null) {
+          try {
+            const selected = (await requireApplication(ctx.appId)).id;
+            if (fileAppId === null) credentials.push([APP_ID_VAR, selected]);
+            if (fileKey === null) {
+              if (fileAppId !== null && fileAppId !== selected) {
+                notes.push(
+                  `No ${API_KEY_VAR} was provisioned: ${filePath} names application ${fileAppId}, but ${selected} is selected. Tell the user to remove ${APP_ID_VAR} from ${filePath} and re-run so a matching pair can be written, or to fill in a ${API_KEY_VAR} for ${fileAppId} by hand.`
+                );
+              } else {
+                credentials.push([
+                  API_KEY_VAR,
+                  (await resolveWriteKey(targetIndex, selected)).key
+                ]);
+              }
+            } else {
               notes.push(
-                `No ${API_KEY_VAR} was provisioned: ${filePath} names application ${fileAppId}, but ${selected} is selected. Tell the user to remove ${APP_ID_VAR} from ${filePath} and re-run so a matching pair can be written, or to fill in a ${API_KEY_VAR} for ${fileAppId} by hand.`
+                `The existing ${API_KEY_VAR} must belong to application ${selected} or writes will fail.`
               );
-            } else {
-              credentials.push([
-                API_KEY_VAR,
-                (await resolveWriteKey(targetIndex, selected)).key
-              ]);
             }
-          } else {
-            notes.push(
-              `The existing ${API_KEY_VAR} must belong to application ${selected} or writes will fail.`
-            );
+          } catch (err) {
+            return `Error: could not resolve Algolia credentials (${err.message})`;
           }
-        } catch (err) {
-          return `Error: could not resolve Algolia credentials (${err.message})`;
         }
-      }
-      let wrote;
-      try {
-        const updated = [
-          ...credentials,
-          // Unconditional, unlike the credentials: the write key is scoped to
-          // the run's index, so a stale name left in the file earns a 403.
-          [INDEX_NAME_VAR, targetIndex]
-        ].reduce(
-          (content, [name, value]) => upsertEnv(content, name, value),
-          existing
-        );
-        const writeError = await safeWriteFile(ctx, resolved2.target, updated);
-        if (writeError) return writeError;
-        const sentences = [
-          `Wrote ${[...credentials.map(([name]) => name), INDEX_NAME_VAR].join(", ")} to ${filePath}.`
-        ];
-        if (fileIndex !== null && fileIndex !== targetIndex) {
-          sentences.push(
-            `That replaced the ${INDEX_NAME_VAR} already there ("${fileIndex}"), which this run does not target.`
-          );
-        }
-        if (present.length > 0) {
-          sentences.push(
-            `Skipped ${present.join(" and ")}: already defined there.`
+        let wrote;
+        try {
+          const updated = [
+            ...credentials,
+            // Unconditional, unlike the credentials: the write key is scoped to
+            // the run's index, so a stale name left in the file earns a 403.
+            [INDEX_NAME_VAR, targetIndex]
+          ].reduce(
+            (content, [name, value]) => upsertEnv(content, name, value),
+            existing
           );
+          const writeError = await safeWriteFile(ctx, resolved2.target, updated);
+          if (writeError) return writeError;
+          const sentences = [
+            `Wrote ${[...credentials.map(([name]) => name), INDEX_NAME_VAR].join(", ")} to ${filePath}.`
+          ];
+          if (fileIndex !== null && fileIndex !== targetIndex) {
+            sentences.push(
+              `That replaced the ${INDEX_NAME_VAR} already there ("${fileIndex}"), which this run does not target.`
+            );
+          }
+          if (present.length > 0) {
+            sentences.push(
+              `Skipped ${present.join(" and ")}: already defined there.`
+            );
+          }
+          wrote = [...sentences, ...notes].join(" ");
+        } catch (err) {
+          return `Error writing credentials to ${filePath}: ${err.message}`;
         }
-        wrote = [...sentences, ...notes].join(" ");
-      } catch (err) {
-        return `Error writing credentials to ${filePath}: ${err.message}`;
-      }
-      return wrote + await gitIgnoreOutcome(ctx, resolved2.target);
+        return wrote + await gitIgnoreOutcome(ctx, resolved2.target);
+      });
     }
   });
 }
@@ -5007,7 +5049,6 @@ async function classifyCommandSafety(createModel, command, cwd, explanation, app
     const { output, usage } = await generateText({
       model: anthropic(profile.model),
       maxOutputTokens: CLASSIFIER_MAX_OUTPUT_TOKENS,
-      temperature: 0,
       providerOptions: {
         anthropic: {
           thinking: modelOptions.thinking,
@@ -5418,6 +5459,10 @@ var MISSING_REPORT_STATUS_ERROR_MESSAGE = "Agent finished without calling report
 var MISSING_REPORT_USER_MESSAGE = "This step ran into a problem finishing. Run the wizard again to retry it.";
 var REPORT_STATUS_RETRIES = 2;
 var STEP_LIMIT_INSTRUCTION = "When reportStatus is the only tool available, you reached the step limit. This limit is not a failure, so do not report fail because of it: report status=success with the work done so far, and name the remaining work in the summary.";
+var TOOL_EVERY_TURN_INSTRUCTION = "Call at least one tool in every response. Do not reply with text only. The run ends only when you call reportStatus.";
+var ENDED_TURN_NUDGE = "Your last response did not call a tool. Continue the work with tools. When the work is done, call reportStatus.";
+var INITIAL_PROMPT = "Follow system instructions";
+var ENDED_TURN_CONTINUATIONS = 3;
 var RECENT_STEPS_LOGGED = 3;
 var LOGGED_CHARS = 300;
 var ATTEMPT_NUMBER_OFFSET = 1;
@@ -5455,6 +5500,13 @@ var MissingReportError = class extends Error {
     this.incompleteCause = incompleteCause;
   }
 };
+var EndedTurnError = class extends MissingReportError {
+  continuation;
+  constructor(continuation) {
+    super(null);
+    this.continuation = continuation;
+  }
+};
 function incompleteCauseOf(stepCount, maxSteps, finishReason) {
   if (stepCount >= maxSteps) return "stepLimit";
   if (finishReason === "length") return "truncated";
@@ -5513,10 +5565,23 @@ function exhaustedError(kind, err) {
 }
 async function runAgent(req) {
   let retryReason = null;
-  for (let attempt = INITIAL_ATTEMPT; attempt <= REPORT_STATUS_RETRIES; attempt++) {
+  let attempt = INITIAL_ATTEMPT;
+  let continuation;
+  let continuations = 0;
+  for (; ; ) {
     try {
-      return await runAgentAttempt(req, attempt, retryReason);
+      return await runAgentAttempt(req, attempt, retryReason, continuation);
     } catch (err) {
+      continuation = void 0;
+      if (err instanceof EndedTurnError && continuations < ENDED_TURN_CONTINUATIONS) {
+        continuations++;
+        continuation = err.continuation;
+        logger.warn(
+          { attempt: attempt + 1, continuations },
+          "continuing runAgent after a turn ended without a tool call"
+        );
+        continue;
+      }
       const kind = retryKind(err);
       if (!kind) throw err;
       if (attempt === REPORT_STATUS_RETRIES) throw exhaustedError(kind, err);
@@ -5525,19 +5590,23 @@ async function runAgent(req) {
         { attempt: attempt + 1, err },
         isMissingReportRetry(kind) ? "retrying runAgent after missing reportStatus" : "retrying runAgent after a transient provider error"
       );
+      attempt++;
     }
   }
-  throw new Error("unreachable");
 }
-async function runAgentAttempt(req, attempt, retryReason) {
+async function runAgentAttempt(req, attempt, retryReason, continuation) {
   const start = Date.now();
   const profileName = req.modelProfile ?? "implementation" /* implementation */;
   const profile = getModelProfile(profileName);
   const profileOptions = providerOptionsForProfile(profileName);
+  const toolChoice = toolChoiceForProfile(profileName);
   const maxSteps = req.maxSteps ?? profile.maxSteps;
+  const stepsUsed = continuation?.stepsUsed ?? 0;
+  const stepsLeft = maxSteps - stepsUsed;
   const forceReport = retryReason === "missingReport";
   const incompleteReason = incompleteReasonOf(retryReason);
-  const modelOptions = forceReport ? { thinking: { type: "disabled" } } : profileOptions;
+  const reportThinking = lowestThinkingForProfile(profileName);
+  const modelOptions = forceReport ? { thinking: reportThinking, effort: void 0 } : profileOptions;
   logger.info(
     {
       startedAt: new Date(start).toISOString(),
@@ -5545,8 +5614,9 @@ async function runAgentAttempt(req, attempt, retryReason) {
       profile: profileName,
       model: profile.model,
       effort: forceReport ? void 0 : profile.effort,
-      thinking: forceReport ? "disabled" : profile.thinking,
-      retryReason
+      thinking: forceReport ? reportThinking.type : profile.thinking,
+      retryReason,
+      stepsUsed
     },
     "runAgent started"
   );
@@ -5560,7 +5630,7 @@ async function runAgentAttempt(req, attempt, retryReason) {
     fetch: proxyFetch
   });
   const toolContext = req.toolContext ?? createToolContext();
-  if (attempt > INITIAL_ATTEMPT) resetToolCounts(toolContext);
+  if (attempt > INITIAL_ATTEMPT && !continuation) resetToolCounts(toolContext);
   const readTools = ["readFile", "searchFiles", "listFiles"];
   const hasReadTools = !req.tools || req.tools.some((t) => readTools.includes(t));
   const instructions = [
@@ -5569,6 +5639,7 @@ async function runAgentAttempt(req, attempt, retryReason) {
       "When you need to read or search multiple files, issue those tool calls together in one step rather than one at a time."
     ] : [],
     "Call notifyUser whenever you start a new phase of work or your focus shifts (e.g. moving from reading code to writing files) \u2014 a short, plain-language, high-level update. Do not call it for every tool use.",
+    ...toolChoice === "auto" ? [TOOL_EVERY_TURN_INSTRUCTION] : [],
     STEP_LIMIT_INSTRUCTION,
     // Last so a retry does not bust the cached tools+system prefix from
     // the first attempt. Inspect-and-continue, not start over: implement
@@ -5613,11 +5684,11 @@ async function runAgentAttempt(req, attempt, retryReason) {
       output: req.outputSchema,
       tools: req.tools
     }),
-    toolChoice: "required",
-    stopWhen: [reportAccepted, stepCountIs(maxSteps)],
+    toolChoice,
+    stopWhen: [reportAccepted, stepCountIs(stepsLeft)],
     prepareStep: ({ stepNumber, messages }) => ({
       messages: withCachedHistory(messages),
-      ...stepNumber >= maxSteps - 1 && {
+      ...stepNumber >= stepsLeft - 1 && {
         activeTools: ["reportStatus"]
       }
     }),
@@ -5625,9 +5696,11 @@ async function runAgentAttempt(req, attempt, retryReason) {
     ...{ onError: () => {
     } }
   });
-  const stream = await agent.stream({
-    prompt: "Follow system instructions"
-  });
+  const prompt = continuation ? [
+    ...continuation.messages,
+    { role: "user", content: ENDED_TURN_NUDGE }
+  ] : [{ role: "user", content: INITIAL_PROMPT }];
+  const stream = await agent.stream({ prompt });
   let chunks = [];
   const chunkLimit = 5;
   let streamError;
@@ -5659,13 +5732,15 @@ async function runAgentAttempt(req, attempt, retryReason) {
   const usage = await stream.totalUsage;
   const steps = await stream.steps;
   const stepCount = steps.length;
-  const hitStepLimit = stepCount >= maxSteps;
+  const totalSteps = stepsUsed + stepCount;
+  const hitStepLimit = totalSteps >= maxSteps;
   const lastStep = steps[steps.length - 1];
   const finishReason = lastStep?.finishReason;
   trackAgentRun({
     operation: req.operation,
     profile: profileName,
     attempt: attempt + ATTEMPT_NUMBER_OFFSET,
+    continuation: continuation?.number ?? 0,
     durationMs: end - start,
     usage,
     stepCount,
@@ -5681,6 +5756,7 @@ async function runAgentAttempt(req, attempt, retryReason) {
       model: profile.model,
       usage,
       stepCount,
+      totalSteps,
       maxSteps,
       hitStepLimit,
       finishReason
@@ -5707,8 +5783,17 @@ async function runAgentAttempt(req, attempt, retryReason) {
       },
       "Agent finished without calling reportStatus"
     );
+    const endedTurn = toolChoice === "auto" && finishReason === "stop" && !lastStep?.toolCalls?.length && !hitStepLimit;
+    if (endedTurn) {
+      const { messages } = await stream.response;
+      throw new EndedTurnError({
+        messages: [...prompt, ...messages],
+        stepsUsed: totalSteps,
+        number: (continuation?.number ?? 0) + 1
+      });
+    }
     throw new MissingReportError(
-      incompleteCauseOf(stepCount, maxSteps, finishReason)
+      incompleteCauseOf(totalSteps, maxSteps, finishReason)
     );
   }
   const result = report.output;
@@ -6682,6 +6767,7 @@ function searchInstructions(input) {
     "Style the search surfaces through the widget's class and CSS-variable overrides (or, when hand-built, the app's existing theme tokens): give the results panel and the element that actually draws the input's border and background \u2014 for a widget, the form or wrapper it renders around the bare input \u2014 non-transparent surfaces, keep that frame distinguishable from the background behind it in every supported theme, and never assume a light surface or reuse the surrounding page's colors unchanged inside the panel.",
     "The panel takes its width from the input by default, so a small input makes it unreadably narrow: give it `min-width: min(320px, calc(100vw - 2rem))` independent of the input, cap its maximum width to the viewport, and anchor it to the input edge it opens from so widening does not push it off-screen.",
     "Match the application styles closely, including light, dark, and high-contrast themes the project already supports.",
+    "Give the search input frame the same height, corner radius, border color and width, background, and focus style as the input it replaces. When it replaces nothing, copy them from the form controls beside it. Read these values from their source (the theme, the component props, or the CSS). Do not keep the widget theme defaults, for example a 44px height and 4px corners, and do not invent colors. When the app theme exists only in code, take the values from that theme object.",
     "When you add UI text to a localized dictionary or message file, add the same keys, translated, to every locale the project supports.",
     "Before reporting, mount the component. Do not run a type check, build, or test command unless a later instruction allows it: the validation pass runs the type check, after the developer agrees to it. If a tool limit is reached or an error remains unresolved, keep the implementation, report status=success, and name the remaining issue in the summary so validation can drive the next pass. Report status=fail only when no search implementation can be written, with the concrete blocker as the reason.",
     "The summary should be extremely concise; do not mention manual testing steps."
@@ -6788,16 +6874,18 @@ function validationInstructions(input) {
     `The confirmed placement candidate was "${input.searchLocation ?? "unknown"}", but verify the actual mount rather than assuming the candidate was used.`,
     "Inspect the generated search component, its actual mount file, that file's parent layout and sibling controls, and the relevant content UI. Do not rely only on type checks or tests.",
     "Confirm that the application renders exactly one search bar. Check for an old search bar and duplicate mounts.",
-    "If the project sets a Content-Security-Policy, confirm that connect-src allows https://*.algolia.net, https://*.algolianet.com, and https://insights.algolia.io, and that search-insights is loaded from npm (not a CDN). If a CSP exists and fails either check, set sufficient=false. If the project has no CSP, skip both checks: do not set sufficient=false, and do not ask to add a CSP.",
+    "If the project sets a Content-Security-Policy, confirm that connect-src allows https://*.algolia.net, https://*.algolianet.com, and https://insights.algolia.io, and that search-insights is loaded from npm (not a CDN). If a CSP exists and fails either check, set sufficient=false. If the project has no CSP, skip both checks: do not set sufficient=false, and do not ask to add a CSP. Without a CSP, insights={true} (or insights: true) with no search-insights package is correct, because the widget loads search-insights from its CDN: do not report a missing search-insights package.",
     "Confirm content-specific search is placed with the corresponding content or task controls. Shared navigation is valid only for genuinely app-wide search that fits the visual hierarchy and responsive layout without crowding primary actions.",
     "Confirm the input has a persistent accessible name; widget-provided combobox, popup, and item relationships and keyboard behavior are preserved; and loading, empty, and error status text is perceivable to assistive technology.",
     "Inspect the CSS that actually applies to the generated DOM. Confirm the results panel and the element drawing the input frame have non-transparent surfaces, the input frame is distinguishable from its surrounding background in every supported theme, text meets 4.5:1 contrast, meaningful boundaries and focus indicators meet 3:1, and no state relies on color alone.",
     "Confirm the search experience reflows without horizontal page scrolling at 320 CSS pixels, keeps its panel on-screen, preserves visible focus, and respects reduced-motion preferences for any added animation.",
     "If the project imports an InstantSearch theme, confirm that the project sets the theme palette to the app colors in each theme that the app supports: --ais-primary-color-rgb to the app accent color, and --ais-background-color-rgb, --ais-text-color-rgb, and --ais-border-color-rgb to the app surface, text, and border colors. If the project keeps the theme defaults, set sufficient=false, because the search icon, focus ring, and active item then show the theme blue, and the panel shows the theme surface instead of the app surface. A match between the light and dark themes of the widget and the page is not enough. The theme colors .ais-Highlight-highlighted and .ais-Snippet-highlighted with a fixed blue that the palette does not change: if the results show either class and the project does not restyle it, set sufficient=false.",
     "Then confirm that the palette overrides (--ais-*-rgb) win over the theme: they must use a higher specificity than the theme, for example `:root:root`, and for a dark mode `:root:root.dark` or `:root:root[data-theme=dark]`, because the theme sets its own blue in `:root` and in `:root[data-theme=dark], .dark`. `:root:root` alone ties with `:root[data-theme=dark]`. If an override can lose to the theme, set sufficient=false, because the search icon and focus ring then show the theme blue instead of the app accent color.",
-    "Find how the app selects each theme it supports (a class or attribute on an ancestor, a prefers-color-scheme media query, or a theme that exists only in code). Confirm that the search input and results panel take their colors from the active app theme through that same switch. A search widget whose colors do not match the page theme, for example a light panel on a dark page, is a failure: set sufficient=false.",
+    "Find how the app selects each theme it supports (a class or attribute on an ancestor, a prefers-color-scheme media query, or a theme that exists only in code). A theme is supported only when the app can select it at runtime: a mounted theme switch, or a stored or system preference that the app applies. A theme file or theme option that the app never selects, for example because the app forces one mode, does not count. Confirm that the search input and results panel take their colors from the active app theme through that same switch. A search widget whose colors do not match the page theme, for example a light panel on a dark page, is a failure: set sufficient=false.",
     "When the project has a package.json, confirm that the theme CSS of the search widget (for InstantSearch, a theme from instantsearch.css) is imported once from a legal global-CSS entry for that framework (Next.js Pages Router: pages/_app; Next.js App Router: root layout; otherwise the app global stylesheet or a component module when allowed). If it is installed but not imported, or imported from a Next.js component file, set sufficient=false.",
     "Confirm that the search component is reachable from and fits the corresponding content task at every supported breakpoint; require app-wide reachability only when the search scope is genuinely app-wide.",
+    "For an InstantSearch Autocomplete, confirm that the item component (the React itemComponent, or the item template in indices[].templates) calls the onSelect that it receives when the user clicks the result, for example onClick={onSelect} on its root element. The widget goes to the getURL route only through onSelect: the click on its <li> only sends the Insights event. If the item ignores onSelect, set sufficient=false, because a click on a result then does nothing.",
+    "Confirm that the search input frame has the same height, corner radius, border, and background as the input that it replaces, or as the form controls beside it when it replaces nothing. If the frame keeps the widget theme defaults or uses colors that the app does not use, set sufficient=false.",
     "Do not run the test suite or any test command.",
     "Do not modify files. Report each implementation issue as a concrete instruction for the next implementation pass.",
     `Detected verification tools: ${JSON.stringify(input.findings.verification ?? [])}. Use only a type checker; ignore any linter or formatter in this list.`,
@@ -6812,7 +6900,7 @@ function validationInstructions(input) {
     "Set sufficient=false when a required placement, accessibility, or theme-color property is observed to fail, the implementation is incomplete, or checks have implementation-caused failures; include concrete additionalInstructions for the next pass.",
     "You can only read source files. If a required property can be checked in the source, check it there. If it can be established only in a browser (rendered contrast, keyboard behavior, 320-pixel reflow, live-region status, computed accessible name), set sufficient=true when the source shows no violation. Never request devtools, a screenshot, or a contrast tool, and never repeat a finding that an earlier pass already fixed.",
     "If a check fails only in untouched code, set unrelatedFailure to a concise failure description.",
-    "Set styleOnly=true when sufficient=false and every finding is one of these: the theme palette defaults remain, a palette override loses to the theme, or the highlight classes keep the theme blue. If any other finding exists, for example a light panel on a dark page, do not set styleOnly.",
+    "Set styleOnly=true when sufficient=false and every finding is one of these: the theme palette defaults remain, a palette override loses to the theme, the highlight classes keep the theme blue, or the input frame does not match the size, radius, border, or background of the controls that it must match. If any other finding exists, for example a light panel on a dark page or a result that a click does not open, do not set styleOnly.",
     "Keep the summary to one short sentence. Put the details in additionalInstructions."
   ];
 }
@@ -7116,10 +7204,17 @@ function validationRunInstructions(plan, attempt) {
     "Do not use an autofix option during validation."
   ];
 }
+function previousFindingsInstructions(findings) {
+  if (!findings) return [];
+  return [
+    `The previous validation pass reported these findings: ${findings}`,
+    "Check those findings first. Keep the conclusions of that pass that the changes did not affect, for example which themes the app supports. Report a new finding only when it breaks the search (the search bar does not render, search returns no results, or a click on a result does not open it), fails an accessibility requirement, or comes from a change made after the previous pass. Do not set sufficient=false for any other new issue: name it briefly in the summary."
+  ];
+}
 function retryTypeCheckInstructions(plan) {
   if (!plan.run) return [];
   return [
-    "The developer approved the type check. Run it once with the project's existing command right after you apply the fixes, before other work. Do not install dependencies, use npx, dlx, or another package runner, or use an autofix option. Fix the errors that your changes cause, and name any error that remains in the summary."
+    "The developer approved the type check. Run it once with the project's existing command right after you apply the fixes, before other work. Do not install dependencies unless a finding requires a package upgrade. If it does, install that upgrade once with the project's package manager, then run the type check. Do not use npx, dlx, or another package runner, or an autofix option. Fix the errors that your changes cause, and name any error that remains in the summary."
   ];
 }
 async function resolveIngestionSource(ctx, repoRoot) {
@@ -7559,6 +7654,7 @@ ${detail}` : ""}`
     );
     let extraInstructions = [];
     let buildCheckPlan;
+    let previousFindings;
     const confirmedFrameworks = language.frameworks ?? [];
     const detectedFrameworks = scan.frameworks ?? [];
     const framework = confirmedFrameworks[0]?.name ?? "unknown";
@@ -7604,9 +7700,10 @@ ${detail}` : ""}`
         searchConfigFile = searchResult.searchConfigFile;
       }
       buildCheckPlan ??= await resolveBuildCheckPlan(ctx, repoRoot, input);
-      const validation = await runValidationUseCase(
-        validationRunInstructions(buildCheckPlan, attempt)
-      );
+      const validation = await runValidationUseCase([
+        ...validationRunInstructions(buildCheckPlan, attempt),
+        ...previousFindingsInstructions(previousFindings)
+      ]);
       summaries.push(formatSummary("validation", validation.summary));
       const finalAttempt = attempt === MAX_IMPLEMENT_VALIDATION_ATTEMPTS;
       let investigateUnrelated = false;
@@ -7657,6 +7754,7 @@ ${detail}` : ""}`
           `Unable to validate the implementation after ${MAX_IMPLEMENT_VALIDATION_ATTEMPTS} attempts (details in wizard.log): ${briefSummary(validation.summary)}`
         );
       }
+      previousFindings = validation.sufficient ? void 0 : validation.additionalInstructions ?? validation.summary;
       extraInstructions = validation.sufficient ? [] : validationRetryInstructions(validation);
       if (validation.unrelatedFailure && investigateUnrelated) {
         extraInstructions.push(
@@ -10082,7 +10180,7 @@ async function resetProjectState() {
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "@algolia/wizard",
-  version: "0.103.0-rc.226.759",
+  version: "0.104.0",
   description: "Magically implement Algolia functionality in your codebase",
   type: "module",
   engines: {
@@ -10129,11 +10227,11 @@ var package_default2 = {
     vitest: "^4.1.11"
   },
   dependencies: {
-    "@ai-sdk/anthropic": "^3.0.118",
-    "@ai-sdk/openai-compatible": "^2.0.75",
+    "@ai-sdk/anthropic": "^3.0.128",
+    "@ai-sdk/openai-compatible": "^2.0.81",
     "@hono/node-server": "^2.0.10",
     "@segment/analytics-node": "^3.1.0",
-    ai: "^6.0.283",
+    ai: "^6.0.302",
     "cross-keychain": "^1.1.0",
     dotenv: "^17.4.2",
     hono: "^4.13.8",

package/docs/algolia-sdk/instantsearch-setup-js.md

@@ -87,14 +87,15 @@ Ensure the attributes you map into the component match the entity. 'title' above
   `searchParameters` (for example `['body:20']`), or as an index setting. Do both
   for the same attribute names the template passes to Snippet.
 
-### Navigation is `getURL`'s job, not the template's
+### Navigation: `getURL` plus the template's `onSelect`
 
 - `indices[].getURL` — `(item) => string`, a route that already exists; don't invent one.
-  It navigates on click **and** on Enter over a highlighted item, and records the click
-  event.
-- The `item` template renders content only: **no `<a>`, no `href`, no click handler of
-  your own, never `stopPropagation`.** The widget's `<li>` owns the click — it sends the
-  Insights `click`, closes the panel, clears the active option.
+  The widget goes there when `onSelect` runs: on Enter over a highlighted item, and on a
+  click only when the `item` template calls `onSelect`.
+- The `item` template **must call the `onSelect` it is handed on click**, for example
+  `` html`<div onClick=${onSelect}>…</div>` ``. The widget's `<li>` click only sends the
+  Insights `click`. Without `onSelect`, a click on a result does nothing. No `<a>`, no
+  `href`, no other click handler, never `stopPropagation`.
 - Do not pass a top-level `onSelect` to `autocomplete()` to navigate. `getURL` already
   navigates.
 - `getSearchPageURL` sends Enter with nothing highlighted to a full results page; pass it
@@ -287,8 +288,8 @@ insights: {
 
 With `insights: true`, `autocomplete` sends `view` (on render) and `click` (from the
 result element's own handler) itself. Its item template gets `{ item, onSelect }` and
-**no `sendEvent`** — nothing to wire. Call `onSelect` for the widget's selection behavior
-(close the panel, record a recent search); the click event fires either way.
+**no `sendEvent`** — nothing to wire. Call `onSelect` on click: it goes to
+the `getURL` route and closes the panel. The click event fires either way.
 
 `hits` and `infiniteHits` behave the same; only a custom `item` template whose click
 target is your own element needs wiring — it gets `sendEvent` as the second argument.

package/docs/algolia-sdk/instantsearch-setup-react.md

@@ -25,8 +25,11 @@ dismissal, Up/Down navigation with wrap-around, Enter/Escape/Tab, and the combob
 (`combobox` on the input, `aria-expanded`, `aria-activedescendant`) — add no open/close
 logic or ARIA roles of your own.
 
-Needs `react-instantsearch` **7.18.0+**. If an older 7.x is pinned, upgrade within `^7`
-rather than switching widgets.
+Needs `react-instantsearch` **7.41.0+**. That is the first release that exports
+`Autocomplete`. Earlier 7.x only exports `EXPERIMENTAL_Autocomplete`, which fails
+the type check. If an older 7.x is pinned, upgrade to the latest 7.x (`^7`) and
+install it before importing `Autocomplete`. Do not import
+`EXPERIMENTAL_Autocomplete`, and do not switch widgets.
 
 ```tsx
 import { liteClient as algoliasearch } from 'algoliasearch/lite'
@@ -79,14 +82,15 @@ Ensure the attributes you map into the component match the entity. 'title' above
   `searchParameters` (for example `['body:20']`), or as an index setting. Do both
   for the same attribute names the component passes to Snippet.
 
-### Navigation is `getURL`'s job, not the item component's
+### Navigation: `getURL` plus the item's `onSelect`
 
 - `indices[].getURL` — `(item) => string`, a route that already exists; don't invent one.
-  It navigates on click **and** on Enter over a highlighted item, and records the click
-  event.
-- `itemComponent` renders content only: **no `<a>`, no `href`, no `onClick` beyond the
-  `onSelect` it is handed, never `stopPropagation`.** The widget's `<li>` owns the click —
-  it sends the Insights `click`, closes the panel, clears the active option.
+  The widget goes there when `onSelect` runs: on Enter over a highlighted item, and on a
+  click only when the item component calls `onSelect`.
+- `itemComponent` **must call the `onSelect` it is handed on click**, for example
+  `<div onClick={onSelect}>`. The widget's `<li>` click only sends the Insights `click`.
+  Without `onSelect`, a click on a result does nothing. No `<a>`, no `href`, no other
+  `onClick`, never `stopPropagation`.
 - Do not pass a top-level `onSelect` to `<Autocomplete>` (for example to call
   `router.push`). `getURL` already navigates. The top-level callback can receive a
   `SyntheticEvent` instead of `{ item }`, so reading `item` from it fails the type check.
@@ -281,8 +285,8 @@ policy allows it:
 With `insights={true}`, `<Autocomplete>` sends `view` (on render) and `click` (from the
 result element's own handler) itself. Its `itemComponent` receives
 `{ item, onSelect, onApply }` and **no `sendEvent`** — nothing to wire. Call `onSelect`
-for the widget's selection behavior (close the panel, record a recent search); the click
-event fires either way.
+on click: it goes to the `getURL` route and closes the panel. The click event fires
+either way.
 
 `<Hits>` and `<InfiniteHits>` behave the same way. Two cases there need explicit wiring:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@algolia/wizard",
-  "version": "0.103.0-rc.226.759",
+  "version": "0.104.0",
   "description": "Magically implement Algolia functionality in your codebase",
   "type": "module",
   "engines": {
@@ -47,11 +47,11 @@
     "vitest": "^4.1.11"
   },
   "dependencies": {
-    "@ai-sdk/anthropic": "^3.0.118",
-    "@ai-sdk/openai-compatible": "^2.0.75",
+    "@ai-sdk/anthropic": "^3.0.128",
+    "@ai-sdk/openai-compatible": "^2.0.81",
     "@hono/node-server": "^2.0.10",
     "@segment/analytics-node": "^3.1.0",
-    "ai": "^6.0.283",
+    "ai": "^6.0.302",
     "cross-keychain": "^1.1.0",
     "dotenv": "^17.4.2",
     "hono": "^4.13.8",