@algolia/wizard 0.46.0 → 0.47.0

package/dist/main.js

@@ -5,7 +5,7 @@ import { render } from "ink";
 
 // src/ui/App.tsx
 import { Box as Box20, Text as Text20, useApp, useInput as useInput7, useWindowSize as useWindowSize7 } from "ink";
-import Spinner2 from "ink-spinner";
+import Spinner3 from "ink-spinner";
 
 // src/core/store.ts
 import { create } from "zustand";
@@ -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
     });
   }
 }));
@@ -637,6 +642,7 @@ function Notices({
 
 // src/ui/PromptInput.tsx
 import { Box as Box9, Text as Text9 } from "ink";
+import Spinner from "ink-spinner";
 import TextInput from "ink-text-input";
 import { useState as useState6 } from "react";
 
@@ -657,25 +663,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 +883,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 +902,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,10 +953,10 @@ 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) => nextSelectableIndex(i, -1, rows.length, isDisabled));
     } else if (key.downArrow || input === "j") {
-      setIndex((i) => (i + 1) % rows.length);
-    } else if (multi && input === " " && index !== cancelIndex) {
+      setIndex((i) => nextSelectableIndex(i, 1, rows.length, isDisabled));
+    } else if (multi && input === " " && index !== cancelIndex && !isDisabled(index)) {
       setChecked((prev) => {
         const next = new Set(prev);
         if (next.has(index)) next.delete(index);
@@ -947,10 +966,12 @@ 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) {
-        onSelect(options.filter((_, i) => checked.has(i)));
+      } else {
+        const picked = options.filter((_, i) => checked.has(i) && !isDisabled(i));
+        if (picked.length > 0) onSelect(picked);
       }
     }
   });
@@ -971,10 +992,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 +1007,7 @@ function SelectPrompt({
               Text8,
               {
                 wrap: "truncate",
-                color: highlighted ? COLORS.primary : COLORS.muted,
+                color: rowDisabled ? COLORS.dim : highlighted ? COLORS.primary : COLORS.muted,
                 children: sec.value
               }
             ) }),
@@ -1031,11 +1054,23 @@ function EnterToContinuePrompt({
 function PromptInput() {
   const { phase, inputReq, submitInput } = useWizard();
   const [draft, setDraft] = useState6("");
+  const [submittedReq, setSubmittedReq] = useState6(null);
   const promptKey = inputReq && `${inputReq.promptType}:${inputReq.prompt}`;
+  const submitting = inputReq != null && submittedReq === inputReq;
   if (phase === "done" || phase === "error") {
     return /* @__PURE__ */ jsx7(Box9, { marginTop: 1, children: /* @__PURE__ */ jsx7(Text9, { color: "gray", dimColor: true, children: "Press Enter or Esc to exit" }) });
   }
   if (phase !== "awaitingInput" || !inputReq) return null;
+  if (submitting) {
+    return /* @__PURE__ */ jsx7(Box9, { flexGrow: 1, children: /* @__PURE__ */ jsxs8(Text9, { color: COLORS.strong, bold: true, children: [
+      /* @__PURE__ */ jsx7(Spinner, { type: "dots" }),
+      " Continuing\u2026"
+    ] }) });
+  }
+  const handleSubmit = (value) => {
+    setSubmittedReq(inputReq);
+    submitInput(value);
+  };
   if (inputReq.promptType === "multipleChoice") {
     return /* @__PURE__ */ jsx7(Box9, { flexGrow: 1, children: /* @__PURE__ */ jsx7(
       SelectPrompt,
@@ -1046,10 +1081,11 @@ function PromptInput() {
         table: inputReq.table,
         options: inputReq.options,
         secondary: inputReq.secondary,
+        disabled: inputReq.disabled,
         defaultSelectedIndex: inputReq.defaultSelectedIndex,
         cancelable: inputReq.cancelable,
         error: inputReq.error,
-        onSelect: submitInput
+        onSelect: handleSubmit
       },
       promptKey
     ) });
@@ -1065,7 +1101,7 @@ function PromptInput() {
         table: inputReq.table,
         options: inputReq.options,
         error: inputReq.error,
-        onSelect: submitInput
+        onSelect: handleSubmit
       },
       promptKey
     ) });
@@ -1077,7 +1113,7 @@ function PromptInput() {
         question: inputReq.prompt,
         messages: inputReq.messages,
         options: ["Continue"],
-        onSelect: submitInput
+        onSelect: handleSubmit
       },
       promptKey
     ) });
