@algolia/wizard 0.46.0 → 0.48.0-rc.141.344

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.48.0-rc.141.344",
   description: "Magically implement Algolia functionality in your codebase",
   type: "module",
   engines: {
@@ -4224,6 +4299,7 @@ function searchInstructions(input) {
   return [
     "Implement an in-app Algolia search experience.",
     `Build the search UI for ${input.searchUiTarget}.`,
+    "Search UI only \u2014 the index is already populated. Do not create or modify ingestion scripts, rake/manage/CLI tasks, migrations, seeders, or other data-loading code, even if the data looks incomplete.",
     ...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
@@ -4231,9 +4307,12 @@ function searchInstructions(input) {
       "No bundled Algolia SDK reference exists for this stack, so rely on the project's own conventions and Algolia's official client for its language. Do not invent APIs \u2014 keep to the documented search endpoint and its parameters."
     ],
     `Create the search experience as its own component in a new file, following the project's existing component conventions (location, naming, styling approach). Do not write it inline into an existing file.`,
-    `Import and render that new component from ${input.searchLocation ? `"${input.searchLocation}"` : "the best shared, 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 list against the target index.`,
+    `Import and render that new component from ${input.searchLocation ? `"${input.searchLocation}"` : "the best shared, 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.`,
@@ -4435,6 +4514,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 +4580,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 +5177,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 +5193,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 +5738,7 @@ function App() {
     inputReq,
     user,
     workflow,
+    settingUpAppId,
     review: review2
   } = useWizard();
   const { exit } = useApp();
@@ -5670,7 +5754,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 +5825,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 +5915,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 +5991,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 +6359,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();