nuxt-ai-ready 0.6.2 → 0.7.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nuxt-ai-ready",
   "type": "module",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "description": "Best practice AI & LLM discoverability for Nuxt sites.",
   "author": {
     "name": "Harlan Wilton",
@@ -25,20 +25,24 @@
     ".": {
       "types": "./dist/types.d.mts",
       "import": "./dist/module.mjs"
-    },
-    "./mcp": {
-      "types": "./mcp.d.ts",
-      "import": "./dist/runtime/mcp.js"
     }
   },
   "main": "./dist/module.mjs",
   "files": [
-    "dist",
-    "mcp.d.ts"
+    "dist"
   ],
+  "peerDependencies": {
+    "@nuxtjs/sitemap": "^7.0.0",
+    "better-sqlite3": "^11.0.0 || ^12.0.0"
+  },
+  "peerDependenciesMeta": {
+    "better-sqlite3": {
+      "optional": true
+    }
+  },
   "dependencies": {
     "@clack/prompts": "^0.11.0",
-    "@nuxt/kit": "4.2.2",
+    "@nuxt/kit": "^4.2.2",
     "consola": "^3.4.2",
     "db0": "^0.3.4",
     "defu": "^6.1.4",
@@ -50,15 +54,6 @@
     "std-env": "3.10.0",
     "ufo": "^1.6.2"
   },
