nuxt-ai-ready 1.5.8 → 1.7.0

package/README.md

@@ -21,7 +21,10 @@ Nuxt AI Ready implements both. It converts your pages to markdown, generates llm
 - 📝 **[Nuxt Content](https://content.nuxt.com) Integration**: Routes backed by a page collection serve source markdown directly, skipping HTML→markdown conversion
 - 📡 **Content Signals**: Configure AI training/search/input permissions via [Nuxt Robots](https://nuxtseo.com/robots)
 - 🌐 **Sitemap Integration**: Index AI-allowed pages via [Nuxt Sitemap](https://nuxtseo.com/sitemap)
-- ⚡ **MCP Server**: `list_pages` and `search_pages` tools with FTS5 full-text search
+- ⚡ **MCP Server**: List, search and read indexed pages through `@nuxtjs/mcp-toolkit`
+- 🔎 **[API Catalog](https://nuxtseo.com/ai-ready/guides/api-catalog)**: Publish RFC 9727 API discovery metadata and advertise it through `Link` headers
+- 🧠 **Agent Skills**: Publish verified local or external skills through the v0.2.0 discovery index
+- 🧩 **[WebMCP](https://nuxtseo.com/ai-ready/guides/webmcp)**: Give browser agents access to built-in site tools or your own tools with `useWebMcpTool()`
 - 🗄️ **Runtime Indexing**: Index pages on-demand without prerendering, with SQLite/D1/LibSQL support
 - 🔔 **[IndexNow](https://nuxtseo.com/ai-ready/guides/indexnow)**: Instantly notify Bing, Yandex, and other search engines when pages change
 - 🌏 **[i18n Aware](https://nuxtseo.com/ai-ready/guides/i18n)**: Auto-detects [`@nuxtjs/i18n`](https://i18n.nuxtjs.org/) for hreflang `Link` headers, locale-tagged frontmatter, and an Available Languages section in `llms.txt`

package/dist/cli.mjs

@@ -12,11 +12,26 @@ async function getSecret(cwd) {
   if (!existsSync(secretPath)) {
     return null;
   }
-  return fsp.readFile(secretPath, "utf-8").then((s) => s.trim()).catch(() => null);
+  return fsp.readFile(secretPath, "utf-8").then((s) => s.trim()).catch(() => {
+    return null;
+  });
 }
 function authHeaders(secret) {
   return { Authorization: `Bearer ${secret}` };
 }
+async function requireSecret(cwd, hint = "") {
+  const secret = await getSecret(cwd);
+  if (!secret) {
+    consola.error(`No secret found. Run \`nuxi dev\` or \`nuxi build\` first${hint}.`);
+  }
+  return secret;
+}
+async function fetchJson(url, init, errorLabel = "Failed") {
+  return fetch(url, init).then((r) => r.json()).catch((err) => {
+    consola.error(`${errorLabel}: ${err.message}`);
+    return null;
+  });
+}
 const main = defineCommand({
   meta: {
     name: "nuxt-ai-ready",
@@ -44,17 +59,12 @@ const main = defineCommand({
       },
       async run({ args }) {
         const cwd = resolve(args.cwd || ".");
-        const secret = await getSecret(cwd);
-        if (!secret) {
-          consola.error("No secret found. Run `nuxi dev` or `nuxi build` first to generate one.");
+        const secret = await requireSecret(cwd, " to generate one");
+        if (!secret)
           return;
-        }
         const url = `${args.url}/__ai-ready/status`;
         consola.info(`Fetching status from ${args.url}...`);
-        const res = await fetch(url, { headers: authHeaders(secret) }).then((r) => r.json()).catch((err) => {
-          consola.error(`Failed to connect: ${err.message}`);
-          return null;
-        });
+        const res = await fetchJson(url, { headers: authHeaders(secret) }, "Failed to connect");
         if (!res)
           return;
         consola.box("AI Ready Status");
@@ -146,11 +156,9 @@ const main = defineCommand({
       },
       async run({ args }) {
         const cwd = resolve(args.cwd || ".");
-        const secret = await getSecret(cwd);
-        if (!secret) {
-          consola.error("No secret found. Run `nuxi dev` or `nuxi build` first.");
+        const secret = await requireSecret(cwd);
+        if (!secret)
           return;
-        }
         const params = new URLSearchParams();
         if (args.all) {
           params.set("all", "true");
@@ -159,10 +167,7 @@ const main = defineCommand({
         }
         const url = `${args.url}/__ai-ready/poll?${params}`;
         consola.info(`Triggering poll at ${args.url}...`);
-        const res = await fetch(url, { method: "POST", headers: authHeaders(secret) }).then((r) => r.json()).catch((err) => {
-          consola.error(`Failed: ${err.message}`);
-          return null;
-        });
+        const res = await fetchJson(url, { method: "POST", headers: authHeaders(secret) });
         if (!res)
           return;
         consola.success(`Indexed: ${colors.green(res.indexed?.toString() || "0")} pages`);
@@ -201,21 +206,16 @@ const main = defineCommand({
       },
       async run({ args }) {
         const cwd = resolve(args.cwd || ".");
-        const secret = await getSecret(cwd);
-        if (!secret) {
-          consola.error("No secret found. Run `nuxi dev` or `nuxi build` first.");
+        const secret = await requireSecret(cwd);
+        if (!secret)
           return;
-        }
         const params = new URLSearchParams();
         if (!args.clear) {
           params.set("clear", "false");
         }
         const url = `${args.url}/__ai-ready/restore?${params}`;
         consola.info(`Restoring database at ${args.url}...`);
-        const res = await fetch(url, { method: "POST", headers: authHeaders(secret) }).then((r) => r.json()).catch((err) => {
-          consola.error(`Failed: ${err.message}`);
-          return null;
-        });
+        const res = await fetchJson(url, { method: "POST", headers: authHeaders(secret) });
         if (!res)
           return;
         consola.success(`Restored: ${colors.green(res.restored?.toString() || "0")} pages`);
@@ -265,12 +265,9 @@ const main = defineCommand({
           params.set("ttl", args.ttl);
         const url = `${args.url}/__ai-ready/prune?${params}`;
         consola.info(`${args.dry ? "Previewing" : "Pruning"} stale routes at ${args.url}...`);
-        const res = await fetch(url, {
+        const res = await fetchJson(url, {
           method: "POST",
           headers: secret ? authHeaders(secret) : void 0
-        }).then((r) => r.json()).catch((err) => {
-          consola.error(`Failed: ${err.message}`);
-          return null;
         });
         if (!res)
           return;
@@ -315,20 +312,15 @@ const main = defineCommand({
       },
       async run({ args }) {
         const cwd = resolve(args.cwd || ".");
-        const secret = await getSecret(cwd);
-        if (!secret) {
-          consola.error("No secret found. Run `nuxi dev` or `nuxi build` first.");
+        const secret = await requireSecret(cwd);
+        if (!secret)
           return;
-        }
         const params = new URLSearchParams({
           limit: args.limit || "100"
         });
         const url = `${args.url}/__ai-ready/indexnow?${params}`;
         consola.info(`Triggering IndexNow sync at ${args.url}...`);
-        const res = await fetch(url, { method: "POST", headers: authHeaders(secret) }).then((r) => r.json()).catch((err) => {
-          consola.error(`Failed: ${err.message}`);
-          return null;
-        });
+        const res = await fetchJson(url, { method: "POST", headers: authHeaders(secret) });
         if (!res)
           return;
         if (res.success) {

package/dist/devtools/lib/ai-ready/state.ts

@@ -9,7 +9,10 @@ export const loading = ref(true)
 export async function refreshSources() {
   if (!appFetch.value || typeof appFetch.value !== 'function')
     return
-  data.value = await appFetch.value('/__ai-ready__/debug.json', { responseType: 'json' }).catch(() => null)
+  data.value = await appFetch.value('/__ai-ready__/debug.json', { responseType: 'json' }).catch(() => {
+    // The devtools host can disconnect while a refresh is in flight.
+    return null
+  })
   loading.value = false
   if (data.value?.siteConfigUrl)
     productionUrl.value = data.value.siteConfigUrl

package/dist/module.d.mts

@@ -1,6 +1,8 @@
 import * as _nuxt_schema from '@nuxt/schema';
-import { LlmsTxtConfig, ModuleOptions } from '../dist/runtime/types.js';
-export { ModuleOptions } from '../dist/runtime/types.js';
+import { LlmsTxtConfig, ContentNegotiationPolicy, ModuleOptions } from '../dist/runtime/types.js';
+export { AgentSkillConfig, AgentSkillsConfig, AgentSkillsIndex, AgentSkillsIndexEntry, ApiCatalogConfig, ApiCatalogEntry, ApiCatalogLinkTarget, ApiCatalogLinks, ExternalAgentSkillConfig, LocalAgentSkillConfig, McpServerCardConfig, ModuleOptions } from '../dist/runtime/types.js';
+import { ResolvedWebMcpToolsConfig } from '../dist/runtime/site-tool-config.js';
+export { GetPageMarkdownToolOptions, ListPagesToolOptions, McpSiteToolAttachmentOptions, SearchPagesToolOptions, SiteToolOptions, SiteToolsConfig, WebMcpSiteToolAttachmentOptions } from '../dist/runtime/site-tool-config.js';
 
 interface ParsedMarkdownResult {
     markdown: string;
@@ -11,6 +13,27 @@ interface ParsedMarkdownResult {
     updatedAt?: string;
 }
 
+interface ResolvedApiCatalogLinkTarget {
+    href: string;
+    type?: string;
+    title?: string;
+    hreflang?: string[];
+    media?: string;
+}
+type ResolvedApiCatalogLinksetEntry = Record<string, string | ResolvedApiCatalogLinkTarget[]>;
+interface ResolvedApiCatalogConfig {
+    href: string;
+    mediaType: string;
+    document: {
+        linkset: ResolvedApiCatalogLinksetEntry[];
+    };
+}
+
+interface ResolvedWebMcpConfig {
+    tools: ResolvedWebMcpToolsConfig;
+    exposedTo?: string[];
+}
+
 interface ModuleHooks {
     /**
      * Hook called when page markdown is generated during prerendering.
@@ -36,6 +59,7 @@ declare module '@nuxt/schema' {
 interface ModulePublicRuntimeConfig {
     debug: boolean;
     debugCron: boolean;
+    contentNegotiation: ContentNegotiationPolicy;
     version: string;
     mdreamOptions: ModuleOptions['mdreamOptions'];
     markdownCacheHeaders: Required<NonNullable<ModuleOptions['markdownCacheHeaders']>>;
@@ -66,8 +90,13 @@ interface ModulePublicRuntimeConfig {
         }>;
     } | null;
     ftsTokenizer?: string;
+    apiCatalog?: ResolvedApiCatalogConfig;
+}
+/** Runtime config exposed to the browser, only set when WebMCP is enabled. */
+interface ModuleAppRuntimeConfig {
+    webmcp: ResolvedWebMcpConfig;
 }
 declare const _default: _nuxt_schema.NuxtModule<ModuleOptions, ModuleOptions, false>;
 
 export { _default as default };
-export type { ModuleHooks, ModulePublicRuntimeConfig };
+export type { ModuleAppRuntimeConfig, ModuleHooks, ModulePublicRuntimeConfig };

package/dist/module.json

@@ -4,9 +4,9 @@
     "nuxt": ">=4.0.0"
   },
   "configKey": "aiReady",
-  "version": "1.5.8",
+  "version": "1.7.0",
   "builder": {
-    "@nuxt/module-builder": "1.0.2",
+    "@nuxt/module-builder": "1.0.3",
     "unbuild": "3.6.1"
   }
 }