AI Agent Discovery Header (ai/link-headers.ts)

Generates RFC 8288 Link headers to help AI agents discover machine-readable site documentation. Use this to expose your API and content catalogs to LLMs and automated crawlers.

// Source: https://github.com/haydenbleasel/blume | License: MIT | Copyright 2026 Hayden Bleasel
// Provided via justclaw.it.com; keep this notice with the code.
import { normalizeBasePath } from "../core/base-path.ts";
import type { ResolvedConfig } from "../core/schema.ts";
import {
  AI_CATALOG_PATH,
  AI_CATALOG_TYPE,
  hasAiCatalog,
} from "./ai-catalog.ts";
import {
  API_CATALOG_PATH,
  API_CATALOG_TYPE,
  hasApiCatalog,
} from "./api-catalog.ts";
import { OPENAPI_PATH } from "./api/paths.ts";

/**
 * The homepage `Link` response header (RFC 8288) — agent discovery for the
 * machine-readable surface Blume already publishes. Agents probing a site read
 * this header off `GET /` to find the resources without scraping HTML:
 * `agent-readability.json` and `llms.txt` as `rel="described

... (truncated -- full source via MCP)