blume 2.0.0 → 2.0.1

package/src/ai/cors.ts

@@ -1,5 +1,5 @@
 /**
- * CORS for the generated Ask AI route (`ai.ask.cors`).
+ * CORS for the assistant's generated route (`ai.assistant.cors`).
  *
  * A browser only lets a page on another origin read a response that names
  * that origin, and a JSON `POST` preflights first. `preflightResponse` answers
@@ -8,12 +8,12 @@
  * rather than stamping each `return`, keeps the next return site added to the
  * handler from shipping an opaque failure for that one status.
  *
- * `allowed` is the `ai.ask.cors` list: origins already reduced to their
+ * `allowed` is the `ai.assistant.cors` list: origins already reduced to their
  * `scheme://host[:port]` form by the config schema, or the single entry `"*"`
  * to admit every origin.
  */
 
-/** The `ai.ask.cors` entry that admits every origin. */
+/** The `ai.assistant.cors` entry that admits every origin. */
 export const ANY_ORIGIN = "*";
 
 /** The headers a response carries for a cross-origin caller. */

package/src/ai/index.ts

@@ -1,5 +1,5 @@
 /**
- * Ask AI provider adapters for `blume.config.ts`:
+ * Assistant provider adapters for `blume.config.ts`:
  *
  * ```ts
  * import { defineConfig } from "blume";
@@ -7,7 +7,7 @@
  *
  * export default defineConfig({
  *   ai: {
- *     ask: {
+ *     assistant: {
  *       enabled: true,
  *       provider: openrouter({ model: "anthropic/claude-sonnet-4-5" }),
  *     },
@@ -27,19 +27,19 @@ export {
   openrouter,
 } from "./ask.ts";
 export type {
-  AskAdapter,
-  AskAdapterOptions,
-  AskGatewayAdapter,
-  AskGatewayOptions,
-  AskInkeepAdapter,
-  AskInkeepOptions,
-  AskLlmGatewayAdapter,
-  AskLlmGatewayOptions,
-  AskOpenAICompatibleAdapter,
-  AskOpenAICompatibleOptions,
-  AskOpenRouterAdapter,
-  AskOpenRouterOptions,
-  AskProviderOptions,
-  AskReasoning,
+  AssistantAdapter,
+  AssistantAdapterOptions,
+  AssistantGatewayAdapter,
+  AssistantGatewayOptions,
+  AssistantInkeepAdapter,
+  AssistantInkeepOptions,
+  AssistantLlmGatewayAdapter,
+  AssistantLlmGatewayOptions,
+  AssistantOpenAICompatibleAdapter,
+  AssistantOpenAICompatibleOptions,
+  AssistantOpenRouterAdapter,
+  AssistantOpenRouterOptions,
+  AssistantProviderOptions,
+  AssistantReasoning,
 } from "./ask.ts";
 export type { AdapterDescriptor } from "../core/adapter.ts";

package/src/ai/openapi-components.ts

@@ -44,7 +44,7 @@ const listItem = (
  * the body plus one of these components, deliberately: the structured UI is the
  * component's job, and the prose stays Markdown so it indexes. That split is
  * right for the rendered page and lossy everywhere else — `<route>.md`,
- * llms-full.txt, MCP `get_page` and the Ask AI corpus all downlevel components
+ * llms-full.txt, MCP `get_page` and the assistant corpus all downlevel components
  * to Markdown, and these three had no serializer, so an operation page reached
  * an agent as its description followed by a bare tag. On a site whose reference
  * is most of the corpus, that is most of the corpus: measured on one 449-page

package/src/ai/serializers.ts

@@ -6,7 +6,7 @@ import { openapiComponentSerializers } from "./openapi-components.ts";
 
 /**
  * Every serializer a project brings to a downlevel pass, layered once for all
- * the agent surfaces (`<route>.md`, llms-full.txt, the search and Ask AI
+ * the agent surfaces (`<route>.md`, llms-full.txt, the search and assistant
  * corpora): the built-in families that read project data — examples, then the
  * API reference — under the user's `agents.markdownComponents`, which is spread
  * last so an entry of the same name still wins. One layering, so a new family

package/src/ai/visibility.ts

@@ -67,7 +67,7 @@ export const applyAudienceVisibility = (
 
 /**
  * Resolve `<Visibility>` blocks for agent-facing Markdown (llms-full.txt, the
- * `.md`/`.mdx` mirrors, MCP tools, Ask AI grounding): `for="web"` content is
+ * `.md`/`.mdx` mirrors, MCP tools, assistant grounding): `for="web"` content is
  * removed and `for="agents"` content is unwrapped.
  */
 export const applyAgentVisibility = (markdown: string): string =>

