@algolia/wizard 0.84.0-rc.202.647 → 0.84.0-rc.202.650

package/dist/main.js

@@ -2315,7 +2315,7 @@ async function ensureApplication(resumeAppId) {
 // package.json
 var package_default = {
   name: "@algolia/wizard",
-  version: "0.84.0-rc.202.647",
+  version: "0.84.0-rc.202.650",
   description: "Magically implement Algolia functionality in your codebase",
   type: "module",
   engines: {
@@ -5206,6 +5206,23 @@ var AgentReportedFailureError = class extends Error {
     this.reason = reason;
   }
 };
+function withCachedHistory(messages) {
+  const last = messages.at(-1);
+  if (!last) return messages;
+  return [
+    ...messages.slice(0, -1),
+    {
+      ...last,
+      providerOptions: {
+        ...last.providerOptions,
+        anthropic: {
+          ...last.providerOptions?.anthropic,
+          cacheControl: { type: "ephemeral" }
+        }
+      }
+    }
+  ];
+}
 function isMissingReportRetry(kind) {
   return kind === "missingReport" || kind === "missingReportAtStepLimit";
 }
@@ -5327,7 +5344,12 @@ async function runAgentAttempt(req, attempt, retryReason) {
       hasToolCall("reportStatus"),
       stepCountIs(profile.maxSteps)
     ],
-    prepareStep: ({ stepNumber }) => stepNumber >= profile.maxSteps - 1 ? { activeTools: ["reportStatus"] } : void 0,
+    prepareStep: ({ stepNumber, messages }) => ({
+      messages: withCachedHistory(messages),
+      ...stepNumber >= profile.maxSteps - 1 && {
+        activeTools: ["reportStatus"]
+      }
+    }),
     // Not in the settings type, but forwarded to streamText, whose default prints over the UI.
     ...{ onError: () => {
     } }
@@ -6250,7 +6272,8 @@ function sourceSpecificInstructions(input) {
       "Records live locally in this project (files, local DB, or local API).",
       "Read each record from its real local source at the confirmed entity paths.",
       "Never fabricate, hardcode, or use placeholder records.",
-      "Add env vars for any local source access (DB URL, API base, file paths) that is not a fixed repo path."
+      "Add env vars for any local source access (DB URL, API base, file paths) that is not a fixed repo path.",
+      "To read a database, use the database client or ORM that the project already declares in its manifest. Never install a database driver or ORM. If the project declares none, report that limitation instead of adding one."
     ],
     fileUpload: [
       `Records come from the developer's file, already copied into the project at "${input.uploadFilePath}". Read and parse that exact file.`,
@@ -6303,7 +6326,8 @@ function ingestionInstructions(input) {
       ] : [],
       `When the script is finished, decide the exact command and cwd you will use to run it. Make sure that the script path in the command resolves from that cwd to the filePath. Then call reviewScript with that filePath, command, cwd, the exact selected entityName, and usesGeneratedRecords set to ${input.ingestionSource === "generated"}. Wait for the developer to review it because running it writes records to a live index. Do not run it before that call returns. If you change the command or cwd after a failed run, call reviewScript again before runShell.`,
       'Then, without changing directories, run the script yourself via runShell using the exact same command and cwd. Report the exact command you ran as "ingestCommand", with no cwd note or other text, so the developer can re-run it. Its explanation must say that running it writes records to Algolia.',
-      "When the script reads from a database or another service, find how the project connects to it locally (env files, README, socket or TCP settings). If that connection needs a local service, such as a database proxy (for example cloud-sql-proxy) or a tunnel, make the script check the connection before it reads, and exit with an error that names the service and the command from the project docs that starts it.",
+      "When the script reads from a database or another service, find how the project connects to it locally (env files, README, socket or TCP settings). If that connection needs a local service, such as a database proxy (for example cloud-sql-proxy) or a tunnel, make the script check the connection before it reads. If the check fails, the script must print an error that names the service, then print exactly one last line to stdout in the form `ALGOLIA_WIZARD_START_HINT=<command>`, where <command> is the command from the project docs that starts the service, and exit with an error. Omit that line when the project docs name no start command.",
+      "Make sure that the start command and the script connect to the same address (the same socket path, or the same host and port). If the project env points at an address that only a deployed environment has, such as a /cloudsql socket, make the script connect to the address of the start command. Set that address in the script before it loads the project database module. Do not edit project env or config files for this.",
       "If external data access fails, do not run authentication commands, change accounts or machine configuration, or start proxies, containers, or services.",
       "Do not troubleshoot unavailable external infrastructure. Preserve the script and command, report success, and let the developer prepare the data source.",
       "If the script cannot access an external data source because credentials or a service are unavailable, do not report status=fail. Report status=success with the completed script, ingestCommand, and a concise failure summary. The wizard handles this run failure and tells the developer how to retry.",
@@ -6403,7 +6427,7 @@ function packageSearchInstructions(input) {
     ],
     `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.`,
     "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.",
-    "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.",
+    "Vendor theme CSS, and any CSS you write against vendor class names, must be global: 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. Import the theme and those global overrides only where the framework allows first-party global CSS: Next.js Pages Router only from pages/_app (or _app.tsx), Next.js App Router only from the root layout, otherwise from the app's global stylesheet or the component module when that is valid. Do not import a plain .css file from a Next.js component \u2014 that fails the build.",
     `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.`,
@@ -6437,7 +6461,7 @@ function validationInstructions(input) {
     "Confirm the search experience reflows without horizontal page scrolling at 320 CSS pixels, keeps its panel on-screen, preserves visible focus, and respects reduced-motion preferences for any added animation.",
     "If the project imports an InstantSearch theme and overrides its palette, confirm that the palette overrides (--ais-*-rgb) win over the theme: they must use a higher specificity than the theme, for example `:root:root`, and for a dark mode `:root:root.dark` or `:root:root[data-theme=dark]`, because the theme sets its own blue in `:root` and in `:root[data-theme=dark], .dark`. `:root:root` alone ties with `:root[data-theme=dark]`. If an override can lose to the theme, set sufficient=false, because the search icon and focus ring then show the theme blue instead of the app accent color.",
     "Find how the app selects each theme it supports (a class or attribute on an ancestor, a prefers-color-scheme media query, or a theme that exists only in code). Confirm that the search input and results panel take their colors from the active app theme through that same switch. A search widget whose colors do not match the page theme, for example a light panel on a dark page, is a failure: set sufficient=false.",
-    "When the project has a package.json, confirm that the theme CSS of the search widget (for InstantSearch, a theme from instantsearch.css) is imported once, from the component or the global stylesheet. If it is installed but not imported, set sufficient=false.",
+    "When the project has a package.json, confirm that the theme CSS of the search widget (for InstantSearch, a theme from instantsearch.css) is imported once from a legal global-CSS entry for that framework (Next.js Pages Router: pages/_app; Next.js App Router: root layout; otherwise the app global stylesheet or a component module when allowed). If it is installed but not imported, or imported from a Next.js component file, set sufficient=false.",
     "Confirm that the search component is reachable from and fits the corresponding content task at every supported breakpoint; require app-wide reachability only when the search scope is genuinely app-wide.",
     "Do not run the test suite or any test command.",
     "Do not modify files. Report each implementation issue as a concrete instruction for the next implementation pass.",
@@ -6515,6 +6539,11 @@ function parseIngestRecordCount(output) {
   const count = Number(match[1]);
   return Number.isFinite(count) ? count : void 0;
 }
+var START_HINT_LINE = /^ALGOLIA_WIZARD_START_HINT=(.*)$/gm;
+function parseStartHint(output) {
+  const matches = [...(output ?? "").matchAll(START_HINT_LINE)];
+  return matches.at(-1)?.[1]?.trim() || void 0;
+}
 function relativeIngestCwd(execution, repoRoot) {
   const cwd = relative7(repoRoot, execution.cwd);
   return cwd && cwd !== "." ? cwd : ".";
@@ -6541,7 +6570,7 @@ function ingestOutcome(executions, repoRoot, ingestCommand) {
 }
 var INGEST_OUTPUT_TAIL_CHARS = 400;
 function outputTail(output) {
-  const trimmed = output?.trim();
+  const trimmed = output?.replace(START_HINT_LINE, "").trim();
   if (!trimmed) return void 0;
   return trimmed.length > INGEST_OUTPUT_TAIL_CHARS ? `\u2026${trimmed.slice(-INGEST_OUTPUT_TAIL_CHARS)}` : trimmed;
 }
@@ -6607,12 +6636,13 @@ function errorLine(output) {
   const lines = output?.split("\n").map((l) => l.trim()).filter(Boolean) ?? [];
   return [...lines].reverse().find((l) => /\w*(Error|Exception)\b/.test(l)) ?? lines.at(-1);
 }
-function ingestFailureMessages(headline, detail, command, cwd) {
+function ingestFailureMessages(headline, detail, command, cwd, startHint) {
   return [
     headline,
     // One message per line: Notices.tsx counts a message as one wrapped
     // line, so an embedded newline overflows the panel's height accounting.
     ...detail?.split("\n").filter((l) => l.trim()) ?? [],
+    ...startHint ? [`Start the data source with: ${startHint}`] : [],
     ...command ? [
       `Ingestion command: ${command}`,
       ...cwd !== "." ? [`Working directory: ${cwd}`] : []
@@ -6939,7 +6969,8 @@ async function implement(ctx, useCases = DEFAULT_IMPLEMENT_USE_CASES) {
           `\u26A0\uFE0F Records were not indexed \u2014 ${reason}.`,
           errorLine(detail),
           attempt.command,
-          relativeIngestCwd(attempt, repoRoot)
+          relativeIngestCwd(attempt, repoRoot),
+          parseStartHint(attempt.output)
         )
       });
       if (choice !== INGEST_RETRY.retry) {
@@ -7053,7 +7084,8 @@ ${detail}` : ""}`
           ingestOutcomeMessage,
           ingestFailureDetail,
           ingestCommand,
-          ingestCwd
+          ingestCwd,
+          parseStartHint(ingestAttempt?.output)
         )
       });
     }
@@ -9322,7 +9354,7 @@ async function resetProjectState() {
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "@algolia/wizard",
-  version: "0.84.0-rc.202.647",
+  version: "0.84.0-rc.202.650",
   description: "Magically implement Algolia functionality in your codebase",
   type: "module",
   engines: {

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

@@ -126,13 +126,18 @@ WCAG 2.2 AA and verify after styling that:
 
 ### Styling the panel
 
-The widget ships no CSS. Install `instantsearch.css` and import a theme once, from the
-component's own JS/TS module or the app's global stylesheet:
+The widget ships no CSS. Install `instantsearch.css` and import a theme once from a
+legal global-CSS entry for the framework:
 
 ```js
 import 'instantsearch.css/themes/satellite.css'
 ```
 
+Import only where first-party global CSS is allowed: Next.js Pages Router from
+`pages/_app`, Next.js App Router from the root layout, otherwise the app global
+stylesheet or the component module when that is valid. Do not import a plain `.css`
+file from a Next.js component — the build fails.
+
 The theme and your `.ais-*` overrides must be **global**: never a CSS `@import` inside a
 framework-scoped style block (Astro `<style>`, Vue `<style scoped>`, Svelte `<style>`) or
 a CSS Module.

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

@@ -118,13 +118,18 @@ WCAG 2.2 AA and verify after styling that:
 
 ### Styling the panel
 
-The widget ships no CSS. Install `instantsearch.css` and import a theme once, from the
-component module or the app's global stylesheet:
+The widget ships no CSS. Install `instantsearch.css` and import a theme once from a
+legal global-CSS entry for the framework:
 
 ```tsx
 import 'instantsearch.css/themes/satellite.css'
 ```
 
+Import only where first-party global CSS is allowed: Next.js Pages Router from
+`pages/_app`, Next.js App Router from the root layout, otherwise the app global
+stylesheet or the component module when that is valid. Do not import a plain `.css`
+file from a Next.js component — the build fails.
+
 The theme and your `.ais-*` overrides must be **global**: never route either through a CSS
 Module, a scoped style block (Astro `<style>`, Vue `<style scoped>`, Svelte `<style>`), or
 any styled-components-style wrapper that rewrites selectors. Keep them in a global

package/package.json

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