blume 1.0.2 → 1.0.3

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # blume
 
+## 1.0.3
+
+### Patch Changes
+
+- e2f902c: Render the Ask AI trigger from the shared header instead of wiring it up per page. Custom pages built on `PageLayout` (a landing page, most of all) never passed the header's `ask` slot, so the Ask AI button — and the search modal's hand-off to it — silently went missing on them while the generated docs, changelog, and reference pages had it. The header now owns the trigger and reads whether Ask AI is on from the config, so every page gets it; pass `askEnabled={false}` to opt a page out.
+- 66b721b: Move the MCP server config under `ai` in `blume.config.ts`, alongside the other agent-facing features. Rename `mcp: { … }` to `ai: { mcp: { … } }` — the shape of the block is unchanged.
+- c8ae77e: Fix `ERR_MODULE_NOT_FOUND` in a deployed server function. Surfacing an adapter's deploy bundle out of `.blume` resolved every traced dependency's symlink against the source dir, so the links pointed into a directory the same step then deleted — the function died on its first external import (`Cannot find package '@orama/orama'` with Ask AI or the MCP server enabled). The bundle is now copied verbatim, leaving those links relative and internal to it.
+
 ## 1.0.2
 
 ### Patch Changes

package/dist/cli/index.js

@@ -676,10 +676,10 @@ var buildAgentReadability = (project) => {
     artifacts.llmsFullTxt = abs("/llms-full.txt");
     artifacts.llmsTxt = abs("/llms.txt");
   }