package/src/astro/generate.ts

@@ -636,7 +636,7 @@ const writeIfChanged = async (
 
 /**
  * Delete generated files under `srcDir` that this pass didn't (re)write. The
- * generator emits many files conditionally — an Ask AI endpoint, OG images, a
+ * generator emits many files conditionally — an assistant endpoint, OG images, a
  * search index, RSS feeds, reference pages, the MCP server — so toggling a
  * feature off would otherwise leave a stale file behind, and a leftover
  * server-rendered endpoint breaks the static build. `writeIfChanged` only ever
@@ -1114,10 +1114,10 @@ export const buildRuntimeData = (project: BlumeProject): string => {
     config: {
       analytics: config.analytics,
       appleIcon: resolveAppleIcon(project),
-      ask: config.ai.ask?.enabled
+      assistant: config.ai.assistant?.enabled
         ? {
-            endpoint: config.ai.ask.endpoint ?? null,
-            suggestions: config.ai.ask.suggestions,
+            endpoint: config.ai.assistant.endpoint ?? null,
+            suggestions: config.ai.assistant.suggestions,
           }
         : null,
       banner: resolveBanner(config),
@@ -1580,9 +1580,9 @@ const proxyAllowlistWarnings = (
 };
 
 /**
- * Write the Ask AI endpoint and, unless the backend runs its own retrieval
+ * Write the assistant endpoint and, unless the backend runs its own retrieval
  * (Inkeep), the grounding snapshot the endpoint queries at request time. A no-op
- * when Ask AI is disabled.
+ * when the assistant is disabled.
  */
 const writeAskFiles = async (
   project: BlumeProject,
@@ -1590,20 +1590,20 @@ const writeAskFiles = async (
   write: (path: string, content: string) => Promise<boolean>,
   modules: RuntimeModules
 ): Promise<void> => {
-  const { ask } = project.config.ai;
-  if (!(ask?.enabled && !ask.endpoint)) {
+  const { assistant } = project.config.ai;
+  if (!(assistant?.enabled && !assistant.endpoint)) {
     return;
   }
-  const backend = resolveAskBackend(ask.provider);
+  const backend = resolveAskBackend(assistant.provider);
   if (backend.grounded) {
     modules.set("blume:ask-data", JSON.stringify(await buildAskData(project)));
   }
   await write(
     join(srcDir, "pages", "api", "ask.ts"),
     askEndpointTemplate(backend, {
-      cors: ask.cors,
-      instructions: ask.instructions,
-      retrieval: ask.retrieval,
+      cors: assistant.cors,
+      instructions: assistant.instructions,
+      retrieval: assistant.retrieval,
     })
   );
 };
@@ -1645,7 +1645,7 @@ export const diagnosticWarning = (diagnostic: Diagnostic): string =>
 
 /**
  * Missing-dependency preflight: the search provider's SDK, content source
- * SDKs, the Ask AI backend's provider SDK, the deployment adapter's package,
+ * SDKs, the assistant backend's provider SDK, the deployment adapter's package,
  * and — since React ships with Blume while Vue/Svelte don't — any island
  * framework's Astro integration. A build fails here, before anything is
  * written, with the install command for the project's package manager —
@@ -1845,7 +1845,7 @@ export const generateRuntime = async (
   const homeLinkHeader =
     buildHomeLinkHeader(config, contentRoutes) ?? undefined;
 
-  const askEnabled = config.ai.ask?.enabled ?? false;
+  const assistantEnabled = config.ai.assistant?.enabled ?? false;
   const exportPdf = config.export.pdf;
   const exportEpub = config.export.epub;
   // Every route's source Markdown: published as `blume:raw-markdown` below,
@@ -1897,7 +1897,7 @@ export const generateRuntime = async (
   project.examples = exampleMarkdownLookup(exampleDiscovery.examples);
 
   // Each island/example framework enables its Astro renderer. React also
-  // switches on for any project `.tsx`/`.jsx` and for Ask AI; Vue/Svelte are
+  // switches on for any project `.tsx`/`.jsx` and for the assistant; Vue/Svelte are
   // island/example-driven. `.astro` examples need no renderer. Component
   // overrides referencing a framework component enable its renderer too.
   const frameworks = new Set<string>([
@@ -1906,7 +1906,8 @@ export const generateRuntime = async (
     ...slotPlan.frameworks,
   ]);
   const dependencyWarnings = await dependencyPreflight(project, frameworks);
-  const needsReact = detectedReact || askEnabled || frameworks.has("react");
+  const needsReact =
+    detectedReact || assistantEnabled || frameworks.has("react");
   const needsVue = frameworks.has("vue");
   const needsSvelte = frameworks.has("svelte");
 
@@ -2025,7 +2026,7 @@ export const generateRuntime = async (
       // The header's Ask trigger, behind the `blume:ask` alias. Always written
       // (even when Ask is off, as a component that renders nothing) so the alias
       // resolves — the same contract as `blume:search-client`.
-      write(askPath, askComponentTemplate(askEnabled)),
+      write(askPath, askComponentTemplate(assistantEnabled)),
       write(join(srcDir, "generated", "components.ts"), slotPlan.module),
       write(
         join(srcDir, "generated", "examples.ts"),
@@ -2288,7 +2289,7 @@ export const generateRuntime = async (
     writeStagedContent(out, staged),
   ]);
 
-  // Remove anything under `.blume/src` this pass didn't write — e.g. an Ask AI
+  // Remove anything under `.blume/src` this pass didn't write — e.g. an assistant
   // endpoint left behind after the feature was switched off.
   await pruneOrphans(srcDir, written);
 

package/src/astro/module-types.ts

@@ -14,7 +14,7 @@
 export const runtimeModuleDeclarations = (
   examplesModule: string
 ): string => `declare module "blume:ask" {
-  const Ask: typeof import("blume/components/islands/AskAI.astro").default;
+  const Ask: typeof import("blume/components/islands/Assistant.astro").default;
   export default Ask;
 }
 

package/src/astro/runtime-deps.ts

@@ -85,18 +85,18 @@ export const sourceAdapterDependencies = (
   );
 
 /**
- * The Ask AI adapter's provider SDK, when missing — only `gateway` needs
+ * The assistant adapter's provider SDK, when missing — only `gateway` needs
  * nothing beyond the core `ai` package Blume ships. An external `endpoint`
  * means no generated route, so no SDK is imported.
  */
-export const askProviderDependencies = (
-  ask: ResolvedConfig["ai"]["ask"],
+export const assistantProviderDependencies = (
+  ask: ResolvedConfig["ai"]["assistant"],
   root: string,
   pkgDir: string = packageRoot()
 ): MissingDependency[] =>
   ask?.enabled && !ask.endpoint
     ? unresolved(
-        `Ask AI provider "${ask.provider.kind}"`,
+        `Assistant provider "${ask.provider.kind}"`,
         ask.provider.runtimeDeps,
         root,
         pkgDir
@@ -152,7 +152,7 @@ export const islandFrameworkDependencies = (
 /**
  * Every package the resolved config's adapters (and the given island
  * frameworks) import that isn't installed: the search SDK, content source
- * SDKs, the Ask AI provider SDK, the deployment adapter, and island
+ * SDKs, the assistant provider SDK, the deployment adapter, and island
  * integrations. The adapters' `runtimeDeps` are the one place that knows.
  */
 export const missingRuntimeDependencies = (
@@ -163,7 +163,7 @@ export const missingRuntimeDependencies = (
 ): MissingDependency[] => [
   ...searchProviderDependencies(config.search.provider, root, pkgDir),
   ...sourceAdapterDependencies(config.content.sources, root, pkgDir),
-  ...askProviderDependencies(config.ai.ask, root, pkgDir),
+  ...assistantProviderDependencies(config.ai.assistant, root, pkgDir),
   ...deploymentAdapterDependencies(config.deployment, root, pkgDir),
   ...islandFrameworkDependencies(frameworks, root),
 ];

package/src/astro/templates.ts

@@ -196,10 +196,10 @@ export const runtimeDependencies = (options: {
       }
     }
   }
-  // Ask AI's provider SDK, as its adapter declares it (the gateway needs
+  // The assistant's provider SDK, as its adapter declares it (the gateway needs
   // nothing beyond core `ai`, so it declares none).
-  if (config.ai.ask?.enabled && !config.ai.ask.endpoint) {
-    deps.push(...config.ai.ask.provider.runtimeDeps);
+  if (config.ai.assistant?.enabled && !config.ai.assistant.endpoint) {
+    deps.push(...config.ai.assistant.provider.runtimeDeps);
   }
   // The deployment adapter's `@astrojs/*` package, for a server build; the
   // descriptor declares it (and nothing for a static build).
@@ -727,7 +727,7 @@ export const astroConfigTemplate = (options: {
     hasFonts: fontEntries.length > 0,
   });
 
-  // Framework renderers are only wired in when an island (or Ask AI, for React)
+  // Framework renderers are only wired in when an island (or the assistant, for React)
   // needs them. The core theme is Astro-first and ships no client JS.
   const reactImport = needsReact ? `import react from "@astrojs/react";\n` : "";
   const vueImport = needsVue ? `import vue from "@astrojs/vue";\n` : "";
@@ -1064,17 +1064,17 @@ export const collections = { docs${options.staged ? ", staged" : ""} };
 const ASK_FALLBACK_PROMPT =
   "You are a helpful documentation assistant. Answer using the project's documentation.";
 
-/** The `ai.ask` values the generated endpoint has to carry with it. */
+/** The `ai.assistant` values the generated endpoint has to carry with it. */
 export interface AskEndpointOptions {
-  /** `ai.ask.cors` — origins allowed to call the route from another site. */
+  /** `ai.assistant.cors` — origins allowed to call the route from another site. */
   cors?: string[];
-  /** `ai.ask.instructions` — extra system-prompt text. */
+  /** `ai.assistant.instructions` — extra system-prompt text. */
   instructions?: string;
-  /** `ai.ask.retrieval` — how much documentation each question carries. */
+  /** `ai.assistant.retrieval` — how much documentation each question carries. */
   retrieval?: AskRetrievalOptions;
 }
 
-/** The pieces `askEndpointTemplate` splices in for `ai.ask.cors`. */
+/** The pieces `askEndpointTemplate` splices in for `ai.assistant.cors`. */
 interface AskCorsTemplate {
   /** The route's closing token: `});` when the POST is wrapped, `};` otherwise. */
   close: string;
@@ -1087,7 +1087,7 @@ interface AskCorsTemplate {
 }
 
 /**
- * `ai.ask.cors`: a browser only lets another origin read the stream when the
+ * `ai.assistant.cors`: a browser only lets another origin read the stream when the
  * response names that origin, and a JSON POST preflights first, so the route
  * answers `OPTIONS` and wraps the `POST` in `withCors`, which stamps a listed
  * origin on every response — errors included, so a cross-origin caller can
@@ -1114,14 +1114,14 @@ export const OPTIONS: APIRoute = ({ request }) =>
     : { close: "};", imports: [], open: "async ({ request }) => {", setup: "" };
 
 /**
- * Largest request body the Ask AI route reads: 64 KB, well above the
+ * Largest request body the assistant route reads: 64 KB, well above the
  * 24,000-character message budget it validates next, so a real conversation
  * never meets it.
  */
 const ASK_BODY_LIMIT_BYTES = 65_536;
 
 /**
- * Generate the Ask AI server endpoint (`.blume/src/pages/api/ask.ts`).
+ * Generate the assistant server endpoint (`.blume/src/pages/api/ask.ts`).
  *
  * The provider-specific pieces — imports, the provider factory call, the model
  * expression, the credential guard, and the adapter's reasoning mapping and
@@ -1130,11 +1130,11 @@ const ASK_BODY_LIMIT_BYTES = 65_536;
  * `blume.config.ts`. `backend.grounded` decides whether answers are grounded
  * in the retrieved docs (every adapter but Inkeep, which retrieves itself).
  *
- * `options.instructions` (the `ai.ask.instructions` config) is appended to the
+ * `options.instructions` (the `ai.assistant.instructions` config) is appended to the
  * built-in prompt on every path: the grounded prompt via `createAskContext`,
- * and the plain fallback here. `options.retrieval` (the `ai.ask.retrieval`
+ * and the plain fallback here. `options.retrieval` (the `ai.assistant.retrieval`
  * config) is forwarded to `createAskContext` on the grounded path, where it
- * sizes retrieval. `options.cors` (the `ai.ask.cors` config) adds a preflight
+ * sizes retrieval. `options.cors` (the `ai.assistant.cors` config) adds a preflight
  * handler and wraps the `POST` so every response names a listed origin. All
  * three travel in one options object so a new call site can't silently drop
  * one of them.
@@ -1232,7 +1232,7 @@ export const askEndpointTemplate = (
   // Provider errors surface mid-stream, after the 200 is committed; this is
   // the only place they can be observed server-side.
   const onError = `      onError({ error }) {
-        console.error("Ask AI provider error:", error);
+        console.error("Assistant provider error:", error);
       },`;
   // The `streamText` argument list, built once so the grounded and plain
   // paths can't drift: they differ only in where the instructions come from.
@@ -1281,9 +1281,9 @@ ${handler}
  * Generate `.blume/src/generated/Ask.astro` — the component behind the
  * `blume:ask` alias that the shared header renders in place of a per-page slot.
  *
- * The header can't import the Ask AI island directly: it's a React component, so
+ * The header can't import the assistant island directly: it's a React component, so
  * the import alone would drag the JSX renderer into the module graph of every
- * project — including the ones that never enable Ask AI and therefore have no
+ * project — including the ones that never enable the assistant and therefore have no
  * React integration wired into their generated Astro config (see `needsReact`).
  * Routing the import through a generated component keeps that dependency behind
  * the config switch: enabled projects get the island, disabled ones get a
@@ -1293,25 +1293,25 @@ ${handler}
  * state suggestions are read straight from the data snapshot, which is why no
  * page has to pass them.
  */
-export const askComponentTemplate = (askEnabled: boolean): string =>
-  askEnabled
+export const askComponentTemplate = (assistantEnabled: boolean): string =>
+  assistantEnabled
     ? `---
 // Generated by Blume. Do not edit.
-import AskAI from "blume/components/islands/AskAI.astro";
+import Assistant from "blume/components/islands/Assistant.astro";
 import data from "blume:data";
 
 const { strings } = Astro.props;
 ---
 
-<AskAI
-  endpoint={data.config.ask?.endpoint ?? undefined}
-  strings={strings ?? data.ui.ask}
-  suggestions={data.config.ask?.suggestions ?? []}
+<Assistant
+  endpoint={data.config.assistant?.endpoint ?? undefined}
+  strings={strings ?? data.ui.assistant}
+  suggestions={data.config.assistant?.suggestions ?? []}
 />
 `
     : `---
 // Generated by Blume. Do not edit.
-// Ask AI is off (\`ai.ask.enabled\`), so the header's Ask trigger renders nothing.
+// The assistant is off (\`ai.assistant.enabled\`), so the header's Ask trigger renders nothing.
 // Deliberately imports no React island, keeping the JSX renderer out of projects
 // that don't need it.
 ---

package/src/blume-modules.d.ts

@@ -18,9 +18,9 @@ declare module "blume:search-client" {
 declare module "blume:ask" {
   /** The generated Ask trigger (see `askComponentTemplate`); empty when Ask is off. */
   // Mirrors the generated `.blume/src/env.d.ts` declaration: the trigger's type
-  // is the AskAI island the enabled template re-exports.
+  // is the Assistant island the enabled template re-exports.
   // oxlint-disable-next-line typescript/consistent-type-imports
-  const Ask: typeof import("./components/islands/AskAI.astro").default;
+  const Ask: typeof import("./components/islands/Assistant.astro").default;
   export default Ask;
 }
 

package/src/cli/commands/audit.ts

@@ -154,7 +154,7 @@ export const auditCommand = defineCommand({
       (kind) => args[kind]
     );
     if (agents.length > 1) {
-      logger.error("Pass at most one of --claude or --codex.");
+      logger.error("Pass at most one of --codex or --claude.");
       process.exit(1);
     }
     const [agent] = agents;

package/src/cli/commands/doctor.ts

@@ -153,12 +153,14 @@ export const doctorCommand = defineCommand({
         logger.info(
           `Sources: ${config.content.sources.map((source) => source.kind).join(", ")}`
         );
-        const { ask } = config.ai;
-        let askSummary = "off";
-        if (ask?.enabled) {
-          askSummary = ask.endpoint ? "external endpoint" : ask.provider.kind;
+        const { assistant } = config.ai;
+        let assistantSummary = "off";
+        if (assistant?.enabled) {
+          assistantSummary = assistant.endpoint
+            ? "external endpoint"
+            : assistant.provider.kind;
         }
-        logger.info(`Ask AI: ${askSummary}`);
+        logger.info(`Assistant: ${assistantSummary}`);
       }
     } catch (error) {
       if (error instanceof BlumeError) {

package/src/cli/commands/eval.ts

@@ -82,7 +82,7 @@ interface EvalFlags {
 /** Validate the flag surface, exiting with a message on the first offense. */
 const parseFlags = (args: EvalFlags) => {
   if (!isAgentKind(args.agent)) {
-    logger.error(`Invalid --agent "${args.agent}" (use claude | codex).`);
+    logger.error(`Invalid --agent "${args.agent}" (use codex | claude).`);
     process.exit(1);
   }
   if (args.action !== undefined && args.action !== "init") {
@@ -152,8 +152,8 @@ export const evalCommand = defineCommand({
       type: "positional",
     },
     agent: {
-      default: "claude",
-      description: "Agent CLI that reads and grades the docs: claude | codex.",
+      default: "codex",
+      description: "Agent CLI that reads and grades the docs: codex | claude.",
       type: "string",
     },
     file: {

package/src/cli/commands/migrate.ts

@@ -53,7 +53,7 @@ export const migrateCommand = defineCommand({
       (kind) => args[kind]
     );
     if (agents.length > 1) {
-      logger.error("Pass at most one of --claude or --codex.");
+      logger.error("Pass at most one of --codex or --claude.");
       process.exit(1);
     }
     const [agent] = agents;
@@ -88,7 +88,7 @@ export const migrateCommand = defineCommand({
       // plus the install line that puts the skill where agents look for it.
       if (!agent) {
         process.stderr.write(
-          `  blume migrate runs the migration with a coding agent: rerun with --claude or --codex.\n  Using another agent? Point it at ${join(skillDir, "SKILL.md")},\n  or install the skill where your agent looks for skills: npx skills add haydenbleasel/blume --skill blume-migrate\n`
+          `  blume migrate runs the migration with a coding agent: rerun with --codex or --claude.\n  Using another agent? Point it at ${join(skillDir, "SKILL.md")},\n  or install the skill where your agent looks for skills: npx skills add haydenbleasel/blume --skill blume-migrate\n`
         );
         return;
       }

package/src/cli/commands/translate.ts

@@ -63,18 +63,18 @@ const parseFlags = (args: TranslateFlags): ParsedTranslateFlags => {
     (kind) => args[kind]
   );
   if (agents.length > 1) {
-    logger.error("Pass exactly one of --claude or --codex.");
+    logger.error("Pass exactly one of --codex or --claude.");
     process.exit(1);
   }
   if (args.check && agents.length > 0) {
     logger.error(
-      "--check is read-only and never runs an agent; drop --claude/--codex."
+      "--check is read-only and never runs an agent; drop --codex/--claude."
     );
     process.exit(1);
   }
   if (!args.check && agents.length === 0) {
     logger.error(
-      "Pass --claude or --codex to choose the agent CLI that translates."
+      "Pass --codex or --claude to choose the agent CLI that translates."
     );
     process.exit(1);
   }

package/src/cli/commands/upgrade.ts

@@ -56,7 +56,7 @@ export const upgradeCommand = defineCommand({
       (kind) => args[kind]
     );
     if (agents.length > 1) {
-      logger.error("Pass at most one of --claude or --codex.");
+      logger.error("Pass at most one of --codex or --claude.");
       process.exit(1);
     }
     const [agent] = agents;
@@ -109,7 +109,7 @@ export const upgradeCommand = defineCommand({
 
       if (!agent) {
         process.stderr.write(
-          `  Each change is covered in the upgrade guide: ${UPGRADE_GUIDE_URL}\n  Rerun with --claude or --codex to hand them to a coding agent.\n`
+          `  Each change is covered in the upgrade guide: ${UPGRADE_GUIDE_URL}\n  Rerun with --codex or --claude to hand them to a coding agent.\n`
         );
         process.exit(1);
       }

package/src/cli/required-secrets.ts

@@ -24,12 +24,12 @@ export const checkRequiredSecrets = (config: ResolvedConfig): Diagnostic[] => {
     });
   };
 
-  if (config.ai.ask?.enabled && !config.ai.ask.endpoint) {
+  if (config.ai.assistant?.enabled && !config.ai.assistant.endpoint) {
     // The adapter descriptor names the env vars its route reads.
-    const { provider } = config.ai.ask;
+    const { provider } = config.ai.assistant;
     const backend = resolveAskBackend(provider);
     for (const env of provider.requiredSecrets) {
-      requireSecret(`Ask AI (${backend.label})`, env, backend.secretNote);
+      requireSecret(`Assistant (${backend.label})`, env, backend.secretNote);
     }
   }
 

package/src/components/copy-feedback.ts

@@ -1,6 +1,6 @@
 /**
  * Shared clipboard + "Copied" feedback used by every copy affordance (code
- * blocks, page actions, color swatches, prompts, API panels, Ask AI). One
+ * blocks, page actions, color swatches, prompts, API panels, the assistant). One
  * implementation owns the invariants each site used to hand-roll:
  *
  * - the clipboard write is guarded and a confirmation must never lie: a

package/src/components/islands/{AskAI.astro → Assistant.astro}

@@ -1,7 +1,7 @@
 ---
 import type { UIStrings } from "../../core/i18n-ui.ts";
 import { resolveIcon } from "../../theme/icons.ts";
-import AskAI from "./ask-ai.tsx";
+import Assistant from "./assistant.tsx";
 
 interface Suggestion {
   icon?: string;
@@ -10,7 +10,7 @@ interface Suggestion {
 
 interface Props {
   endpoint?: string;
-  strings?: UIStrings["ask"];
+  strings?: UIStrings["assistant"];
   suggestions?: Suggestion[];
 }
 
@@ -48,19 +48,19 @@ const icons = {
     the draft input, and the open panel — across client-router navigations
     instead of remounting it empty on every page. The island re-portals its
     panel and re-stamps the body push attribute itself on astro:after-swap
-    (see ask-ai.tsx), since the swap replaces <body> wholesale. */}
-<AskAI
+    (see assistant.tsx), since the swap replaces <body> wholesale. */}
+<Assistant
   client:load
   endpoint={endpoint}
   icons={icons}
   strings={strings}
   suggestions={items}
-  transition:persist="blume-ask"
+  transition:persist="blume-assistant"
 />
 
 <style is:global>
   :root {
-    --blume-ask-width: min(30rem, 100vw);
+    --blume-assistant-width: min(30rem, 100vw);
   }
 
   /* Desktop docks the panel and shrinks the page to fit, like vercel.com/docs.
@@ -70,8 +70,8 @@ const icons = {
       transition: padding-inline-end 0.2s ease-out;
     }
 
-    body[data-blume-ask="open"] {
-      padding-inline-end: var(--blume-ask-width);
+    body[data-blume-assistant="open"] {
+      padding-inline-end: var(--blume-assistant-width);
     }
   }
 
@@ -81,11 +81,11 @@ const icons = {
      changelog index) is single-column, and forcing the sidebar tracks onto it
      would squeeze its only item — <main> — into the 17.5rem track. */
   @media (min-width: 1280px) {
-    body[data-blume-ask="open"] [data-blume-toc] {
+    body[data-blume-assistant="open"] [data-blume-toc] {
       display: none;
     }
 
-    body[data-blume-ask="open"] [data-blume-doc-grid]:has([data-blume-toc]) {
+    body[data-blume-assistant="open"] [data-blume-doc-grid]:has([data-blume-toc]) {
       grid-template-columns: 17.5rem minmax(0, 1fr);
     }
   }