@@ -1104,7 +1140,7 @@ function PromptInput() {
         messages: inputReq.messages,
         options: labels,
         secondary: inputReq.secondary,
-        onSelect: (value) => submitInput(value === labels[0])
+        onSelect: (value) => handleSubmit(value === labels[0])
       },
       promptKey
     ) });
@@ -1285,6 +1321,10 @@ import { mkdir as mkdir2, readFile as readFile2, writeFile as writeFile2, rm } f
 import { join as join4 } from "node:path";
 var isStepVisible = (s) => s.visible !== false;
 var stateFile = (workflowId) => join4(stateDir(), `state-${workflowId}.json`);
+function runAppId(state) {
+  const appId = state.algoliaState.appId;
+  return typeof appId === "string" && appId ? appId : void 0;
+}
 async function loadWorkflowState(workflowId) {
   try {
     const raw = await readFile2(stateFile(workflowId), "utf8");
@@ -1564,7 +1604,11 @@ function reconcileWorkflowState(state, workflow) {
   }
   return state;
 }
-function initWorkflowState(workflow, now) {
+async function loadResumableState(workflow) {
+  const persisted = await loadWorkflowState(workflow.id);
+  return persisted ? reconcileWorkflowState(persisted, workflow) : null;
+}
+function initWorkflowState(workflow, now, appId) {
   return {
     workflowId: workflow.id,
     startedAt: now,
@@ -1576,7 +1620,7 @@ function initWorkflowState(workflow, now) {
       visible: s.visible,
       status: "pending"
     })),
-    algoliaState: {},
+    algoliaState: appId ? { appId } : {},
     userInputs: {}
   };
 }
@@ -1666,11 +1710,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(), appId);
     ensureExecutedStepCount(state);
     store.startWorkflow(
       {
@@ -1762,14 +1806,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",
@@ -1788,9 +1907,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:",
@@ -1800,17 +1919,18 @@ 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
@@ -1829,7 +1949,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
@@ -1865,8 +1985,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");
@@ -1887,13 +2007,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");
@@ -1915,13 +2035,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 }) => {
@@ -1933,7 +2053,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
@@ -1961,8 +2081,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) {
@@ -1983,15 +2103,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");
@@ -2021,68 +2141,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";
 
@@ -2090,13 +2148,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 {
@@ -2118,47 +2176,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"
       );
     }
