@algolia/wizard 0.40.0 → 0.41.0-rc.131.289

package/dist/main.js

@@ -259,10 +259,14 @@ var useWizard = create((set, get) => ({
   error: null,
   inputReq: null,
   _resolve: null,
+  settingUpAppId: null,
+  setSettingUpApp: (appId) => set({ settingUpAppId: appId }),
   // `endAuth` lands on 'preflight', not 'idle': sign-in happens after the
   // welcome screen, so going back would gate the run a second time.
   beginAuth: () => set({ phase: "authenticating", cliOutput: [] }),
-  endAuth: () => set((s) => s.phase === "authenticating" ? { phase: "preflight" } : {}),
+  endAuth: () => set(
+    (s) => s.phase === "authenticating" ? { phase: "preflight", cliOutput: [] } : {}
+  ),
   confirmStart: () => set(
     (s) => s.phase === "idle" ? { phase: "preflight", homeScreen: "home" } : {}
   ),
@@ -409,7 +413,8 @@ var useWizard = create((set, get) => ({
       logs: [],
       error: null,
       inputReq: null,
-      _resolve: null
+      _resolve: null,
+      settingUpAppId: null
     });
   }
 }));
@@ -657,25 +662,27 @@ function SelectRow({
   labelWidth,
   highlightBackground = true,
   usePadding = false,
+  disabled = false,
   children
 }) {
-  const labelColor = highlighted ? highlightBackground ? COLORS.highlight.fg : COLORS.success : COLORS.primary;
+  const active = highlighted && !disabled;
+  const labelColor = disabled ? COLORS.dim : active ? highlightBackground ? COLORS.highlight.fg : COLORS.success : COLORS.primary;
   return /* @__PURE__ */ jsxs3(
     Box4,
     {
       width,
       paddingX: usePadding ? 1 : 0,
       paddingY: usePadding ? 1 : 0,
-      backgroundColor: highlighted && highlightBackground ? COLORS.highlight.bg : void 0,
+      backgroundColor: active && highlightBackground ? COLORS.highlight.bg : void 0,
       children: [
         /* @__PURE__ */ jsx3(Box4, { width: labelWidth, children: /* @__PURE__ */ jsxs3(
           Text4,
           {
             color: labelColor,
-            bold: highlighted && !highlightBackground,
+            bold: active && !highlightBackground,
             wrap: "truncate",
             children: [
-              highlighted ? "\u276F   " : "    ",
+              active ? "\u276F   " : "    ",
               label
             ]
           }
@@ -875,6 +882,14 @@ var ARROW_WIDTH = 4;
 var COLUMN_GAP = 2;
 var BAR_PADDING = 2;
 var ROW_HEIGHT = 3;
+function nextSelectableIndex(start, dir, rowCount, isDisabled) {
+  let i = start;
+  for (let step = 0; step < rowCount; step++) {
+    i = (i + dir + rowCount) % rowCount;
+    if (!isDisabled(i)) return i;
+  }
+  return start;
+}
 function SelectPrompt({
   options,
   onSelect,
@@ -886,15 +901,18 @@ function SelectPrompt({
   multi,
   cancelable,
   secondary,
+  disabled,
   defaultSelectedIndex = 0
 }) {
-  const [index, setIndex] = useState5(
-    () => defaultSelectedIndex > 0 && defaultSelectedIndex < options.length ? defaultSelectedIndex : 0
-  );
-  const [checked, setChecked] = useState5(() => /* @__PURE__ */ new Set());
   const hasCancel = Boolean(multi || cancelable);
   const rows = hasCancel ? [...options, "Cancel"] : options;
   const cancelIndex = hasCancel ? options.length : -1;
+  const isDisabled = (i) => i !== cancelIndex && Boolean(disabled?.[i]);
+  const [index, setIndex] = useState5(() => {
+    const start = defaultSelectedIndex > 0 && defaultSelectedIndex < options.length ? defaultSelectedIndex : 0;
+    return isDisabled(start) ? nextSelectableIndex(start, 1, rows.length, isDisabled) : start;
+  });
+  const [checked, setChecked] = useState5(() => /* @__PURE__ */ new Set());
   const hints = [];
   if (rows.length > 1) hints.push({ key: "[\u2191] [\u2193]", label: "move" });
   if (multi) hints.push({ key: "[space]", label: "select" });
@@ -934,9 +952,15 @@ function SelectPrompt({
   useInput2((input, key) => {
     if (rows.length === 0) return;
     if (key.upArrow || input === "k") {
-      setIndex((i) => (i - 1 + rows.length) % rows.length);
+      setIndex((i) => {
+        const next = (i - 1 + rows.length) % rows.length;
+        return isDisabled(next) ? i : next;
+      });
     } else if (key.downArrow || input === "j") {
-      setIndex((i) => (i + 1) % rows.length);
+      setIndex((i) => {
+        const next = (i + 1) % rows.length;
+        return isDisabled(next) ? i : next;
+      });
     } else if (multi && input === " " && index !== cancelIndex) {
       setChecked((prev) => {
         const next = new Set(prev);
@@ -947,6 +971,7 @@ function SelectPrompt({
     } else if (key.return) {
       if (index === cancelIndex) {
         onSelect(CANCEL);
+      } else if (isDisabled(index)) {
       } else if (!multi) {
         onSelect(options[index]);
       } else if (checked.size > 0) {
@@ -971,10 +996,12 @@ function SelectPrompt({
       const bullet = multi && !isCancel ? checked.has(i) ? "\u25CF " : "\u25CB " : "";
       const sec = isCancel ? void 0 : secondary?.[i];
       const isText = sec?.kind === "text";
+      const rowDisabled = isDisabled(i);
       return /* @__PURE__ */ jsxs7(
         SelectRow,
         {
           highlighted,
+          disabled: rowDisabled,
           width: isText ? "100%" : barWidth,
           labelWidth: isText ? labelWidth : barLabelWidth,
           label: `${bullet}${option}`,
@@ -984,7 +1011,7 @@ function SelectPrompt({
               Text8,
               {
                 wrap: "truncate",
-                color: highlighted ? COLORS.primary : COLORS.muted,
+                color: rowDisabled ? COLORS.dim : highlighted ? COLORS.primary : COLORS.muted,
                 children: sec.value
               }
             ) }),
@@ -1046,6 +1073,7 @@ function PromptInput() {
         table: inputReq.table,
         options: inputReq.options,
         secondary: inputReq.secondary,
+        disabled: inputReq.disabled,
         defaultSelectedIndex: inputReq.defaultSelectedIndex,
         cancelable: inputReq.cancelable,
         error: inputReq.error,
@@ -1417,6 +1445,44 @@ function trackActionEnd(ctx) {
     metricTags(ctx.workflowId, ctx.actionId)
   );
 }
+var MAX_ATTRIBUTE_LENGTH = 500;
+function truncate2(value) {
+  return value.length <= MAX_ATTRIBUTE_LENGTH ? value : `${value.slice(0, MAX_ATTRIBUTE_LENGTH - 3)}...`;
+}
+function readString(source, key) {
+  const value = Reflect.get(source, key);
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function causeAttributes(cause) {
+  if (cause instanceof Error) {
+    return {
+      error_cause_name: cause.name,
+      error_cause: truncate2(cause.message)
+    };
+  }
+  return typeof cause === "string" ? { error_cause: truncate2(cause) } : {};
+}
+function providerAttributes(source) {
+  const statusCode = Reflect.get(source, "statusCode");
+  const isRetryable = Reflect.get(source, "isRetryable");
+  const url = readString(source, "url");
+  const responseBody = readString(source, "responseBody");
+  return {
+    ...typeof statusCode === "number" && Number.isFinite(statusCode) && { error_status_code: statusCode },
+    ...typeof isRetryable === "boolean" && { error_retryable: isRetryable },
+    ...url && { error_url: truncate2(url) },
+    ...responseBody && { error_response_body: truncate2(responseBody) }
+  };
+}
+function errorAttributes(err) {
+  if (!(err instanceof Error)) return {};
+  const { cause } = err;
+  return {
+    error_name: err.name,
+    ...causeAttributes(cause),
+    ...providerAttributes(cause instanceof Error ? cause : err)
+  };
+}
 function trackActionError(ctx) {
   const attributes = {
     event: "wizard.action.error",
@@ -1424,7 +1490,8 @@ function trackActionError(ctx) {
     action_id: ctx.actionId,
     action_title: ctx.actionTitle,
     error: ctx.error,
-    app_id: ctx.appId
+    app_id: ctx.appId,
+    ...errorAttributes(ctx.cause)
   };
   emitTelemetryLog(
     "error",
@@ -1460,7 +1527,8 @@ function trackWorkflowError(ctx) {
     workflow_id: ctx.workflowId,
     action_id: ctx.actionId,
     error: ctx.error,
-    app_id: ctx.appId
+    app_id: ctx.appId,
+    ...errorAttributes(ctx.cause)
   };
   emitTelemetryLog(
     "error",
@@ -1524,6 +1592,10 @@ function reconcileWorkflowState(state, workflow) {
   }
   return state;
 }
+async function loadResumableState(workflow) {
+  const persisted = await loadWorkflowState(workflow.id);
+  return persisted ? reconcileWorkflowState(persisted, workflow) : null;
+}
 function initWorkflowState(workflow, now) {
   return {
     workflowId: workflow.id,
@@ -1626,11 +1698,11 @@ async function runStep(state, index, step, appId) {
     durationMs: Date.now() - startedAt
   });
 }
-async function runWorkflow(workflow, appId) {
+async function runWorkflow(workflow, appId, resumableState) {
   const store = useWizard.getState();
   try {
-    const persisted = await loadWorkflowState(workflow.id);
-    const state = (persisted && reconcileWorkflowState(persisted, workflow)) ?? initWorkflowState(workflow, nowIso());
+    const resolved2 = resumableState !== void 0 ? resumableState : await loadResumableState(workflow);
+    const state = resolved2 ?? initWorkflowState(workflow, nowIso());
     ensureExecutedStepCount(state);
     store.startWorkflow(
       {
@@ -1686,14 +1758,16 @@ async function runWorkflow(workflow, appId) {
         appId,
         actionId: failedActionId,
         actionTitle: failedActionTitle,
-        error: message
+        error: message,
+        cause: err
       });
     }
     trackWorkflowError({
       workflowId: workflow.id,
       appId,
       error: message,
-      actionId: failedActionId
+      actionId: failedActionId,
+      cause: err
     });
     track("Error", {
       step,
@@ -1720,14 +1794,89 @@ async function listIndices() {
   return items.map((i) => ({ name: i.name, entries: i.entries })).sort((a, b) => a.name.localeCompare(b.name));
 }
 
+// src/lib/algoliaApp.ts
+import { z as z5 } from "zod";
+var applicationSchema = z5.object({
+  id: z5.string().min(1),
+  name: z5.string().default(""),
+  plan: z5.string().optional()
+});
+var listSchema = z5.array(
+  z5.object({
+    id: z5.string().min(1),
+    name: z5.string().default(""),
+    plan_label: z5.string().optional(),
+    status: z5.string().optional(),
+    acl: z5.array(z5.string()).optional()
+  }).transform(({ id, name, plan_label, status, acl }) => ({
+    id,
+    name,
+    plan: plan_label,
+    status,
+    acl
+  }))
+);
+function canSelectApplication(app) {
+  return app.status === "active" && (app.acl ?? []).includes("keys");
+}
+async function currentApplication() {
+  let raw;
+  try {
+    raw = await runAlgoliaCli(["application", "current", "-o", "json"]);
+  } catch {
+    return null;
+  }
+  const parsed = applicationSchema.safeParse(parseJson(raw));
+  return parsed.success ? parsed.data : null;
+}
+async function requireApplication() {
+  const app = await currentApplication();
+  if (!app) {
+    throw new Error(
+      "No Algolia application is selected. Run `npx @algolia/cli@latest application select` and restart the wizard."
+    );
+  }
+  return app;
+}
+async function listApplications() {
+  const raw = await runAlgoliaCli(["application", "list", "-o", "json"]);
+  const parsed = listSchema.safeParse(parseJson(raw));
+  if (!parsed.success) {
+    throw new Error("Could not read the list of Algolia applications.");
+  }
+  return parsed.data;
+}
+async function selectApplication(id) {
+  const raw = await runAlgoliaCli(
+    ["application", "select", "--non-interactive", "--app-id", id],
+    { onOutput: stderrSink }
+  );
+  const parsed = applicationSchema.safeParse(parseJson(raw));
+  if (!parsed.success) {
+    throw new Error(
+      `Selected application ${id}, but the Algolia CLI returned an unreadable result.`
+    );
+  }
+  return parsed.data;
+}
+function parseJson(text) {
+  try {
+    return JSON.parse(text);
+  } catch {
+    return void 0;
+  }
+}
+
 // src/actions/selectIndex.ts
 var CREATE_NEW_INDEX = "Create a new index\u2026";
 var selectIndexStep = async (ctx) => {
+  await requireApplication();
   const indices = await listIndices();
   const names = indices.map((i) => i.name);
   const hasIndices = names.length > 0;
   let error;
-  for (; ; ) {
+  let chosen;
+  while (chosen === void 0) {
     const selection = hasIndices ? await ctx.requestUserInput({
       prompt: "Which index do you want to ingest into?",
       promptType: "multipleChoice",
@@ -1746,9 +1895,9 @@ var selectIndexStep = async (ctx) => {
     if (typeof selection !== "string") {
       throw new Error("selectIndex received an unexpected non-text result");
     }
-    let chosen;
+    let candidate;
     if (!hasIndices) {
-      chosen = selection.trim();
+      candidate = selection.trim();
     } else if (selection === CREATE_NEW_INDEX) {
       const name = await ctx.requestUserInput({
         prompt: "Name the new index:",
@@ -1758,21 +1907,28 @@ var selectIndexStep = async (ctx) => {
       if (typeof name !== "string") {
         throw new Error("selectIndex received an unexpected non-text result");
       }
-      chosen = name.trim();
+      candidate = name.trim();
     } else {
-      chosen = selection;
+      candidate = selection;
     }
-    if (!chosen) {
+    if (!candidate) {
       error = "Index name cannot be empty.";
       continue;
     }
-    ctx.setUserInput("index", chosen);
-    return { selection: chosen };
+    chosen = candidate;
   }
+  ctx.setUserInput("index", chosen);
+  return { selection: chosen };
 };
 
 // src/lib/agent.ts
-import { ToolLoopAgent, hasToolCall, Output as Output3 } from "ai";
+import {
+  ToolLoopAgent,
+  hasToolCall,
+  Output as Output3,
+  APICallError,
+  NoOutputGeneratedError
+} from "ai";
 import { createAnthropic as createAnthropic3 } from "@ai-sdk/anthropic";
 import "zod";
 
@@ -1781,7 +1937,7 @@ import "zod";
 
 // src/lib/tools/listFiles.ts
 import { tool } from "ai";
-import z5 from "zod";
+import z6 from "zod";
 import { readdir } from "node:fs/promises";
 
 // src/lib/tools/path.ts
@@ -1817,8 +1973,8 @@ async function hasSymlinkParent(ctx, target) {
 function listFilesTool(ctx) {
   return tool({
     description: 'List files in a directory (default: the current working directory). Pass path to list a subdirectory directly \u2014 e.g. "packages/api" \u2014 without first changeDirectory-ing into it.',
-    inputSchema: z5.object({
-      path: z5.string().optional().describe("Directory to list, relative to cwd (default: cwd)")
+    inputSchema: z6.object({
+      path: z6.string().optional().describe("Directory to list, relative to cwd (default: cwd)")
     }),
     execute: async ({ path = "." }) => {
       logger.info({ path }, "called listFiles tool");
@@ -1839,13 +1995,13 @@ function listFilesTool(ctx) {
 
 // src/lib/tools/changeDirectory.ts
 import { tool as tool2 } from "ai";
-import z6 from "zod";
+import z7 from "zod";
 import { stat } from "node:fs/promises";
 function changeDirectoryTool(ctx) {
   return tool2({
     description: "Change the current working directory. Subsequent file operations resolve relative to it. Returns the new working directory.",
-    inputSchema: z6.object({
-      path: z6.string().describe("Directory to change into")
+    inputSchema: z7.object({
+      path: z7.string().describe("Directory to change into")
     }),
     execute: async ({ path }) => {
       logger.info({ path }, "called changeDirectory tool");
@@ -1867,13 +2023,13 @@ function changeDirectoryTool(ctx) {
 
 // src/lib/tools/reportStatus.ts
 import { tool as tool3 } from "ai";
-import z7 from "zod";
+import z8 from "zod";
 function reportStatusTool(output) {
   return tool3({
     description: "Report the status of your execution. Return a reason in case of failure.",
-    inputSchema: z7.object({
-      status: z7.enum(["success", "fail"]),
-      reason: z7.string().optional(),
+    inputSchema: z8.object({
+      status: z8.enum(["success", "fail"]),
+      reason: z8.string().optional(),
       output
     }),
     execute: async ({ status, reason, output: output2 }) => {
@@ -1885,7 +2041,7 @@ function reportStatusTool(output) {
 
 // src/lib/tools/readFile.ts
 import { tool as tool4 } from "ai";
-import z8 from "zod";
+import z9 from "zod";
 import { readFile as readFile3 } from "node:fs/promises";
 
 // src/lib/tools/env.ts
@@ -1913,8 +2069,8 @@ function redactEnvValues(content) {
 function readFileTool(ctx) {
   return tool4({
     description: "Read the contents of a file at the given path",
-    inputSchema: z8.object({
-      filePath: z8.string().describe("Path to the file to read")
+    inputSchema: z9.object({
+      filePath: z9.string().describe("Path to the file to read")
     }),
     execute: async ({ filePath }) => {
       if (++ctx.counts.read > ctx.limits.read) {
@@ -1935,15 +2091,15 @@ function readFileTool(ctx) {
 
 // src/lib/tools/writeFile.ts
 import { tool as tool5 } from "ai";
-import z9 from "zod";
+import z10 from "zod";
 import { mkdir as mkdir3, writeFile as writeFile3 } from "node:fs/promises";
 import { dirname as dirname3 } from "node:path";
 function writeFileTool(ctx) {
   return tool5({
     description: "Write content to a file at the given path, overwriting it. Writes to secret env files (.env, .env.local, etc.) are refused by this tool \u2014 call it anyway and the tool will tell you how to proceed.",
-    inputSchema: z9.object({
-      filePath: z9.string().describe("Path to the file to write"),
-      content: z9.string().describe("Content to write to the file")
+    inputSchema: z10.object({
+      filePath: z10.string().describe("Path to the file to write"),
+      content: z10.string().describe("Content to write to the file")
     }),
     execute: async ({ filePath, content }) => {
       logger.info({ filePath }, "called writeFile tool");
@@ -1973,68 +2129,6 @@ import z13 from "zod";
 import { mkdir as mkdir4, readFile as readFile5, writeFile as writeFile5 } from "node:fs/promises";
 import { dirname as dirname4, relative as relative3 } from "node:path";
 
-// src/lib/algoliaApp.ts
-import { z as z10 } from "zod";
-var applicationSchema = z10.object({
-  id: z10.string().min(1),
-  name: z10.string().default(""),
-  plan: z10.string().optional()
-});
-var listSchema = z10.array(
-  z10.object({
-    id: z10.string().min(1),
-    name: z10.string().default(""),
-    plan_label: z10.string().optional()
-  }).transform(({ id, name, plan_label }) => ({ id, name, plan: plan_label }))
-);
-async function currentApplication() {
-  let raw;
-  try {
-    raw = await runAlgoliaCli(["application", "current", "-o", "json"]);
-  } catch {
-    return null;
-  }
-  const parsed = applicationSchema.safeParse(parseJson(raw));
-  return parsed.success ? parsed.data : null;
-}
-async function requireApplication() {
-  const app = await currentApplication();
-  if (!app) {
-    throw new Error(
-      "No Algolia application is selected. Run `npx @algolia/cli@latest application select` and restart the wizard."
-    );
-  }
-  return app;
-}
-async function listApplications() {
-  const raw = await runAlgoliaCli(["application", "list", "-o", "json"]);
-  const parsed = listSchema.safeParse(parseJson(raw));
-  if (!parsed.success) {
-    throw new Error("Could not read the list of Algolia applications.");
-  }
-  return parsed.data;
-}
-async function selectApplication(id) {
-  const raw = await runAlgoliaCli(
-    ["application", "select", "--non-interactive", "--app-id", id],
-    { onOutput: stderrSink }
-  );
-  const parsed = applicationSchema.safeParse(parseJson(raw));
-  if (!parsed.success) {
-    throw new Error(
-      `Selected application ${id}, but the Algolia CLI returned an unreadable result.`
-    );
-  }
-  return parsed.data;
-}
-function parseJson(text) {
-  try {
-    return JSON.parse(text);
-  } catch {
-    return void 0;
-  }
-}
-
 // src/lib/algoliaApiKey.ts
 import { z as z12 } from "zod";
 
@@ -2042,13 +2136,13 @@ import { z as z12 } from "zod";
 import { deletePassword, getPassword, setPassword } from "cross-keychain";
 import { z as z11 } from "zod";
 var SERVICE = "algolia-wizard";
-var ACCOUNT = "api-keys";
+var account = (userId) => `api-keys:${userId}`;
 var storedKeysSchema = z11.record(z11.string(), z11.string());
 function entryId(kind, index, appId) {
   return `${kind}:${appId}:${index}`;
 }
-async function loadKeys() {
-  const raw = await getPassword(SERVICE, ACCOUNT);
+async function loadKeys(userId) {
+  const raw = await getPassword(SERVICE, account(userId));
   if (!raw) return {};
   let payload;
   try {
@@ -2070,47 +2164,47 @@ function serialized(op) {
   });
   return next;
 }
-async function readStoredKey(kind, index, appId) {
+async function readStoredKey(kind, userId, index, appId) {
   try {
-    return (await loadKeys())[entryId(kind, index, appId)] ?? null;
+    return (await loadKeys(userId))[entryId(kind, index, appId)] ?? null;
   } catch (err) {
     logger.warn(
-      { err: err.message, kind, index, appId },
+      { err: err.message, kind, index, appId, userId },
       "could not read the API key from the keychain"
     );
     return null;
   }
 }
-function storeKey(kind, index, appId, value) {
+function storeKey(kind, userId, index, appId, value) {
   return serialized(async () => {
     const id = entryId(kind, index, appId);
     try {
-      const keys = await loadKeys();
+      const keys = await loadKeys(userId);
       await setPassword(
         SERVICE,
-        ACCOUNT,
+        account(userId),
         JSON.stringify({ ...keys, [id]: value })
       );
-      if ((await loadKeys())[id] !== value) {
+      if ((await loadKeys(userId))[id] !== value) {
         throw new Error("the keychain did not store the value");
       }
     } catch (err) {
       logger.warn(
-        { err: err.message, kind, index, appId },
+        { err: err.message, kind, index, appId, userId },
         "could not store the API key in the keychain; the next run will create another"
       );
     }
   });
 }
-function deleteStoredKeys() {
+function deleteStoredKeys(userId) {
   return serialized(async () => {
     try {
-      await deletePassword(SERVICE, ACCOUNT);
+      await deletePassword(SERVICE, account(userId));
     } catch (err) {
       const message = err.message;
       if (/not found/i.test(message)) return;
       logger.warn(
-        { err: message },
+        { err: message, userId },
         "could not delete the API keys from the keychain"
       );
     }
@@ -2118,6 +2212,16 @@ function deleteStoredKeys() {
 }
 
 // src/lib/algoliaApiKey.ts
+function requireUserId() {
+  const userId = useWizard.getState().user?.userId;
+  if (!userId) {
+    throw new Error("No Algolia user is signed in; cannot scope the API key.");
+  }
+  return userId;
+}
+async function currentUserId() {
+  return useWizard.getState().user?.userId ?? (await getUser())?.userId ?? null;
+}
 var WRITE_ACLS = [
   "addObject",
   "deleteObject",
@@ -2164,23 +2268,30 @@ async function keyExists(key) {
 var resolved = /* @__PURE__ */ new Map();
 async function forgetResolvedKeys() {
   resolved.clear();
-  await deleteStoredKeys();
+  const userId = await currentUserId();
+  if (userId) await deleteStoredKeys(userId);
 }
 function resolveKey(kind, index, appId, acls, description) {
-  const cacheKey = `${kind}:${appId}:${index}`;
+  const userId = requireUserId();
+  const cacheKey = `${userId}:${kind}:${appId}:${index}`;
   const cached = resolved.get(cacheKey);
   if (cached) return cached;
-  const pending = provisionKey(kind, index, appId, acls, description).catch(
-    (err) => {
-      resolved.delete(cacheKey);
-      throw err;
-    }
-  );
+  const pending = provisionKey(
+    kind,
+    userId,
+    index,
+    appId,
+    acls,
+    description
+  ).catch((err) => {
+    resolved.delete(cacheKey);
+    throw err;
+  });
   resolved.set(cacheKey, pending);
   return pending;
 }
-async function provisionKey(kind, index, appId, acls, description) {
-  const stored = await readStoredKey(kind, index, appId);
+async function provisionKey(kind, userId, index, appId, acls, description) {
+  const stored = await readStoredKey(kind, userId, index, appId);
   if (stored) {
     if (await keyExists(stored)) {
       logger.info({ kind, index, appId }, "reusing the stored API key");
@@ -2192,7 +2303,7 @@ async function provisionKey(kind, index, appId, acls, description) {
     );
   }
   const key = await createKey(index, acls, description);
-  await storeKey(kind, index, appId, key);
+  await storeKey(kind, userId, index, appId, key);
   return { key, source: "created" };
 }
 function resolveWriteKey(index, appId) {
@@ -2635,17 +2746,38 @@ function storeApproval(root) {
     return "approve";
   };
 }
-var EXPLORATORY_COMMANDS = /* @__PURE__ */ new Set(["ls", "find", "tree", "dir"]);
+var FILE_IO_COMMANDS = /* @__PURE__ */ new Set([
+  "ls",
+  "find",
+  "fd",
+  "tree",
+  "dir",
+  "locate",
+  "cat",
+  "head",
+  "tail",
+  "less",
+  "more",
+  "tac",
+  "nl",
+  "grep",
+  "egrep",
+  "fgrep",
+  "rg",
+  "ack",
+  "ag",
+  "xxd",
+  "hexdump",
+  "od",
+  "strings"
+]);
 function commandSegments(command) {
   return command.split(/&&|;|\|/).map((segment) => segment.trim());
 }
-function isExploratoryCommand(command) {
-  return commandSegments(command).map((segment) => segment.split(/\s+/)[0]).some((word) => word !== void 0 && EXPLORATORY_COMMANDS.has(word));
+function isFileIOCommand(command) {
+  return commandSegments(command).map((segment) => segment.split(/\s+/)[0]).some((word) => word !== void 0 && FILE_IO_COMMANDS.has(word));
 }
 var READ_ONLY_BINARIES = /* @__PURE__ */ new Set([
-  "cat",
-  "head",
-  "tail",
   "wc",
   "pwd",
   "echo",
@@ -2656,10 +2788,6 @@ var READ_ONLY_BINARIES = /* @__PURE__ */ new Set([
   "which",
   "file",
   "stat",
-  "grep",
-  "egrep",
-  "fgrep",
-  "rg",
   "diff"
 ]);
 var READ_ONLY_NO_ARGS_BINARIES = /* @__PURE__ */ new Set(["env", "printenv"]);
@@ -2865,7 +2993,7 @@ async function approveAndRun(ctx, command, cwd, explanation) {
 }
 function runShellTool(ctx, createModel = defaultCreateModel) {
   return tool8({
-    description: "Run a shell command in the project. Use this for anything the project needs done in its own ecosystem: installing dependencies, running a script you wrote, running the project's lint/typecheck/test commands. Do not use this to find or read files \u2014 use listFiles, searchFiles, and readFile instead of ls/find/cat/head/tail/grep/rg. This tool refuses ls/find/tree/dir outright; a read command like cat is not refused (some read-only commands run without approval, see below), but it's still the wrong tool for reading a file \u2014 the dedicated tools exist for that and won't count against this tool's command budget. The user approves any command that could change the project before it runs, so write a clear `explanation`. A command judged read-only (inspection, or running tests/typecheck/lint without an autofix flag, in any language) runs immediately without approval. If the user rejects a command, do not retry it \u2014 propose a different approach.",
+    description: "Run a shell command in the project. Use this for anything the project needs done in its own ecosystem: installing dependencies, running a script you wrote, running the project's lint/typecheck/test commands. Do not use this to find or read files \u2014 use listFiles, searchFiles, and readFile instead of shell file-listing, reading, or search commands (ls/find/tree/cat/head/tail/grep/rg and similar). This tool refuses all of those outright: the dedicated tools enforce the project-root boundary and secret redaction that a raw shell read would bypass, and they won't count against this tool's command budget. The user approves any command that could change the project before it runs, so write a clear `explanation`. A command judged read-only (inspection, or running tests/typecheck/lint without an autofix flag, in any language) runs immediately without approval. If the user rejects a command, do not retry it \u2014 propose a different approach.",
     inputSchema: z15.object({
       command: z15.string().describe(
         "The command to run, exactly as it would be typed in a shell. Pipes, && and redirects are allowed."
@@ -2883,8 +3011,8 @@ function runShellTool(ctx, createModel = defaultCreateModel) {
       }
       const resolved2 = resolveInRoot(ctx, cwd ?? ".");
       if (!resolved2.ok) return resolved2.error;
-      if (isExploratoryCommand(command)) {
-        return "Refused: use listFiles or searchFiles to find files, and readFile to read one, instead of ls/find/tree/dir.";
+      if (isFileIOCommand(command)) {
+        return "Refused: use listFiles or searchFiles to find files, and readFile to read one, instead of a shell file-listing, reading, or search command (ls/find/fd/tree/dir/locate/cat/head/tail/less/more/tac/nl/grep/egrep/fgrep/rg/ack/ag/xxd/hexdump/od/strings).";
       }
       logger.info({ command, cwd: resolved2.target }, "called runShell tool");
       const fast = fastPathSafety(command);
@@ -3139,21 +3267,31 @@ var MODEL_BY_SIZE = {
 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 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) {
+    return "missingReport";
+  }
+  if (NoOutputGeneratedError.isInstance(err)) return "transientProvider";
+  if (APICallError.isInstance(err) && err.isRetryable) {
+    return "transientProvider";
+  }
+  return null;
+}
+function exhaustedError(kind, err) {
+  return kind === "missingReport" ? new Error(MISSING_REPORT_USER_MESSAGE) : new Error(PROVIDER_ERROR_USER_MESSAGE, { cause: err });
+}
 async function runAgent(req) {
   for (let attempt = 0; attempt <= REPORT_STATUS_RETRIES; attempt++) {
     try {
       return await runAgentAttempt(req, attempt);
     } catch (err) {
-      const isMissingReport = err instanceof Error && err.message === MISSING_REPORT_STATUS_ERROR_MESSAGE;
-      if (!isMissingReport) {
-        throw err;
-      }
-      if (attempt === REPORT_STATUS_RETRIES) {
-        throw new Error(MISSING_REPORT_USER_MESSAGE);
-      }
+      const kind = retryKind(err);
+      if (!kind) throw err;
+      if (attempt === REPORT_STATUS_RETRIES) throw exhaustedError(kind, err);
       logger.warn(
-        { attempt: attempt + 1 },
-        "retrying runAgent after missing reportStatus"
+        { attempt: attempt + 1, err },
+        kind === "missingReport" ? "retrying runAgent after missing reportStatus" : "retrying runAgent after a transient provider error"
       );
     }
   }
@@ -3216,18 +3354,28 @@ async function runAgentAttempt(req, attempt) {
   });
   let chunks = [];
   const chunkLimit = 5;
-  for await (const chunk of stream.textStream) {
+  let streamError;
+  for await (const part of stream.fullStream) {
+    if (part.type === "error") {
+      streamError = part.error;
+      continue;
+    }
+    if (part.type !== "text-delta") continue;
     if (chunks.length < chunkLimit) {
-      chunks.push(chunk);
+      chunks.push(part.text);
       continue;
     }
-    chunks.push(chunk);
+    chunks.push(part.text);
     logger.debug(chunks.join(""));
     chunks = [];
   }
   if (chunks.length) {
     logger.debug(chunks.join(""));
   }
+  if (streamError !== void 0) {
+    logger.error({ err: streamError }, "agent stream reported an error");
+    throw streamError;
+  }
   const end = Date.now();
   const usage = await stream.totalUsage;
   logger.info(
@@ -3387,7 +3535,7 @@ async function runAnalysis(mode, extraInstructions = []) {
 // package.json
 var package_default = {
   name: "@algolia/wizard",
-  version: "0.40.0",
+  version: "0.41.0-rc.131.289",
   description: "Magically implement Algolia functionality in your codebase",
   type: "module",
   engines: {
@@ -4258,6 +4406,10 @@ async function implement(ctx, useCases = DEFAULT_IMPLEMENT_USE_CASES) {
   if (useCases.includes("ingestion")) {
     ingestAppId = appId ?? (await requireApplication()).id;
   }
+  let ingestWriteKey;
+  if (useCases.includes("ingestion") && ingestAppId) {
+    ingestWriteKey = (await resolveWriteKey(targetIndex, ingestAppId)).key;
+  }
   let uploadFilePath;
   let uploadWarning;
   if (ingestionSource === "fileUpload") {
@@ -4320,9 +4472,9 @@ async function implement(ctx, useCases = DEFAULT_IMPLEMENT_USE_CASES) {
   let ingestDurationMs;
   let ingestOutcomeMessage;
   const ingestKeyAppId = ingestAppId;
-  const ingestionTools = ingestKeyAppId ? makeToolContext(repoRoot, async () => ({
+  const ingestionTools = ingestKeyAppId && ingestWriteKey ? makeToolContext(repoRoot, async () => ({
     [APP_ID_VAR]: ingestKeyAppId,
-    [API_KEY_VAR]: (await resolveWriteKey(targetIndex, ingestKeyAppId)).key,
+    [API_KEY_VAR]: ingestWriteKey,
     [INDEX_NAME_VAR]: targetIndex
   })) : void 0;
   const searchTools = makeToolContext(repoRoot);
@@ -5036,7 +5188,7 @@ function logNameColor(entry) {
   return STATUS_COLOR[entry.status] ?? KIND_COLOR[entry.kind];
 }
 var ROW_GAP = 1;
-function truncate2(str, maxWidth) {
+function truncate3(str, maxWidth) {
   if (maxWidth <= 0) return "";
   return str.length > maxWidth ? `${str.slice(0, maxWidth - 1)}\u2026` : str;
 }
@@ -5068,9 +5220,9 @@ function Logs() {
       const partCount = 2 + (rawPreview ? 1 : 0) + (durationText ? 1 : 0);
       const gaps = (partCount - 1) * ROW_GAP;
       let budget = scroll.width - timestamp.length - durationText.length - gaps;
-      const name = truncate2(entry.name, budget);
+      const name = truncate3(entry.name, budget);
       budget -= name.length;
-      const preview = rawPreview ? truncate2(rawPreview, budget) : "";
+      const preview = rawPreview ? truncate3(rawPreview, budget) : "";
       return /* @__PURE__ */ jsxs16(Box17, { flexDirection: "row", gap: ROW_GAP, children: [
         /* @__PURE__ */ jsx15(Text17, { color: COLORS.dim, children: timestamp }),
         /* @__PURE__ */ jsx15(Text17, { color: logNameColor(entry), wrap: "truncate", children: name }),
@@ -5478,6 +5630,7 @@ function App() {
     inputReq,
     user,
     workflow,
+    settingUpAppId,
     review: review2
   } = useWizard();
   const { exit } = useApp();
@@ -5493,7 +5646,7 @@ function App() {
   const isCommandApprovalPrompt = isAwaitingUserInput && inputReq?.promptType === "commandApproval";
   const promptPending = isAwaitingUserInput && !isCommandApprovalPrompt;
   const holdForTip = stepHasTips && promptPending && tipState === "revealing";
-  const showTips = stepHasTips && (phase === "running" || isCommandApprovalPrompt || holdForTip);
+  const showTips = stepHasTips && (phase === "running" && currentStep?.status === "running" || isCommandApprovalPrompt || holdForTip);
   const showNoticesInMain = !stepHasTips;
   const showNotices = (!isAwaitingUserInput || holdForTip) && !review2;
   useInput7(
@@ -5578,6 +5731,12 @@ function App() {
                           ] }),
                           /* @__PURE__ */ jsx18(Text20, { color: COLORS.muted, children: "A browser window will open \u2014 complete sign-in there." })
                         ] }),
+                        settingUpAppId && /* @__PURE__ */ jsx18(Box20, { flexDirection: "column", marginBottom: 1, children: /* @__PURE__ */ jsxs18(Text20, { color: COLORS.strong, bold: true, children: [
+                          /* @__PURE__ */ jsx18(Spinner2, { type: "dots" }),
+                          " Setting up Wizard using app",
+                          " ",
+                          settingUpAppId
+                        ] }) }),
                         /* @__PURE__ */ jsx18(CliOutput, {}),
                         showTips && currentStep && /* @__PURE__ */ jsx18(
                           Tips,
@@ -5648,50 +5807,72 @@ function readValue(raw) {
 }
 
 // src/lib/algoliaAppPicker.ts
-function secondaryFor(app) {
+function blockReasonFor(app) {
+  return app.status !== "active" ? "Paused" : "Missing permissions";
+}
+function secondaryFor(app, highlightId) {
+  if (!canSelectApplication(app)) {
+    return { kind: "text", value: blockReasonFor(app) };
+  }
+  if (app.id === highlightId) {
+    return { kind: "badge", value: "[DETECTED]" };
+  }
   return app.plan ? { kind: "badge", value: app.plan } : void 0;
 }
 function labelFor(app) {
   return app.name.trim() ? `${app.name} \u2014 ${app.id}` : app.id;
 }
-function selectAndReport(app) {
-  useWizard.getState().pushCliOutput(
-    "stdout",
-    `Selecting ${labelFor(app)} \u2014 provisioning its API key\u2026`
-  );
-  return selectApplication(app.id);
+async function isEligible(app) {
+  const apps = await listApplications();
+  const full = apps.find((candidate) => candidate.id === app.id);
+  return full != null && canSelectApplication(full);
 }
-async function promptForApplication(leadIn = []) {
+async function selectAndReport(app) {
   const store = useWizard.getState();
-  const apps = await listApplications();
-  if (apps.length === 0) {
+  store.setSettingUpApp(app.id);
+  try {
+    return await selectApplication(app.id);
+  } finally {
+    store.setSettingUpApp(null);
+  }
+}
+async function promptForApplication(highlight) {
+  const store = useWizard.getState();
+  const unordered = await listApplications();
+  if (unordered.length === 0) {
     throw new Error(
       "This Algolia account has no applications. Create one in the Algolia dashboard, or with `npx @algolia/cli@latest application create`, then restart the wizard."
     );
   }
-  if (apps.length === 1) {
-    const only = apps[0];
-    logger.info(
-      { app: only.id },
-      "single application on the account; selecting it"
+  if (!unordered.some(canSelectApplication)) {
+    throw new Error(
+      "None of the applications on this Algolia account are usable \u2014 each is either paused or missing key-management access. Activate one, or grant it the `keys` ACL, then restart the wizard."
     );
-    for (const line of leadIn) store.pushCliOutput("stdout", line);
-    return selectAndReport(only);
   }
-  const messages = [
-    ...leadIn,
-    "Which Algolia application should the wizard work in?"
+  const apps = [
+    ...unordered.filter(canSelectApplication),
+    ...unordered.filter((app) => !canSelectApplication(app))
   ];
+  const envApp = highlight ? unordered.find((app) => app.id === highlight.id) : void 0;
+  const highlightIndex = envApp && canSelectApplication(envApp) ? apps.indexOf(envApp) : -1;
+  const messages = [];
+  if (highlight && highlightIndex < 0) {
+    messages.push(
+      envApp ? `Could not use ${highlight.id} from ${highlight.file} \u2014 it\u2019s ${blockReasonFor(envApp).toLowerCase()}. Pick another below.` : `Could not use ${highlight.id} from ${highlight.file} \u2014 it may have been removed, or this account may not have access to it.`
+    );
+  }
   for (; ; ) {
     const choice = await store.requestUserInput({
-      prompt: "Select an application",
+      prompt: "Which Algolia application should the wizard work in?",
       promptType: "multipleChoice",
       options: apps.map(labelFor),
-      secondary: apps.map(secondaryFor),
+      secondary: apps.map((app) => secondaryFor(app, highlight?.id)),
+      disabled: apps.map((app) => !canSelectApplication(app)),
+      ...highlightIndex >= 0 ? { defaultSelectedIndex: highlightIndex } : {},
       messages
     });
     const chosen = apps.find((app) => labelFor(app) === choice);
-    if (!chosen) {
+    if (!chosen || !canSelectApplication(chosen)) {
       throw new Error("Application picker received an unexpected selection");
     }
     try {
@@ -5707,42 +5888,15 @@ async function promptForApplication(leadIn = []) {
     }
   }
 }
-async function confirmEnvApplication(env, current) {
-  const useEnv = `Use ${env.id} (from ${env.file})`;
-  const choice = await useWizard.getState().requestUserInput({
-    prompt: "Select an application",
-    promptType: "multipleChoice",
-    options: [
-      useEnv,
-      current ? `Use ${labelFor(current)} (already selected)` : "Pick a different application"
-    ],
-    messages: [
-      `${env.file} already sets ${env.name}=${env.id}.`,
-      "Which Algolia application should the wizard work in?"
-    ]
-  });
-  return choice === useEnv;
-}
-async function selectEnvApplication(env) {
-  try {
-    return await selectAndReport({ id: env.id, name: "" });
-  } catch (err) {
-    logger.warn(
-      { app: env.id, err: err.message },
-      "could not select the application named in env; falling back to the picker"
-    );
-    return promptForApplication([
-      `Could not select ${env.id} from ${env.file} \u2014 it may have been removed, or this account may not have access to it.`
-    ]);
-  }
-}
-async function ensureApplication() {
+async function ensureApplication(isResuming) {
   const current = await currentApplication();
-  const env = await findEnvApplicationId();
-  if (env && env.id !== current?.id && await confirmEnvApplication(env, current)) {
-    return selectEnvApplication(env);
+  if (isResuming) {
+    if (current && await isEligible(current)) return current;
+    return promptForApplication();
   }
-  return current ?? await promptForApplication();
+  const env = await findEnvApplicationId();
+  if (!env) return promptForApplication();
+  return promptForApplication({ id: env.id, file: env.file });
 }
 
 // src/lib/seed.ts
@@ -6106,14 +6260,15 @@ async function run(workflow) {
   }
   store.setUser(user);
   let app;
+  const resumableState = await loadResumableState(workflow);
   try {
-    app = await ensureApplication();
+    app = await ensureApplication(resumableState != null);
   } catch (err) {
     store.setError(err instanceof Error ? err.message : String(err));
     await instance.waitUntilExit();
     process.exit(1);
   }
-  runWorkflow(workflow, app.id);
+  runWorkflow(workflow, app.id, resumableState);
 }
 await requestTerminalSize();
 var started = await startup();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@algolia/wizard",
-  "version": "0.40.0",
+  "version": "0.41.0-rc.131.289",
   "description": "Magically implement Algolia functionality in your codebase",
   "type": "module",
   "engines": {