next-agent-md 0.1.0

package/README.md

@@ -0,0 +1,166 @@
+# next-agent-md
+
+Next.js Edge Middleware that serves Markdown to AI agents — bringing [Cloudflare's Markdown for Agents](https://blog.cloudflare.com/markdown-for-agents/) pattern to any Next.js app.
+
+When an AI agent sends `Accept: text/markdown`, the middleware intercepts the request, converts the page HTML to clean Markdown, and returns it with an `x-markdown-tokens` header. This reduces token usage by ~80%.
+
+## Install
+
+```bash
+npm install next-agent-md
+```
+
+## Quick start
+
+The fastest way to get started:
+
+```bash
+npx next-agent-md init
+```
+
+This scaffolds the correct file for your Next.js version and that's it.
+
+> **Next.js version note**
+> Next.js 16+ renamed the middleware file convention from `middleware.ts` to `proxy.ts`.
+> The `init` command detects your version automatically and creates the right file.
+> All code examples below use `proxy.ts` — replace with `middleware.ts` if you're on Next.js ≤ 15.
+
+## Manual setup
+
+### 1. Add the proxy/middleware file
+
+**Next.js 16+** (`proxy.ts`):
+
+```ts
+// proxy.ts
+import { withMarkdownForAgents } from 'next-agent-md'
+
+export default withMarkdownForAgents()
+
+export const config = {
+  matcher: ['/((?!_next/static|_next/image|favicon.ico).*)'],
+}
+```
+
+**Next.js ≤ 15** (`middleware.ts`):
+
+```ts
+// middleware.ts
+import { withMarkdownForAgents } from 'next-agent-md'
+
+export default withMarkdownForAgents()
+
+export const config = {
+  matcher: ['/((?!_next/static|_next/image|favicon.ico).*)'],
+}
+```
+
+**Wrapping existing middleware:**
+
+```ts
+// proxy.ts (or middleware.ts on Next.js ≤ 15)
+import { withMarkdownForAgents } from 'next-agent-md'
+import { myAuthMiddleware } from './lib/auth'
+
+export default withMarkdownForAgents(myAuthMiddleware, {
+  contentSignal: { aiTrain: true, search: true, aiInput: true },
+})
+
+export const config = {
+  matcher: ['/((?!_next/static|_next/image|favicon.ico).*)'],
+}
+```
+
+### 2. Add the next.config plugin (optional but recommended)
+
+```ts
+// next.config.ts
+import { withAgentMd } from 'next-agent-md/config'
+
+export default withAgentMd()(nextConfig)
+```
+
+The config plugin:
+
+- Injects `Vary: accept` on all non-static routes so CDNs cache HTML and Markdown separately
+- Warns at startup if no `proxy.ts` or `middleware.ts` is found, with a pointer to `npx next-agent-md init`
+
+**Composing with other plugins:**
+
+```ts
+import { withAgentMd } from 'next-agent-md/config'
+import bundleAnalyzer from '@next/bundle-analyzer'
+
+const withAnalyzer = bundleAnalyzer({ enabled: process.env.ANALYZE === 'true' })
+
+export default withAgentMd()(withAnalyzer(nextConfig))
+```
+
+## How it works
+
+1. Incoming request has `Accept: text/markdown`
+2. Middleware self-fetches the same URL with `Accept: text/html` + an internal skip header (loop prevention)
+3. Strips boilerplate HTML: `<nav>`, `<header>`, `<footer>`, `<aside>`, `<script>`, `<style>`, etc.
+4. Converts cleaned HTML to Markdown via [`node-html-markdown`](https://github.com/crosstype/node-html-markdown)
+5. Returns a `text/markdown` response with:
+   - `x-markdown-tokens` — estimated token count (`chars / 4`)
+   - `vary: accept` — tells CDNs to cache HTML and Markdown versions separately
+   - `content-signal` — optional AI usage permissions header (see options)
+
+## Options
+
+```ts
+interface MarkdownAgentsOptions {
+  /** Header used to prevent infinite self-fetch loops. Default: 'x-markdown-skip' */
+  skipHeader?: string
+
+  /** Add `Vary: accept` to markdown responses. Default: true */
+  varyHeader?: boolean
+
+  /**
+   * Controls the Content-Signal response header.
+   * Pass true to enable all signals, or an object for fine-grained control.
+   * Default: false (header not sent)
+   *
+   * @example contentSignal: true
+   * // → Content-Signal: ai-train=yes, search=yes, ai-input=yes
+   *
+   * @example contentSignal: { aiTrain: false, search: true, aiInput: true }
+   * // → Content-Signal: ai-train=no, search=yes, ai-input=yes
+   */
+  contentSignal?: boolean | {
+    aiTrain?: boolean  // Default: true
+    search?: boolean   // Default: true
+    aiInput?: boolean  // Default: true
+  }
+
+  /** Extra HTML tag names to strip before conversion. Default: [] */
+  stripSelectors?: string[]
+}
+```
+
+## Testing
+
+```bash
+# Test Accept header
+curl -H "Accept: text/markdown" http://localhost:3000/
+
+# Check response headers
+curl -sI -H "Accept: text/markdown" http://localhost:3000/ \
+  | grep -E "content-type|x-markdown-tokens|vary|content-signal"
+```
+
+## Requirements
+
+- Next.js ≥ 13.0.0 (tested on 15 and 16)
+- Node.js ≥ 18.0.0
+- Works in **Edge Runtime** (default for Next.js middleware/proxy)
+
+| Next.js version | File convention |
+| --- | --- |
+| ≤ 15 | `middleware.ts` |
+| 16+ | `proxy.ts` |
+
+## License
+
+MIT

package/dist/cli.cjs

@@ -0,0 +1,274 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/build.ts
+var import_node_fs = __toESM(require("fs"), 1);
+var import_node_path = __toESM(require("path"), 1);
+
+// src/strip-boilerplate.ts
+var DEFAULT_STRIP_TAGS = [
+  "nav",
+  "header",
+  "footer",
+  "aside",
+  "script",
+  "style",
+  "noscript",
+  "iframe",
+  "svg"
+];
+var STRIP_ROLES = ["navigation", "banner", "contentinfo", "complementary"];
+function stripBoilerplate(html, extraTags = []) {
+  let result = html;
+  const allTags = [...DEFAULT_STRIP_TAGS, ...extraTags];
+  for (const tag of allTags) {
+    const tagRegex = new RegExp(`<${tag}[\\s>][\\s\\S]*?<\\/${tag}>`, "gi");
+    result = result.replace(tagRegex, "");
+    const selfClosingRegex = new RegExp(`<${tag}[^>]*\\/>`, "gi");
+    result = result.replace(selfClosingRegex, "");
+  }
+  for (const role of STRIP_ROLES) {
+    const roleRegex = new RegExp(
+      `<[a-z][^>]+role=["']${role}["'][\\s\\S]*?>[\\s\\S]*?<\\/[a-z]+>`,
+      "gi"
+    );
+    result = result.replace(roleRegex, "");
+  }
+  result = result.replace(/<!--[\s\S]*?-->/g, "");
+  return result;
+}
+
+// src/convert.ts
+var import_node_html_markdown = require("node-html-markdown");
+var nhm = new import_node_html_markdown.NodeHtmlMarkdown({
+  // Use fenced code blocks (```) for better AI readability
+  codeBlockStyle: "fenced",
+  // Limit consecutive blank lines — saves tokens
+  maxConsecutiveNewlines: 2,
+  // Skip data: URIs — they're noise for AI agents
+  keepDataImages: false,
+  // Inline links are cleaner for AI consumption
+  useInlineLinks: true
+});
+function htmlToMarkdown(html) {
+  return nhm.translate(html);
+}
+
+// src/build.ts
+async function buildStaticMarkdown(options = {}) {
+  const cwd = options.cwd ?? process.cwd();
+  const distDir = options.distDir ?? ".next";
+  const outDir = options.outDir ?? import_node_path.default.join("public", ".well-known", "markdown");
+  const stripSelectors = options.stripSelectors ?? [];
+  const distPath = import_node_path.default.join(cwd, distDir);
+  const outPath = import_node_path.default.join(cwd, outDir);
+  if (!import_node_fs.default.existsSync(distPath)) {
+    throw new Error(
+      `Build output not found at ${distDir}/. Run \`next build\` first.`
+    );
+  }
+  const manifestPath = import_node_path.default.join(distPath, "prerender-manifest.json");
+  if (!import_node_fs.default.existsSync(manifestPath)) {
+    return { generated: [], skipped: [] };
+  }
+  const manifest = JSON.parse(
+    import_node_fs.default.readFileSync(manifestPath, "utf8")
+  );
+  const staticRoutes = Object.keys(manifest.routes);
+  if (staticRoutes.length === 0) {
+    return { generated: [], skipped: [] };
+  }
+  const generated = [];
+  const skipped = [];
+  import_node_fs.default.mkdirSync(outPath, { recursive: true });
+  for (const route of staticRoutes) {
+    const html = findHtmlForRoute(distPath, route);
+    if (!html) {
+      skipped.push(route);
+      continue;
+    }
+    const markdown = htmlToMarkdown(stripBoilerplate(html, stripSelectors));
+    const slug = route === "/" ? "index" : route.replace(/^\//, "");
+    const mdFile = import_node_path.default.join(outPath, `${slug}.md`);
+    import_node_fs.default.mkdirSync(import_node_path.default.dirname(mdFile), { recursive: true });
+    import_node_fs.default.writeFileSync(mdFile, markdown, "utf8");
+    generated.push(route);
+  }
+  return { generated, skipped };
+}
+function findHtmlForRoute(distPath, route) {
+  const slug = route === "/" ? "index" : route.replace(/^\//, "");
+  const candidates = [
+    // App Router: .next/server/app/[route]/page.html or .next/server/app/[route].html
+    import_node_path.default.join(distPath, "server", "app", slug, "page.html"),
+    import_node_path.default.join(distPath, "server", "app", `${slug}.html`),
+    import_node_path.default.join(distPath, "server", "app", slug, "index.html"),
+    // Pages Router: .next/server/pages/[route].html
+    import_node_path.default.join(distPath, "server", "pages", `${slug}.html`),
+    import_node_path.default.join(distPath, "server", "pages", slug, "index.html")
+  ];
+  for (const candidate of candidates) {
+    if (import_node_fs.default.existsSync(candidate)) {
+      return import_node_fs.default.readFileSync(candidate, "utf8");
+    }
+  }
+  return null;
+}
+
+// src/cli.ts
+var import_node_fs2 = __toESM(require("fs"), 1);
+var import_node_path2 = __toESM(require("path"), 1);
+var command = process.argv[2];
+switch (command) {
+  case "init":
+    runInit();
+    break;
+  case "build":
+    runBuild();
+    break;
+  default:
+    printHelp();
+}
+var MIDDLEWARE_CONTENT = `import { withMarkdownForAgents } from 'next-agent-md'
+
+export default withMarkdownForAgents()
+
+export const config = {
+  matcher: ['/((?!_next/static|_next/image|favicon.ico).*)'],
+}
+`;
+function detectNextVersion(cwd) {
+  try {
+    const pkg = JSON.parse(import_node_fs2.default.readFileSync(import_node_path2.default.join(cwd, "package.json"), "utf8"));
+    const version = pkg.dependencies?.next ?? pkg.devDependencies?.next ?? "";
+    const major = parseInt(version.replace(/[^0-9]/, ""), 10);
+    return isNaN(major) ? 15 : major;
+  } catch {
+    return 15;
+  }
+}
+function runInit() {
+  const cwd = process.cwd();
+  const nextMajor = detectNextVersion(cwd);
+  const filename = nextMajor >= 16 ? "proxy.ts" : "middleware.ts";
+  const useSrcDir = import_node_fs2.default.existsSync(import_node_path2.default.join(cwd, "src"));
+  const targetDir = useSrcDir ? import_node_path2.default.join(cwd, "src") : cwd;
+  const targetFile = import_node_path2.default.join(targetDir, filename);
+  const displayPath = useSrcDir ? `src/${filename}` : filename;
+  const existing = [
+    "proxy.ts",
+    "proxy.js",
+    "middleware.ts",
+    "middleware.js",
+    import_node_path2.default.join("src", "proxy.ts"),
+    import_node_path2.default.join("src", "proxy.js"),
+    import_node_path2.default.join("src", "middleware.ts"),
+    import_node_path2.default.join("src", "middleware.js")
+  ].map((f) => import_node_path2.default.join(cwd, f)).find((f) => import_node_fs2.default.existsSync(f));
+  if (existing) {
+    const rel = import_node_path2.default.relative(cwd, existing);
+    console.log(`
+  \x1B[33m\u26A0  Skipped:\x1B[0m ${rel} already exists.
+`);
+    console.log(`  To use next-agent-md, update it to:
+`);
+    console.log(`  \x1B[90m${MIDDLEWARE_CONTENT}\x1B[0m`);
+    return;
+  }
+  import_node_fs2.default.writeFileSync(targetFile, MIDDLEWARE_CONTENT, "utf8");
+  console.log(
+    [
+      "",
+      `  \x1B[32m\u2714  Created ${displayPath}\x1B[0m`,
+      "",
+      "  AI agents can now request Markdown from any page:",
+      "",
+      '    \x1B[36mcurl -H "Accept: text/markdown" http://localhost:3000/\x1B[0m',
+      "",
+      "  Optional \u2014 also add the config plugin to next.config.ts:",
+      "",
+      "    \x1B[90mimport { withAgentMd } from 'next-agent-md/config'\x1B[0m",
+      "    \x1B[90mexport default withAgentMd()(nextConfig)\x1B[0m",
+      "",
+      "  The config plugin auto-generates pre-built .md files after next build,",
+      "  eliminating self-fetch overhead for static pages.",
+      ""
+    ].join("\n")
+  );
+}
+async function runBuild() {
+  console.log("\n  \x1B[90mnext-agent-md\x1B[0m  Generating static markdown files\u2026\n");
+  try {
+    const { generated, skipped } = await buildStaticMarkdown();
+    if (generated.length === 0 && skipped.length === 0) {
+      console.log("  No static pages found in build output. Skipping.\n");
+      return;
+    }
+    for (const route of generated) {
+      console.log(`  \x1B[32m\u2714\x1B[0m  ${route}`);
+    }
+    if (skipped.length > 0) {
+      console.log(`
+  \x1B[33m\u26A0  ${skipped.length} route(s) skipped\x1B[0m (HTML not found in build output):`);
+      for (const route of skipped) {
+        console.log(`       ${route}`);
+      }
+    }
+    console.log(
+      [
+        "",
+        `  \x1B[32m\u2714  ${generated.length} file(s) written to public/.well-known/markdown/\x1B[0m`,
+        "",
+        "  Static pages will be served from pre-built .md files.",
+        "  Dynamic pages fall back to on-demand conversion.",
+        ""
+      ].join("\n")
+    );
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(`
+  \x1B[31m\u2716  Error:\x1B[0m ${message}
+`);
+    process.exit(1);
+  }
+}
+function printHelp() {
+  console.log(
+    [
+      "",
+      "  \x1B[1mnext-agent-md\x1B[0m",
+      "",
+      "  Commands:",
+      "    \x1B[36minit\x1B[0m    Scaffold middleware.ts in your Next.js project",
+      "    \x1B[36mbuild\x1B[0m   Pre-generate markdown for static pages after next build",
+      "",
+      "  Examples:",
+      "    npx next-agent-md init",
+      "    npx next-agent-md build",
+      ""
+    ].join("\n")
+  );
+}
+//# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/build.ts","../src/strip-boilerplate.ts","../src/convert.ts","../src/cli.ts"],"sourcesContent":["/**\n * Static markdown pre-generation.\n *\n * Reads the Next.js build output, finds all statically pre-rendered HTML files,\n * converts them to Markdown, and writes them to public/.well-known/markdown/\n * so the middleware can serve them directly without a self-fetch round-trip.\n *\n * Run automatically after `next build` via the withAgentMd() config plugin,\n * or manually with `npx next-agent-md build`.\n */\nimport fs from 'node:fs'\nimport path from 'node:path'\nimport { stripBoilerplate } from './strip-boilerplate'\nimport { htmlToMarkdown } from './convert'\n\nexport interface BuildOptions {\n  /** Next.js project root. Default: process.cwd() */\n  cwd?: string\n  /** Next.js build output directory. Default: '.next' */\n  distDir?: string\n  /** Where to write .md files, relative to cwd. Default: 'public/.well-known/markdown' */\n  outDir?: string\n  /** Extra tags to strip (passed through to stripBoilerplate). Default: [] */\n  stripSelectors?: string[]\n}\n\ninterface PrerenderManifest {\n  version: number\n  routes: Record<string, unknown>\n  dynamicRoutes: Record<string, unknown>\n}\n\nexport async function buildStaticMarkdown(options: BuildOptions = {}): Promise<BuildResult> {\n  const cwd = options.cwd ?? process.cwd()\n  const distDir = options.distDir ?? '.next'\n  const outDir = options.outDir ?? path.join('public', '.well-known', 'markdown')\n  const stripSelectors = options.stripSelectors ?? []\n\n  const distPath = path.join(cwd, distDir)\n  const outPath = path.join(cwd, outDir)\n\n  // ── Validate build output exists ──────────────────────────────────────────\n  if (!fs.existsSync(distPath)) {\n    throw new Error(\n      `Build output not found at ${distDir}/. Run \\`next build\\` first.`\n    )\n  }\n\n  // ── Read prerender manifest to find static routes ─────────────────────────\n  const manifestPath = path.join(distPath, 'prerender-manifest.json')\n  if (!fs.existsSync(manifestPath)) {\n    return { generated: [], skipped: [] }\n  }\n\n  const manifest: PrerenderManifest = JSON.parse(\n    fs.readFileSync(manifestPath, 'utf8')\n  )\n\n  const staticRoutes = Object.keys(manifest.routes)\n  if (staticRoutes.length === 0) {\n    return { generated: [], skipped: [] }\n  }\n\n  // ── Find HTML files for each static route ─────────────────────────────────\n  const generated: string[] = []\n  const skipped: string[] = []\n\n  fs.mkdirSync(outPath, { recursive: true })\n\n  for (const route of staticRoutes) {\n    const html = findHtmlForRoute(distPath, route)\n    if (!html) {\n      skipped.push(route)\n      continue\n    }\n\n    const markdown = htmlToMarkdown(stripBoilerplate(html, stripSelectors))\n\n    // Write to outDir — nested paths become nested dirs\n    // e.g. /blog/hello → public/.well-known/markdown/blog/hello.md\n    const slug = route === '/' ? 'index' : route.replace(/^\\//, '')\n    const mdFile = path.join(outPath, `${slug}.md`)\n\n    fs.mkdirSync(path.dirname(mdFile), { recursive: true })\n    fs.writeFileSync(mdFile, markdown, 'utf8')\n    generated.push(route)\n  }\n\n  return { generated, skipped }\n}\n\nexport interface BuildResult {\n  generated: string[]\n  skipped: string[]\n}\n\n/**\n * Finds the pre-rendered HTML for a given route from the Next.js build output.\n * Checks App Router paths first, then Pages Router paths.\n */\nfunction findHtmlForRoute(distPath: string, route: string): string | null {\n  const slug = route === '/' ? 'index' : route.replace(/^\\//, '')\n\n  const candidates = [\n    // App Router: .next/server/app/[route]/page.html or .next/server/app/[route].html\n    path.join(distPath, 'server', 'app', slug, 'page.html'),\n    path.join(distPath, 'server', 'app', `${slug}.html`),\n    path.join(distPath, 'server', 'app', slug, 'index.html'),\n    // Pages Router: .next/server/pages/[route].html\n    path.join(distPath, 'server', 'pages', `${slug}.html`),\n    path.join(distPath, 'server', 'pages', slug, 'index.html'),\n  ]\n\n  for (const candidate of candidates) {\n    if (fs.existsSync(candidate)) {\n      return fs.readFileSync(candidate, 'utf8')\n    }\n  }\n\n  return null\n}\n\n/**\n * Returns the public URL path for a pre-built markdown file.\n * Used by the middleware to check if a fast-path file exists.\n *\n * e.g. pathname '/blog/hello' → '/.well-known/markdown/blog/hello.md'\n */\nexport function markdownPublicPath(pathname: string): string {\n  const slug = pathname === '/' ? 'index' : pathname.replace(/^\\//, '')\n  return `/.well-known/markdown/${slug}.md`\n}\n","/**\n * HTML tags whose content is typically boilerplate (navigation, chrome, scripts).\n * These are stripped before markdown conversion to reduce noise for AI agents.\n */\nconst DEFAULT_STRIP_TAGS = [\n  'nav',\n  'header',\n  'footer',\n  'aside',\n  'script',\n  'style',\n  'noscript',\n  'iframe',\n  'svg',\n]\n\n/**\n * ARIA roles that indicate navigation or structural boilerplate (not content).\n */\nconst STRIP_ROLES = ['navigation', 'banner', 'contentinfo', 'complementary']\n\n/**\n * Strips boilerplate HTML elements from a page before markdown conversion.\n *\n * Uses regex rather than a DOM parser to remain compatible with the Edge Runtime\n * (jsdom and similar are not available). Handles the common case well; deeply\n * nested elements of the same tag type may not be fully removed.\n *\n * @param html - Raw HTML string to clean\n * @param extraTags - Additional tag names to strip (e.g. ['cookie-banner'])\n */\nexport function stripBoilerplate(html: string, extraTags: string[] = []): string {\n  let result = html\n\n  const allTags = [...DEFAULT_STRIP_TAGS, ...extraTags]\n\n  for (const tag of allTags) {\n    // Match the full element including content — non-greedy to avoid over-matching\n    const tagRegex = new RegExp(`<${tag}[\\\\s>][\\\\s\\\\S]*?<\\\\/${tag}>`, 'gi')\n    result = result.replace(tagRegex, '')\n\n    // Also handle self-closing variants: <tag ... />\n    const selfClosingRegex = new RegExp(`<${tag}[^>]*\\\\/>`, 'gi')\n    result = result.replace(selfClosingRegex, '')\n  }\n\n  // Remove elements with ARIA roles indicating structural boilerplate\n  for (const role of STRIP_ROLES) {\n    const roleRegex = new RegExp(\n      `<[a-z][^>]+role=[\"']${role}[\"'][\\\\s\\\\S]*?>[\\\\s\\\\S]*?<\\\\/[a-z]+>`,\n      'gi'\n    )\n    result = result.replace(roleRegex, '')\n  }\n\n  // Remove HTML comments — often contain CMS/build tool artifacts\n  result = result.replace(/<!--[\\s\\S]*?-->/g, '')\n\n  return result\n}\n","import { NodeHtmlMarkdown } from 'node-html-markdown'\n\n/**\n * Shared converter instance — reusing avoids repeated option parsing overhead.\n */\nconst nhm = new NodeHtmlMarkdown({\n  // Use fenced code blocks (```) for better AI readability\n  codeBlockStyle: 'fenced',\n  // Limit consecutive blank lines — saves tokens\n  maxConsecutiveNewlines: 2,\n  // Skip data: URIs — they're noise for AI agents\n  keepDataImages: false,\n  // Inline links are cleaner for AI consumption\n  useInlineLinks: true,\n})\n\n/**\n * Converts an HTML string to Markdown.\n */\nexport function htmlToMarkdown(html: string): string {\n  return nhm.translate(html)\n}\n","#!/usr/bin/env node\n/**\n * next-agent-md CLI\n *\n * Commands:\n *   init   — scaffold middleware.ts in the current Next.js project\n *   build  — pre-generate markdown files from static pages after next build\n */\nimport { buildStaticMarkdown } from './build'\n\nconst command = process.argv[2]\n\nswitch (command) {\n  case 'init':\n    runInit()\n    break\n  case 'build':\n    runBuild()\n    break\n  default:\n    printHelp()\n}\n\n// ── init ──────────────────────────────────────────────────────────────────────\n\nimport fs from 'node:fs'\nimport path from 'node:path'\n\nconst MIDDLEWARE_CONTENT = `import { withMarkdownForAgents } from 'next-agent-md'\n\nexport default withMarkdownForAgents()\n\nexport const config = {\n  matcher: ['/((?!_next/static|_next/image|favicon.ico).*)'],\n}\n`\n\nfunction detectNextVersion(cwd: string): number {\n  try {\n    const pkg = JSON.parse(fs.readFileSync(path.join(cwd, 'package.json'), 'utf8'))\n    const version: string = pkg.dependencies?.next ?? pkg.devDependencies?.next ?? ''\n    const major = parseInt(version.replace(/[^0-9]/, ''), 10)\n    return isNaN(major) ? 15 : major\n  } catch {\n    return 15\n  }\n}\n\nfunction runInit(): void {\n  const cwd = process.cwd()\n  const nextMajor = detectNextVersion(cwd)\n\n  // Next.js 16+ uses proxy.ts; older versions use middleware.ts\n  const filename = nextMajor >= 16 ? 'proxy.ts' : 'middleware.ts'\n\n  const useSrcDir = fs.existsSync(path.join(cwd, 'src'))\n  const targetDir = useSrcDir ? path.join(cwd, 'src') : cwd\n  const targetFile = path.join(targetDir, filename)\n  const displayPath = useSrcDir ? `src/${filename}` : filename\n\n  const existing = [\n    'proxy.ts', 'proxy.js',\n    'middleware.ts', 'middleware.js',\n    path.join('src', 'proxy.ts'), path.join('src', 'proxy.js'),\n    path.join('src', 'middleware.ts'), path.join('src', 'middleware.js'),\n  ].map(f => path.join(cwd, f)).find((f) => fs.existsSync(f))\n\n  if (existing) {\n    const rel = path.relative(cwd, existing)\n    console.log(`\\n  \\x1b[33m⚠  Skipped:\\x1b[0m ${rel} already exists.\\n`)\n    console.log(`  To use next-agent-md, update it to:\\n`)\n    console.log(`  \\x1b[90m${MIDDLEWARE_CONTENT}\\x1b[0m`)\n    return\n  }\n\n  fs.writeFileSync(targetFile, MIDDLEWARE_CONTENT, 'utf8')\n\n  console.log(\n    [\n      '',\n      `  \\x1b[32m✔  Created ${displayPath}\\x1b[0m`,\n      '',\n      '  AI agents can now request Markdown from any page:',\n      '',\n      '    \\x1b[36mcurl -H \"Accept: text/markdown\" http://localhost:3000/\\x1b[0m',\n      '',\n      '  Optional — also add the config plugin to next.config.ts:',\n      '',\n      \"    \\x1b[90mimport { withAgentMd } from 'next-agent-md/config'\\x1b[0m\",\n      '    \\x1b[90mexport default withAgentMd()(nextConfig)\\x1b[0m',\n      '',\n      '  The config plugin auto-generates pre-built .md files after next build,',\n      '  eliminating self-fetch overhead for static pages.',\n      '',\n    ].join('\\n')\n  )\n}\n\n// ── build ─────────────────────────────────────────────────────────────────────\n\nasync function runBuild(): Promise<void> {\n  console.log('\\n  \\x1b[90mnext-agent-md\\x1b[0m  Generating static markdown files…\\n')\n\n  try {\n    const { generated, skipped } = await buildStaticMarkdown()\n\n    if (generated.length === 0 && skipped.length === 0) {\n      console.log('  No static pages found in build output. Skipping.\\n')\n      return\n    }\n\n    for (const route of generated) {\n      console.log(`  \\x1b[32m✔\\x1b[0m  ${route}`)\n    }\n\n    if (skipped.length > 0) {\n      console.log(`\\n  \\x1b[33m⚠  ${skipped.length} route(s) skipped\\x1b[0m (HTML not found in build output):`)\n      for (const route of skipped) {\n        console.log(`       ${route}`)\n      }\n    }\n\n    console.log(\n      [\n        '',\n        `  \\x1b[32m✔  ${generated.length} file(s) written to public/.well-known/markdown/\\x1b[0m`,\n        '',\n        '  Static pages will be served from pre-built .md files.',\n        '  Dynamic pages fall back to on-demand conversion.',\n        '',\n      ].join('\\n')\n    )\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err)\n    console.error(`\\n  \\x1b[31m✖  Error:\\x1b[0m ${message}\\n`)\n    process.exit(1)\n  }\n}\n\n// ── help ──────────────────────────────────────────────────────────────────────\n\nfunction printHelp(): void {\n  console.log(\n    [\n      '',\n      '  \\x1b[1mnext-agent-md\\x1b[0m',\n      '',\n      '  Commands:',\n      '    \\x1b[36minit\\x1b[0m    Scaffold middleware.ts in your Next.js project',\n      '    \\x1b[36mbuild\\x1b[0m   Pre-generate markdown for static pages after next build',\n      '',\n      '  Examples:',\n      '    npx next-agent-md init',\n      '    npx next-agent-md build',\n      '',\n    ].join('\\n')\n  )\n}\n"],"mappings":"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","names":["path","fs","import_node_fs","import_node_path","fs","path"]}

package/dist/cli.d.cts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node