@@ -2166,6 +2224,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",
@@ -2212,23 +2280,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");
@@ -2240,7 +2315,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) {
@@ -3509,7 +3584,7 @@ async function runAnalysis(mode, extraInstructions = []) {
 // package.json
 var package_default = {
   name: "@algolia/wizard",
-  version: "0.46.0",
+  version: "0.47.0",
   description: "Magically implement Algolia functionality in your codebase",
   type: "module",
   engines: {
@@ -4435,6 +4510,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") {
@@ -4497,9 +4576,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);
@@ -5094,13 +5173,13 @@ import { Box as Box15, Text as Text15 } from "ink";
 
 // src/ui/Steps.tsx
 import { Box as Box13, Text as Text13 } from "ink";
-import Spinner from "ink-spinner";
+import Spinner2 from "ink-spinner";
 import { jsx as jsx11, jsxs as jsxs12 } from "react/jsx-runtime";
 function Steps() {
   const { steps } = useWizard();
   const visibleSteps = steps.filter(isStepVisible);
   return /* @__PURE__ */ jsx11(Box13, { flexDirection: "column", gap: 1, children: visibleSteps.map((s) => /* @__PURE__ */ jsx11(Box13, { flexDirection: "column", children: /* @__PURE__ */ jsxs12(Text13, { color: COLORS.status[s.status], children: [
-    s.status === "running" ? /* @__PURE__ */ jsx11(Spinner, { type: "dots" }) : MARKER[s.status],
+    s.status === "running" ? /* @__PURE__ */ jsx11(Spinner2, { type: "dots" }) : MARKER[s.status],
     " ",
     s.title
   ] }) }, s.id)) });
@@ -5110,7 +5189,7 @@ function CurrentStep() {
   const currentStep = steps.filter(isStepVisible).find((s) => s.status === "running");
   if (!currentStep) return null;
   return /* @__PURE__ */ jsxs12(Text13, { color: COLORS.status.running, children: [
-    /* @__PURE__ */ jsx11(Spinner, { type: "dots" }),
+    /* @__PURE__ */ jsx11(Spinner2, { type: "dots" }),
     " ",
     ` ${currentStep.title}`
   ] });
@@ -5655,6 +5734,7 @@ function App() {
     inputReq,
     user,
     workflow,
+    settingUpAppId,
     review: review2
   } = useWizard();
   const { exit } = useApp();
@@ -5670,7 +5750,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(
@@ -5741,20 +5821,26 @@ function App() {
                     children: [
                       /* @__PURE__ */ jsxs18(Box20, { flexGrow: 2, flexDirection: "column", children: [
                         phase === "preflight" && !user && /* @__PURE__ */ jsx18(Box20, { flexDirection: "column", marginBottom: 1, children: /* @__PURE__ */ jsxs18(Text20, { color: COLORS.strong, bold: true, children: [
-                          /* @__PURE__ */ jsx18(Spinner2, { type: "dots" }),
+                          /* @__PURE__ */ jsx18(Spinner3, { type: "dots" }),
                           " Signing in to Algolia"
                         ] }) }),
                         phase === "preflight" && user && /* @__PURE__ */ jsx18(Box20, { flexDirection: "column", marginBottom: 1, children: /* @__PURE__ */ jsxs18(Text20, { color: COLORS.strong, bold: true, children: [
-                          /* @__PURE__ */ jsx18(Spinner2, { type: "dots" }),
+                          /* @__PURE__ */ jsx18(Spinner3, { type: "dots" }),
                           " Getting things ready"
                         ] }) }),
                         phase === "authenticating" && /* @__PURE__ */ jsxs18(Box20, { flexDirection: "column", marginBottom: 1, children: [
                           /* @__PURE__ */ jsxs18(Text20, { color: COLORS.strong, bold: true, children: [
-                            /* @__PURE__ */ jsx18(Spinner2, { type: "dots" }),
+                            /* @__PURE__ */ jsx18(Spinner3, { type: "dots" }),
                             " Signing in to Algolia"
                           ] }),
                           /* @__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(Spinner3, { type: "dots" }),
+                          " Setting up Wizard using app",
+                          " ",
+                          settingUpAppId
+                        ] }) }),
                         /* @__PURE__ */ jsx18(CliOutput, {}),
                         showTips && currentStep && /* @__PURE__ */ jsx18(
                           Tips,
@@ -5825,54 +5911,71 @@ 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 selectAndReport(id) {
+  const store = useWizard.getState();
+  store.setSettingUpApp(id);
+  try {
+    return await selectApplication(id);
+  } finally {
+    store.setSettingUpApp(null);
+  }
 }
-async function promptForApplication(leadIn = []) {
+async function promptForApplication(highlight) {
   const store = useWizard.getState();
-  const apps = await listApplications();
-  if (apps.length === 0) {
+  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 {
-      return await selectAndReport(chosen);
+      return await selectAndReport(chosen.id);
     } catch (err) {
       logger.warn(
         { app: chosen.id, err: err.message },
@@ -5884,42 +5987,11 @@ 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() {
-  const current = await currentApplication();
+async function ensureApplication(resumeAppId) {
+  if (resumeAppId) return selectAndReport(resumeAppId);
   const env = await findEnvApplicationId();
-  if (env && env.id !== current?.id && await confirmEnvApplication(env, current)) {
-    return selectEnvApplication(env);
-  }
-  return current ?? await promptForApplication();
+  if (!env) return promptForApplication();
+  return promptForApplication({ id: env.id, file: env.file });
 }
 
 // src/lib/seed.ts
@@ -6283,14 +6355,17 @@ async function run(workflow) {
   }
   store.setUser(user);
   let app;
+  const resumableState = await loadResumableState(workflow);
   try {
-    app = await ensureApplication();
+    app = await ensureApplication(
+      resumableState ? runAppId(resumableState) : void 0
+    );
   } 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.46.0",
+  "version": "0.47.0",
   "description": "Magically implement Algolia functionality in your codebase",
   "type": "module",
   "engines": {