-  "peerDependencies": {
-    "@nuxtjs/sitemap": "^7.5.2",
-    "better-sqlite3": "^12.5.0"
-  },
-  "peerDependenciesMeta": {
-    "better-sqlite3": {
-      "optional": true
-    }
-  },
   "devDependencies": {
     "@antfu/eslint-config": "^6.7.3",
     "@arethetypeswrong/cli": "^0.18.2",
@@ -70,14 +65,16 @@
     "@nuxtjs/color-mode": "^4.0.0",
     "@nuxtjs/eslint-config-typescript": "^12.1.0",
     "@nuxtjs/i18n": "^10.2.1",
-    "@nuxtjs/mcp-toolkit": "^0.6.1",
+    "@nuxtjs/mcp-toolkit": "^0.6.2",
     "@nuxtjs/robots": "^5.6.7",
     "@nuxtjs/sitemap": "^7.5.2",
+    "@types/better-sqlite3": "^7.6.13",
     "@vitest/coverage-v8": "^4.0.16",
+    "@vue/test-utils": "^2.4.6",
     "@vueuse/nuxt": "^14.1.0",
-    "agents": "^0.3.3",
-    "ai": "^6.0.23",
-    "better-sqlite3": "^12.5.0",
+    "agents": "^0.3.4",
+    "ai": "^6.0.27",
+    "better-sqlite3": "^12.6.0",
     "bumpp": "^10.3.2",
     "eslint": "^9.39.2",
     "execa": "^9.6.1",
@@ -92,21 +89,23 @@
     "vue": "^3.5.26",
     "vue-router": "^4.6.4",
     "vue-tsc": "^3.2.2",
+    "wrangler": "^4.58.0",
     "zod": "^4.3.5"
   },
   "resolutions": {
     "nuxt-ai-ready": "workspace:*"
   },
   "scripts": {
-    "lint": "eslint . --fix",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
     "build": "nuxt-module-build build --stub && nuxt-module-build prepare && nuxt-module-build build",
-    "dev": "nuxi dev playground",
-    "dev:minimal": "nuxi dev playground",
-    "prepare:fixtures": "nuxi prepare playground && nuxi prepare playground && nuxi prepare test/fixtures/basic",
-    "dev:build": "nuxi build playground",
-    "dev:build:minimal": "nuxi build playground",
-    "dev:prepare": "nuxt-module-build build --stub && nuxt-module-build prepare && nuxt-module-build build && nuxi prepare playground",
-    "dev:prepare:minimal": "nuxt-module-build build --stub && nuxt-module-build prepare && nuxt-module-build build && nuxi prepare playground",
+    "dev": "nuxt dev playground",
+    "dev:minimal": "nuxt dev playground",
+    "prepare:fixtures": "nuxt prepare playground && nuxt prepare playground && nuxt prepare test/fixtures/basic",
+    "dev:build": "nuxt build playground",
+    "dev:build:minimal": "nuxt build playground",
+    "dev:prepare": "nuxt-module-build build --stub && nuxt-module-build prepare && nuxt-module-build build && nuxt prepare playground",
+    "dev:prepare:minimal": "nuxt-module-build build --stub && nuxt-module-build prepare && nuxt-module-build build && nuxt prepare playground",
     "release": "pnpm build && bumpp -x \"npx changelogen --output=CHANGELOG.md\"",
     "test": "pnpm run prepare:fixtures && vitest",
     "test:unit": "vitest run --project=unit",

package/dist/runtime/mcp.d.ts

@@ -1,32 +0,0 @@
-export declare const tools: readonly [{
-    name: string;
-    description: string;
-    inputSchema: {};
-    cache: "1h";
-    handler(): Promise<{
-        content: {
-            type: "text";
-            text: string;
-        }[];
-    }>;
-}, import("@nuxtjs/mcp-toolkit").McpToolDefinition<Readonly<{
-    [k: string]: import("zod/v4/core").$ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
-}>, Readonly<{
-    [k: string]: import("zod/v4/core").$ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
-}>>];
-export declare const resources: readonly [{
-    uri: string;
-    name: string;
-    description: string;
-    metadata: {
-        mimeType: string;
-    };
-    cache: "1h";
-    handler(uri: URL): Promise<{
-        contents: {
-            uri: string;
-            mimeType: string;
-            text: string;
-        }[];
-    }>;
-}];

package/dist/runtime/mcp.js

@@ -1,5 +0,0 @@
-import pages from "./server/mcp/resources/pages.js";
-import listPages from "./server/mcp/tools/list-pages.js";
-import searchPages from "./server/mcp/tools/search-pages.js";
-export const tools = [listPages, searchPages];
-export const resources = [pages];

package/dist/runtime/server/db/dump.d.ts

@@ -1,29 +0,0 @@
-import type { DatabaseAdapter } from './schema.js';
-export interface DumpRow {
-    route: string;
-    route_key: string;
-    title: string;
-    description: string;
-    markdown: string;
-    headings: string;
-    keywords: string;
-    updated_at: string;
-    indexed_at: number;
-    is_error: number;
-}
-/**
- * Export all pages as JSON for dump
- */
-export declare function exportDump(db: DatabaseAdapter): Promise<DumpRow[]>;
-/**
- * Compress dump data to base64 gzip
- */
-export declare function compressDump(data: DumpRow[]): Promise<string>;
-/**
- * Decompress dump from base64 gzip
- */
-export declare function decompressDump(base64: string): Promise<DumpRow[]>;
-/**
- * Import dump into database
- */
-export declare function importDump(db: DatabaseAdapter, rows: DumpRow[]): Promise<void>;

package/dist/runtime/server/db/dump.js

@@ -1,29 +0,0 @@
-export async function exportDump(db) {
-  return db.all(`
-    SELECT route, route_key, title, description, markdown, headings, keywords, updated_at, indexed_at, is_error
-    FROM ai_ready_pages
-  `);
-}
-export async function compressDump(data) {
-  const json = JSON.stringify(data);
-  const encoder = new TextEncoder();
-  const stream = new Blob([encoder.encode(json)]).stream();
-  const compressed = stream.pipeThrough(new CompressionStream("gzip"));
-  const buffer = await new Response(compressed).arrayBuffer();
-  return Buffer.from(buffer).toString("base64");
-}
-export async function decompressDump(base64) {
-  const buffer = Buffer.from(base64, "base64");
-  const stream = new Blob([buffer]).stream();
-  const decompressed = stream.pipeThrough(new DecompressionStream("gzip"));
-  const text = await new Response(decompressed).text();
-  return JSON.parse(text);
-}
-export async function importDump(db, rows) {
-  for (const row of rows) {
-    await db.exec(`
-      INSERT OR REPLACE INTO ai_ready_pages (route, route_key, title, description, markdown, headings, keywords, updated_at, indexed_at, is_error)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-    `, [row.route, row.route_key, row.title, row.description, row.markdown, row.headings, row.keywords, row.updated_at, row.indexed_at, row.is_error]);
-  }
-}

package/dist/runtime/server/db/schema.d.ts

@@ -1,8 +0,0 @@
-export declare const SCHEMA_VERSION = "v1.1.0";
-export declare const createTablesSQL = "\nCREATE TABLE IF NOT EXISTS ai_ready_pages (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  route TEXT UNIQUE NOT NULL,\n  route_key TEXT UNIQUE NOT NULL,\n  title TEXT NOT NULL DEFAULT '',\n  description TEXT NOT NULL DEFAULT '',\n  markdown TEXT NOT NULL DEFAULT '',\n  headings TEXT NOT NULL DEFAULT '[]',\n  keywords TEXT NOT NULL DEFAULT '[]',\n  updated_at TEXT NOT NULL,\n  indexed_at INTEGER NOT NULL,\n  is_error INTEGER NOT NULL DEFAULT 0\n);\n\nCREATE INDEX IF NOT EXISTS idx_ai_ready_pages_route ON ai_ready_pages(route);\nCREATE INDEX IF NOT EXISTS idx_ai_ready_pages_is_error ON ai_ready_pages(is_error);\n\nCREATE VIRTUAL TABLE IF NOT EXISTS ai_ready_pages_fts USING fts5(\n  route, title, description, markdown, headings, keywords,\n  content=ai_ready_pages, content_rowid=id\n);\n\nCREATE TRIGGER IF NOT EXISTS ai_ready_pages_ai AFTER INSERT ON ai_ready_pages BEGIN\n  INSERT INTO ai_ready_pages_fts(rowid, route, title, description, markdown, headings, keywords)\n  VALUES (new.id, new.route, new.title, new.description, new.markdown, new.headings, new.keywords);\nEND;\n\nCREATE TRIGGER IF NOT EXISTS ai_ready_pages_ad AFTER DELETE ON ai_ready_pages BEGIN\n  INSERT INTO ai_ready_pages_fts(ai_ready_pages_fts, rowid, route, title, description, markdown, headings, keywords)\n  VALUES('delete', old.id, old.route, old.title, old.description, old.markdown, old.headings, old.keywords);\nEND;\n\nCREATE TRIGGER IF NOT EXISTS ai_ready_pages_au AFTER UPDATE ON ai_ready_pages BEGIN\n  INSERT INTO ai_ready_pages_fts(ai_ready_pages_fts, rowid, route, title, description, markdown, headings, keywords)\n  VALUES('delete', old.id, old.route, old.title, old.description, old.markdown, old.headings, old.keywords);\n  INSERT INTO ai_ready_pages_fts(rowid, route, title, description, markdown, headings, keywords)\n  VALUES (new.id, new.route, new.title, new.description, new.markdown, new.headings, new.keywords);\nEND;\n\nCREATE TABLE IF NOT EXISTS _ai_ready_info (\n  id TEXT PRIMARY KEY,\n  version TEXT,\n  checksum TEXT,\n  ready INTEGER DEFAULT 0\n);\n";
-export interface DatabaseAdapter {
-    all: <T>(sql: string, params?: unknown[]) => Promise<T[]>;
-    first: <T>(sql: string, params?: unknown[]) => Promise<T | undefined>;
-    exec: (sql: string, params?: unknown[]) => Promise<void>;
-}
-export declare function initSchema(db: DatabaseAdapter): Promise<void>;

package/dist/runtime/server/db/schema.js

@@ -1,124 +0,0 @@
-export const SCHEMA_VERSION = "v1.1.0";
-const DROP_TABLES_SQL = [
-  "DROP TABLE IF EXISTS ai_ready_pages_fts",
-  "DROP TABLE IF EXISTS ai_ready_pages",
-  "DROP TABLE IF EXISTS _ai_ready_info",
-  // Legacy unprefixed tables (migration from v1.0.0)
-  "DROP TABLE IF EXISTS pages_fts",
-  "DROP TABLE IF EXISTS pages"
-];
-export const createTablesSQL = `
-CREATE TABLE IF NOT EXISTS ai_ready_pages (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  route TEXT UNIQUE NOT NULL,
-  route_key TEXT UNIQUE NOT NULL,
-  title TEXT NOT NULL DEFAULT '',
-  description TEXT NOT NULL DEFAULT '',
-  markdown TEXT NOT NULL DEFAULT '',
-  headings TEXT NOT NULL DEFAULT '[]',
-  keywords TEXT NOT NULL DEFAULT '[]',
-  updated_at TEXT NOT NULL,
-  indexed_at INTEGER NOT NULL,
-  is_error INTEGER NOT NULL DEFAULT 0
-);
-
-CREATE INDEX IF NOT EXISTS idx_ai_ready_pages_route ON ai_ready_pages(route);
-CREATE INDEX IF NOT EXISTS idx_ai_ready_pages_is_error ON ai_ready_pages(is_error);
-
-CREATE VIRTUAL TABLE IF NOT EXISTS ai_ready_pages_fts USING fts5(
-  route, title, description, markdown, headings, keywords,
-  content=ai_ready_pages, content_rowid=id
-);
-
-CREATE TRIGGER IF NOT EXISTS ai_ready_pages_ai AFTER INSERT ON ai_ready_pages BEGIN
-  INSERT INTO ai_ready_pages_fts(rowid, route, title, description, markdown, headings, keywords)
-  VALUES (new.id, new.route, new.title, new.description, new.markdown, new.headings, new.keywords);
-END;
-
-CREATE TRIGGER IF NOT EXISTS ai_ready_pages_ad AFTER DELETE ON ai_ready_pages BEGIN
-  INSERT INTO ai_ready_pages_fts(ai_ready_pages_fts, rowid, route, title, description, markdown, headings, keywords)
-  VALUES('delete', old.id, old.route, old.title, old.description, old.markdown, old.headings, old.keywords);
-END;
-
-CREATE TRIGGER IF NOT EXISTS ai_ready_pages_au AFTER UPDATE ON ai_ready_pages BEGIN
-  INSERT INTO ai_ready_pages_fts(ai_ready_pages_fts, rowid, route, title, description, markdown, headings, keywords)
-  VALUES('delete', old.id, old.route, old.title, old.description, old.markdown, old.headings, old.keywords);
-  INSERT INTO ai_ready_pages_fts(rowid, route, title, description, markdown, headings, keywords)
-  VALUES (new.id, new.route, new.title, new.description, new.markdown, new.headings, new.keywords);
-END;
-
-CREATE TABLE IF NOT EXISTS _ai_ready_info (
-  id TEXT PRIMARY KEY,
-  version TEXT,
-  checksum TEXT,
-  ready INTEGER DEFAULT 0
-);
-`;
-export async function initSchema(db) {
-  const needsRebuild = await checkSchemaVersion(db);
-  if (needsRebuild) {
-    for (const sql of DROP_TABLES_SQL) {
-      await db.exec(sql);
-    }
-  }
-  const statements = [
-    // Main table
-    `CREATE TABLE IF NOT EXISTS ai_ready_pages (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      route TEXT UNIQUE NOT NULL,
-      route_key TEXT UNIQUE NOT NULL,
-      title TEXT NOT NULL DEFAULT '',
-      description TEXT NOT NULL DEFAULT '',
-      markdown TEXT NOT NULL DEFAULT '',
-      headings TEXT NOT NULL DEFAULT '[]',
-      keywords TEXT NOT NULL DEFAULT '[]',
-      updated_at TEXT NOT NULL,
-      indexed_at INTEGER NOT NULL,
-      is_error INTEGER NOT NULL DEFAULT 0
-    )`,
-    // Indexes
-    `CREATE INDEX IF NOT EXISTS idx_ai_ready_pages_route ON ai_ready_pages(route)`,
-    `CREATE INDEX IF NOT EXISTS idx_ai_ready_pages_is_error ON ai_ready_pages(is_error)`,
-    // FTS5 virtual table
-    `CREATE VIRTUAL TABLE IF NOT EXISTS ai_ready_pages_fts USING fts5(
-      route, title, description, markdown, headings, keywords,
-      content=ai_ready_pages, content_rowid=id
-    )`,
-    // Triggers for FTS sync
-    `CREATE TRIGGER IF NOT EXISTS ai_ready_pages_ai AFTER INSERT ON ai_ready_pages BEGIN
-      INSERT INTO ai_ready_pages_fts(rowid, route, title, description, markdown, headings, keywords)
-      VALUES (new.id, new.route, new.title, new.description, new.markdown, new.headings, new.keywords);
-    END`,
-    `CREATE TRIGGER IF NOT EXISTS ai_ready_pages_ad AFTER DELETE ON ai_ready_pages BEGIN
-      INSERT INTO ai_ready_pages_fts(ai_ready_pages_fts, rowid, route, title, description, markdown, headings, keywords)
-      VALUES('delete', old.id, old.route, old.title, old.description, old.markdown, old.headings, old.keywords);
-    END`,
-    `CREATE TRIGGER IF NOT EXISTS ai_ready_pages_au AFTER UPDATE ON ai_ready_pages BEGIN
-      INSERT INTO ai_ready_pages_fts(ai_ready_pages_fts, rowid, route, title, description, markdown, headings, keywords)
-      VALUES('delete', old.id, old.route, old.title, old.description, old.markdown, old.headings, old.keywords);
-      INSERT INTO ai_ready_pages_fts(rowid, route, title, description, markdown, headings, keywords)
-      VALUES (new.id, new.route, new.title, new.description, new.markdown, new.headings, new.keywords);
-    END`,
-    // Info table
-    `CREATE TABLE IF NOT EXISTS _ai_ready_info (
-      id TEXT PRIMARY KEY,
-      version TEXT,
-      checksum TEXT,
-      ready INTEGER DEFAULT 0
-    )`
-  ];
-  for (const statement of statements) {
-    await db.exec(statement);
-  }
-  await db.exec(
-    "INSERT OR REPLACE INTO _ai_ready_info (id, version) VALUES (?, ?)",
-    ["schema", SCHEMA_VERSION]
-  );
-}
-async function checkSchemaVersion(db) {
-  const info = await db.first(
-    "SELECT version FROM _ai_ready_info WHERE id = ?",
-    ["schema"]
-  ).catch(() => null);
-  return !info || info.version !== SCHEMA_VERSION;
-}

package/dist/runtime/server/plugins/page-indexer.js

@@ -1,68 +0,0 @@
-import { defineNitroPlugin, useRuntimeConfig } from "nitropack/runtime";
-import { useDatabase } from "../db/index.js";
-import { getPage, isPageFresh, upsertPage } from "../db/queries.js";
-import { logger } from "../logger.js";
-import { convertHtmlToMarkdownMeta } from "../utils.js";
-import { extractKeywords, stripMarkdown } from "../utils/keywords.js";
-export default defineNitroPlugin((nitro) => {
-  const config = useRuntimeConfig()["nuxt-ai-ready"];
-  const ttl = config.ttl ?? 0;
-  nitro.hooks.hook("afterResponse", (event, response) => {
-    const body = response?.body;
-    const path = event.path;
-    if (path.startsWith("/api") || path.startsWith("/_") || path.startsWith("/@") || path.endsWith(".md") || path.includes(".")) {
-      return;
-    }
-    const contentType = event.node.res.getHeader("content-type");
-    if (!contentType?.toString().includes("text/html"))
-      return;
-    const status = event.node.res.statusCode;
-    if (status >= 400)
-      return;
-    event.waitUntil((async () => {
-      const html = typeof body === "string" ? body : null;
-      if (!html) {
-        logger.debug(`[runtime-indexing] Skipping ${path} - no HTML body`);
-        return;
-      }
-      const db = await useDatabase(event);
-      if (ttl > 0 && await isPageFresh(db, path, ttl)) {
-        logger.debug(`[runtime-indexing] Skipping ${path} - still fresh`);
-        return;
-      }
-      const existing = await getPage(db, path);
-      const isUpdate = !!existing;
-      const isError = html.includes("__NUXT_ERROR__") || html.includes("nuxt-error-page");
-      const result = await convertHtmlToMarkdownMeta(html, path, config.mdreamOptions);
-      const updatedAt = result.updatedAt || (/* @__PURE__ */ new Date()).toISOString();
-      const headings = JSON.stringify(result.headings);
-      const keywords = extractKeywords(stripMarkdown(result.markdown), result.metaKeywords);
-      await upsertPage(db, {
-        route: path,
-        title: result.title,
-        description: result.description,
-        markdown: result.markdown,
-        headings,
-        keywords,
-        updatedAt,
-        isError
-      });
-      logger.debug(`[runtime-indexing] Indexed: ${path} "${result.title}"`);
-      if (!isError) {
-        const hookContext = {
-          route: path,
-          title: result.title,
-          description: result.description,
-          headings,
-          keywords,
-          markdown: result.markdown,
-          updatedAt,
-          isUpdate
-        };
-        await nitro.hooks.callHook("ai-ready:page:indexed", hookContext);
-      }
-    })().catch((err) => {
-      logger.error(`[runtime-indexing] Failed to index ${path}:`, err);
-    }));
-  });
-});

package/dist/runtime/server/tsconfig.json

@@ -1,3 +0,0 @@
-{
-  "extends": "../../../.nuxt/tsconfig.server.json"
-}

package/dist/runtime/server/utils/pageData.d.ts

@@ -1,28 +0,0 @@
-import type { H3Event } from 'h3';
-/** Page entry from database */
-export interface PageEntry {
-    route: string;
-    title: string;
-    description: string;
-    headings: string;
-    keywords: string[];
-    updatedAt: string;
-}
-/** Page data includes markdown content */
-export interface PageData extends PageEntry {
-    markdown: string;
-}
-/** Page list item for MCP tools/resources */
-export interface PageListItem {
-    route: string;
-    title: string;
-    description: string;
-    headings?: string;
-    keywords?: string[];
-}
-/** Read page data - returns page data indexed by route */
-export declare function getPages(event?: H3Event): Promise<Map<string, PageEntry>>;
-/** Get error routes detected during prerender */
-export declare function getErrorRoutes(event?: H3Event): Promise<Set<string>>;
-/** Get pages as flat list for MCP consumption */
-export declare function getPagesList(event?: H3Event): Promise<PageListItem[]>;

package/dist/runtime/server/utils/pageData.js

@@ -1,43 +0,0 @@
-import { useDatabase } from "../db/index.js";
-import { getAllPages as dbGetAllPages, getErrorRoutes as dbGetErrorRoutes } from "../db/queries.js";
-function getEventFromContext(providedEvent) {
-  if (providedEvent) return providedEvent;
-  const { useEvent } = require("nitropack/runtime");
-  return useEvent().catch(() => void 0);
-}
-export async function getPages(event) {
-  if (import.meta.dev) return /* @__PURE__ */ new Map();
-  if (import.meta.prerender) {
-    return (await readPrerenderedData()).pages;
-  }
-  const db = await useDatabase(getEventFromContext(event));
-  const pages = await dbGetAllPages(db);
-  return new Map(pages.map((p) => [p.route, p]));
-}
-export async function getErrorRoutes(event) {
-  if (import.meta.dev) return /* @__PURE__ */ new Set();
-  if (import.meta.prerender) {
-    return (await readPrerenderedData()).errorRoutes;
-  }
-  const db = await useDatabase(getEventFromContext(event));
-  const routes = await dbGetErrorRoutes(db);
-  return new Set(routes);
-}
-export async function getPagesList(event) {
-  const pages = await getPages(event);
-  return Array.from(pages.values()).map((p) => ({
-    route: p.route,
-    title: p.title || p.route,
-    description: p.description || "",
-    headings: p.headings || void 0,
-    keywords: p.keywords?.length ? p.keywords : void 0
-  }));
-}
-async function readPrerenderedData() {
-  const m = await import("#ai-ready-virtual/read-page-data.mjs");
-  const data = await m.readPageDataFromFilesystem();
-  return {
-    pages: new Map(data.pages?.map((p) => [p.route, p]) || []),
-    errorRoutes: new Set(data.errorRoutes || [])
-  };
-}

package/mcp.d.ts

@@ -1,4 +0,0 @@
-import type { McpResourceDefinition, McpToolDefinition } from '@nuxtjs/mcp-toolkit'
-
-export declare const tools: readonly [McpToolDefinition, McpToolDefinition]
-export declare const resources: readonly [McpResourceDefinition]