blume 1.6.1 → 1.6.2

package/dist/cli/index.js

@@ -3267,6 +3267,14 @@ var builtinProxyKinds = (config) => {
 };
 var needsPlaygroundProxy = (config) => builtinProxyKinds(config).length > 0;
 
+// src/ai/api/paths.ts
+var OPENAPI_PATH = "/openapi.json";
+var API_BASE = "/api/docs";
+var API_PAGES_PATH = `${API_BASE}/pages.json`;
+var API_PAGE_PATH = `${API_BASE}/pages/{route}.json`;
+var API_NAVIGATION_PATH = `${API_BASE}/navigation.json`;
+var API_SEARCH_PATH = `${API_BASE}/search`;
+
 // src/ai/api-catalog.ts
 var API_CATALOG_PATH = "/.well-known/api-catalog";
 var API_CATALOG_TYPE = "application/linkset+json";
@@ -3290,6 +3298,13 @@ var linksetEntries = (config) => {
     }
     entries.push(entry);
   }
+  if (config.ai.api) {
+    entries.push({
+      anchor: abs(API_BASE),
+      "service-desc": [{ href: abs(OPENAPI_PATH), type: "application/json" }],
+      "service-doc": [{ href: abs("/"), type: "text/html" }]
+    });
+  }
   if (config.ai.mcp.enabled) {
     entries.push({
       anchor: abs(config.ai.mcp.route),
@@ -3318,6 +3333,9 @@ var buildHomeLinkHeader = (config, routePaths) => {
   if (hasApiCatalog(config)) {
     links.push(`<${deployBase}${API_CATALOG_PATH}>; rel="api-catalog"; type="application/linkset+json"`);
   }
+  if (config.ai.api) {
+    links.push(`<${deployBase}${OPENAPI_PATH}>; rel="service-desc"; type="application/json"`);
+  }
   if (config.seo.agentReadability) {
     links.push(`<${deployBase}/agent-readability.json>; rel="describedby"; type="application/json"`);
   }
@@ -5662,6 +5680,9 @@ const links = [
   ...(data.config.discovery.llmsTxt
     ? [{ href: href("/llms.txt"), label: nf.llms }]
     : []),
+  ...(data.config.discovery.api
+    ? [{ href: href("/openapi.json"), label: nf.api }]
+    : []),
 ];
 
 const body = [
@@ -5685,6 +5706,114 @@ export function GET() {
   });
 }
 `;
+var notFoundJsonTemplate = () => `// Generated by Blume. Do not edit. Override by adding \`pages/404.astro\`.
+import { problem } from "blume/ai/api/problem.ts";
+import { withBase } from "blume/components/islands/base-path.ts";
+import { absoluteUrl } from "blume/core/site-url.ts";
+import data from "blume:data";
+
+export const prerender = true;
+
+const nf = data.ui.notFound;
+
+// Absolute for internal routes when the site is known; an external tab href
+// passes through untouched.
+const href = (path: string): string => {
+  const based = withBase(path);
+  return data.config.site && based.startsWith("/") && !based.startsWith("//")
+    ? absoluteUrl(data.config.site, based)
+    : based;
+};
+
+// The recovery set of 404.astro: home, every top-level section (a tab links to
+// its resolved target), then the machine-readable indexes that exist.
+const links = [
+  { href: href("/"), label: nf.home },
+  ...data.navigation.tabs.map((tab) => ({
+    href: href(tab.href ?? tab.path),
+    label: tab.label,
+  })),
+  ...(data.config.discovery.sitemap
+    ? [{ href: href("/sitemap.xml"), label: nf.sitemap }]
+    : []),
+  ...(data.config.discovery.llmsTxt
+    ? [{ href: href("/llms.txt"), label: nf.llms }]
+    : []),
+  ...(data.config.discovery.api
+    ? [{ href: href("/openapi.json"), label: nf.api }]
+    : []),
+];
+
+const body = problem({
+  code: "PAGE_NOT_FOUND",
+  detail: nf.description,
+  links,
+  resolution: nf.suggestions + ": " + links.map((link) => link.href).join(", "),
+  status: 404,
+  title: nf.title,
+});
+
+export function GET() {
+  return new Response(JSON.stringify(body, null, 2) + "\\n", {
+    headers: { "Content-Type": "application/problem+json; charset=utf-8" },
+  });
+}
+`;
+var apiPagesIndexTemplate = () => `// Generated by Blume. Do not edit.
+import { pagesIndexResponse } from "blume/ai/api/handlers.ts";
+import data from "blume:mcp-data";
+
+export const prerender = true;
+
+export function GET() {
+  return pagesIndexResponse(data);
+}
+`;
+var apiPageTemplate = () => `// Generated by Blume. Do not edit.
+import { pageParams, pageResponse } from "blume/ai/api/handlers.ts";
+import data from "blume:mcp-data";
+
+export const prerender = true;
+
+export function getStaticPaths() {
+  return pageParams(data);
+}
+
+export function GET({ props }: { props: { route: string } }) {
+  return pageResponse(data, props.route);
+}
+`;
+var apiNavigationTemplate = () => `// Generated by Blume. Do not edit.
+import { navigationResponse } from "blume/ai/api/handlers.ts";
+import data from "blume:mcp-data";
+
+export const prerender = true;
+
+export function GET() {
+  return navigationResponse(data);
+}
+`;
+var apiSearchTemplate = () => `// Generated by Blume. Do not edit.
+import type { APIRoute } from "astro";
+import { createSearchHandler } from "blume/ai/api/handlers.ts";
+import data from "blume:mcp-data";
+
+export const prerender = false;
+
+const handler = createSearchHandler(data);
+
+export const GET: APIRoute = ({ request }) => handler(request);
+`;
+var apiNotFoundTemplate = (context) => `// Generated by Blume. Do not edit.
+import type { APIRoute } from "astro";
+import { apiNotFoundResponse } from "blume/ai/api/handlers.ts";
+
+export const prerender = false;
+
+const context = ${JSON.stringify(context)};
+
+export const ALL: APIRoute = ({ request }) => apiNotFoundResponse(request, context);
+`;
 var islandDirective = (spec) => spec.client === "only" ? `client:only="${spec.framework}"` : `client:${spec.client}`;
 var wrapperPropsType = (name) => `type Props = typeof ${name} extends (
   props: infer P extends object,
@@ -10091,6 +10220,7 @@ var uiStringsObject = z.object({
     toggleTheme: z.string().default("Toggle color theme")
   }).prefault({}),
   notFound: z.object({
+    api: z.string().default("JSON API description (openapi.json)"),
     description: z.string().default("We couldn't find the page you're looking for."),
     home: z.string().default("Back to home"),
     llms: z.string().default("Docs index for AI agents (llms.txt)"),
@@ -10597,6 +10727,7 @@ var llmsTxtObjectSchema = z2.strictObject({
   openapi: z2.boolean().default(true)
 });
 var aiConfigSchema = z2.strictObject({
+  api: z2.boolean().default(true),
   ask: z2.strictObject({
     apiKeyEnv: z2.string().optional(),
     baseUrl: z2.url().optional(),
@@ -16381,6 +16512,23 @@ var askApiUrl = (endpoint, site, abs) => {
   }
   return site && endpoint.startsWith("/") ? absoluteUrl(site, endpoint) : endpoint;
 };
+var markdownArtifact = (config, abs) => {
+  const negotiates = config.deployment.output === "server" && (config.deployment.adapter === "vercel" || config.deployment.adapter === "cloudflare");
+  return negotiates ? { contentNegotiation: "text/markdown", pattern: abs("/{route}.md") } : { pattern: abs("/{route}.md") };
+};
+var apiArtifact = (config, abs) => {
+  if (!config.ai.api) {
+    return null;
+  }
+  const api = {
+    openapi: abs(OPENAPI_PATH),
+    pages: abs(API_PAGES_PATH)
+  };
+  if (config.deployment.output === "server") {
+    api.search = abs(API_SEARCH_PATH);
+  }
+  return api;
+};
 var wellKnownArtifacts = (config, abs) => {
   const artifacts = {};
   if (config.ai.webBotAuth.keys.length > 0) {
@@ -16405,9 +16553,13 @@ var buildAgentReadability = (project) => {
     const based = withBasePath(deployBase, path);
     return site ? absoluteUrl(site, based) : based;
   };
-  const negotiates = config.deployment.output === "server" && (config.deployment.adapter === "vercel" || config.deployment.adapter === "cloudflare");
-  const markdown = negotiates ? { contentNegotiation: "text/markdown", pattern: abs("/{route}.md") } : { pattern: abs("/{route}.md") };
-  const artifacts = { markdown };
+  const artifacts = {
+    markdown: markdownArtifact(config, abs)
+  };
+  const api = apiArtifact(config, abs);
+  if (api) {
+    artifacts.api = api;
+  }
   if (config.ai.llmsTxt.enabled) {
     artifacts.llmsFullTxt = abs("/llms-full.txt");
     artifacts.llmsTxt = abs("/llms.txt");
@@ -17123,6 +17275,9 @@ var agentResourceLines = (project) => {
     `- [llms-full.txt](${url("/llms-full.txt")}): The full Markdown of every page in one file.`,
     `- [Page Markdown](${url("/index.md")}): Append \`.md\` to any page URL to fetch that page as raw Markdown.`
   ];
+  if (config.ai.api) {
+    lines.push(`- [JSON API](${url(API_PAGES_PATH)}): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at ${url(OPENAPI_PATH)}.`);
+  }
   if (config.ai.mcp.enabled) {
     lines.push(`- [MCP server](${url(config.ai.mcp.route)}): Streamable HTTP Model Context Protocol server with search_docs, get_page, list_pages, and get_navigation tools, plus every page as a resource. Discovery document: ${url("/.well-known/mcp.json")}`);
   }
@@ -18062,12 +18217,17 @@ ${references.join(`
 
 // src/deploy/vercel-negotiation.ts
 var ACCEPT_MARKDOWN_HEADER_VALUE = "(.*,)?\\s*text/(x-)?markdown(\\s*[;,].*)?$";
+var ACCEPT_JSON_HEADER_VALUE = "(.*,)?\\s*application/(problem\\+)?json(\\s*[;,].*)?$";
 var isString6 = (value) => typeof value === "string";
 var ACCEPT_MARKDOWN_CONDITION = [
   { key: "accept", type: "header", value: ACCEPT_MARKDOWN_HEADER_VALUE }
 ];
+var ACCEPT_JSON_CONDITION = [
+  { key: "accept", type: "header", value: ACCEPT_JSON_HEADER_VALUE }
+];
 var VARY_ACCEPT = { vary: "Accept" };
 var NOT_FOUND_MARKDOWN_DEST = "/404.md";
+var NOT_FOUND_JSON_DEST = "/404.json";
 var NOT_FOUND_HTML_DEST = "/404.html";
 var NOT_FOUND_MARKDOWN_ROUTES = [
   {
@@ -18079,6 +18239,16 @@ var NOT_FOUND_MARKDOWN_ROUTES = [
   },
   { dest: NOT_FOUND_MARKDOWN_DEST, src: "^/.*\\.mdx?$", status: 404 }
 ];
+var NOT_FOUND_JSON_ROUTES = [
+  {
+    dest: NOT_FOUND_JSON_DEST,
+    has: ACCEPT_JSON_CONDITION,
+    headers: VARY_ACCEPT,
+    src: "^/.*$",
+    status: 404
+  },
+  { dest: NOT_FOUND_JSON_DEST, src: "^/.*\\.json$", status: 404 }
+];
 var MAX_ALTERNATION_LENGTH = 3900;
 var REGEX_SPECIALS = /[$()*+.?[\]^{|}\\]/gu;
 var routePattern = (route) => encodeURI(route).replace(REGEX_SPECIALS, "\\$&");
@@ -18134,8 +18304,8 @@ var TRAILING_SLASH_REDIRECT = {
   src: "^/(.+)/$",
   status: 308
 };
-var isNegotiationRoute = (route) => route.has?.some((condition) => condition.value === ACCEPT_MARKDOWN_HEADER_VALUE) === true || route.dest === NOT_FOUND_MARKDOWN_DEST && route.status === 404 || route.continue === true && route.headers?.vary === "Accept" && isString6(route.src) && Object.keys(route).length === 3 || route.continue === true && isString6(route.headers?.link) && route.src === HOME_SRC && Object.keys(route).length === 3 || route.status === TRAILING_SLASH_REDIRECT.status && route.src === TRAILING_SLASH_REDIRECT.src;
-var injectNegotiationRoutes = (configText, routePaths, homeLinkHeader, contentTypeOverrides, homeTokens, notFoundMarkdown = false) => {
+var isNegotiationRoute = (route) => route.has?.some((condition) => condition.value === ACCEPT_MARKDOWN_HEADER_VALUE) === true || route.dest === NOT_FOUND_MARKDOWN_DEST && route.status === 404 || route.dest === NOT_FOUND_JSON_DEST && route.status === 404 || route.continue === true && route.headers?.vary === "Accept" && isString6(route.src) && Object.keys(route).length === 3 || route.continue === true && isString6(route.headers?.link) && route.src === HOME_SRC && Object.keys(route).length === 3 || route.status === TRAILING_SLASH_REDIRECT.status && route.src === TRAILING_SLASH_REDIRECT.src;
+var injectNegotiationRoutes = (configText, routePaths, homeLinkHeader, contentTypeOverrides, homeTokens, notFound = {}) => {
   const overrideEntries = Object.entries(contentTypeOverrides ?? {});
   let config;
   try {
@@ -18163,10 +18333,14 @@ var injectNegotiationRoutes = (configText, routePaths, homeLinkHeader, contentTy
     });
   }
   routes.splice(filesystemIndex, 0, ...headerRoutes, ...rewriteRoutes, TRAILING_SLASH_REDIRECT);
-  if (notFoundMarkdown) {
+  const notFoundRoutes = [
+    ...notFound.markdown ? NOT_FOUND_MARKDOWN_ROUTES : [],
+    ...notFound.json ? NOT_FOUND_JSON_ROUTES : []
+  ];
+  if (notFoundRoutes.length > 0) {
     const fallbackIndex = routes.findIndex((route) => route.status === 404 && route.dest === NOT_FOUND_HTML_DEST);
     if (fallbackIndex !== -1) {
-      routes.splice(fallbackIndex, 0, ...NOT_FOUND_MARKDOWN_ROUTES);
+      routes.splice(fallbackIndex, 0, ...notFoundRoutes);
     }
   }
   config.routes = routes;
@@ -18731,6 +18905,519 @@ import {
 } from "pathe";
 import { glob as glob7 } from "tinyglobby";
 
+// src/ai/api/problem.ts
+var PROBLEM_TYPE = "application/problem+json";
+
+// src/ai/api/spec.ts
+var JSON_TYPE = "application/json";
+var MARKDOWN_TYPE = "text/markdown";
+var TEXT_TYPE = "text/plain";
+var ref = (name) => ({
+  $ref: `#/components/schemas/${name}`
+});
+var jsonResponse = (description, schema) => ({
+  content: { [JSON_TYPE]: { schema: ref(schema) } },
+  description
+});
+var problemResponse = (description) => ({
+  content: { [PROBLEM_TYPE]: { schema: ref("Problem") } },
+  description
+});
+var textResponse = (description, type) => ({
+  content: { [type]: { schema: { type: "string" } } },
+  description
+});
+var string = (description) => ({ description, type: "string" });
+var facetsSchema = {
+  additionalProperties: { type: "string" },
+  description: "Facet values the site declares for the page's content type (`content.types.<type>.facets`), key → value.",
+  type: "object"
+};
+var versionProperty = {
+  description: 'Docs version the page belongs to on a versioned site: `""` for the current docs, else an archived version id. Absent on unversioned sites.',
+  type: "string"
+};
+var searchParameters = [
+  {
+    description: "The search query.",
+    in: "query",
+    name: "q",
+    required: true,
+    schema: { minLength: 1, type: "string" }
+  },
+  {
+    description: "Maximum hits to return (default 8, at most 20).",
+    in: "query",
+    name: "limit",
+    required: false,
+    schema: { default: 8, maximum: 20, minimum: 1, type: "integer" }
+  },
+  {
+    description: "Only include pages of these content types (frontmatter `type`, e.g. `doc`, `rfc`). Comma-separated or repeated. Omit for every type.",
+    explode: false,
+    in: "query",
+    name: "contentTypes",
+    required: false,
+    schema: { items: { type: "string" }, type: "array" },
+    style: "form"
+  },
+  {
+    description: "Only include pages in this locale (e.g. `fr`). Omit for every language.",
+    in: "query",
+    name: "locale",
+    required: false,
+    schema: { type: "string" }
+  },
+  {
+    description: "Docs version to scope to on a versioned site: `latest` (the default — current docs only), `all`, or an archived version id. Ignored when the site is unversioned.",
+    in: "query",
+    name: "version",
+    required: false,
+    schema: { type: "string" }
+  },
+  {
+    description: "Only include pages matching every facet, as `filters[key]=value` pairs (e.g. `filters[status]=enforced`). Facets are metadata the site declares per content type; the page index shows each page's values.",
+    explode: true,
+    in: "query",
+    name: "filters",
+    required: false,
+    schema: { additionalProperties: { type: "string" }, type: "object" },
+    style: "deepObject"
+  }
+];
+var schemas = {
+  JsonRpcRequest: {
+    description: "A JSON-RPC 2.0 request, as the Model Context Protocol sends.",
+    properties: {
+      id: { description: "Request id (absent on notifications)." },
+      jsonrpc: { const: "2.0", type: "string" },
+      method: string("The MCP method, e.g. `initialize` or `tools/call`."),
+      params: { description: "Method parameters.", type: "object" }
+    },
+    required: ["jsonrpc", "method"],
+    type: "object"
+  },
+  JsonRpcResponse: {
+    description: "A JSON-RPC 2.0 response: a `result` or an `error`.",
+    properties: {
+      error: {
+        properties: {
+          code: { type: "integer" },
+          data: {},
+          message: { type: "string" }
+        },
+        required: ["code", "message"],
+        type: "object"
+      },
+      id: {},
+      jsonrpc: { const: "2.0", type: "string" },
+      result: { type: "object" }
+    },
+    required: ["jsonrpc"],
+    type: "object"
+  },
+  NavLink: {
+    properties: {
+      href: string("Link target — an internal route or an external URL."),
+      icon: string("Optional icon name."),
+      label: { type: "string" }
+    },
+    required: ["href", "label"],
+    type: "object"
+  },
+  NavNode: {
+    description: "A sidebar entry: a page (linking to its route) or a group holding further nodes.",
+    oneOf: [
+      {
+        properties: {
+          badge: { type: "string" },
+          deprecated: { type: "boolean" },
+          description: { type: "string" },
+          icon: { type: "string" },
+          kind: { const: "page", type: "string" },
+          label: { type: "string" },
+          pageId: string("The page's stable content id."),
+          route: string("The page's route.")
+        },
+        required: ["kind", "label", "pageId", "route"],
+        type: "object"
+      },
+      {
+        properties: {
+          badge: { type: "string" },
+          children: { items: ref("NavNode"), type: "array" },
+          collapsed: { type: "boolean" },
+          icon: { type: "string" },
+          kind: { const: "group", type: "string" },
+          label: { type: "string" },
+          path: string("The group's route prefix (not necessarily a page)."),
+          route: string("The group's index page route, when it has one.")
+        },
+        required: ["children", "kind", "label"],
+        type: "object"
+      }
+    ]
+  },
+  NavSelector: {
+    description: "A top-level partition selector (products, versions, languages).",
+    properties: {
+      items: {
+        items: {
+          properties: {
+            description: { type: "string" },
+            label: { type: "string" },
+            path: { type: "string" },
+            tag: { type: "string" }
+          },
+          required: ["label", "path"],
+          type: "object"
+        },
+        type: "array"
+      },
+      kind: { type: "string" },
+      label: { type: "string" }
+    },
+    required: ["items", "kind", "label"],
+    type: "object"
+  },
+  NavTab: {
+    properties: {
+      href: string("The clickable target when it differs from `path` (the section's first page)."),
+      icon: { type: "string" },
+      label: { type: "string" },
+      path: string("The tab's section prefix.")
+    },
+    required: ["label", "path"],
+    type: "object"
+  },
+  Navigation: {
+    description: "The docs navigation model: header tabs, the sidebar tree, partition selectors, and pinned links.",
+    properties: {
+      actions: { items: ref("NavLink"), type: "array" },
+      cta: { oneOf: [ref("NavLink"), { type: "null" }] },
+      featured: { items: ref("NavLink"), type: "array" },
+      repoUrl: { type: ["string", "null"] },
+      root: string("The tree root's route (`/`, or a locale/version prefix)."),
+      selectors: { items: ref("NavSelector"), type: "array" },
+      sidebar: { items: ref("NavNode"), type: "array" },
+      tabs: { items: ref("NavTab"), type: "array" }
+    },
+    required: ["featured", "selectors", "sidebar", "tabs"],
+    type: "object"
+  },
+  Page: {
+    allOf: [
+      ref("PageSummary"),
+      {
+        properties: {
+          markdown: string("The page as agent Markdown: frontmatter included, components downleveled to plain Markdown.")
+        },
+        required: ["markdown"],
+        type: "object"
+      }
+    ],
+    description: "A page's index entry plus its full Markdown body."
+  },
+  PageSummary: {
+    properties: {
+      contentType: string("The page's content type (frontmatter `type`)."),
+      description: { type: "string" },
+      facets: facetsSchema,
+      json: {
+        description: "This page's JSON representation (the `getPage` operation).",
+        format: "uri-reference",
+        type: "string"
+      },
+      lastModified: {
+        description: "ISO 8601 last-modified date, when known.",
+        type: ["string", "null"]
+      },
+      locale: string("The page's locale code."),
+      markdownUrl: {
+        description: "The page's raw-Markdown mirror (the `getPageMarkdown` operation).",
+        format: "uri-reference",
+        type: "string"
+      },
+      route: string("The page's route (`/guides/install`); the key every other operation takes."),
+      title: { type: "string" },
+      url: {
+        description: "Where the rendered page is served.",
+        format: "uri-reference",
+        type: "string"
+      },
+      version: versionProperty
+    },
+    required: [
+      "contentType",
+      "json",
+      "lastModified",
+      "locale",
+      "markdownUrl",
+      "route",
+      "title",
+      "url"
+    ],
+    type: "object"
+  },
+  PagesIndex: {
+    properties: {
+      count: { type: "integer" },
+      generator: string("The Blume version that built the site."),
+      pages: { items: ref("PageSummary"), type: "array" },
+      site: { type: ["string", "null"] }
+    },
+    required: ["count", "generator", "pages", "site"],
+    type: "object"
+  },
+  Problem: {
+    description: "RFC 9457 problem details, with a stable code and a resolution hint.",
+    properties: {
+      code: string("Stable error code (e.g. `PAGE_NOT_FOUND`)."),
+      detail: string("Human-readable explanation of this occurrence."),
+      instance: string("The request path the problem occurred on."),
+      links: {
+        description: "Recovery links, when there is somewhere useful to go.",
+        items: {
+          properties: { href: { type: "string" }, label: { type: "string" } },
+          required: ["href", "label"],
+          type: "object"
+        },
+        type: "array"
+      },
+      resolution: string("What to do next."),
+      status: { type: "integer" },
+      title: { type: "string" },
+      type: string("Problem type URI; `about:blank` by default.")
+    },
+    required: ["code", "detail", "resolution", "status", "title", "type"],
+    type: "object"
+  },
+  SearchHit: {
+    properties: {
+      contentType: { type: "string" },
+      excerpt: string("The page description, else the start of its content."),
+      facets: facetsSchema,
+      route: string("The page's route; pass it to `getPage`."),
+      title: { type: "string" },
+      url: { format: "uri-reference", type: "string" },
+      version: versionProperty
+    },
+    required: ["excerpt", "route", "title", "url"],
+    type: "object"
+  },
+  SearchResponse: {
+    properties: {
+      count: { type: "integer" },
+      query: { type: "string" },
+      results: { items: ref("SearchHit"), type: "array" }
+    },
+    required: ["count", "query", "results"],
+    type: "object"
+  }
+};
+var ROUTE_PARAM = {
+  description: "The page route without its leading slash (`guides/install`), or `index` for the home page. May contain slashes.",
+  in: "path",
+  name: "route",
+  required: true,
+  schema: { type: "string" }
+};
+var serverUrl = (input) => {
+  if (input.site) {
+    return input.base ? absoluteUrl(input.site, input.base) : siteRoot(input.site);
+  }
+  return input.base || "/";
+};
+var buildApiSpec = (input) => {
+  const pathEntries = [
+    [
+      API_PAGES_PATH,
+      {
+        get: {
+          description: "Every documentation page with its route, title, description, content type, locale, facets, and the URLs of its rendered, Markdown, and JSON forms. Unfiltered; on a versioned site every version is listed with its `version`. Use it to enumerate the docs or to find a page when search is too narrow.",
+          operationId: "listPages",
+          responses: {
+            "200": jsonResponse("The page index.", "PagesIndex"),
+            default: problemResponse("An error, as problem details.")
+          },
+          summary: "List every page",
+          tags: ["Pages"]
+        }
+      }
+    ],
+    [
+      API_PAGE_PATH,
+      {
+        get: {
+          description: "A single page as JSON: its index entry plus the page's agent Markdown (frontmatter included, components downleveled to plain Markdown). Take `route` from `listPages` or `searchDocs`.",
+          operationId: "getPage",
+          parameters: [ROUTE_PARAM],
+          responses: {
+            "200": jsonResponse("The page.", "Page"),
+            "404": problemResponse("No page has that route."),
+            default: problemResponse("An error, as problem details.")
+          },
+          summary: "Get a page as JSON",
+          tags: ["Pages"]
+        }
+      }
+    ],
+    [
+      API_NAVIGATION_PATH,
+      {
+        get: {
+          description: "The navigation tree (header tabs and the sidebar hierarchy) as readers see it, for the default locale and the current docs.",
+          operationId: "getNavigation",
+          responses: {
+            "200": jsonResponse("The navigation tree.", "Navigation"),
+            default: problemResponse("An error, as problem details.")
+          },
+          summary: "Get the navigation tree",
+          tags: ["Navigation"]
+        }
+      }
+    ]
+  ];
+  if (input.search) {
+    pathEntries.push([
+      API_SEARCH_PATH,
+      {
+        get: {
+          description: "Full-text search across the documentation. Returns matching pages with their title, route, content type, and a short excerpt; narrow by content type, locale, version, or facet. Use it first to discover relevant pages, then `getPage` to read one in full.",
+          operationId: "searchDocs",
+          parameters: searchParameters,
+          responses: {
+            "200": jsonResponse("The matching pages, best first.", "SearchResponse"),
+            "400": problemResponse("The query was missing or blank."),
+            default: problemResponse("An error, as problem details.")
+          },
+          summary: "Search the docs",
+          tags: ["Search"]
+        }
+      }
+    ]);
+  }
+  pathEntries.push([
+    "/{route}.md",
+    {
+      get: {
+        description: "A page's raw-Markdown mirror: append `.md` to any page URL. Components are downleveled to plain Markdown; `.mdx` serves the source as written. The same body the `getPage` operation carries in its `markdown` field.",
+        operationId: "getPageMarkdown",
+        parameters: [ROUTE_PARAM],
+        responses: {
+          "200": textResponse("The page as Markdown.", MARKDOWN_TYPE),
+          "404": textResponse("No page has that route; the body lists where to look next.", MARKDOWN_TYPE)
+        },
+        summary: "Get a page as Markdown",
+        tags: ["Markdown"]
+      }
+    }
+  ]);
+  if (input.llmsTxt) {
+    pathEntries.push([
+      "/llms.txt",
+      {
+        get: {
+          description: "The llms.txt index: the site's summary, when to use it, and every page with a one-line description, grouped by section.",
+          operationId: "getLlmsTxt",
+          responses: {
+            "200": textResponse("The index.", TEXT_TYPE)
+          },
+          summary: "Get llms.txt",
+          tags: ["Markdown"]
+        }
+      }
+    ], [
+      "/llms-full.txt",
+      {
+        get: {
+          description: "The full Markdown of every current-docs page in one file.",
+          operationId: "getLlmsFullTxt",
+          responses: {
+            "200": textResponse("Every page's Markdown.", TEXT_TYPE)
+          },
+          summary: "Get llms-full.txt",
+          tags: ["Markdown"]
+        }
+      }
+    ]);
+  }
+  if (input.agentReadability) {
+    pathEntries.push([
+      "/agent-readability.json",
+      {
+        get: {
+          description: "A manifest indexing every agent-facing artifact the site publishes — this API, the Markdown mirrors, llms.txt, the MCP server, feeds, and the sitemap.",
+          operationId: "getAgentReadability",
+          responses: {
+            "200": {
+              content: { [JSON_TYPE]: { schema: { type: "object" } } },
+              description: "The manifest."
+            }
+          },
+          summary: "Get the agent-readability manifest",
+          tags: ["Discovery"]
+        }
+      }
+    ]);
+  }
+  if (input.mcpRoute) {
+    pathEntries.push([
+      input.mcpRoute,
+      {
+        post: {
+          description: "The Model Context Protocol server (Streamable HTTP, stateless, JSON responses). Tools: `search_docs`, `get_page`, `list_pages`, `get_navigation` — the same operations this API exposes — plus every page as a `text/markdown` resource. Discovery document at `/.well-known/mcp.json`.",
+          operationId: "mcp",
+          requestBody: {
+            content: { [JSON_TYPE]: { schema: ref("JsonRpcRequest") } },
+            required: true
+          },
+          responses: {
+            "200": jsonResponse("The JSON-RPC response.", "JsonRpcResponse")
+          },
+          summary: "Call the MCP server",
+          tags: ["MCP"]
+        }
+      }
+    ]);
+  }
+  const tags = [
+    { description: "Enumerate and read documentation pages.", name: "Pages" },
+    ...input.search ? [{ description: "Full-text search over the docs.", name: "Search" }] : [],
+    { description: "How the docs are organized.", name: "Navigation" },
+    { description: "Plain-text and Markdown surfaces.", name: "Markdown" },
+    ...input.agentReadability ? [{ description: "Agent discovery documents.", name: "Discovery" }] : [],
+    ...input.mcpRoute ? [{ description: "The Model Context Protocol endpoint.", name: "MCP" }] : []
+  ];
+  const info = {
+    description: [
+      `Read-only JSON API over the ${input.name} documentation${input.description ? `: ${input.description}` : "."}`,
+      "Every operation is public and needs no authentication. Errors are RFC 9457 problem details (`application/problem+json`) with a stable `code`, a `detail`, and a `resolution` hint."
+    ].join(`
+
+`),
+    title: `${input.name} API`,
+    version: input.version,
+    "x-generator": `blume@${input.version}`
+  };
+  const document = {
+    components: { schemas },
+    info,
+    openapi: "3.1.0",
+    paths: Object.fromEntries(pathEntries),
+    security: [],
+    servers: [{ description: input.name, url: serverUrl(input) }],
+    tags
+  };
+  if (input.site) {
+    document.externalDocs = {
+      description: `${input.name} documentation`,
+      url: absoluteUrl(input.site, withBasePath(input.base, "/"))
+    };
+  }
+  return document;
+};
+
 // src/ai/ask-data.ts
 var buildAskData = async (project) => {
   const documents = await buildSearchDocuments(project, {
@@ -18854,7 +19541,7 @@ var MCP_TOOLS = [
 ];
 
 // src/ai/mcp/discovery.ts
-var serverUrl = (input) => {
+var serverUrl2 = (input) => {
   const path = withBasePath(input.base, input.route);
   return input.site ? absoluteUrl(input.site, path) : path;
 };
@@ -18863,7 +19550,7 @@ var buildMcpDiscovery = (input) => ({
     {
       name: input.name,
       transport: "streamable-http",
-      url: serverUrl(input)
+      url: serverUrl2(input)
     }
   ]
 });
@@ -18884,7 +19571,7 @@ var reverseDnsName = (input) => {
 };
 var HTTP_URL2 = /^https?:\/\//u;
 var buildMcpServerCard = (input) => {
-  const url = serverUrl(input);
+  const url = serverUrl2(input);
   const card2 = {
     $schema: SERVER_CARD_SCHEMA,
     capabilities: {
@@ -19534,52 +20221,52 @@ var specConfiguration = async (spec, root) => {
     };
   }
 };
-var acceptScalarReference = (ref, seen, contentRoutes, warnings) => {
-  if (ref.renderer !== "scalar") {
+var acceptScalarReference = (ref2, seen, contentRoutes, warnings) => {
+  if (ref2.renderer !== "scalar") {
     return null;
   }
-  if (seen.has(ref.route)) {
-    warnings.push(`Two API reference sources resolve to ${ref.route}; keeping the first.`);
+  if (seen.has(ref2.route)) {
+    warnings.push(`Two API reference sources resolve to ${ref2.route}; keeping the first.`);
     return null;
   }
-  if (contentRoutes.has(ref.route)) {
-    warnings.push(`API reference route ${ref.route} collides with a content page; skipping the reference there.`);
+  if (contentRoutes.has(ref2.route)) {
+    warnings.push(`API reference route ${ref2.route} collides with a content page; skipping the reference there.`);
     return null;
   }
-  seen.add(ref.route);
-  return ref;
+  seen.add(ref2.route);
+  return ref2;
 };
 var buildReferenceFiles = async (options) => {
   const { config, root, contentRoutes } = options;
   const warnings = [];
   const seen = new Set;
   const accepted = [];
-  for (const ref of resolveReferences(config)) {
-    const next = acceptScalarReference(ref, seen, contentRoutes, warnings);
+  for (const ref2 of resolveReferences(config)) {
+    const next = acceptScalarReference(ref2, seen, contentRoutes, warnings);
     if (next) {
       accepted.push(next);
     }
   }
-  const built = await Promise.all(accepted.map(async (ref) => ({
-    ref,
-    spec: await specConfiguration(ref.spec, root)
+  const built = await Promise.all(accepted.map(async (ref2) => ({
+    ref: ref2,
+    spec: await specConfiguration(ref2.spec, root)
   })));
   const files = [];
-  for (const { ref, spec } of built) {
+  for (const { ref: ref2, spec } of built) {
     if (spec.warning) {
       warnings.push(spec.warning);
     }
-    const pagePath = referencePagePath(ref.route);
+    const pagePath = referencePagePath(ref2.route);
     files.push({
       content: scalarReferenceTemplate({
         configuration: {
           ...spec.config,
-          ...themeConfiguration(config, ref.theme),
-          ...ref.scalar
+          ...themeConfiguration(config, ref2.theme),
+          ...ref2.scalar
         },
-        noindex: ref.noindex,
-        route: ref.route,
-        title: ref.label
+        noindex: ref2.noindex,
+        route: ref2.route,
+        title: ref2.label
       }),
       pagePath
     });
@@ -21311,6 +21998,7 @@ var buildRuntimeData = (project) => {
       description: config.description,
       discovery: {
         agentReadability: config.seo.agentReadability,
+        api: config.ai.api,
         llmsTxt: config.ai.llmsTxt.enabled,
         sitemap: config.seo.sitemap && Boolean(config.deployment.site)
       },
@@ -21439,12 +22127,18 @@ var planMcp = (project, srcDir, userPages) => {
     enabled: true
   };
 };
-var writeMcpFiles = async (project, plan, write, modules) => {
-  if (!plan.enabled) {
-    return;
+var publishAgentData = async (project, plans, modules) => {
+  if (!(plans.mcp.enabled || plans.api.enabled)) {
+    return null;
   }
   const data = await buildMcpData(project);
   modules.set("blume:mcp-data", JSON.stringify(data));
+  return data;
+};
+var writeMcpFiles = async (plan, write, data) => {
+  if (!(plan.enabled && data)) {
+    return;
+  }
   const discoveryInput = {
     base: data.base,
     name: data.name,
@@ -21458,6 +22152,52 @@ var writeMcpFiles = async (project, plan, write, modules) => {
     write(join31(plan.dir, "server-card.ts"), staticJsonEndpointTemplate(buildMcpServerCard(discoveryInput)))
   ]);
 };
+var ownsApiRest = (page) => page.pattern.startsWith("/api/[");
+var contentUnderApi = (page) => page.route === "/api" || page.route.startsWith("/api/");
+var planApi = (project, srcDir, userPages) => {
+  const { config, context } = project;
+  const server = config.deployment.output === "server";
+  return {
+    catchAll: server && !userPages.some(ownsApiRest) && !project.graph.pages.some(contentUnderApi),
+    enabled: config.ai.api,
+    server,
+    spec: !routeIsTaken(userPages, project.graph.pages, OPENAPI_PATH) && !existsSync17(join31(context.root, "public", "openapi.json")),
+    srcDir
+  };
+};
+var writeApiFiles = async (project, plan, write, data, mcp) => {
+  if (!(plan.enabled && data)) {
+    return;
+  }
+  const { config } = project;
+  const mcpRoute = mcp.enabled ? mcp.route : null;
+  const apiDir = join31(plan.srcDir, "pages", "api");
+  const writes = [
+    write(join31(apiDir, "docs", "pages.json.ts"), apiPagesIndexTemplate()),
+    write(join31(apiDir, "docs", "pages", "[...route].json.ts"), apiPageTemplate()),
+    write(join31(apiDir, "docs", "navigation.json.ts"), apiNavigationTemplate())
+  ];
+  if (plan.server) {
+    writes.push(write(join31(apiDir, "docs", "search.ts"), apiSearchTemplate()));
+  }
+  if (plan.catchAll) {
+    writes.push(write(join31(apiDir, "[...path].ts"), apiNotFoundTemplate({ base: data.base, site: data.site })));
+  }
+  if (plan.spec) {
+    writes.push(write(join31(plan.srcDir, "pages", "openapi.json.ts"), staticJsonEndpointTemplate(buildApiSpec({
+      agentReadability: config.seo.agentReadability,
+      base: data.base,
+      description: config.description,
+      llmsTxt: config.ai.llmsTxt.enabled,
+      mcpRoute,
+      name: config.title,
+      search: plan.server,
+      site: data.site,
+      version: data.version
+    }))));
+  }
+  await Promise.all(writes);
+};
 var planPlaygroundProxy = (config, srcDir) => ({
   enabled: needsPlaygroundProxy(config),
   entrypoint: join31(srcDir, "blume-openapi", "api-proxy.ts"),
@@ -21514,7 +22254,8 @@ var writeNotFoundPage = async (write, srcDir, pages, contentPages) => {
   }
   await Promise.all([
     write(join31(srcDir, "pages", "404.astro"), notFoundPageTemplate()),
-    write(join31(srcDir, "pages", "404.md.ts"), notFoundMarkdownTemplate())
+    write(join31(srcDir, "pages", "404.md.ts"), notFoundMarkdownTemplate()),
+    write(join31(srcDir, "pages", "404.json.ts"), notFoundJsonTemplate())
   ]);
 };
 var diagnosticWarning = (diagnostic) => diagnostic.suggestion ? `${diagnostic.message} ${diagnostic.suggestion}` : diagnostic.message;
@@ -21604,6 +22345,8 @@ var generateRuntime = async (project) => {
   const changelogIndex = hasGeneratedChangelog(project, pages);
   const mcp = planMcp(project, srcDir, pages);
   pages.push(...mcp.discoveryPages);
+  const api = planApi(project, srcDir, pages);
+  const agentData = await publishAgentData(project, { api, mcp }, modules);
   const openApiSource2 = project.sources.find(isOpenApiSource);
   const openApiData = openApiSource2 ? openApiSource2.openApiData() : {};
   const playgroundProxy = planPlaygroundProxy(config, srcDir);
@@ -21676,7 +22419,8 @@ var generateRuntime = async (project) => {
     Promise.all(slotPlan.wrappers.map((wrapper) => write(join31(srcDir, "generated", "component-slots", `${wrapper.name}.astro`), wrapper.content))),
     Promise.all(exampleDiscovery.examples.map((example) => write(join31(srcDir, "generated", "examples", `${exampleSlug(example.path)}.astro`), exampleWrapperTemplate(example)))),
     writeAskFiles(project, srcDir, write, modules),
-    writeMcpFiles(project, mcp, write, modules),
+    writeMcpFiles(mcp, write, agentData),
+    writeApiFiles(project, api, write, agentData, mcp),
     playgroundProxy.enabled ? write(playgroundProxy.entrypoint, playgroundProxyTemplate(proxyOrigins)) : Promise.resolve(false)
   ]);
   if (config.seo.og.enabled) {
@@ -21988,8 +22732,11 @@ var emitVercelNegotiation = async (project, routePaths, root) => {
   }
   const rawMarkdown = await buildRawMarkdown(project);
   const home = rawMarkdown["/"];
-  const notFoundMarkdown = existsSync19(join33(root, ".vercel", "output", "static", "404.md"));
-  const injected = injectNegotiationRoutes(await readFile20(configPath, "utf-8"), routePaths, buildHomeLinkHeader(config2, routePaths), overrides, home ? markdownTokenCount(agentMarkdown(home)) : undefined, notFoundMarkdown);
+  const staticDir = join33(root, ".vercel", "output", "static");
+  const injected = injectNegotiationRoutes(await readFile20(configPath, "utf-8"), routePaths, buildHomeLinkHeader(config2, routePaths), overrides, home ? markdownTokenCount(agentMarkdown(home)) : undefined, {
+    json: existsSync19(join33(staticDir, "404.json")),
+    markdown: existsSync19(join33(staticDir, "404.md"))
+  });
   if (injected === null) {
     logger.warn("Could not wire Accept: text/markdown negotiation into .vercel/output/config.json — raw Markdown stays available at the .md URLs.");
     return;
@@ -24489,6 +25236,9 @@ import {
   McpError,
   ReadResourceRequestSchema
 } from "@modelcontextprotocol/sdk/types.js";
+import { z as z8 } from "zod";
+
+// src/ai/mcp/query.ts
 import { z as z7 } from "zod";
 
 // src/search/orama-index.ts
@@ -24632,13 +25382,10 @@ var queryOramaIndex = async (db, term, limit, filters) => {
   return found.hits.map((hit) => hit.document);
 };
 
-// src/ai/mcp/server.ts
+// src/ai/mcp/query.ts
 var DEFAULT_SEARCH_LIMIT = 8;
 var MAX_SEARCH_LIMIT = 20;
 var EXCERPT_LENGTH = 200;
-var RESOURCE_MIME_TYPE = "text/markdown";
-var RESOURCE_NOT_FOUND = -32002;
-var LOCAL_RESOURCE_SCHEME = "blume:";
 var contentTypesField = z7.preprocess((value) => {
   const list2 = (Array.isArray(value) ? value : [value]).filter((entry) => typeof entry === "string");
   return list2.length > 0 ? list2 : undefined;
@@ -24690,21 +25437,6 @@ var TOOL_INPUTS = {
     version: versionField
   })
 };
-var inputSchemaFor = (schema) => {
-  const {
-    $schema: _dialect,
-    additionalProperties: _closed,
-    ...rest
-  } = z7.toJSONSchema(schema);
-  return rest;
-};
-var TOOL_DEFINITIONS = MCP_TOOLS.map((tool) => ({
-  annotations: tool.annotations,
-  description: tool.description,
-  inputSchema: inputSchemaFor(TOOL_INPUTS[tool.name]),
-  name: tool.name,
-  title: tool.title
-}));
 var matchesFacets = (facets, filters) => Object.entries(filters).every(([key, value]) => facets?.[key] === value);
 var asVersionScope = (value, data) => {
   if (!data.archivedVersions) {
@@ -24736,8 +25468,6 @@ var urlFor = (route, data) => {
   const path = withBasePath(data.base, route);
   return data.site ? absoluteUrl(data.site, path) : path;
 };
-var resourceUri = (route, data) => data.site ? urlFor(route, data) : `${LOCAL_RESOURCE_SCHEME}${withBasePath(data.base, route)}`;
-var resourceRoute = (uri, data) => normalizeRoute2(uri.startsWith(LOCAL_RESOURCE_SCHEME) ? uri.slice(LOCAL_RESOURCE_SCHEME.length) : uri, data);
 var excerptFor = (doc) => {
   if (doc.description) {
     return doc.description;
@@ -24745,10 +25475,6 @@ var excerptFor = (doc) => {
   const head = doc.content.slice(0, EXCERPT_LENGTH).trim();
   return doc.content.length > EXCERPT_LENGTH ? `${head}…` : head;
 };
-var text = (value, isError = false) => {
-  const content = [{ text: value, type: "text" }];
-  return isError ? { content, isError: true } : { content };
-};
 var createIndexProvider = (documents, locale) => {
   let dbPromise = null;
   return function provideIndex() {
@@ -24756,6 +25482,90 @@ var createIndexProvider = (documents, locale) => {
     return dbPromise;
   };
 };
+var searchDocs = async (data, index, input) => {
+  const db = await index();
+  const hits = await queryOramaIndex(db, input.query, input.limit ?? DEFAULT_SEARCH_LIMIT, {
+    contentTypes: input.contentTypes,
+    facets: input.filters,
+    locale: input.locale,
+    version: asVersionScope(input.version, data)
+  });
+  return hits.map((doc) => {
+    const hit = {
+      contentType: doc.contentType,
+      excerpt: excerptFor(doc),
+      facets: doc.facets,
+      route: doc.route,
+      title: doc.title,
+      url: urlFor(doc.route, data)
+    };
+    if (data.archivedVersions) {
+      hit.version = doc.version ?? "";
+    }
+    return hit;
+  });
+};
+var getPageMarkdown = (data, route) => data.pages[route];
+var listPages = (data, input) => {
+  const { contentTypes, filters, locale } = input;
+  const versionScope = asVersionScope(input.version, data);
+  return data.routes.filter((route) => (!contentTypes || contentTypes.includes(route.contentType)) && (!filters || matchesFacets(route.facets, filters)) && (!locale || route.locale === locale) && (versionScope === undefined || route.version === versionScope)).map((route) => {
+    const listing = {
+      contentType: route.contentType,
+      description: route.description,
+      facets: route.facets,
+      lastModified: route.lastModified,
+      route: route.route,
+      title: route.title,
+      url: urlFor(route.route, data)
+    };
+    if (data.archivedVersions) {
+      listing.version = route.version;
+    }
+    return listing;
+  });
+};
+var getNavigation = (data, input) => {
+  const { locale, version: versionId } = input;
+  const unknownVersion = unknownVersionError(versionId, data);
+  if (unknownVersion) {
+    return { error: unknownVersion };
+  }
+  let { navigation } = data;
+  const byLocale = versionId ? data.navigationByVersion?.[versionId] : undefined;
+  if (byLocale) {
+    navigation = (locale ? byLocale[locale] : undefined) ?? byLocale[data.defaultLocale ?? ""] ?? Object.values(byLocale)[0] ?? navigation;
+  } else if (locale && data.navigationByLocale?.[locale]) {
+    navigation = data.navigationByLocale[locale];
+  }
+  return { navigation };
+};
+
+// src/ai/mcp/server.ts
+var RESOURCE_MIME_TYPE = "text/markdown";
+var RESOURCE_NOT_FOUND = -32002;
+var LOCAL_RESOURCE_SCHEME = "blume:";
+var inputSchemaFor = (schema) => {
+  const {
+    $schema: _dialect,
+    additionalProperties: _closed,
+    ...rest
+  } = z8.toJSONSchema(schema);
+  return rest;
+};
+var TOOL_DEFINITIONS = MCP_TOOLS.map((tool) => ({
+  annotations: tool.annotations,
+  description: tool.description,
+  inputSchema: inputSchemaFor(TOOL_INPUTS[tool.name]),
+  name: tool.name,
+  title: tool.title
+}));
+var resourceUri = (route, data) => data.site ? urlFor(route, data) : `${LOCAL_RESOURCE_SCHEME}${withBasePath(data.base, route)}`;
+var resourceRoute = (uri, data) => normalizeRoute2(uri.startsWith(LOCAL_RESOURCE_SCHEME) ? uri.slice(LOCAL_RESOURCE_SCHEME.length) : uri, data);
+var text = (value, isError = false) => {
+  const content = [{ text: value, type: "text" }];
+  return isError ? { content, isError: true } : { content };
+};
 var buildServer = (data, index) => {
   const capabilities = { resources: {}, tools: {} };
   const serverOptions = data.instructions ? { capabilities, instructions: data.instructions } : { capabilities };
@@ -24779,7 +25589,7 @@ var buildServer = (data, index) => {
   }));
   server.setRequestHandler(ReadResourceRequestSchema, (request2) => {
     const { uri } = request2.params;
-    const markdown = data.pages[resourceRoute(uri, data)];
+    const markdown = getPageMarkdown(data, resourceRoute(uri, data));
     if (markdown === undefined) {
       throw new McpError(RESOURCE_NOT_FOUND, `No page found at "${uri}". Use resources/list or list_pages to find valid URIs.`);
     }
@@ -24790,74 +25600,28 @@ var buildServer = (data, index) => {
   server.setRequestHandler(CallToolRequestSchema, async (request2) => {
     const { arguments: args = {}, name } = request2.params;
     if (name === "search_docs") {
-      const input = TOOL_INPUTS.search_docs.parse(args);
-      const db = await index();
-      const hits = await queryOramaIndex(db, input.query, input.limit ?? DEFAULT_SEARCH_LIMIT, {
-        contentTypes: input.contentTypes,
-        facets: input.filters,
-        locale: input.locale,
-        version: asVersionScope(input.version, data)
-      });
-      const results = hits.map((doc) => {
-        const hit = {
-          contentType: doc.contentType,
-          excerpt: excerptFor(doc),
-          facets: doc.facets,
-          route: doc.route,
-          title: doc.title,
-          url: urlFor(doc.route, data)
-        };
-        if (data.archivedVersions) {
-          hit.version = doc.version ?? "";
-        }
-        return hit;
-      });
+      const results = await searchDocs(data, index, TOOL_INPUTS.search_docs.parse(args));
       return text(JSON.stringify(results, null, 2));
     }
     if (name === "get_page") {
       const input = TOOL_INPUTS.get_page.parse(args);
       const key = normalizeRoute2(input.route, data);
-      const markdown = data.pages[key];
+      const markdown = getPageMarkdown(data, key);
       if (markdown === undefined) {
         return text(`No page found at "${key}". Use list_pages or search_docs to find valid routes.`, true);
       }
       return text(markdown);
     }
     if (name === "list_pages") {
-      const input = TOOL_INPUTS.list_pages.parse(args);
-      const { contentTypes, filters, locale } = input;
-      const versionScope = asVersionScope(input.version, data);
-      const routes = data.routes.filter((route) => (!contentTypes || contentTypes.includes(route.contentType)) && (!filters || matchesFacets(route.facets, filters)) && (!locale || route.locale === locale) && (versionScope === undefined || route.version === versionScope));
-      return text(JSON.stringify(routes.map((route) => {
-        const listing = {
-          contentType: route.contentType,
-          description: route.description,
-          facets: route.facets,
-          lastModified: route.lastModified,
-          route: route.route,
-          title: route.title,
-          url: urlFor(route.route, data)
-        };
-        if (data.archivedVersions) {
-          listing.version = route.version;
-        }
-        return listing;
-      }), null, 2));
+      const listing = listPages(data, TOOL_INPUTS.list_pages.parse(args));
+      return text(JSON.stringify(listing, null, 2));
     }
     if (name === "get_navigation") {
-      const { locale, version: versionId } = TOOL_INPUTS.get_navigation.parse(args);
-      const unknownVersion = unknownVersionError(versionId, data);
-      if (unknownVersion) {
-        return text(unknownVersion, true);
+      const result = getNavigation(data, TOOL_INPUTS.get_navigation.parse(args));
+      if ("error" in result) {
+        return text(result.error, true);
       }
-      let { navigation } = data;
-      const byLocale = versionId ? data.navigationByVersion?.[versionId] : undefined;
-      if (byLocale) {
-        navigation = (locale ? byLocale[locale] : undefined) ?? byLocale[data.defaultLocale ?? ""] ?? Object.values(byLocale)[0] ?? navigation;
-      } else if (locale && data.navigationByLocale?.[locale]) {
-        navigation = data.navigationByLocale[locale];
-      }
-      return text(JSON.stringify(navigation, null, 2));
+      return text(JSON.stringify(result.navigation, null, 2));
     }
     return text(`Unknown tool: ${name}`, true);
   });
@@ -25009,11 +25773,11 @@ var translateAgentArgs = (kind, lastMessagePath) => kind === "claude" ? claudeAr
 import { createHash as createHash5 } from "node:crypto";
 import { readFile as readFile26 } from "node:fs/promises";
 import { join as join45 } from "pathe";
-import { z as z8 } from "zod";
+import { z as z9 } from "zod";
 var LEDGER_FILE = "blume.translations.json";
-var ledgerSchema = z8.object({
-  files: z8.record(z8.string(), z8.record(z8.string(), z8.string())),
-  version: z8.literal(1)
+var ledgerSchema = z9.object({
+  files: z9.record(z9.string(), z9.record(z9.string(), z9.string())),
+  version: z9.literal(1)
 });
 var emptyLedger = () => ({
   files: {},
@@ -26150,18 +26914,18 @@ var checkPathLink = (resolved, fragment, page2, link, site, ctx, via = "") => {
   };
 };
 var checkExternalLinks = async (refs) => {
-  const results = await probeAll(refs.map((ref) => ref.url));
+  const results = await probeAll(refs.map((ref2) => ref2.url));
   const diagnostics = [];
-  for (const ref of refs) {
-    const result = results.get(ref.url);
+  for (const ref2 of refs) {
+    const result = results.get(ref2.url);
     const grade = result ? gradeExternal(result) : null;
     if (grade) {
       diagnostics.push({
         code: "BLUME_DEAD_LINK",
-        column: ref.column,
-        file: ref.file,
-        line: ref.line,
-        message: `External link ${ref.url} is unreachable (${grade.detail}).`,
+        column: ref2.column,
+        file: ref2.file,
+        line: ref2.line,
+        message: `External link ${ref2.url} is unreachable (${grade.detail}).`,
         severity: grade.severity
       });
     }
@@ -26215,7 +26979,7 @@ var validateLinks = async (graph, options) => {
   let uncheckedAssets = 0;
   for (const page2 of graph.pages) {
     for (const link of page2.links) {
-      const result = classifyLink(page2, link, ctx, (ref) => external.push(ref));
+      const result = classifyLink(page2, link, ctx, (ref2) => external.push(ref2));
       if (result === "asset-unchecked") {
         uncheckedAssets += 1;
       } else if (result) {
@@ -26613,5 +27377,5 @@ process.on("unhandledRejection", (error) => {
 });
 runMain(main, { rawArgs: normalizeHostArgs(process.argv.slice(2)) });
 
-//# debugId=2A8DB3E67F0908D564756E2164756E21
+//# debugId=9AB8E5F1D71CCEF764756E2164756E21
 //# sourceMappingURL=index.js.map