nuxt-ai-ready 0.3.0 → 0.3.2

package/dist/module.json

@@ -4,7 +4,7 @@
     "nuxt": ">=4.0.0"
   },
   "configKey": "aiReady",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "3.6.1"

package/dist/module.mjs

@@ -1,5 +1,5 @@
 import { dirname, join } from 'node:path';
-import { useLogger, useNuxt, defineNuxtModule, createResolver, addTypeTemplate, hasNuxtModule, addServerHandler, addPlugin } from '@nuxt/kit';
+import { useLogger, useNuxt, defineNuxtModule, createResolver, addTypeTemplate, hasNuxtModule, addServerHandler, addPlugin, extendPages } from '@nuxt/kit';
 import defu from 'defu';
 import { useSiteConfig, installNuxtSiteConfig, withSiteUrl } from 'nuxt-site-config/kit';
 import { relative } from 'pathe';
@@ -338,6 +338,23 @@ function setupPrerenderHandler(llmsTxtConfig, timestampsConfig) {
   });
 }
 
+function createPagesPromise(nuxt = useNuxt()) {
+  return new Promise((resolve) => {
+    nuxt.hooks.hook("modules:done", () => {
+      if (typeof nuxt.options.pages === "boolean" && !nuxt.options.pages || typeof nuxt.options.pages === "object" && !nuxt.options.pages.enabled) {
+        return resolve([]);
+      }
+      extendPages(resolve);
+    });
+  });
+}
+function flattenPages(pages, parent = "") {
+  return pages.flatMap((page) => {
+    const path = parent + page.path;
+    const current = { path, name: page.name, meta: page.meta };
+    return page.children?.length ? [current, ...flattenPages(page.children, path)] : [current];
+  });
+}
 const module$1 = defineNuxtModule({
   meta: {
     name: "nuxt-ai-ready",
@@ -393,9 +410,17 @@ const module$1 = defineNuxtModule({
     }
     nuxt.options.nitro.scanDirs = nuxt.options.nitro.scanDirs || [];
     nuxt.options.nitro.scanDirs.push(
-      resolve("./runtime/server/utils"),
-      resolve("./runtime/server/mcp")
+      resolve("./runtime/server/utils")
     );
+    const pagesPromise = createPagesPromise(nuxt);
+    nuxt.hooks.hook("nitro:config", (nitroConfig) => {
+      nitroConfig.virtual = nitroConfig.virtual || {};
+      nitroConfig.virtual["#ai-ready/routes.mjs"] = async () => {
+        const pages = await pagesPromise;
+        const routes = flattenPages(pages);
+        return `export default ${JSON.stringify(routes)}`;
+      };
+    });
     if (typeof config.contentSignal === "object") {
       nuxt.options.robots.groups.push({
         userAgent: "*",
@@ -451,22 +476,12 @@ export {}
     const hasMCP = hasNuxtModule("@nuxtjs/mcp-toolkit");
     if (hasMCP) {
       nuxt.hook("mcp:definitions:paths", (paths) => {
-        const mcpRuntimeDir = resolve("./runtime/server/mcp");
-        paths.tools = paths.tools || [];
-        paths.resources = paths.resources || [];
-        paths.prompts = paths.prompts || [];
+        const mcpRuntimeDir = resolve(`./runtime/server/mcp/${nuxt.options.dev ? "dev" : "prod"}`);
         const mcpConfig = config.mcp || {};
-        const toolsConfig = mcpConfig.tools ?? {};
-        const resourcesConfig = mcpConfig.resources ?? {};
-        if (toolsConfig.listPages !== false) {
-          paths.tools.push(`${mcpRuntimeDir}/tools/list-pages.ts`);
-        }
-        if (resourcesConfig.pages !== false) {
-          paths.resources.push(`${mcpRuntimeDir}/resources/pages.ts`);
-        }
-        if (resourcesConfig.pagesChunks !== false) {
-          paths.resources.push(`${mcpRuntimeDir}/resources/pages-chunks.ts`);
-        }
+        if (mcpConfig.tools !== false)
+          (paths.tools ||= []).push(`${mcpRuntimeDir}/tools`);
+        if (mcpConfig.resources !== false)
+          (paths.resources ||= []).push(`${mcpRuntimeDir}/resources`);
       });
       const mcpLink = {
         title: "MCP",
@@ -500,6 +515,7 @@ export {}
     nuxt.options.runtimeConfig["nuxt-ai-ready"] = {
       version: version || "0.0.0",
       debug: config.debug || false,
+      hasSitemap: hasNuxtModule("@nuxtjs/sitemap"),
       mdreamOptions: config.mdreamOptions || {},
       markdownCacheHeaders: defu(config.markdownCacheHeaders, {
         maxAge: 3600,

package/dist/runtime/nuxt/plugins/prerender.d.ts

@@ -1,2 +1,2 @@
-declare const _default: import("nuxt/app").Plugin<Record<string, unknown>> & import("nuxt/app").ObjectPlugin<Record<string, unknown>>;
+declare const _default: import("#app").Plugin<Record<string, unknown>> & import("#app").ObjectPlugin<Record<string, unknown>>;
 export default _default;

package/dist/runtime/server/mcp/dev/resources/pages.js

@@ -0,0 +1,19 @@
+import { getDevPages } from "../utils.js";
+export default {
+  uri: "resource://nuxt-ai-ready/pages",
+  name: "All Pages",
+  description: "Page routes from sitemap/routes. In dev mode, returns JSON (TOON format unavailable until build).",
+  metadata: {
+    mimeType: "application/json"
+  },
+  async handler(uri) {
+    const pages = await getDevPages();
+    return {
+      contents: [{
+        uri: uri.toString(),
+        mimeType: "application/json",
+        text: JSON.stringify(pages, null, 2)
+      }]
+    };
+  }
+};

package/dist/runtime/server/mcp/dev/tools/list-pages.js

@@ -0,0 +1,10 @@
+import { getDevPages, jsonResult } from "../utils.js";
+export default {
+  name: "list_pages",
+  description: "Lists all available pages with their routes. In dev mode, returns JSON from sitemap/routes (TOON format unavailable until build).",
+  inputSchema: {},
+  async handler() {
+    const pages = await getDevPages();
+    return jsonResult(pages);
+  }
+};

package/dist/runtime/server/mcp/dev/utils.js

@@ -0,0 +1,34 @@
+import routes from "#ai-ready/routes.mjs";
+import { useRuntimeConfig } from "nitropack/runtime";
+export { jsonResult } from "../utils.js";
+function routeToRegex(routePath) {
+  const pattern = routePath.replace(/:[^/]+\(\.\*\)\*?/g, ".*").replace(/:[^/]+/g, "[^/]+");
+  return new RegExp(`^${pattern}$`);
+}
+function matchRoute(path, routeRecords) {
+  for (const r of routeRecords) {
+    if (routeToRegex(r.path).test(path))
+      return r;
+  }
+}
+export async function getDevPages() {
+  const config = useRuntimeConfig()["nuxt-ai-ready"];
+  if (!config.hasSitemap)
+    return routes.map((r) => ({ route: r.path, name: r.name, meta: r.meta }));
+  const { parseSitemapXml } = await import("@nuxtjs/sitemap/utils");
+  const sitemapRes = await fetch("/sitemap.xml");
+  if (!sitemapRes.ok)
+    return routes.map((r) => ({ route: r.path, name: r.name, meta: r.meta }));
+  const xml = await sitemapRes.text();
+  const { urls } = await parseSitemapXml(xml);
+  return urls.map((entry) => {
+    const pathname = typeof entry === "string" ? new URL(entry).pathname : new URL(entry.loc).pathname;
+    const matched = matchRoute(pathname, routes);
+    return {
+      route: pathname,
+      ...typeof entry !== "string" && entry.lastmod && { lastmod: entry.lastmod },
+      ...matched?.name && { name: matched.name },
+      ...matched?.meta && { meta: matched.meta }
+    };
+  });
+}

package/dist/runtime/server/mcp/{tools → prod/tools}/list-pages.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { toonResult } from "../utils.js";
+import { toonResult } from "../../utils.js";
 const schema = {
   mode: z.enum(["chunks", "minimal"]).default("minimal").describe("Return individual content chunks (chunks) or page-level metadata (minimal)")
 };

package/dist/runtime/types.d.ts

@@ -63,24 +63,10 @@ export interface ModuleOptions {
      * @default All enabled when @nuxtjs/mcp-toolkit is installed
      */
     mcp?: {
-        /**
-         * Enable/disable specific MCP tools
-         * @default All tools enabled
-         */
-        tools?: {
-            /** Get page by route - fetches markdown content for specific page */
-            listPages?: boolean;
-        };
-        /**
-         * Enable/disable specific MCP resources
-         * @default All resources enabled
-         */
-        resources?: {
-            /** pages://list - all pages without markdown content */
-            pages?: boolean;
-            /** pages://chunks - individual content chunks from all pages */
-            pagesChunks?: boolean;
-        };
+        /** Enable MCP tools (list-pages) @default true */
+        tools?: boolean;
+        /** Enable MCP resources (pages, pages-chunks) @default true */
+        resources?: boolean;
     };
     /**
      * Content timestamp tracking configuration

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nuxt-ai-ready",
   "type": "module",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Best practice AI & LLM discoverability for Nuxt sites.",
   "author": {
     "name": "Harlan Wilton",

package/dist/runtime/server/mcp/resources/pages-chunks.d.ts

@@ -1,17 +0,0 @@
-declare const _default: {
-    uri: string;
-    name: string;
-    description: string;
-    metadata: {
-        mimeType: string;
-    };
-    cache: "1h";
-    handler(uri: URL): Promise<{
-        contents: {
-            uri: string;
-            mimeType: string;
-            text: string;
-        }[];
-    }>;
-};
-export default _default;

package/dist/runtime/server/mcp/resources/pages.d.ts

@@ -1,17 +0,0 @@
-declare const _default: {
-    uri: string;
-    name: string;
-    description: string;
-    metadata: {
-        mimeType: string;
-    };
-    cache: "1h";
-    handler(uri: URL): Promise<{
-        contents: {
-            uri: string;
-            mimeType: string;
-            text: string;
-        }[];
-    }>;
-};
-export default _default;

package/dist/runtime/server/mcp/tools/list-pages.d.ts

@@ -1,86 +0,0 @@
-import { z } from 'zod';
-/**
- * Lists all pages by fetching and returning TOON-encoded data
- * TOON (Token-Oriented Object Notation) is a compact encoding that minimizes tokens for LLM input
- * See https://toonformat.dev
- */
-declare const _default: {
-    name: string;
-    description: string;
-    inputSchema: {
-        mode: z.ZodDefault<z.ZodEnum<{
-            minimal: "minimal";
-            chunks: "chunks";
-        }>>;
-    };
-    cache: "1h";
-    handler({ mode }: import("@modelcontextprotocol/sdk/server/zod-compat.js").ShapeOutput<Readonly<{
-        [k: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
-    }>>): Promise<{
-        [x: string]: unknown;
-        content: ({
-            type: "text";
-            text: string;
-            _meta?: {
-                [x: string]: unknown;
-            } | undefined;
-        } | {
-            type: "image";
-            data: string;
-            mimeType: string;
-            _meta?: {
-                [x: string]: unknown;
-            } | undefined;
-        } | {
-            type: "audio";
-            data: string;
-            mimeType: string;
-            _meta?: {
-                [x: string]: unknown;
-            } | undefined;
-        } | {
-            uri: string;
-            name: string;
-            type: "resource_link";
-            description?: string | undefined;
-            mimeType?: string | undefined;
-            _meta?: {
-                [x: string]: unknown;
-            } | undefined;
-            icons?: {
-                src: string;
-                mimeType?: string | undefined;
-                sizes?: string[] | undefined;
-            }[] | undefined;
-            title?: string | undefined;
-        } | {
-            type: "resource";
-            resource: {
-                uri: string;
-                text: string;
-                mimeType?: string | undefined;
-                _meta?: {
-                    [x: string]: unknown;
-                } | undefined;
-            } | {
-                uri: string;
-                blob: string;
-                mimeType?: string | undefined;
-                _meta?: {
-                    [x: string]: unknown;
-                } | undefined;
-            };
-            _meta?: {
-                [x: string]: unknown;
-            } | undefined;
-        })[];
-        _meta?: {
-            [x: string]: unknown;
-        } | undefined;
-        structuredContent?: {
-            [x: string]: unknown;
-        } | undefined;
-        isError?: boolean | undefined;
-    }>;
-};
-export default _default;