@algolia/wizard 0.66.0 → 0.68.0

package/dist/main.js

@@ -48,7 +48,7 @@ function runAlgoliaCli(args, { onOutput, redact } = {}) {
   const store = useWizard.getState();
   const command = mask(args.join(" "), redact);
   const logId = store.logStart("tool", `algolia ${command}`);
-  return new Promise((resolve4, reject) => {
+  return new Promise((resolve5, reject) => {
     const child = spawn("npx", npxArgs(args), { shell });
     let stdout = "";
     let stderr = "";
@@ -71,7 +71,7 @@ function runAlgoliaCli(args, { onOutput, redact } = {}) {
       splitters.stdout.flush();
       splitters.stderr.flush();
       if (code === 0) {
-        resolve4(stdout);
+        resolve5(stdout);
       } else {
         const failed = stderr.trim();
         let detail = "";
@@ -275,15 +275,15 @@ var useWizard = create((set, get) => ({
   ),
   openLearnMore: () => set({ homeScreen: "learnMore" }),
   backToHome: () => set({ homeScreen: "home" }),
-  waitForStart: () => new Promise((resolve4) => {
+  waitForStart: () => new Promise((resolve5) => {
     if (get().phase !== "idle") {
-      resolve4();
+      resolve5();
       return;
     }
     const unsubscribe = useWizard.subscribe((s) => {
       if (s.phase !== "idle") {
         unsubscribe();
-        resolve4();
+        resolve5();
       }
     });
   }),
@@ -385,11 +385,11 @@ var useWizard = create((set, get) => ({
       (t) => t.id === id ? { ...t, status, durationMs: Date.now() - t.startedAt } : t
     )
   })),
-  requestUserInput: (req) => new Promise((resolve4) => {
+  requestUserInput: (req) => new Promise((resolve5) => {
     set({
       phase: "awaitingInput",
       inputReq: req,
-      _resolve: resolve4
+      _resolve: resolve5
     });
   }),
   submitInput: async (value) => {
@@ -1490,7 +1490,106 @@ async function clearWorkflowState(workflowId) {
   await rm(stateFile(workflowId), { force: true });
 }
 
+// src/lib/modelProfiles.ts
+var TOKENS_PER_MILLION = 1e6;
+var INITIAL_MODEL_ATTEMPT = 1;
+var NO_TOKENS = 0;
+var QUICK_MAX_OUTPUT_TOKENS = 8192;
+var QUICK_MAX_STEPS = 16;
+var ANALYSIS_MAX_OUTPUT_TOKENS = 8192;
+var ANALYSIS_MAX_STEPS = 24;
+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 SONNET_5_PRICES = {
+  input: 2,
+  output: 10,
+  cacheRead: 0.2,
+  cacheWrite: 2.5
+};
+var MODEL_PROFILES = {
+  quick: {
+    model: "claude-haiku-4-5",
+    thinking: "disabled",
+    maxOutputTokens: QUICK_MAX_OUTPUT_TOKENS,
+    maxSteps: QUICK_MAX_STEPS,
+    prices: HAIKU_4_5_PRICES
+  },
+  analysis: {
+    model: "claude-sonnet-5",
+    thinking: "adaptive",
+    effort: "low",
+    maxOutputTokens: ANALYSIS_MAX_OUTPUT_TOKENS,
+    maxSteps: ANALYSIS_MAX_STEPS,
+    prices: SONNET_5_PRICES
+  },
+  implementation: {
+    model: "claude-sonnet-5",
+    thinking: "adaptive",
+    effort: "medium",
+    maxOutputTokens: IMPLEMENTATION_MAX_OUTPUT_TOKENS,
+    maxSteps: IMPLEMENTATION_MAX_STEPS,
+    prices: SONNET_5_PRICES
+  },
+  implementationRetry: {
+    model: "claude-sonnet-5",
+    thinking: "adaptive",
+    effort: "high",
+    maxOutputTokens: IMPLEMENTATION_MAX_OUTPUT_TOKENS,
+    maxSteps: IMPLEMENTATION_MAX_STEPS,
+    prices: SONNET_5_PRICES
+  },
+  validation: {
+    model: "claude-sonnet-5",
+    thinking: "adaptive",
+    effort: "low",
+    maxOutputTokens: VALIDATION_MAX_OUTPUT_TOKENS,
+    maxSteps: VALIDATION_MAX_STEPS,
+    prices: SONNET_5_PRICES
+  }
+};
+function getModelProfile(profileName) {
+  return MODEL_PROFILES[profileName];
+}
+function providerOptionsForProfile(profileName) {
+  const profile = getModelProfile(profileName);
+  return {
+    thinking: { type: profile.thinking },
+    ...profile.effort !== void 0 && { effort: profile.effort }
+  };
+}
+function tokenCount(value = NO_TOKENS) {
+  return value;
+}
+function estimateModelCost(profileName, usage) {
+  const { prices } = getModelProfile(profileName);
+  const inputDetails = Object.assign({}, usage.inputTokenDetails);
+  const cacheRead = tokenCount(inputDetails.cacheReadTokens);
+  const cacheWrite = tokenCount(inputDetails.cacheWriteTokens);
+  const input = Math.max(
+    NO_TOKENS,
+    tokenCount(usage.inputTokens) - cacheRead - cacheWrite
+  );
+  const output = tokenCount(usage.outputTokens);
+  return (input * prices.input + cacheRead * prices.cacheRead + cacheWrite * prices.cacheWrite + output * prices.output) / TOKENS_PER_MILLION;
+}
+
 // src/lib/telemetry.ts
+var COUNT_METRIC = 1;
+var GAUGE_METRIC = 3;
+var FIRST_ATTEMPT = 1;
+var NO_TOKENS2 = 0;
+var AGENT_TELEMETRY_CONTEXT = {
+  appId: void 0,
+  workflowId: void 0
+};
 function isTelemetryOptedOut() {
   return process.env.WIZARD_TELEMETRY === "false";
 }
@@ -1537,6 +1636,110 @@ function sendMetric(name, value, type, tags = []) {
 function metricTags(workflowId, actionId) {
   return actionId ? [`workflow:${workflowId}`, `action:${actionId}`] : [`workflow:${workflowId}`];
 }
+function agentMetricTags(event, workflowId) {
+  const profile = getModelProfile(event.profile);
+  return [
+    ...workflowId ? [`workflow:${workflowId}`] : [],
+    `operation:${event.operation}`,
+    `profile:${event.profile}`,
+    `model:${profile.model}`,
+    `effort:${profile.effort ?? "none"}`,
+    `thinking:${profile.thinking}`
+  ];
+}
+function agentRunValues(event) {
+  const usage = Object.assign({}, event.usage);
+  const inputTokenDetails = Object.assign({}, usage.inputTokenDetails);
+  return {
+    inputTokens: usage.inputTokens ?? NO_TOKENS2,
+    outputTokens: usage.outputTokens ?? NO_TOKENS2,
+    cacheReadTokens: inputTokenDetails.cacheReadTokens ?? NO_TOKENS2,
+    cacheWriteTokens: inputTokenDetails.cacheWriteTokens ?? NO_TOKENS2,
+    estimatedCostUsd: estimateModelCost(event.profile, usage)
+  };
+}
+function agentRunMetrics(event, values, tags) {
+  const runTags = [...tags];
+  return [
+    {
+      name: "wizard.agent.duration_ms",
+      value: event.durationMs,
+      type: GAUGE_METRIC,
+      tags: runTags
+    },
+    {
+      name: "wizard.agent.input_tokens",
+      value: values.inputTokens,
+      type: COUNT_METRIC,
+      tags: runTags
+    },
+    {
+      name: "wizard.agent.output_tokens",
+      value: values.outputTokens,
+      type: COUNT_METRIC,
+      tags: runTags
+    },
+    {
+      name: "wizard.agent.cache_read_tokens",
+      value: values.cacheReadTokens,
+      type: COUNT_METRIC,
+      tags: runTags
+    },
+    {
+      name: "wizard.agent.cache_write_tokens",
+      value: values.cacheWriteTokens,
+      type: COUNT_METRIC,
+      tags: runTags
+    },
+    {
+      name: "wizard.agent.estimated_cost_usd",
+      value: values.estimatedCostUsd,
+      type: COUNT_METRIC,
+      tags: runTags
+    },
+    {
+      name: "wizard.agent.retry",
+      value: Number(event.attempt > FIRST_ATTEMPT),
+      type: COUNT_METRIC,
+      tags: runTags
+    }
+  ];
+}
+function trackAgentRun(event) {
+  const profile = getModelProfile(event.profile);
+  const values = agentRunValues(event);
+  const tagsForMetrics = agentMetricTags(
+    event,
+    AGENT_TELEMETRY_CONTEXT.workflowId
+  );
+  const tags = [
+    ...tagsForMetrics,
+    ...AGENT_TELEMETRY_CONTEXT.appId ? [`app_id:${AGENT_TELEMETRY_CONTEXT.appId}`] : []
+  ];
+  sendTelemetry({
+    logs: [
+      {
+        status: "info",
+        message: "wizard agent completed",
+        attributes: {
+          event: "wizard.agent.complete",
+          operation: event.operation,
+          profile: event.profile,
+          model: profile.model,
+          effort: profile.effort ?? "none",
+          thinking: profile.thinking,
+          attempt: event.attempt,
+          durationMs: event.durationMs,
+          workflow_id: AGENT_TELEMETRY_CONTEXT.workflowId,
+          app_id: AGENT_TELEMETRY_CONTEXT.appId,
+          ...values
+        },
+        tags
+      }
+    ],
+    metrics: agentRunMetrics(event, values, tagsForMetrics)
+  });
+}
 function logTags(workflowId, actionId, appId) {
   return [
     ...metricTags(workflowId, actionId),
@@ -1552,6 +1755,8 @@ function emitTelemetryLog(level, message, attributes, tags) {
   sendLog(level, message, attributes, tags);
 }
 function trackWorkflowStart(ctx) {
+  AGENT_TELEMETRY_CONTEXT.appId = ctx.appId;
+  AGENT_TELEMETRY_CONTEXT.workflowId = ctx.workflowId;
   const attributes = {
     event: "wizard.workflow.start",
     workflow_id: ctx.workflowId,
@@ -1677,6 +1882,8 @@ function trackWizardComplete(event) {
     attributes,
     logTags(event.workflowId, void 0, event.appId)
   );
+  AGENT_TELEMETRY_CONTEXT.appId = void 0;
+  AGENT_TELEMETRY_CONTEXT.workflowId = void 0;
 }
 function trackWorkflowError(ctx) {
   const attributes = {
@@ -1693,6 +1900,8 @@ function trackWorkflowError(ctx) {
     attributes,
     logTags(ctx.workflowId, ctx.actionId, ctx.appId)
   );
+  AGENT_TELEMETRY_CONTEXT.appId = void 0;
+  AGENT_TELEMETRY_CONTEXT.workflowId = void 0;
 }
 
 // src/lib/events.ts
@@ -1760,7 +1969,7 @@ function identify(traits) {
 // package.json
 var package_default = {
   name: "@algolia/wizard",
-  version: "0.66.0",
+  version: "0.68.0",
   description: "Magically implement Algolia functionality in your codebase",
   type: "module",
   engines: {
@@ -2306,7 +2515,8 @@ import {
   hasToolCall,
   Output as Output3,
   APICallError,
-  NoOutputGeneratedError
+  NoOutputGeneratedError,
+  stepCountIs
 } from "ai";
 import { createAnthropic as createAnthropic3 } from "@ai-sdk/anthropic";
 import "zod";
@@ -2806,10 +3016,10 @@ var GIT_ENV_OVERRIDES = [
 function gitSucceeds(root, args) {
   const env = { ...process.env };
   for (const key of GIT_ENV_OVERRIDES) delete env[key];
-  return new Promise((resolve4) => {
+  return new Promise((resolve5) => {
     execFile("git", ["-C", root, ...args], { env }, (err) => {
-      if (!err) return resolve4(true);
-      resolve4(
+      if (!err) return resolve5(true);
+      resolve5(
         err.code === 1 ? false : void 0
       );
     });
@@ -3256,7 +3466,7 @@ var SIGKILL_DELAY_MS = 5e3;
 function runShell(command, opts) {
   const timeoutMs = opts.timeoutMs ?? DEFAULT_SHELL_TIMEOUT_MS;
   const startedAt = Date.now();
-  return new Promise((resolve4) => {
+  return new Promise((resolve5) => {
     let output = "";
     let timedOut = false;
     let settled = false;
@@ -3271,7 +3481,7 @@ function runShell(command, opts) {
       settled = true;
       clearTimeout(timer);
       clearTimeout(killTimer);
-      resolve4({
+      resolve5({
         exitCode,
         output: truncateText(output.trim()),
         timedOut,
@@ -3297,6 +3507,7 @@ function runShell(command, opts) {
 }
 
 // src/lib/tools/runShell.ts
+var CLASSIFIER_MAX_OUTPUT_TOKENS = 512;
 function storeApproval(root) {
   return async (req) => {
     const store = useWizard.getState();
@@ -3510,7 +3721,6 @@ function fastPathSafety(command) {
   if (results.every((r) => r === true)) return true;
   return void 0;
 }
-var CLASSIFIER_MODEL = "claude-haiku-4-5";
 var commandSafetySchema = z16.object({
   safe: z16.boolean(),
   reason: z16.string().describe("One short sentence explaining the verdict.")
@@ -3528,16 +3738,28 @@ function defaultCreateModel() {
 }
 function approvedCommandHistory(approvedCommands) {
   return Array.from(approvedCommands).map((entry) => {
-    const sep2 = entry.indexOf("\0");
-    return { cwd: entry.slice(0, sep2), command: entry.slice(sep2 + 1) };
+    const sep3 = entry.indexOf("\0");
+    return { cwd: entry.slice(0, sep3), command: entry.slice(sep3 + 1) };
   });
 }
 async function classifyCommandSafety(createModel, command, cwd, explanation, approvedHistory) {
   try {
     const anthropic = createModel();
-    const { output } = await generateText({
-      model: anthropic(CLASSIFIER_MODEL),
+    const profile = getModelProfile("quick" /* quick */);
+    const modelOptions = providerOptionsForProfile("quick" /* quick */);
+    const startedAt = Date.now();
+    const { output, usage } = await generateText({
+      model: anthropic(profile.model),
+      maxOutputTokens: CLASSIFIER_MAX_OUTPUT_TOKENS,
       temperature: 0,
+      providerOptions: {
+        anthropic: {
+          thinking: modelOptions.thinking,
+          ...modelOptions.effort !== void 0 && {
+            effort: modelOptions.effort
+          }
+        }
+      },
       output: Output.object({ schema: commandSafetySchema }),
       prompt: [
         "A coding agent wants to run this shell command in a user's project without asking for approval first. The command may be in any programming language or ecosystem.",
@@ -3558,6 +3780,13 @@ async function classifyCommandSafety(createModel, command, cwd, explanation, app
         `Stated purpose: ${explanation}`
       ].join("\n")
     });
+    trackAgentRun({
+      operation: "shell-safety-classifier",
+      profile: "quick" /* quick */,
+      attempt: INITIAL_MODEL_ATTEMPT,
+      durationMs: Date.now() - startedAt,
+      usage
+    });
     if (!output.safe) {
       logger.info(
         { command, reason: output.reason },
@@ -3702,7 +3931,6 @@ import { createAnthropic as createAnthropic2 } from "@ai-sdk/anthropic";
 import { nanoid as nanoid2 } from "nanoid";
 import z17 from "zod";
 var DATA_DIR = ".algolia-wizard/data";
-var RECORD_MODEL = "claude-haiku-4-5";
 var MAX_RECORDS = 100;
 var BATCH_SIZE = 10;
 var MAX_BATCH_ATTEMPTS = 3;
@@ -3737,9 +3965,21 @@ function generateRecordTool(ctx, createModel = defaultCreateModel2) {
         const generateBatch = async (batchCount) => {
           let lastError;
           for (let attempt = 1; attempt <= MAX_BATCH_ATTEMPTS; attempt++) {
+            const profile = getModelProfile("quick" /* quick */);
+            const modelOptions = providerOptionsForProfile("quick" /* quick */);
+            const startedAt = Date.now();
             try {
-              const { output } = await generateText2({
-                model: anthropic(RECORD_MODEL),
+              const { output, usage } = await generateText2({
+                model: anthropic(profile.model),
+                maxOutputTokens: profile.maxOutputTokens,
+                providerOptions: {
+                  anthropic: {
+                    thinking: modelOptions.thinking,
+                    ...modelOptions.effort !== void 0 && {
+                      effort: modelOptions.effort
+                    }
+                  }
+                },
                 output: Output2.object({
                   schema: z17.object({
                     records: z17.array(recordSchema2).length(batchCount)
@@ -3751,9 +3991,23 @@ function generateRecordTool(ctx, createModel = defaultCreateModel2) {
                   `Variety seed: ${nanoid2()}. Use it to diversify values.`
                 ].filter(Boolean).join("\n")
               });
+              trackAgentRun({
+                operation: "sample-record-generation",
+                profile: "quick" /* quick */,
+                attempt,
+                durationMs: Date.now() - startedAt,
+                usage
+              });
               return output.records;
             } catch (err) {
               if (!NoObjectGeneratedError.isInstance(err)) throw err;
+              trackAgentRun({
+                operation: "sample-record-generation",
+                profile: "quick" /* quick */,
+                attempt,
+                durationMs: Date.now() - startedAt,
+                usage: err.usage
+              });
               lastError = err;
               logger.warn(
                 { entityName, batchCount, attempt, err },
@@ -3867,14 +4121,10 @@ var FS_READ_TOOLS = [
 ];
 
 // src/lib/agent.ts
-var MODEL_BY_SIZE = {
-  small: "claude-haiku-4-5",
-  medium: "claude-sonnet-4-6",
-  large: "claude-opus-4-8"
-};
 var MISSING_REPORT_STATUS_ERROR_MESSAGE = "Agent finished without calling reportStatus";
 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 ATTEMPT_NUMBER_OFFSET = 1;
 var PROVIDER_ERROR_USER_MESSAGE = "The AI service had trouble responding. Run the wizard again to retry this step.";
 function retryKind(err) {
   if (err instanceof Error && err.message === MISSING_REPORT_STATUS_ERROR_MESSAGE) {
@@ -3907,7 +4157,20 @@ async function runAgent(req) {
 }
 async function runAgentAttempt(req, attempt) {
   const start = Date.now();
-  logger.info({ startedAt: new Date(start).toISOString() }, "runAgent started");
+  const profileName = req.modelProfile ?? "implementation" /* implementation */;
+  const profile = getModelProfile(profileName);
+  const modelOptions = providerOptionsForProfile(profileName);
+  logger.info(
+    {
+      startedAt: new Date(start).toISOString(),
+      operation: req.operation,
+      profile: profileName,
+      model: profile.model,
+      effort: profile.effort,
+      thinking: profile.thinking
+    },
+    "runAgent started"
+  );
   const token = getAuthToken();
   if (!token) {
     throw new Error("Not authenticated: no user token available");
@@ -3934,7 +4197,16 @@ async function runAgentAttempt(req, attempt) {
     ] : []
   ];
   const agent = new ToolLoopAgent({
-    model: anthropic(MODEL_BY_SIZE[req.modelSize ?? "medium"]),
+    model: anthropic(profile.model),
+    maxOutputTokens: profile.maxOutputTokens,
+    providerOptions: {
+      anthropic: {
+        thinking: modelOptions.thinking,
+        ...modelOptions.effort !== void 0 && {
+          effort: modelOptions.effort
+        }
+      }
+    },
     // Cache tools + system on the last system block. Tools render before
     // system, so one breakpoint here caches both, reused on every loop turn
     // after the first.
@@ -3955,7 +4227,10 @@ async function runAgentAttempt(req, attempt) {
       tools: req.tools
     }),
     toolChoice: "required",
-    stopWhen: [hasToolCall("reportStatus")]
+    stopWhen: [
+      hasToolCall("reportStatus"),
+      stepCountIs(profile.maxSteps)
+    ]
   });
   const stream = await agent.stream({
     prompt: "Follow system instructions"
@@ -3986,13 +4261,20 @@ async function runAgentAttempt(req, attempt) {
   }
   const end = Date.now();
   const usage = await stream.totalUsage;
+  trackAgentRun({
+    operation: req.operation,
+    profile: profileName,
+    attempt: attempt + ATTEMPT_NUMBER_OFFSET,
+    durationMs: end - start,
+    usage
+  });
   logger.info(
     {
       finishedAt: new Date(end).toISOString(),
       durationMs: end - start,
-      // cachedInputTokens > 0 confirms prompt caching engaged. If it stays 0
-      // across turns, the tools+system prefix is under the model's min
-      // cacheable size (2048 tokens for sonnet-4-6) and caching is a no-op.
+      operation: req.operation,
+      profile: profileName,
+      model: profile.model,
       usage
     },
     "runAgent finished"
@@ -4073,6 +4355,7 @@ function prioritizeFrontendFrameworks(result) {
 }
 var detectLanguage = async () => {
   const result = await runAgent({
+    operation: "language-detection",
     instructions: [
       "Analyze the codebase and determine the programming languages and frameworks used",
       "If a superset language is found, exclude the subset language (e.g. TypeScript over JavaScript).",
@@ -4088,7 +4371,7 @@ var detectLanguage = async () => {
     ],
     tools: ["listFiles", "changeDirectory", "readFile", "searchFiles"],
     outputSchema: detectLanguageSchema,
-    modelSize: "small"
+    modelProfile: "quick" /* quick */
   });
   return prioritizeFrontendFrameworks(result);
 };
@@ -4164,9 +4447,11 @@ var MODE_CONFIG = {
 function runMode(mode, extraInstructions = []) {
   const { instructions, outputSchema } = MODE_CONFIG[mode];
   return runAgent({
+    operation: `code-analysis-${mode}`,
     instructions: [...instructions, ...extraInstructions],
     tools: READONLY_TOOLS,
-    outputSchema
+    outputSchema,
+    modelProfile: "analysis" /* analysis */
   });
 }
 async function runAnalysis(mode, extraInstructions = []) {
@@ -4544,6 +4829,7 @@ ${JSON.stringify(s.output, null, 2)}`
 }
 var reviewStep = async (ctx, options) => {
   const result = await runAgent({
+    operation: "workflow-review",
     instructions: [
       "Summarize what was accomplished in the workflow, leaving out verbose details.",
       "Base your summary only on the step outputs provided \u2014 do not read the repository.",
@@ -4558,7 +4844,7 @@ ${formatCompletedSteps(ctx.completedSteps)}`,
     ],
     tools: [],
     outputSchema: reviewSchema,
-    modelSize: "small"
+    modelProfile: "quick" /* quick */
   });
   ctx.clearNotices();
   useWizard.getState().setReview(result);
@@ -4568,7 +4854,7 @@ ${formatCompletedSteps(ctx.completedSteps)}`,
 // src/actions/implement.ts
 import z28 from "zod";
 import { access, mkdir as mkdir5, readFile as readFile8 } from "node:fs/promises";
-import { join as join10, relative as relative6 } from "node:path";
+import { dirname as dirname5, isAbsolute as isAbsolute3, join as join10, relative as relative6, resolve as resolve4, sep as sep2 } from "node:path";
 
 // src/lib/git.ts
 import { execFile as execFile2 } from "node:child_process";
@@ -4576,7 +4862,7 @@ import { copyFile, mkdir as mkdir4, stat as stat3 } from "node:fs/promises";
 import { basename as basename2, dirname as dirname3, isAbsolute as isAbsolute2, join as join8, resolve as resolve3 } from "node:path";
 var MAX_BUFFER = 32 * 1024 * 1024;
 function git(args) {
-  return new Promise((resolve4, reject) => {
+  return new Promise((resolve5, reject) => {
     execFile2("git", args, { maxBuffer: MAX_BUFFER }, (err, stdout, stderr) => {
       if (err)
         return reject(
@@ -4584,7 +4870,7 @@ function git(args) {
             `git ${args.join(" ")} failed: ${stderr.toString().trim() || err.message}`
           )
         );
-      resolve4(stdout.toString());
+      resolve5(stdout.toString());
     });
   });
 }
@@ -4739,6 +5025,7 @@ var validationOutputSchema = z28.object({
   unrelatedFailure: z28.string().optional()
 });
 var MAX_IMPLEMENT_VALIDATION_ATTEMPTS = 3;
+var FIRST_IMPLEMENTATION_ATTEMPT = 1;
 var DEFAULT_IMPLEMENT_USE_CASES = ["ingestion", "search"];
 var INGEST_DIR = ".algolia-wizard";
 var INGESTION_SOURCE_PROMPT = "What data do you want to index?";
@@ -4846,12 +5133,22 @@ function searchInstructions(input) {
   const entity = input.findings.confirmedEntities ? input.findings.confirmedEntities[0].name : null;
   const attributes = input.findings.confirmedEntities ? input.findings.confirmedEntities[0].attributes : null;
   const entitySchemaMessage = entity && attributes ? `The following entity schema should be used to build the UI: ${JSON.stringify({ entity, attributes })}` : null;
-  const doc = getFrameworkSpecificDoc(frameworksForDoc(input.language));
+  const packageManagedInstructions = input.frontendHasPackageJson ? packageSearchInstructions(input) : cdnSearchInstructions(input);
   return [
     "Implement an in-app Algolia search experience.",
     entitySchemaMessage ?? "",
     `Build the search UI for ${input.searchUiTarget}.`,
     "Create search UI only. Do not create or modify ingestion scripts, rake/manage/CLI tasks, migrations, seeders, or other data-loading code, even if the data looks incomplete.",
+    ...packageManagedInstructions,
+    "Meet WCAG AA contrast (4.5:1 body text, 3:1 large text/icons) between the panel's text and its own background, and give the input and the active result a focus indicator visible against whatever sits behind it. Style the panel through the widget's class and CSS-variable overrides (or, when hand-built, the app's existing theme tokens) \u2014 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 a min-width of 320px independent of the input, anchored to the input edge it opens from so widening does not push it off-screen.",
+    "Match the styles of the application as closely as possible.",
+    "The summary should be extremely concise; do not mention manual testing steps."
+  ];
+}
+function packageSearchInstructions(input) {
+  const doc = getFrameworkSpecificDoc(frameworksForDoc(input.language));
+  return [
     ...doc ? [
       "Follow the Algolia SDK reference below for client setup, search UI wiring, and Insights instrumentation \u2014 Insights is required, not optional; prefer the reference over prior knowledge:",
       doc
@@ -4862,16 +5159,22 @@ function searchInstructions(input) {
     `Import and render the new component in ${input.searchLocation ? `"${input.searchLocation}"` : "the best, always-rendered layout location (e.g. a header/nav component)"} so it is reachable across the app \u2014 at least a working search input and results panel against the target index.`,
     "If a search box already exists, replace its usage with an import and render of your new component; remove the old implementation.",
     "When rendering results with an existing shared component (e.g. a card), import and reuse that component rather than inlining its markup \u2014 inlining silently drops the styles and behavior its own file provides.",
-    "Meet WCAG AA contrast (4.5:1 body text, 3:1 large text/icons) between the panel's text and its own background, and give the input and the active result a focus indicator visible against whatever sits behind it. Style the panel through the widget's class and CSS-variable overrides (or, when hand-built, the app's existing theme tokens) \u2014 never assume a light surface or reuse the surrounding page's colors unchanged inside the panel.",
     "Vendor theme CSS, and any CSS you write against vendor class names, must be global: import the theme from the component's own script module or the app's global stylesheet, and put overrides in a global block (Astro <style is:global>, an unscoped Vue block, a plain global CSS file). Never a framework-scoped style block or a CSS Module \u2014 scoping rewrites the vendor selectors and the widget's runtime DOM carries no scope attribute, so not one rule matches: styling silently does nothing and the build still passes.",
-    "The panel takes its width from the input by default, so a small input makes it unreadably narrow: give it a min-width of 320px independent of the input, anchored to the input edge it opens from so widening does not push it off-screen.",
     `Define ${SEARCH_CONFIG_APP_ID}, ${SEARCH_CONFIG_SEARCH_KEY}, and ${SEARCH_CONFIG_INDEX_NAME} as exported constants in a module that fits this project's existing conventions for shared client-side config \u2014 reuse an existing one if it already holds config like this, or add a small new one otherwise. These are PUBLIC values, safe to commit and expose client-side: never read them from an environment variable or a .env* file, and never hardcode them anywhere except in that one module (import them wherever the search client needs them).`,
     `Set ${SEARCH_CONFIG_APP_ID} to "${input.appId}" and ${SEARCH_CONFIG_INDEX_NAME} to "${input.targetIndex}".`,
     input.searchKey ? `Set ${SEARCH_CONFIG_SEARCH_KEY} to "${input.searchKey}".` : `A real search-only key could not be provisioned${input.searchKeyError ? ` (${input.searchKeyError})` : ""} \u2014 set ${SEARCH_CONFIG_SEARCH_KEY} to the placeholder "${SEARCH_KEY_PLACEHOLDER}" and add a prominent TODO for the developer to fill in a real one.`,
     'Report the repo-relative path of that module as "searchConfigFile" in your final status.',
-    "Install any Algolia packages you import with the project's own package manager via runShell, and declare them in the project's dependency manifest.",
-    "Match the styles of the application as closely as possible.",
-    "The summary should be extremely concise; do not mention manual testing steps."
+    "Install any Algolia packages you import with the project's own package manager via runShell, and declare them in the project's dependency manifest."
+  ];
+}
+function cdnSearchInstructions(input) {
+  return [
+    `The target frontend has no package.json. Add the search container to its existing HTML or template, create separate classic config and search scripts, define window.${SEARCH_CONFIG_APP_ID}, window.${SEARCH_CONFIG_SEARCH_KEY}, and window.${SEARCH_CONFIG_INDEX_NAME} in the config script, and report that script as "searchConfigFile". Never create package.json, create a component, use imports or exports, or run npm, pnpm, yarn, or bun.`,
+    `Set window.${SEARCH_CONFIG_APP_ID} to "${input.appId}" and window.${SEARCH_CONFIG_INDEX_NAME} to "${input.targetIndex}".`,
+    input.searchKey ? `Set window.${SEARCH_CONFIG_SEARCH_KEY} to "${input.searchKey}".` : `A real search-only key could not be provisioned${input.searchKeyError ? ` (${input.searchKeyError})` : ""} \u2014 set window.${SEARCH_CONFIG_SEARCH_KEY} to the placeholder "${SEARCH_KEY_PLACEHOLDER}" and add a prominent TODO for the developer to fill in a real one.`,
+    'Load these exact pinned tags in order before the config and search scripts: <script src="https://cdn.jsdelivr.net/npm/algoliasearch@5.59.0/dist/lite/builds/browser.umd.js" integrity="sha256-pduQHl1jn0IaN/BIpSotQm7Y5THdpKcX3Bw6xdRteRw=" crossorigin="anonymous"></script> then <script src="https://cdn.jsdelivr.net/npm/instantsearch.js@4.117.0/dist/instantsearch.production.min.js" integrity="sha256-5zhKxAGeH7ThWfnmdD4pS1gsmafE2b8aWRsq8set/dc=" crossorigin="anonymous"></script>.',
+    'When using the InstantSearch theme, load this exact tag before the application styles: <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/instantsearch.css@8.22.1/themes/satellite-min.css" integrity="sha256-5/eHPZl63VYJSDVOKrOgGe/5+owUkX3uPAW6+XYeLNc=" crossorigin="anonymous">. Never use an unversioned or differently versioned theme URL, and never omit its integrity attribute.',
+    `In that classic search script, use window['algoliasearch/lite'].liteClient and window.instantsearch. Add window.instantsearch.widgets.autocomplete as the only search widget. Configure it with container '#autocomplete', placeholder 'Search...', and an indices array containing one object whose indexName is window.${SEARCH_CONFIG_INDEX_NAME}; put item and noResults functions in its templates option, implement getURL only for an existing route, and match the item template to the entity schema. Keep insights: true and call search.start(). Do not substitute searchBox or hits, omit indices, use imports or exports, or use type="module".`
   ];
 }
 function validationInstructions(input) {
@@ -4883,6 +5186,9 @@ function validationInstructions(input) {
     "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.",
     `Available type-check and lint tools: ${JSON.stringify(input.findings.verification ?? [])}.`,
+    ...!input.frontendHasPackageJson ? [
+      "The frontend has no package.json: never create one or run npm, pnpm, yarn, or bun. Validate the CDN implementation by inspecting its HTML or template and classic scripts for the search container, Algolia \u2192 InstantSearch \u2192 config \u2192 search load order, browser globals, autocomplete widget configuration, search.start(), and exact pinned CDN URLs and integrity attributes for every Algolia script or stylesheet. Source inspection is required even when the project has no automated checks. window.instantsearch.widgets.autocomplete is a real widget in the pinned InstantSearch build; do not report its use as an error, and do not fetch a remote bundle or URL to verify it."
+    ] : [],
     "Always call reportStatus with status=success after validation, even when sufficient=false.",
     "Set sufficient=true only when the search bar is unique, correctly placed, and structurally complete.",
     "Set sufficient=false for an implementation issue. Include concrete additionalInstructions for the next pass.",
@@ -5038,11 +5344,25 @@ async function pathExists(path) {
     return false;
   }
 }
+async function frontendHasPackageJson(repoRoot, searchLocation) {
+  let directory = repoRoot;
+  if (searchLocation) {
+    const candidate = dirname5(resolve4(repoRoot, searchLocation));
+    const candidateRelative = relative6(repoRoot, candidate);
+    const outsideRoot = candidateRelative === ".." || candidateRelative.startsWith(`..${sep2}`) || isAbsolute3(candidateRelative);
+    if (!outsideRoot) directory = candidate;
+  }
+  for (; ; ) {
+    if (await pathExists(join10(directory, "package.json"))) return true;
+    if (directory === repoRoot) return false;
+    directory = dirname5(directory);
+  }
+}
 async function resolveBuildCheckPlan(ctx, repoRoot, input) {
   if (!input.findings.verification?.length) {
     return { run: false, installDependencies: false };
   }
-  const installDependencies = isJsProject(input.language) && !await pathExists(join10(repoRoot, "node_modules"));
+  const installDependencies = input.frontendHasPackageJson && isJsProject(input.language) && !await pathExists(join10(repoRoot, "node_modules"));
   const accepted = Boolean(
     await ctx.requestUserInput({
       prompt: installDependencies ? MISSING_DEPENDENCIES_PROMPT : BUILD_CHECK_PROMPT,
@@ -5220,7 +5540,11 @@ async function implement(ctx, useCases = DEFAULT_IMPLEMENT_USE_CASES) {
     ingestDir: INGEST_DIR,
     ingestionSource,
     uploadFilePath,
-    searchUiTarget: searchUiTarget(language)
+    searchUiTarget: searchUiTarget(language),
+    frontendHasPackageJson: await frontendHasPackageJson(
+      repoRoot,
+      searchLocation
+    )
   };
   let agentRuns = 0;
   let ingestCommand;
@@ -5235,10 +5559,11 @@ async function implement(ctx, useCases = DEFAULT_IMPLEMENT_USE_CASES) {
     [INDEX_NAME_VAR]: targetIndex
   })) : void 0;
   const searchTools = makeToolContext(repoRoot);
-  async function runImplementationUseCase(currentUseCase, extraInstructions = []) {
+  async function runImplementationUseCase(currentUseCase, extraInstructions = [], isRetry = false) {
     if (agentRuns > 0) ctx.recordStepExecution();
     agentRuns += 1;
     return runAgent({
+      operation: `${currentUseCase}-implementation`,
       instructions: buildAgentInstructions(
         currentUseCase,
         input,
@@ -5246,6 +5571,7 @@ async function implement(ctx, useCases = DEFAULT_IMPLEMENT_USE_CASES) {
       ),
       tools: toolsForUseCase(currentUseCase, input.ingestionSource),
       outputSchema: implementationOutputSchema,
+      modelProfile: isRetry ? "implementationRetry" /* implementationRetry */ : "implementation" /* implementation */,
       toolContext: currentUseCase === "ingestion" ? ingestionTools ?? searchTools : searchTools
     });
   }
@@ -5253,6 +5579,7 @@ async function implement(ctx, useCases = DEFAULT_IMPLEMENT_USE_CASES) {
     if (agentRuns > 0) ctx.recordStepExecution();
     agentRuns += 1;
     return runAgent({
+      operation: "search-validation",
       instructions: buildAgentInstructions(
         "validation",
         input,
@@ -5260,6 +5587,7 @@ async function implement(ctx, useCases = DEFAULT_IMPLEMENT_USE_CASES) {
       ),
       tools: toolsForUseCase("validation"),
       outputSchema: validationOutputSchema,
+      modelProfile: "validation" /* validation */,
       toolContext: searchTools
     });
   }
@@ -5393,8 +5721,8 @@ ${detail}` : ""}`
       });
     };
     useWizard.getState().clearWrittenFiles();
-    for (let attempt = 1; attempt <= MAX_IMPLEMENT_VALIDATION_ATTEMPTS; attempt++) {
-      if (attempt > 1) {
+    for (let attempt = FIRST_IMPLEMENTATION_ATTEMPT; attempt <= MAX_IMPLEMENT_VALIDATION_ATTEMPTS; attempt++) {
+      if (attempt > FIRST_IMPLEMENTATION_ATTEMPT) {
         logger.info(
           {
             attempt,
@@ -5406,7 +5734,8 @@ ${detail}` : ""}`
       }
       const searchResult = await runImplementationUseCase(
         "search",
-        extraInstructions
+        extraInstructions,
+        attempt > FIRST_IMPLEMENTATION_ATTEMPT
       );
       summaries.push(formatSummary("search", searchResult.summary));
       if (searchResult.searchConfigFile) {
@@ -5800,7 +6129,7 @@ function getWorkflow(id) {
 }
 
 // src/ui/Welcome.tsx
-import { dirname as dirname5, join as join11 } from "node:path";
+import { dirname as dirname6, join as join11 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 import { useState as useState10 } from "react";
 import { Box as Box11, Spacer, Text as Text12, useInput as useInput6, useWindowSize as useWindowSize5 } from "ink";
@@ -5832,7 +6161,7 @@ var sidebarItems = [
 // src/ui/Welcome.tsx
 import Image, { TerminalInfoContext, defaultTerminalInfo } from "ink-picture";
 import { jsx as jsx10, jsxs as jsxs11 } from "react/jsx-runtime";
-var IMAGE_PATH = join11(dirname5(fileURLToPath2(import.meta.url)), "algolia.png");
+var IMAGE_PATH = join11(dirname6(fileURLToPath2(import.meta.url)), "algolia.png");
 var TERMINAL_INFO = {
   ...defaultTerminalInfo,
   supportsUnicode: true,
@@ -7150,11 +7479,11 @@ async function requestTerminalSize(stdout = process.stdout, {
   stdout.write("\x1B[2J\x1B[H");
 }
 function waitForResize(stdout, timeoutMs) {
-  return new Promise((resolve4) => {
+  return new Promise((resolve5) => {
     const finish = (didResize) => () => {
       clearTimeout(timer);
       stdout.off("resize", onResize);
-      resolve4(didResize);
+      resolve5(didResize);
     };
     const onResize = finish(true);
     const timer = setTimeout(finish(false), timeoutMs);
@@ -7162,15 +7491,15 @@ function waitForResize(stdout, timeoutMs) {
   });
 }
 function delay(ms) {
-  return new Promise((resolve4) => {
-    setTimeout(resolve4, ms);
+  return new Promise((resolve5) => {
+    setTimeout(resolve5, ms);
   });
 }
 
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "@algolia/wizard",
-  version: "0.66.0",
+  version: "0.68.0",
   description: "Magically implement Algolia functionality in your codebase",
   type: "module",
   engines: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@algolia/wizard",
-  "version": "0.66.0",
+  "version": "0.68.0",
   "description": "Magically implement Algolia functionality in your codebase",
   "type": "module",
   "engines": {