blume 2.0.0 → 2.0.1

package/dist/types/ai/ask.d.ts

@@ -5,17 +5,17 @@ import type { AdapterDescriptor, JsonValue } from "../core/adapter.ts";
  * `reasoning` values minus `provider-default`, which is what omitting the
  * option means.
  */
-export declare const askReasoningLevels: readonly ["none", "minimal", "low", "medium", "high", "xhigh"];
+export declare const assistantReasoningLevels: readonly ["none", "minimal", "low", "medium", "high", "xhigh"];
 /** How much the model reasons before answering (an adapter's `reasoning`). */
-export type AskReasoning = (typeof askReasoningLevels)[number];
+export type AssistantReasoning = (typeof assistantReasoningLevels)[number];
 /**
  * The AI SDK's `providerOptions` shape, forwarded to `streamText` verbatim:
  * `{ [provider]: { [option]: value } }`. The escape hatch for model controls
  * Blume doesn't name, so a new provider knob never needs a Blume field.
  */
-export type AskProviderOptions = Record<string, Record<string, JsonValue>>;
-/** The options every Ask AI adapter accepts. */
-export interface AskAdapterOptions {
+export type AssistantProviderOptions = Record<string, Record<string, JsonValue>>;
+/** The options every assistant adapter accepts. */
+export interface AssistantAdapterOptions {
     /**
      * Name of the env var holding the provider's API key. Each adapter has its
      * own default; set this only to point at a different variable.
@@ -32,10 +32,10 @@ export interface AskAdapterOptions {
      * Options passed to `streamText` as its `providerOptions`, untouched, in the
      * AI SDK's own shape (`{ openai: { textVerbosity: "low" } }`, say).
      */
-    providerOptions?: AskProviderOptions;
+    providerOptions?: AssistantProviderOptions;
 }
 /** Options for {@link gateway}. */
-export interface AskGatewayOptions extends AskAdapterOptions {
+export interface AssistantGatewayOptions extends AssistantAdapterOptions {
     /** A `provider/model` id routed by the gateway. Defaults to `openai/gpt-5.5`. */
     model?: string;
     /**
@@ -44,9 +44,9 @@ export interface AskGatewayOptions extends AskAdapterOptions {
      * control (OpenAI's `reasoning_effort`, for example); the model has to
      * offer the level you pick. Omitted keeps the model's default.
      */
-    reasoning?: AskReasoning;
+    reasoning?: AssistantReasoning;
 }
-export type AskGatewayAdapter = AdapterDescriptor<"gateway", AskGatewayOptions>;
+export type AssistantGatewayAdapter = AdapterDescriptor<"gateway", AssistantGatewayOptions>;
 export declare const gatewayAdapterSchema: z.ZodObject<{
     kind: z.ZodLiteral<"gateway">;
     options: z.ZodObject<{
@@ -67,14 +67,14 @@ export declare const gatewayAdapterSchema: z.ZodObject<{
     runtimeDeps: z.ZodArray<z.ZodString>;
 }, z.core.$strict>;
 /**
- * Route Ask AI through the Vercel AI Gateway (the default). `model` is a
+ * Route the assistant through the Vercel AI Gateway (the default). `model` is a
  * `provider/model` string; the key is `AI_GATEWAY_API_KEY`, or Vercel's OIDC
  * token when deployed there. Needs no provider SDK beyond the `ai` package
  * Blume ships.
  */
-export declare const gateway: (options?: AskGatewayOptions) => AskGatewayAdapter;
+export declare const gateway: (options?: AssistantGatewayOptions) => AssistantGatewayAdapter;
 /** Options for {@link openrouter}. */
-export interface AskOpenRouterOptions extends AskAdapterOptions {
+export interface AssistantOpenRouterOptions extends AssistantAdapterOptions {
     /** The OpenRouter model id (`anthropic/claude-sonnet-4-5`). */
     model: string;
     /**
@@ -82,9 +82,9 @@ export interface AskOpenRouterOptions extends AskAdapterOptions {
      * OpenRouter's `reasoning.effort`, because its provider ignores the AI
      * SDK's call-level option. Omitted keeps the model's default.
      */
-    reasoning?: AskReasoning;
+    reasoning?: AssistantReasoning;
 }
-export type AskOpenRouterAdapter = AdapterDescriptor<"openrouter", AskOpenRouterOptions>;
+export type AssistantOpenRouterAdapter = AdapterDescriptor<"openrouter", AssistantOpenRouterOptions>;
 export declare const openrouterAdapterSchema: z.ZodObject<{
     kind: z.ZodLiteral<"openrouter">;
     options: z.ZodObject<{
@@ -105,12 +105,12 @@ export declare const openrouterAdapterSchema: z.ZodObject<{
     runtimeDeps: z.ZodArray<z.ZodString>;
 }, z.core.$strict>;
 /**
- * Route Ask AI through OpenRouter. Reads `OPENROUTER_API_KEY` and needs
+ * Route the assistant through OpenRouter. Reads `OPENROUTER_API_KEY` and needs
  * `@openrouter/ai-sdk-provider` installed in the project.
  */
-export declare const openrouter: (options: AskOpenRouterOptions) => AskOpenRouterAdapter;
+export declare const openrouter: (options: AssistantOpenRouterOptions) => AssistantOpenRouterAdapter;
 /** Options for {@link llmgateway}. */
-export interface AskLlmGatewayOptions extends AskAdapterOptions {
+export interface AssistantLlmGatewayOptions extends AssistantAdapterOptions {
     /** Overrides the preset endpoint (`https://api.llmgateway.io/v1`). */
     baseUrl?: string;
     /** The model id LLMGateway serves. */
@@ -119,9 +119,9 @@ export interface AskLlmGatewayOptions extends AskAdapterOptions {
      * How much the model reasons before answering, sent in the request as
      * `reasoning_effort`. Omitted keeps the model's default.
      */
-    reasoning?: AskReasoning;
+    reasoning?: AssistantReasoning;
 }
-export type AskLlmGatewayAdapter = AdapterDescriptor<"llmgateway", AskLlmGatewayOptions>;
+export type AssistantLlmGatewayAdapter = AdapterDescriptor<"llmgateway", AssistantLlmGatewayOptions>;
 export declare const llmgatewayAdapterSchema: z.ZodObject<{
     kind: z.ZodLiteral<"llmgateway">;
     options: z.ZodObject<{
@@ -143,21 +143,21 @@ export declare const llmgatewayAdapterSchema: z.ZodObject<{
     runtimeDeps: z.ZodArray<z.ZodString>;
 }, z.core.$strict>;
 /**
- * Route Ask AI through LLMGateway's OpenAI-compatible endpoint. Reads
+ * Route the assistant through LLMGateway's OpenAI-compatible endpoint. Reads
  * `LLMGATEWAY_API_KEY` and needs `@ai-sdk/openai-compatible` installed.
  */
-export declare const llmgateway: (options: AskLlmGatewayOptions) => AskLlmGatewayAdapter;
+export declare const llmgateway: (options: AssistantLlmGatewayOptions) => AssistantLlmGatewayAdapter;
 /**
  * Options for {@link inkeep}. No `reasoning`: Inkeep runs its own QA pipeline
  * behind an OpenAI-compatible endpoint with no reasoning control.
  */
-export interface AskInkeepOptions extends AskAdapterOptions {
+export interface AssistantInkeepOptions extends AssistantAdapterOptions {
     /** Overrides the preset endpoint (`https://api.inkeep.com/v1`). */
     baseUrl?: string;
     /** The Inkeep QA model id. */
     model: string;
 }
-export type AskInkeepAdapter = AdapterDescriptor<"inkeep", AskInkeepOptions>;
+export type AssistantInkeepAdapter = AdapterDescriptor<"inkeep", AssistantInkeepOptions>;
 export declare const inkeepAdapterSchema: z.ZodObject<{
     kind: z.ZodLiteral<"inkeep">;
     options: z.ZodObject<{
@@ -175,9 +175,9 @@ export declare const inkeepAdapterSchema: z.ZodObject<{
  * dashboard, so Blume leaves it ungrounded and it takes no `reasoning`.
  * Reads `INKEEP_API_KEY` and needs `@ai-sdk/openai-compatible` installed.
  */
-export declare const inkeep: (options: AskInkeepOptions) => AskInkeepAdapter;
+export declare const inkeep: (options: AssistantInkeepOptions) => AssistantInkeepAdapter;
 /** Options for {@link openaiCompatible}. */
-export interface AskOpenAICompatibleOptions extends AskAdapterOptions {
+export interface AssistantOpenAICompatibleOptions extends AssistantAdapterOptions {
     /** Name of the env var holding the endpoint's API key. */
     apiKeyEnv: string;
     /** The endpoint's base URL (`https://my-gateway.example.com/v1`). */
@@ -191,9 +191,9 @@ export interface AskOpenAICompatibleOptions extends AskAdapterOptions {
      * `reasoning_effort`, so the endpoint has to accept that parameter.
      * Omitted keeps the model's default.
      */
-    reasoning?: AskReasoning;
+    reasoning?: AssistantReasoning;
 }
-export type AskOpenAICompatibleAdapter = AdapterDescriptor<"openai-compatible", AskOpenAICompatibleOptions>;
+export type AssistantOpenAICompatibleAdapter = AdapterDescriptor<"openai-compatible", AssistantOpenAICompatibleOptions>;
 export declare const openaiCompatibleAdapterSchema: z.ZodObject<{
     kind: z.ZodLiteral<"openai-compatible">;
     options: z.ZodObject<{
@@ -216,28 +216,28 @@ export declare const openaiCompatibleAdapterSchema: z.ZodObject<{
     runtimeDeps: z.ZodArray<z.ZodString>;
 }, z.core.$strict>;
 /**
- * Route Ask AI through any OpenAI-compatible endpoint: supply its `baseUrl`,
+ * Route the assistant through any OpenAI-compatible endpoint: supply its `baseUrl`,
  * the `model` it serves, and the env var holding its key. Needs
  * `@ai-sdk/openai-compatible` installed.
  */
-export declare const openaiCompatible: (options: AskOpenAICompatibleOptions) => AskOpenAICompatibleAdapter;
-/** Which backend answers Ask AI: the value of `gateway()`, `openrouter()`, … */
-export type AskAdapter = AskGatewayAdapter | AskOpenRouterAdapter | AskLlmGatewayAdapter | AskInkeepAdapter | AskOpenAICompatibleAdapter;
+export declare const openaiCompatible: (options: AssistantOpenAICompatibleOptions) => AssistantOpenAICompatibleAdapter;
+/** Which backend answers the assistant: the value of `gateway()`, `openrouter()`, … */
+export type AssistantAdapter = AssistantGatewayAdapter | AssistantOpenRouterAdapter | AssistantLlmGatewayAdapter | AssistantInkeepAdapter | AssistantOpenAICompatibleAdapter;
 /**
- * Error params for `ai.ask`: a 1.x flat provider field (`model`, `apiKeyEnv`,
+ * Error params for `ai.assistant`: a 1.x flat provider field (`model`, `apiKeyEnv`,
  * `baseUrl`, `headers`, `reasoning`) names the adapter call it moves into —
  * the one the object's `provider` picks, 1.x string or descriptor — instead
  * of Zod's bare "Unrecognized key"; any other unknown key keeps its wording.
  */
-export declare const askMovedFieldsHint: {
+export declare const assistantMovedFieldsHint: {
     error: (issue: z.core.$ZodRawIssue) => string | undefined;
 };
 /**
- * `ai.ask.provider`: the descriptor an adapter factory returned, validated
+ * `ai.assistant.provider`: the descriptor an adapter factory returned, validated
  * against that adapter's own option schema. A value that isn't a descriptor
  * at all (a 1.x provider name) names the factory that replaced it.
  */
-export declare const askAdapterSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+export declare const assistantAdapterSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"gateway">;
     options: z.ZodObject<{
         model: z.ZodDefault<z.ZodString>;
@@ -324,11 +324,11 @@ export declare const askAdapterSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     requiredSecrets: z.ZodArray<z.ZodString>;
     runtimeDeps: z.ZodArray<z.ZodString>;
 }, z.core.$strict>], "kind">;
-/** A resolved (post-defaults) `ai.ask.provider` descriptor. */
-export type AskAdapterConfig = z.output<typeof askAdapterSchema>;
-export type AskAdapterKind = AskAdapterConfig["kind"];
-/** The provider when `ai.ask.provider` is unset: the gateway with its defaults. */
-export declare const DEFAULT_ASK_PROVIDER: AskAdapter;
+/** A resolved (post-defaults) `ai.assistant.provider` descriptor. */
+export type AssistantAdapterConfig = z.output<typeof assistantAdapterSchema>;
+export type AssistantAdapterKind = AssistantAdapterConfig["kind"];
+/** The provider when `ai.assistant.provider` is unset: the gateway with its defaults. */
+export declare const DEFAULT_ASSISTANT_PROVIDER: AssistantAdapter;
 /** The route fragments an adapter contributes to `askEndpointTemplate`. */
 export interface AskBackendTemplate {
     /**
@@ -357,12 +357,12 @@ export interface AskBackendTemplate {
 export interface AskBackend {
     /** Whether Blume grounds answers in the docs (Inkeep retrieves itself). */
     grounded: boolean;
-    kind: AskAdapterKind;
+    kind: AssistantAdapterKind;
     /** Human-readable adapter name for diagnostics ("AI Gateway"). */
     label: string;
     /** Appended to the missing-secret warning (an alternative credential, say). */
     secretNote?: string;
     template: AskBackendTemplate;
 }
-/** Resolve a parsed `ai.ask.provider` descriptor into its backend. */
-export declare const resolveAskBackend: (provider?: AskAdapterConfig) => AskBackend;
+/** Resolve a parsed `ai.assistant.provider` descriptor into its backend. */
+export declare const resolveAskBackend: (provider?: AssistantAdapterConfig) => AskBackend;

package/dist/types/ai/index.d.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" }),
  *     },
@@ -20,5 +20,5 @@
  * nothing here runs at request time.
  */
 export { gateway, inkeep, llmgateway, openaiCompatible, openrouter, } from "./ask.ts";
-export type { AskAdapter, AskAdapterOptions, AskGatewayAdapter, AskGatewayOptions, AskInkeepAdapter, AskInkeepOptions, AskLlmGatewayAdapter, AskLlmGatewayOptions, AskOpenAICompatibleAdapter, AskOpenAICompatibleOptions, AskOpenRouterAdapter, AskOpenRouterOptions, AskProviderOptions, AskReasoning, } from "./ask.ts";
+export type { 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/dist/types/ai/openapi-components.d.ts

@@ -7,7 +7,7 @@ import type { OpenApiData } from "../openapi/model.ts";
  * 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/dist/types/ai/serializers.d.ts

@@ -1,7 +1,7 @@
 import type { BlumeProject } from "../core/project-graph.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/dist/types/ai/visibility.d.ts

@@ -11,7 +11,7 @@ export type VisibilityAudience = "agents" | "web";
 export declare const applyAudienceVisibility: (markdown: string, audience: VisibilityAudience) => string;
 /**
  * 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 declare const applyAgentVisibility: (markdown: string) => string;

package/dist/types/core/config-input.d.ts

@@ -1,5 +1,5 @@
 import type { AstroIntegration } from "astro";
-import type { AskAdapter } from "../ai/ask.ts";
+import type { AssistantAdapter } from "../ai/ask.ts";
 import type { ComponentMarkdown } from "../ai/component-markdown.ts";
 import type { AnalyticsAdapter } from "../analytics/schema.ts";
 import type { DeploymentInput } from "../deploy/adapters/registry.ts";
@@ -420,15 +420,15 @@ export interface SearchOptions {
  * links and `indexing` settings.
  */
 export type SearchConfig = SearchProviderConfig | SearchOptions;
-/** An empty-state prompt shown before the first Ask AI question. */
-export interface AskSuggestion {
+/** An empty-state prompt shown before the first question to the assistant. */
+export interface AssistantSuggestion {
     /** Lucide icon name shown beside the suggestion. */
     icon?: string;
     /** The clickable suggestion text. */
     label: string;
 }
-/** How much retrieved documentation each Ask AI question carries. */
-export interface AskRetrievalConfig {
+/** How much retrieved documentation each question to the assistant carries. */
+export interface AssistantRetrievalConfig {
     /**
      * Total injected documentation characters, across all excerpts. Defaults to
      * `10000`. The single biggest lever on time-to-first-token — the model reads
@@ -448,8 +448,8 @@ export interface AskRetrievalConfig {
      */
     maxResults?: number;
 }
-/** The Ask AI chat assistant. */
-export interface AskConfig {
+/** The chat assistant. */
+export interface AssistantConfig {
     /**
      * Origins allowed to call the generated endpoint from another site — a
      * marketing page that embeds an ask box, for example — or `"*"` to allow
@@ -462,10 +462,10 @@ export interface AskConfig {
      * combined with it.
      */
     cors?: string[];
-    /** Turn Ask AI on. Defaults to `false`. */
+    /** Turn the assistant on. Defaults to `false`. */
     enabled?: boolean;
     /**
-     * Existing Ask AI endpoint to call instead of generating one. This keeps a
+     * Existing assistant endpoint to call instead of generating one. This keeps a
      * Blume site static while an API backend owns retrieval, model access, rate
      * limiting, and streaming. Accepts an absolute URL or root-relative path.
      */
@@ -485,15 +485,15 @@ export interface AskConfig {
      * mapping, and `providerOptions` passthrough. Defaults to
      * `gateway({ model: "openai/gpt-5.5" })`.
      */
-    provider?: AskAdapter;
+    provider?: AssistantAdapter;
     /**
      * How much documentation each question carries into the model's prompt.
      * Lower values cut time-to-first-token — which dominates on a self-hosted
      * backend — at the cost of recall. Defaults keep the built-in behavior.
      */
-    retrieval?: AskRetrievalConfig;
+    retrieval?: AssistantRetrievalConfig;
     /** Starter prompts shown before the first question. */
-    suggestions?: AskSuggestion[];
+    suggestions?: AssistantSuggestion[];
 }
 /** What the AI Catalog (ARD) manifest carries. */
 export interface AiCatalogConfig {
@@ -557,10 +557,10 @@ export interface McpConfig {
     /** Route the server mounts at. Defaults to `/mcp`. */
     route?: string;
 }
-/** Model-facing features: the Ask AI assistant and the "Open in chat" action. */
+/** Model-facing features: the assistant and the "Open in chat" action. */
 export interface AiConfig {
-    /** The Ask AI chat assistant. */
-    ask?: AskConfig;
+    /** The chat assistant. */
+    assistant?: AssistantConfig;
     /**
      * The "Open in chat" page action, which opens the current page in an AI
      * assistant pre-filled with a prompt pointing at its raw Markdown.
@@ -728,7 +728,7 @@ export type ContentSignalsConfig = boolean | {
 /**
  * The machine-readable surface agents consume: the JSON API, `llms.txt`, the
  * MCP server, published skills, discovery manifests, and the robots.txt usage
- * policy. The reader-facing model features (Ask AI, Open in chat) live under
+ * policy. The reader-facing model features (the assistant, Open in chat) live under
  * `ai`.
  */
 export interface AgentsConfig {
@@ -1184,7 +1184,7 @@ export type TocConfig = boolean | {
 export interface BlumeConfig {
     /** The machine-readable surface for agents: JSON API, `llms.txt`, MCP, skills, discovery. */
     agents?: AgentsConfig;
-    /** Model-facing features: the Ask AI assistant and the "Open in chat" action. */
+    /** Model-facing features: the assistant and the "Open in chat" action. */
     ai?: AiConfig;
     /**
      * Analytics adapters from `blume/analytics`, emitted into `<head>` of every

package/dist/types/core/config.d.ts

@@ -74,7 +74,7 @@ import type { Diagnostic } from "./types.ts";
  *   `flexsearch()`, `pagefind()`, `algolia({…})`, `oramaCloud({…})`,
  *   `typesense({…})`, `mixedbread({…})`, or `false`), or `{ provider,
  *   popular, indexing }` to add curated links and indexing settings.
- * - `ai` — what faces a model at read time: `ask` (the Ask AI assistant, with
+ * - `ai` — what faces a model at read time: `assistant` (the chat assistant, with
  *   a provider adapter from `blume/ai` such as `gateway()` or `openrouter()`)
  *   and `openInChat` (the "Open in chat" page action).
  * - `agents` — the machine-readable surface: `llmsTxt`, the JSON `api`, the
@@ -133,7 +133,7 @@ import type { Diagnostic } from "./types.ts";
  * });
  * ```
  *
- * @example An OpenAPI reference with the Ask AI assistant enabled.
+ * @example An OpenAPI reference with the assistant enabled.
  * ```ts
  * import { openapi } from "blume/reference";
  *
@@ -146,7 +146,7 @@ import type { Diagnostic } from "./types.ts";
  *     }),
  *   ],
  *   agents: { llmsTxt: true },
- *   ai: { ask: { enabled: true } },
+ *   ai: { assistant: { enabled: true } },
  * });
  * ```
  *

package/dist/types/core/data.d.ts

@@ -125,10 +125,10 @@ export interface BlumeDataConfig {
     analytics: ResolvedConfig["analytics"];
     /** Apple touch icon, or `null` when none is configured/detected. */
     appleIcon: BlumeFavicon | null;
-    /** Ask AI empty-state suggestions, or `null` when Ask AI is off. */
-    ask: {
+    /** The assistant's empty-state suggestions, or `null` when the assistant is off. */
+    assistant: {
         endpoint: string | null;
-        suggestions: NonNullable<ResolvedConfig["ai"]["ask"]>["suggestions"];
+        suggestions: NonNullable<ResolvedConfig["ai"]["assistant"]>["suggestions"];
     } | null;
     banner: BlumeBanner | null;
     /** Site-wide route mount point, normalized to `""` or `/seg` (see config). */

package/dist/types/core/i18n-ui.d.ts

@@ -11,7 +11,6 @@ declare const uiStringsObject: z.ZodObject<{
     actions: z.ZodPrefault<z.ZodObject<{
         addToCursor: z.ZodDefault<z.ZodString>;
         addToVscode: z.ZodDefault<z.ZodString>;
-        askAI: z.ZodDefault<z.ZodString>;
         connectMcp: z.ZodDefault<z.ZodString>;
         copied: z.ZodDefault<z.ZodString>;
         copyClaudeCode: z.ZodDefault<z.ZodString>;
@@ -30,7 +29,7 @@ declare const uiStringsObject: z.ZodObject<{
         openInChatPrompt: z.ZodDefault<z.ZodString>;
         scrollToTop: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
-    ask: z.ZodPrefault<z.ZodObject<{
+    assistant: z.ZodPrefault<z.ZodObject<{
         ai: z.ZodDefault<z.ZodString>;
         clear: z.ZodDefault<z.ZodString>;
         close: z.ZodDefault<z.ZodString>;
@@ -100,8 +99,8 @@ declare const uiStringsObject: z.ZodObject<{
         all: z.ZodDefault<z.ZodString>;
         allLanguages: z.ZodDefault<z.ZodString>;
         allVersions: z.ZodDefault<z.ZodString>;
-        askAi: z.ZodDefault<z.ZodString>;
-        askAiHint: z.ZodDefault<z.ZodString>;
+        assistant: z.ZodDefault<z.ZodString>;
+        assistantHint: z.ZodDefault<z.ZodString>;
         button: z.ZodDefault<z.ZodString>;
         devOnly: z.ZodDefault<z.ZodString>;
         error: z.ZodDefault<z.ZodString>;
@@ -127,7 +126,6 @@ export declare const uiStringsSchema: z.ZodPrefault<z.ZodObject<{
     actions: z.ZodPrefault<z.ZodObject<{
         addToCursor: z.ZodDefault<z.ZodString>;
         addToVscode: z.ZodDefault<z.ZodString>;
-        askAI: z.ZodDefault<z.ZodString>;
         connectMcp: z.ZodDefault<z.ZodString>;
         copied: z.ZodDefault<z.ZodString>;
         copyClaudeCode: z.ZodDefault<z.ZodString>;
@@ -146,7 +144,7 @@ export declare const uiStringsSchema: z.ZodPrefault<z.ZodObject<{
         openInChatPrompt: z.ZodDefault<z.ZodString>;
         scrollToTop: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
-    ask: z.ZodPrefault<z.ZodObject<{
+    assistant: z.ZodPrefault<z.ZodObject<{
         ai: z.ZodDefault<z.ZodString>;
         clear: z.ZodDefault<z.ZodString>;
         close: z.ZodDefault<z.ZodString>;
@@ -216,8 +214,8 @@ export declare const uiStringsSchema: z.ZodPrefault<z.ZodObject<{
         all: z.ZodDefault<z.ZodString>;
         allLanguages: z.ZodDefault<z.ZodString>;
         allVersions: z.ZodDefault<z.ZodString>;
-        askAi: z.ZodDefault<z.ZodString>;
-        askAiHint: z.ZodDefault<z.ZodString>;
+        assistant: z.ZodDefault<z.ZodString>;
+        assistantHint: z.ZodDefault<z.ZodString>;
         button: z.ZodDefault<z.ZodString>;
         devOnly: z.ZodDefault<z.ZodString>;
         error: z.ZodDefault<z.ZodString>;

package/dist/types/core/schema.d.ts

@@ -471,7 +471,7 @@ type SearchOptionsInput = z.input<typeof searchOptionsSchema>;
 /** What `search` accepts: an adapter (or `false`) directly, or the object form. */
 type SearchConfigInput = false | SearchAdapterInput | SearchOptionsInput;
 declare const aiConfigSchema: z.ZodObject<{
-    ask: z.ZodOptional<z.ZodObject<{
+    assistant: z.ZodOptional<z.ZodObject<{
         cors: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodPipe<z.ZodURL, z.ZodTransform<string, string>>]>>>;
         enabled: z.ZodDefault<z.ZodBoolean>;
         endpoint: z.ZodOptional<z.ZodString>;
@@ -582,9 +582,9 @@ declare const aiConfigSchema: z.ZodObject<{
         cursor: "cursor";
     }>>]>>, z.ZodTransform<("v0" | "chatgpt" | "claude" | "t3" | "scira" | "cursor")[], boolean | ("v0" | "chatgpt" | "claude" | "t3" | "scira" | "cursor")[]>>;
 }, z.core.$strict>;
-export { askReasoningLevels } from "../ai/ask.ts";
-export type { AskReasoning } from "../ai/ask.ts";
-export type AskAiConfig = NonNullable<z.infer<typeof aiConfigSchema>["ask"]>;
+export { assistantReasoningLevels } from "../ai/ask.ts";
+export type { AssistantReasoning } from "../ai/ask.ts";
+export type AssistantConfig = NonNullable<z.infer<typeof aiConfigSchema>["assistant"]>;
 export { openInChatProviders } from "./open-in-chat.ts";
 export type { OpenInChatProvider } from "./open-in-chat.ts";
 /** A configured locale: ISO-ish code plus display metadata for the switcher. */
@@ -785,7 +785,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
         webmcp: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strict>>;
     ai: z.ZodPrefault<z.ZodObject<{
-        ask: z.ZodOptional<z.ZodObject<{
+        assistant: z.ZodOptional<z.ZodObject<{
             cors: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodPipe<z.ZodURL, z.ZodTransform<string, string>>]>>>;
             enabled: z.ZodDefault<z.ZodBoolean>;
             endpoint: z.ZodOptional<z.ZodString>;

package/dist/types/core/unrecognized-keys.d.ts

@@ -2,6 +2,6 @@
  * Zod's own wording for unknown keys no removed-key hint covers, appended to
  * a hint so an unrelated typo isn't silently dropped from the diagnostic
  * beside it. Shared by every config object that names a removed field's
- * replacement (the root config, `ai.ask`, `openapi()`/`asyncapi()`, …).
+ * replacement (the root config, `ai.assistant`, `openapi()`/`asyncapi()`, …).
  */
 export declare const unrecognizedKeysMessage: (keys: string[]) => string;

package/dist/types/search/documents.d.ts

@@ -62,7 +62,7 @@ interface BuildOptions {
  *
  * `content` selects the extraction: `"plain"` (default) strips Markdown to bare
  * searchable text; `"markdown"` keeps the body's Markdown — code blocks, lists,
- * headings — for Ask AI grounding, where fenced examples are often the answer
+ * headings — for assistant grounding, where fenced examples are often the answer
  * and stripping them makes the model unable to cite content the docs do contain.
  * The `"markdown"` body is agent-facing, so components are downleveled with the
  * same serializers the `.md` mirror, llms-full.txt and MCP `get_page` use: a

package/dist/types/search/orama-index.d.ts

@@ -27,7 +27,7 @@ export interface OramaDoc {
 }
 /**
  * Build an in-memory Orama full-text index from search documents. Shared by the
- * Orama client loader (browser), the MCP server, and Ask AI grounding (Node),
+ * Orama client loader (browser), the MCP server, and assistant grounding (Node),
  * so ranking is identical wherever docs are queried. `locale` — the site's
  * `i18n.defaultLocale` — swaps in a word-segmenting tokenizer for every
  * non-Latin script, all of which Orama's default tokenizer reduces to zero

package/docs/02-deployment.mdx

@@ -81,7 +81,7 @@ This is a distinct concept from the two paths above:
 
 ## Server rendering
 
-Static output covers most docs. Switch to server output when you need request-time features — most notably the [Ask AI](/docs/configuration/ask-ai) endpoint and the [MCP server](/docs/discoverability/mcp). You do that by naming the host: `deployment` takes an adapter imported from `blume/deploy`.
+Static output covers most docs. Switch to server output when you need request-time features — most notably the [assistant](/docs/configuration/assistant) endpoint and the [MCP server](/docs/discoverability/mcp). You do that by naming the host: `deployment` takes an adapter imported from `blume/deploy`.
 
 ```ts blume.config.ts lineNumbers
 import { defineConfig } from "blume";
@@ -128,7 +128,7 @@ On Vercel and Cloudflare, a server build also turns on [`Accept: text/markdown`
 :::
 
 :::note
-Server features have their own configuration — for example, Ask AI needs a model API key. See the [Ask AI guide](/docs/configuration/ask-ai) for setup.
+Server features have their own configuration — for example, the assistant needs a model API key. See the [assistant guide](/docs/configuration/assistant) for setup.
 :::
 
 ## Redirects
@@ -159,8 +159,8 @@ When a feature needs a runtime secret, Blume warns at `blume dev`/`build` if it'
 
 | Feature | Variable |
 | --- | --- |
-| Ask AI (AI Gateway) | `AI_GATEWAY_API_KEY` (or Vercel OIDC) |
-| Ask AI (other adapters) | the adapter's default key env var (`OPENROUTER_API_KEY`, `LLMGATEWAY_API_KEY`, `INKEEP_API_KEY`), or the `apiKeyEnv` you passed it |
+| Assistant (AI Gateway) | `AI_GATEWAY_API_KEY` (or Vercel OIDC) |
+| Assistant (other adapters) | the adapter's default key env var (`OPENROUTER_API_KEY`, `LLMGATEWAY_API_KEY`, `INKEEP_API_KEY`), or the `apiKeyEnv` you passed it |
 | Mixedbread search | `MIXEDBREAD_API_KEY` |
 
 Set them in `.env.local` for local dev and in your host's environment for production. Build-time secrets for search-index sync (Algolia, Orama Cloud, Typesense) are warned about separately during the sync step.