-  if (config.mcp.enabled) {
+  if (config.ai.mcp.enabled) {
     artifacts.mcp = {
       discovery: abs("/.well-known/mcp.json"),
-      url: abs(config.mcp.route)
+      url: abs(config.ai.mcp.route)
     };
   }
   if (config.ai.ask?.enabled) {
@@ -697,7 +697,7 @@ var buildAgentReadability = (project) => {
     artifacts,
     description: config.description,
     generator: version ? `blume@${version}` : undefined,
-    name: config.mcp.name ?? config.title,
+    name: config.ai.mcp.name ?? config.title,
     site
   };
   const usage = usagePolicy(config.seo.contentSignals);
@@ -1225,7 +1225,7 @@ var serverFeatures = (config) => {
   if (config.ai.ask?.enabled) {
     features.push("Ask AI");
   }
-  if (config.mcp.enabled) {
+  if (config.ai.mcp.enabled) {
     features.push("MCP server");
   }
   if (searchProviderMeta(config.search.provider).requiresServer) {
@@ -1269,7 +1269,7 @@ var surfaceAdapterOutput = async (config, context) => {
   }
   await mkdir2(dirname4(to), { recursive: true });
   await rm(to, { force: true, recursive: true });
-  await cp(from, to, { recursive: true });
+  await cp(from, to, { recursive: true, verbatimSymlinks: true });
   await rm(from, { force: true, recursive: true });
   return { from, ignore: `${rel.split("/")[0]}/`, moved: true, to };
 };
@@ -4117,8 +4117,8 @@ var buildMcpData = async (project) => {
       route: doc.route,
       title: doc.title
     })),
-    instructions: config.mcp.instructions,
-    name: config.mcp.name ?? config.title,
+    instructions: config.ai.mcp.instructions,
+    name: config.ai.mcp.name ?? config.title,
     navigation: graph.navigation,
     pages,
     routes,
@@ -6377,6 +6377,12 @@ var askAiProviders = [
   "inkeep",
   "openai-compatible"
 ];
+var mcpConfigSchema = z2.strictObject({
+  enabled: z2.boolean().default(false),
+  instructions: z2.string().optional(),
+  name: z2.string().optional(),
+  route: z2.string().default("/mcp").transform(normalizeRoute)
+});
 var aiConfigSchema = z2.strictObject({
   ask: z2.strictObject({
     apiKeyEnv: z2.string().optional(),
@@ -6406,7 +6412,8 @@ var aiConfigSchema = z2.strictObject({
   ]).default(true).transform((value) => typeof value === "boolean" ? { enabled: value, openapi: true } : value),
   markdownComponents: z2.record(z2.string(), z2.custom((value) => typeof value === "function", {
     message: "Expected a serializer function."
-  })).default({})
+  })).default({}),
+  mcp: mcpConfigSchema.default({})
 });
 var featuredLinkSchema = z2.strictObject({
   href: z2.string(),
@@ -6433,12 +6440,6 @@ var exportConfigSchema = z2.union([
     pdf: z2.boolean().default(false)
   })
 ]).transform((value) => typeof value === "boolean" ? { epub: value, pdf: value } : value);
-var mcpConfigSchema = z2.strictObject({
-  enabled: z2.boolean().default(false),
-  instructions: z2.string().optional(),
-  name: z2.string().optional(),
-  route: z2.string().default("/mcp").transform(normalizeRoute)
-});
 var localeSchema = z2.strictObject({
   code: z2.string().min(1),
   dir: z2.enum(["ltr", "rtl"]).default("ltr"),
@@ -6625,7 +6626,6 @@ var blumeConfigSchema = z2.strictObject({
   lastModified: lastModifiedConfigSchema.default(false),
   logo: logoConfigSchema.optional(),
   markdown: markdownConfigSchema.default({}),
-  mcp: mcpConfigSchema.default({}),
   navigation: navigationConfigSchema.default({}),
   openapi: openapiConfigSchema.default({}),
   react: reactConfigSchema.default({}),
@@ -7748,6 +7748,7 @@ var reactIntegration = (compilerPath) => compilerPath ? `react({ babel: { plugin
 var astroConfigTemplate = (options) => {
   const { context, config, needsReact, pages, dataPath, themePath } = options;
   const {
+    askPath,
     contentRoutes,
     examplesPath,
     examplesThemePath,
@@ -7867,6 +7868,7 @@ export default defineConfig({
     },
     resolve: {
       alias: {
+        "blume:ask": ${JSON.stringify(askPath)},
         "blume:data": ${JSON.stringify(dataPath)},
         "blume:examples": ${JSON.stringify(examplesPath)},
         "blume:examples-theme": ${JSON.stringify(examplesThemePath)},
@@ -8038,6 +8040,22 @@ ${setup}
 ${handler}
 `;
 };
+var askComponentTemplate = (askEnabled) => askEnabled ? `---
+// Generated by Blume. Do not edit.
+import AskAI from "blume/components/islands/AskAI.astro";
+import data from "blume:data";
+
+const { strings } = Astro.props;
+---
+
+<AskAI strings={strings ?? data.ui.ask} suggestions={data.config.ask?.suggestions ?? []} />
+` : `---
+// Generated by Blume. Do not edit.
+// Ask AI is off (\`ai.ask.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.
+---
+`;
 var searchEndpointTemplate = () => `// Generated by Blume. Do not edit.
 import documents from "../generated/search.json";
 
@@ -8317,10 +8335,6 @@ const htmlLang = i18n ? i18n.defaultLocale : "en";
 </ReferenceLayout>
 `;
 var catchAllPageTemplate = (options) => {
-  const askImport = options.askEnabled ? `import AskAI from "blume/components/islands/AskAI.astro";
-` : "";
-  const askSlot = options.askEnabled ? `
-  <AskAI slot="ask" strings={ui.ask} suggestions={data.config.ask?.suggestions ?? []} />` : "";
   const mathImport = options.mathEnabled ? `import Math from "blume/components/content/Math.astro";
 ` : "";
   const mathEntry = options.mathEnabled ? `Math,
@@ -8333,7 +8347,6 @@ import { getEntry, render } from "astro:content";
 import RootLayout from "blume/components/layout/RootLayout.astro";
 import { withBase } from "blume/components/islands/base-path.ts";
 import { resolveSlot } from "blume/components/layout/overrides.ts";
-${askImport}
 import Accordion from "blume/components/content/Accordion.astro";
 import AccordionItem from "blume/components/content/AccordionItem.astro";
 import AutoTypeTable from "blume/components/content/AutoTypeTable.astro";
@@ -8570,7 +8583,6 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
   canonical={canonical}
   editUrl={editUrl}
   feedback={data.config.feedback}
-  askEnabled={${options.askEnabled}}
   exportPdf={${options.exportPdf}}
   exportEpub={${options.exportEpub}}
   feeds={data.feeds}
@@ -8580,7 +8592,7 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
   lastModified={lastModified}
   noindex={seo.noindex}
   structuredDataEnabled={data.config.structuredData}
->${askSlot}
+>
   <h1>{title}</h1>
   {frontmatter.description && <p class="text-lg text-muted-foreground">{frontmatter.description}</p>}
   <Content components={components} />
@@ -8588,10 +8600,6 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
 `;
 };
 var changelogIndexTemplate = (options) => {
-  const askImport = options.askEnabled ? `import AskAI from "blume/components/islands/AskAI.astro";
-` : "";
-  const askSlot = options.askEnabled ? `
-  <AskAI slot="ask" strings={data.ui.ask} suggestions={data.config.ask?.suggestions ?? []} />` : "";
   const clientData = options.needsReact ? `
   clientData={{ config: data.config, navigation: data.navigation, page: { route: "/changelog", title: pageTitle } }}` : "";
   const stagedSpread = options.staged ? `
@@ -8604,7 +8612,7 @@ import Update from "blume/components/content/Update.astro";
 import { withBase } from "blume/components/islands/base-path.ts";
 import { resolveSlot } from "blume/components/layout/overrides.ts";
 import { layoutOverrides } from "../generated/components.ts";
-${askImport}import data from "../generated/data.json";
+import data from "../generated/data.json";
 
 export const prerender = true;
 
@@ -8773,14 +8781,13 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
   ogImage={null}
   x={data.config.x}
   canonical={canonical}
-  askEnabled={${options.askEnabled}}
   exportPdf={${options.exportPdf}}
   exportEpub={${options.exportEpub}}
   feeds={data.feeds}
   siteUrl={data.config.site}
   noindex={false}
   structuredDataEnabled={data.config.structuredData}
->${askSlot}
+>
   <h1>{changelogTitle}</h1>
   {
     items.length === 0 ? (
@@ -9000,6 +9007,11 @@ const Example = entry.Component;
 var envTemplate = () => `/// <reference path="../.astro/types.d.ts" />
 /// <reference types="astro/client" />
 
+declare module "blume:ask" {
+  const Ask: typeof import("blume/components/islands/AskAI.astro").default;
+  export default Ask;
+}
+
 declare module "blume:data" {
   const data: import("blume").BlumeData;
   export default data;
@@ -10547,7 +10559,10 @@ var buildRuntimeData = (project) => {
       } : null,
       imageZoom: config.markdown.imageZoom,
       logo: resolveLogo(project),
-      mcp: config.mcp.enabled ? { name: config.mcp.name ?? config.title, route: config.mcp.route } : null,
+      mcp: config.ai.mcp.enabled ? {
+        name: config.ai.mcp.name ?? config.title,
+        route: config.ai.mcp.route
+      } : null,
       og: { enabled: config.seo.og.enabled ?? false },
       repoUrl,
       search: {
@@ -10591,7 +10606,7 @@ var buildRuntimeData = (project) => {
 };
 var planMcp = (project, srcDir, userPages) => {
   const { config } = project;
-  const { route } = config.mcp;
+  const { route } = config.ai.mcp;
   const dir = join22(srcDir, "blume-mcp");
   const base = {
     dir,
@@ -10601,14 +10616,14 @@ var planMcp = (project, srcDir, userPages) => {
     srcDir,
     warnings: []
   };
-  if (!config.mcp.enabled) {
+  if (!config.ai.mcp.enabled) {
     return base;
   }
   if (routeIsTaken(userPages, project.graph.pages, route)) {
     return {
       ...base,
       warnings: [
-        `MCP server route "${route}" is already used by a content or custom page; the MCP server was not generated. Set a different "mcp.route" in blume.config.ts.`
+        `MCP server route "${route}" is already used by a content or custom page; the MCP server was not generated. Set a different "ai.mcp.route" in blume.config.ts.`
       ]
     };
   }
@@ -10677,6 +10692,7 @@ var generateRuntime = async (project) => {
   const { context, config } = project;
   const out = context.outDir;
   const srcDir = join22(out, "src");
+  const askPath = join22(srcDir, "generated", "Ask.astro");
   const dataPath = join22(srcDir, "generated", "data.json");
   const themePath = join22(srcDir, "generated", "app.css");
   const searchClientPath = join22(srcDir, "generated", "search-client.ts");
@@ -10735,6 +10751,7 @@ var generateRuntime = async (project) => {
     Promise.all([
       write(join22(out, "astro.config.mjs"), astroConfigTemplate({
         aliases: resolveTsconfigAliases(context.root),
+        askPath,
         config,
         contentRoutes: project.manifest.routes.map((route) => route.path),
         context,
@@ -10761,12 +10778,12 @@ var generateRuntime = async (project) => {
         staged: hasStaged
       })),
       write(join22(srcDir, "pages", "[...slug].astro"), catchAllPageTemplate({
-        askEnabled,
         exportEpub,
         exportPdf,
         mathEnabled: usesMath,
         needsReact
       })),
+      write(askPath, askComponentTemplate(askEnabled)),
       write(join22(srcDir, "generated", "components.ts"), slotPlan.module),
       write(join22(srcDir, "generated", "islands.ts"), islandMapTemplate(islandDiscovery.islands)),
       write(join22(srcDir, "generated", "examples.ts"), exampleMapTemplate(exampleDiscovery.examples, config.basePath)),
@@ -10796,7 +10813,6 @@ var generateRuntime = async (project) => {
   }
   if (hasGeneratedChangelog(project, pages)) {
     await write(join22(srcDir, "pages", "changelog.astro"), changelogIndexTemplate({
-      askEnabled,
       exportEpub,
       exportPdf,
       needsReact,
@@ -12531,7 +12547,7 @@ var askFiles = async (project, srcDir, genDir) => {
   }
   return files;
 };
-var hostsMcp = (project, userPages) => project.config.mcp.enabled && !routeIsTaken(userPages, project.graph.pages, project.config.mcp.route);
+var hostsMcp = (project, userPages) => project.config.ai.mcp.enabled && !routeIsTaken(userPages, project.graph.pages, project.config.ai.mcp.route);
 var mcpDiscoveryPages = (project, userPages) => hostsMcp(project, userPages) ? [
   {
     entrypoint: "src/blume-mcp/discovery.ts",
@@ -12546,7 +12562,7 @@ var mcpFiles = async (project, userPages, srcDir, genDir) => {
   if (!hostsMcp(project, userPages)) {
     return [];
   }
-  const { route } = project.config.mcp;
+  const { route } = project.config.ai.mcp;
   const data = await buildMcpData(project);
   const discoveryInput = {
     base: data.base,
@@ -12649,6 +12665,7 @@ var eject = async (root) => {
   const files = [
     {
       content: astroConfigTemplate({
+        askPath: "./src/generated/Ask.astro",
         config,
         contentRoutes: project.manifest.routes.map((route) => route.path),
         context: relContext,
@@ -12682,7 +12699,6 @@ var eject = async (root) => {
     },
     {
       content: catchAllPageTemplate({
-        askEnabled,
         exportEpub,
         exportPdf,
         mathEnabled: usesMath,
@@ -12723,6 +12739,10 @@ var eject = async (root) => {
       path: join27(genDir, "app.css")
     },
     { content: buildRuntimeData(project), path: join27(genDir, "data.json") },
+    {
+      content: askComponentTemplate(askEnabled),
+      path: join27(genDir, "Ask.astro")
+    },
     {
       content: `${JSON.stringify(ejectOpenApiData(project))}
 `,
@@ -12752,7 +12772,6 @@ var eject = async (root) => {
     });
   }
   files.push(...await mcpFiles(project, pages, srcDir, genDir), ...changelogFiles(project, pages, srcDir, {
-    askEnabled,
     exportEpub,
     exportPdf,
     needsReact,
@@ -13847,5 +13866,5 @@ process.on("unhandledRejection", (error) => {
 });
 runMain(main);
 
-//# debugId=5F5E50EAF35B586A64756E2164756E21
+//# debugId=C36C25DD63079AEA64756E2164756E21
 //# sourceMappingURL=index.js.map